Telegram Mini App — local classifieds board.
An MVP project is needed with the possibility of further scaling for a mobile application and web version. The architecture should be designed for the future development of the project.
Functionality for users:
Authorization via Telegram WebApp with the ability to change the nickname and profile photo. Users can publish ads: title, description, price, category, up to 5 photos, and choose a contact method.
Mandatory fields when publishing:
title
description minimum 20 characters
price
category
at least 1 photo
contact method
If fields are not filled out — highlight errors and prohibit publication.
Contact methods:
only internal chat
only call
chat + call
Only the selected contact methods are displayed on the ad card.
Internal chat within Mini App:
message storage in the database
notifications via Telegram bot
unread messages
text + photo
no voice messages
Ads:
3 free ads per week
the rest are paid via LiqPay
price is set in the admin panel
ad lifespan 30 days
after closing, it is stored in the user's archive for another 30 days
possibility of reposting
Boosting ads:
for 3 or 7 days
boosting up within the category
visual highlighting by color
payment via LiqPay
Photos:
automatic compression
WebP
maximum 500KB
width up to 600px
photo storage in the cloud
Main page:
app name
keyword search
auto-slider for advertising banners
categories
ads feed
bottom navigation menu
Categories:
horizontal swipe
separate page "All categories"
Personal account:
my ads
favorites
messages
profile settings
feedback
Ad statuses:
under moderation
published
rejected
archive
Favorites:
heart button
separate tab
Subscription to categories:
notifications via Telegram bot when new ads appear.
Telegram bot:
Notifications about publication, rejection, new messages, end of boosting, and upcoming closure of the ad.
Admin panel:
user and ad statistics
manual moderation
category management
banner management
setting the cost of boosting and paid ads
Technical requirements:
backend API with the possibility of further connecting a mobile application
PostgreSQL
GitHub repository
comments in the code
transfer of all source files and accesses after completion
photos in cloud storage
LiqPay integration + webhook
architecture should allow for further scaling of the project
All servers, databases, and services are registered on my accounts.