Smart Local Offers Mobile App

1. CUSTOMER / BUYER SYSTEM

Guest Mode (No Login Required)

Users can:

* Browse all offers by city
* View nearby offers on map
* Search offers, products, stores, categories
* View store profiles
* View digital catalogs (images / PDFs)
* View ratings and reviews (read-only)
* Open offer details (price, discount, location, duration)

⸻

Registered User System

Authentication via:

* Phone number (OTP)
* Email (OTP)

Registered users can:

* Save offers to favorites
* Follow stores
* Receive push notifications
* Rate stores
* Use chat with merchants
* Reserve offers (if enabled)
* View interaction history

⸻

Location System

* GPS detection
* Manual city selection fallback
* Radius filtering:
* 1 km / 5 km / 10 km / 25 km / custom radius
* Offers Near Me feed
* Map-based discovery with pins

⸻

Search System

Supports:

* Offers search
* Products search
* Stores search
* Categories
* Keywords
* City filtering
* Geo-based ranking

⸻

Favorites System

* Save offers
* Reserved offers automatically saved
* Expired offers remain marked as “Expired”
* Full interaction history stored

⸻

Chat System

* Real-time messaging
* User to merchant communication
* Text messages (MVP) with future media support
* Lightweight mode for weak internet
* Chat linked to offers

⸻

Notification System

Users receive:

* Nearby offers alerts
* New offers in selected city
* Followed store updates
* Personalized recommendations
* Flash deal alerts
* Expiring offers reminders

⸻

Personalization Engine

* Tracks user behavior
* Learns interests:
* food
* clothing
* electronics
* services
* Ranks feed based on relevance

⸻

2. MERCHANT SYSTEM

Merchant Registration

* Phone OTP authentication
* Email optional verification

⸻

Mobile Merchant App

Merchants can:

* Create offers from mobile
* Upload images from camera or gallery
* Manage store from phone
* Publish offers instantly
* Edit or delete offers

⸻

Merchant Profile

Includes:

* Store name
* Description
* Category
* Contact information
* Address
* GPS location
* Logo/image
* Verification status
* Join date
* Ratings and reviews

⸻

Location System

* GPS map pin selection
* Enables:
* Nearby discovery
* Radius ranking
* Geo-targeting

⸻

Offer System

Merchants can create:

* Percentage discounts
* Fixed price deals
* Limited quantity offers
* Unlimited offers
* First X buyers offers
* Time-based offers
* Flash deals

⸻

Offer Settings

Reservation system (optional per offer):

* Enable or disable per offer
* Generates unique keyword
* Used for in-store redemption

Reservation and favorites:

* Reserved offers saved automatically
* After expiry, marked as expired but kept in history

Quantity control:

* Limited or unlimited stock
* Auto stock deduction

Time control:

* Start date
* End date
* Extend offer
* Pause offer
* Repost offer (new ad entry)

⸻

AI Offer Assistant

Helps merchants:

* Improve offer titles
* Rewrite descriptions
* Improve clarity
* Suggest keywords
* Suggest categories
* Improve engagement potential

⸻

Merchant Dashboard

Analytics:

* Views
* Engagement rate
* Interested users
* Favorites count
* Phone clicks
* Location clicks
* Chat requests

Offer management:

* Create offers
* Edit offers
* Delete offers
* Extend offers
* Activate or pause offers
* Repost offers

Insights:

* Best performing offers
* Weak performing offers
* Keywords performance
* User behavior trends

⸻

3. ADMIN SYSTEM

User Management

* View users
* Block or unblock users
* Activity logs

⸻

Merchant Management

* Approve or reject merchants
* Verify stores
* Suspend accounts

⸻

Offer Moderation

* View all offers
* Remove spam or fake content
* Detect duplicates

⸻

City Management

* Damascus
* Aleppo
* Homs
* Hama
* Latakia
* Tartous
* Idlib
* Sarmada
* Daraa
* Deir Ezzor
* Jableh
* Baniyas

Admin can:

* Add or edit cities
* Enable or disable regions

⸻

Platform Analytics

* Daily active users
* Total merchants
* Total offers
* Top cities
* Top categories
* Engagement metrics

⸻

Notification Control

* City-wide announcements
* Category campaigns
* System messages

⸻

Trust and Safety

* Merchant verification
* Fake account detection
* Content moderation
* Review monitoring

⸻

4. SYSTEM FEATURES

Performance Optimization

* Lightweight design
* Low data usage
* Fast loading feed

⸻

Location Engine

* GPS detection
* Radius filtering
* City fallback system

⸻

Offer Lifecycle

* Created
* Active
* Expired
* Expired offers remain in favorites

⸻

Ranking System

Offers ranked by:

* Distance
* Recency
* Engagement
* Relevance

⸻

Engagement System

* Trending offers per city
* Daily deals feed
* Flash offers
* Personalized recommendations

⸻

Security and Fraud Control

* Fake offer detection
* Duplicate detection
* Report system
* Merchant monitoring

⸻

5. SYSTEM ARCHITECTURE

Frontend

* Flutter (iOS and Android single codebase)

Backend

* Firebase or Supabase:
* Authentication
* Database
* Cloud functions
* Push notifications

Maps

* Google Maps API

AI Layer

* OpenAI API for text improvement and optimization and Offers