# TS LUXEWEAR - MULTI-STORE WOMEN'S FASHION PLATFORM

## PHASE 1 → CORE APP FOUNDATION

**APP NAME:** TS LuxeWear

**PLATFORM TYPE:** Multi-store women's fashion platform

**DEVELOPMENT CONTEXT:**

This project is built primarily from mobile using Google AI Studio, then pushed to GitHub, and deployed when needed.

Workflow:
1. Build app/code using Google AI Studio on mobile
2. Push project to GitHub
3. Deploy frontend/web dashboards if needed
4. Use Firebase as backend
5. Use Cloudinary for product images

This platform must be optimized for mobile-based development and free-tier services.

**BUSINESS MODEL:**

TS LuxeWear is a multi-store women's fashion platform where one platform supports multiple store owners.

Example:
- TS LuxeWear
  - Priya Boutique
  - Fashion Queen
  - Velvet Sarees
  - Ethnic Grace

Each store owner manages their own store independently.

Customers can browse products from different stores inside one unified app.

**IMPORTANT:**
This platform is completely FREE.

Remove all subscription systems:
- No paid plans
- No upgrade plans
- No subscription renewals
- No commission system

**PLATFORM REQUIREMENTS:**

This should work like a real app and run smoothly on:
- Android phones
- iPhones
- Tablets
- Desktop computers
- Laptops

One codebase that supports all devices smoothly.

The UI must be responsive, fast, premium, and production-ready.

**SYSTEM ARCHITECTURE:**

Build using multi-tenant architecture.

Every store must have:
- store_id
- store_name
- owner_name
- owner_phone
- owner_whatsapp
- store_logo
- store_banner
- store_status (active/suspended)
- store_url (unique URL for each store)
- store_address_map_link (Google Maps link)
- store_type
- store_categories
- store_followers_count
- created_at

Every product, order inquiry, review, category, and customer interaction must be linked with store_id.

## PHASE 2 → AUTHENTICATION & ROLE ACCESS

**USER ROLES:**

Build a role-based authentication system using Firebase.

User roles:
1. super_admin
2. store_owner
3. customer
4. guest

**AUTHENTICATION REQUIREMENTS:**

Main app must NOT show Super Admin login publicly.

Public users should only see:
- Continue as Guest
- Customer Login (Google)
- Store Owner Login (Google)

**HIDDEN ADMIN ACCESS:**

Create a hidden admin route:
/admin

Example:
myapp.com/admin

Only these Gmail accounts must have "super_admin" access:
1. shakirsir2122@gmail.com
2. stalha2110@gmail.com

No other Gmail account should ever receive super_admin access.

If any other user tries to access /admin, block access and redirect them.

**LOGIN FLOW:**

After Google login, Firebase must verify the Gmail account.

If Gmail matches one of the approved super admin accounts:
→ Redirect to Super Admin Dashboard

If Gmail belongs to a store owner:
→ Redirect to Store Owner Dashboard

If Gmail belongs to a customer:
→ Redirect to Customer Home

Guest users:
→ Redirect to Guest Shopping Mode

**SECURITY:**

Protect all admin routes and admin dashboard pages.

Unauthorized users must never access admin pages even if they manually type /admin in browser URL.

## PHASE 3 → PERMISSION SYSTEM & USER PRIVACY

**PERMISSION REQUEST STRATEGY:**

Implement a smart and professional permission request system.

**IMPORTANT RULES:**

- Do NOT ask all permissions immediately on app startup
- On first app open, ask only the most essential/common permissions required for basic app functionality
- Remaining permissions should only be requested WHEN the user actually uses a feature that requires that permission

**CONTEXT-BASED PERMISSION REQUESTS:**

**Camera Permission:**
- Request only when user wants to upload/take product photo
- Request only when user wants to update profile image
- Request only when store owner wants to add product images using camera
- Request only when customer wants to upload review photos

**Gallery/Photos Permission:**
- Request only when user selects images from device
- Request only when uploading product images from gallery
- Request only when changing profile picture from gallery
- Request only when uploading images with reviews

**Notification Permission:**
- Request when user enables alerts for orders
- Request when enabling product updates
- Request when enabling promotional notifications
- Request when enabling store updates
- Request when following a store to get new product notifications
- Request when enabling inquiry/question reply notifications
- Request when enabling low stock alerts (store owners)

**Location Permission:**
- Request only if location-based features are used
- Request only when user wants to find nearby stores (if applicable)

**Storage/File Permission:**
- Request only when downloading product images
- Request only when uploading files or documents
- Request only when saving invoices or receipts
- Request only when downloading invoice PDF

**PERMISSION FLOW REQUIREMENTS:**

The permission flow must feel:
- Professional
- Modern
- User-friendly
- Privacy-focused
- Non-spammy

**BEFORE REQUESTING PERMISSION:**

- Clearly explain WHY the permission is needed
- Show context-appropriate message
- Use friendly and transparent language

Example:
"To upload product photos, TS LuxeWear needs access to your camera. This allows you to take photos directly from the app."

**HANDLING PERMISSION DENIAL:**

If user denies permission:
- Show limited fallback behavior where possible
- Allow user to continue using other app features
- Do not block entire app functionality
- Provide alternative options when available

Example:
If camera permission denied:
→ Still allow user to upload from gallery
→ Continue browsing products normally

**CROSS-PLATFORM PERMISSION HANDLING:**

Ensure permissions work properly across:
- Android
- iPhone/iOS
- Tablets
- Desktop/Laptop browsers (where applicable)

**PERMISSION RE-REQUEST LOGIC:**

- If user denies permission initially, do not spam them
- Allow user to manually enable permission later from settings
- Show helpful message on how to enable permission from device settings if needed again

**PRIVACY-FOCUSED APPROACH:**

- Only request permissions that are absolutely necessary
- Avoid unnecessary permission requests
- Be transparent about data usage
- Respect user privacy choices
- Do not penalize users who deny optional permissions

## PHASE 4 → PUSH NOTIFICATION SYSTEM

Implement a comprehensive push notification system using Firebase Cloud Messaging.

**FOR CUSTOMERS:**

Notification types:
- Order status updates (Confirmed, Packed, Shipped, Delivered)
- Order cancellation notifications
- New products from followed stores
- New offers/promotions from followed stores
- Out-of-stock product restocked (from wishlist)
- Reply to product inquiry/question
- Review reply from store owner
- Special festival/seasonal offers

**FOR STORE OWNERS:**

Notification types:
- New order received
- New customer inquiry/question on product
- New customer review on product
- Low stock alert (when stock falls below threshold)
- Maintenance charge due date reminder
- Customer return/refund request
- New customer followed your store

**FOR SUPER ADMIN:**

Notification types:
- New store registration
- New customer complaint
- New store complaint
- Maintenance charge payment received
- Suspicious activity alert
- Platform milestone notifications

**NOTIFICATION FEATURES:**

- In-app notification center/inbox
- Badge count for unread notifications
- Notification history (last 30 days)
- Mark as read/unread
- Delete notifications
- Notification sound toggle
- Notification preferences (enable/disable by type)
- Click notification to navigate to relevant page
- Real-time delivery using Firebase
- Notification grouping by category

**NOTIFICATION PERMISSION TRIGGER:**

- Request notification permission when user first enables any notification setting
- Explain benefits before requesting permission
- Allow granular control over notification types
- Users can manage notification preferences anytime

**OPTIMIZATION:**

- Queue notifications to avoid spam
- Smart notification timing (avoid late night)
- Batch similar notifications
- Notification throttling for repeated events

## PHASE 5 → SUPER ADMIN DASHBOARD

Create a premium modern dashboard.

**PLATFORM OVERVIEW:**

- Total stores
- Total customers
- Total products
- Total categories
- Active stores
- Suspended stores

**STORE MANAGEMENT:**

- View all stores
- Approve stores
- Suspend stores
- Delete stores
- View store performance

**ANALYTICS:**

- Top visiting store according to customer
- Top viewed products
- Customer growth
- Daily active users
- Most used function of app by Store
- Add features that help monitor the stores for app improvement

**FINANCIALS:**

- Maintenance charge & due date with paid or not
- Total earnings from particular store

**ORDER MONITORING:**

- View all orders/inquiries platform-wide
- Monitor order status across all stores
- Track order completion rates
- View pending, confirmed, packed, shipped, delivered, cancelled orders
- Store-wise order analytics
- Customer order history across platform

**SUPPORT:**

- Customer complaints
- Store complaints
- Bug reports

**NOTIFICATIONS:**

- New login: Store/customer details
- Complaints
- Maintenance charge due date reminder from specific store
- Low stock alerts
- Suspicious activity alerts
- New order/inquiry notifications

## PHASE 6 → STORE OWNER DASHBOARD

Each store owner logs in and only sees their own data.

**A. DASHBOARD HOME:**

- Today's sale / Weekly sale: after clicking on this widget it will switch between today's sale and weekly sale
- Customer visits Today / Weekly: same switch function as sale
- Product views
- Low stock alerts
- Total store followers
- Pending customer inquiries

**B. PRODUCT MANAGEMENT:**

Store owner can:
- Add product
- Edit product
- Delete product
- Duplicate product
- Bulk upload products

Product fields:
- Product name
- Category
- Price
- Discount price
- Description
- Fabric
- Sizes
- Colors
- Stock quantity
- Low stock threshold (for alerts)

**LOW STOCK ALERTS & AUTO-INVENTORY MANAGEMENT:**

Implement intelligent stock monitoring system:

- Store owner sets minimum stock threshold per product (e.g., 5 units)
- When stock falls below threshold:
  → Automatic push notification to store owner
  → Alert appears in dashboard home
  → Product marked with "Low Stock" badge
  → Email notification (optional)

- When stock reaches zero:
  → Auto mark product as "Out of Stock"
  → Hide from customer search results (optional setting)
  → Add to "Restock Needed" list

- Stock history tracking:
  → View stock changes over time
  → Track when products were restocked
  → Identify fast-moving products

- Restock reminder system:
  → Remind store owner after X days if still out of stock
  → Priority list of products needing restock
  → Bulk restock option

- Customer notification on restock:
  → If customer has product in wishlist and it's restocked
  → Send notification "Your wishlisted item is back in stock!"

**IMAGE COMPRESSION CUSTOMIZATION:**

When uploading product images to Cloudinary, compress image should have customization options like 50%, 60% compression level.

**C. CATEGORY MANAGEMENT:**

Store owner must have full category control.

They can:
- Add category
- Edit category
- Delete category

Example:
If store owner creates:
- Party Wear
- Wedding Collection
- Daily Wear
- Designer Sarees

These categories must automatically sync in real-time to:
1. Store owner dashboard
2. Customer app
3. Super admin dashboard

Use Firebase real-time updates.

**D. ORDER MANAGEMENT:**

Store owners must have a comprehensive Order Management section in their dashboard.

**Order Settings:**
- On/off option for accepting orders
- Delivery charge on/off, if on then input charge number in rupees
- COD availability toggle
- Return policy toggle

**Order Dashboard:**

Store owner should see all orders/inquiries with:
- Pending inquiries
- Confirmed orders
- Packed orders
- Shipped orders
- Delivered orders
- Cancelled orders

**Order Details View:**

For each order, display:
- Customer name
- Customer phone number
- Customer delivery address
- Product details (name, size, color, price)
- Product image
- Order/inquiry timestamp
- Current order status
- Delivery charge (if applicable)

**Order Status Management:**

Store owner can manually update order status:
- Pending (default when order is created)
- Confirmed (store owner accepts the order)
- Packed (order is packed and ready)
- Shipped (order is shipped)
- Delivered (order is delivered to customer)
- Cancelled (order is cancelled)

**INVOICE/ORDER RECEIPT GENERATION:**

Implement professional invoice system:

- Auto-generate invoice when order status changes to "Confirmed"
- Invoice includes:
  → Store branding (logo, name, address, phone, WhatsApp)
  → Invoice number (auto-incremented unique ID)
  → Invoice date
  → Customer details (name, phone, address)
  → Product details (name, size, color, quantity, price)
  → Subtotal
  → Delivery charge (if applicable)
  → Discount (if applicable)
  → Total amount
  → Payment method (COD/WhatsApp)
  → Order ID reference

- Invoice features:
  → Download as PDF
  → Share via WhatsApp to customer
  → Share via email
  → Print option
  → Professional formatting with store branding
  → Invoice history/archive
  → Re-download previous invoices
  → Invoice template customization

- Invoice numbering system:
  → Format: STORE_PREFIX-YEAR-MONTH-NUMBER
  → Example: PB-2024-01-0001
  → Auto-increment for each store
  → Reset yearly or continuous (store owner choice)

- Customer access:
  → Customer can view invoice in "My Orders"
  → Download invoice from order details
  → Invoice automatically attached when order confirmed

**Real-time Updates:**

When store owner updates order status:
- Customer should see status update in real-time in their order tracking
- Super admin should see updated status in order monitoring
- Related analytics should update automatically
- Push notification sent to customer
- Invoice generated/updated if needed

**Order Tracking System:**

Implement practical tracking system:
- Accept order → Packed order → Mark delivered
- Each status change should be timestamped
- Status history should be maintained

**E. CUSTOMER MANAGEMENT:**

- Reviews
- Total number of customer visits
- Request of category or product by customer, even for out of stock product
- Customer inquiry
- Add needed features that store owner wants in real life

**F. CUSTOMER INQUIRY & MESSAGING SYSTEM:**

Implement comprehensive inquiry and messaging system separate from orders.

**Inquiry Dashboard:**

Store owner has dedicated section for customer questions/inquiries.

View all inquiries:
- Unanswered inquiries (priority)
- Answered inquiries
- All inquiries
- Inquiry history

**Inquiry Details:**

Each inquiry shows:
- Customer name
- Customer email/phone
- Product name & link
- Question text
- Timestamp
- Status (new, replied, resolved)

**UNIFIED MESSAGING INBOX:**

Create professional messaging interface:

**Inbox Features:**
- All customer inquiries and questions in one place
- Conversation-based view (like WhatsApp)
- Chat history between customer and store owner
- Real-time message updates
- Unread message counter
- Message notifications

**Conversation Management:**
- Pin important conversations
- Archive old conversations
- Mark as read/unread
- Search conversations by customer name or product
- Filter by status (active, resolved, archived)
- Sort by newest, oldest, unread

**Quick Reply Templates:**

Store owner can create and use saved replies:

- Create custom quick reply templates
- Save frequently asked questions with answers
- One-click quick replies
- Template categories (shipping, sizing, customization, etc.)

Example templates:
- "Delivery takes 5-7 business days"
- "Yes, customization is available. Please share your requirements."
- "Product will be restocked in 3 days"

**Canned Responses:**

Pre-built responses for common questions:
- What's your delivery timeline?
- Do you offer COD?
- Is return available?
- What are product dimensions?
- Is bulk order discount available?

**Messaging Features:**
- Type and send reply
- Attach product links in reply
- Attach images in reply
- Message read status (seen/unseen)
- Typing indicator
- Message timestamp

**Customer Notification:**
- Customer gets push notification when store owner replies
- In-app notification badge
- Email notification (optional)

**Benefits:**
- Faster customer response
- Better service quality
- Reduced response time
- Organized communication
- Professional customer service

**G. OFFERS:**

- Create offer & description of offer like festival offer (Diwali, Eid, etc.)
- Notify followers when new offer is created

**H. STORE URL & MAP:**

- Each store owner has their own unique URL for their store
- If they send URL to any customer, customer visits only their store products
- Store owner can save Google Maps store address link into their profile
- The link automatically shows in every description of product to their customer
- User can also check in info of the store owner

## PHASE 7 → PRODUCT IMAGE SYSTEM

When store owner uploads product:

Step 1:
Choose image from mobile gallery or camera.

**Permission Trigger:**
Request camera permission only when user selects camera option.
Request gallery permission only when user selects gallery option.

Step 2:
Allow store owner to select compression level (50%, 60%, etc.).

Step 3:
Compress image automatically based on selected level.

Step 4:
Convert image to optimized format.

Step 5:
Upload image to Cloudinary.

Step 6:
Get image URL.

Step 7:
Save only image URL in Firebase.

**IMPORTANT:**
Do NOT store image files in Firebase.

Store only Cloudinary URLs.

Customers should see images normally.

## PHASE 8 → PRODUCT SHARING SYSTEM

Every product must have a specific shareable link.

When store owner or customer shares a product link:
- The link must navigate directly to that specific product from that specific store
- Product link must contain store_id and product_id
- Link must work even for users who are not logged in

## PHASE 9 → WHATSAPP ORDER FLOW & INTERNAL ORDER SYSTEM

**IMPORTANT:**

When customer clicks "Buy Now" or "Order on WhatsApp", the app should NOT immediately open WhatsApp.

Instead, implement a connected internal order flow.

**STEP 1 → CUSTOMER DETAILS FORM:**

First show a small order details form.

Required fields:
- Customer Name
- Phone Number
- Delivery Address

Requirements:
- Validate inputs properly
- Save customer information for future orders
- Allow auto-fill for returning customers
- Make the process fast and user-friendly
- Form should be clean and mobile-friendly

**STEP 2 → INTERNAL ORDER ENTRY:**

After customer submits details:

Automatically create an internal order/inquiry entry inside the app database.

Save:
- order_id (unique)
- customer_name
- customer_phone
- customer_address
- product_id
- product_name
- product_price
- product_size
- product_color
- product_image_url
- store_id
- store_name
- timestamp
- order_status (default: Pending)

**Default inquiry status:**
Pending

**IMPORTANT:**
This internal order system should connect:
- Customer
- Store Owner
- Super Admin

**STEP 3 → WHATSAPP MESSAGE FLOW:**

After internal order entry is created:

Automatically open WhatsApp with a pre-filled message.

Example:

Hello, I want to order this product.

Customer Name: Talha
Phone: 98XXXXXXX
Address: Maharashtra, India

Product Name: Designer Saree
Size: M
Color: Pink
Price: ₹1499

Product Link: [specific product URL]

Send this message directly to the correct store owner WhatsApp number.

**CONNECTED SYSTEM REQUIREMENT:**

All order/inquiry data must remain interconnected between:
- Customer
- Store Owner
- Super Admin

Examples:

- Store owner status updates should reflect in customer order tracking
- Super admin should be able to monitor all inquiries/orders platform-wide
- Customer should see inquiry/order status updates inside app
- Related analytics and dashboards should update accordingly
- Push notifications sent when status changes
- Invoice generated when order confirmed

**COD & DELIVERY OPTIONS:**

- Show if COD is available or not for that store
- If COD available, show if return is available or not
- Show delivery charge if applicable

**DATABASE STRUCTURE FOR ORDERS:**

Each order should maintain:
- Real-time status tracking
- Status update history with timestamps
- Customer details
- Product details
- Store details
- Payment method (COD/WhatsApp)
- Delivery charge (if applicable)
- Invoice ID (after generation)

## PHASE 10 → CUSTOMER APP

Customers should see premium UI.

**AUTHENTICATION:**

- Continue as Guest
- Google login

**HOMEPAGE:**

- Featured stores
- Trending products
- New arrivals
- Recommended products
- Followed stores section

**STORE SELECTION:**

- Select store (show which type of store it is & what categories they have in short info)
- Show store follower count
- Show "Follow" button
- Or explore all items from all stores

**FOLLOW STORE FEATURE:**

Implement store following system:

**Follow/Unfollow:**
- "Follow Store" button on store page
- "Unfollow" button if already following
- Follower count displays on store page (social proof)
- Example: "1.2K followers"

**Followed Stores Dashboard:**

Customer has dedicated section for followed stores:
- List of all followed stores
- Store logo, name, and type
- Quick access to each store
- Unfollow option
- View all products from followed stores in one feed

**Notifications from Followed Stores:**

Customer receives push notifications when followed store:
- Adds new products → "Priya Boutique added 5 new products!"
- Creates new offer/promotion → "Fashion Queen: 30% off Diwali Sale!"
- Restocks out-of-stock items from customer's wishlist → "Designer Saree you wishlisted is back in stock!"

**Notification Preferences:**

Customer can customize:
- Enable/disable new product notifications
- Enable/disable offer notifications
- Enable/disable restock notifications
- Manage per store or globally

**Benefits:**
- Customer stays updated with favorite stores
- Store owners build loyal customer base
- Increases engagement and repeat purchases
- Store owners can see follower analytics

**CATEGORIES:**

- Show categories created by store owners
- Automatically show new added categories by store owner to the customer in real-time
- Example categories:
  - Sarees
  - Kurtis
  - Dresses
  - Western Wear
  - Ethnic Wear
  - Accessories

**SHOPPING FEATURES:**

- Search
- Filters
- Wishlist (with restock notifications)
- Cart
- Product reviews
- Ratings
- Similar products

**PRODUCT PAGE:**

- Multiple images
- Zoom
- Size selection
- Color selection
- Description
- Related products
- WhatsApp order button (triggers customer details form first)
- Product share button
- "Ask a Question" button
- COD availability status
- Return availability status
- Delivery charge information
- Store address (Google Maps link)
- Stock status display
- Average rating
- Review count

**CUSTOMER INQUIRY/QUESTION SYSTEM:**

Implement product inquiry system separate from orders.

**"Ask a Question" Feature:**

On product page, customer can click "Ask a Question" button.

**Inquiry Form:**

Simple form appears:
- Customer name (auto-fill if logged in)
- Email or phone
- Question text area
- Product details (auto-populated)

**Submit Inquiry:**

When customer submits:
- Inquiry saved in database
- Store owner receives push notification
- Store owner sees inquiry in messaging inbox
- Inquiry appears in customer's "My Inquiries" section

**In-App Chat Between Customer and Store Owner:**

After inquiry submission:
- Customer and store owner can chat in real-time
- Conversation interface (similar to messaging apps)
- Store owner replies from unified messaging inbox
- Customer receives notification when store owner replies
- Customer can view reply in "My Inquiries" section
- Continue conversation if needed

**Inquiry History:**

Customer can view:
- All past inquiries
- Product they asked about
- Store name
- Question and answer
- Timestamp
- Status (pending, answered, resolved)

**FAQ Auto-Suggestion:**

When customer types question:
- Suggest common FAQs related to keywords
- Example: Customer types "delivery" → Show FAQ: "Delivery takes 5-7 days"
- Reduce inquiry volume
- Instant answers for common questions
- Store owners can add custom FAQs

**Notification System:**

Customer gets notified when:
- Store owner replies to their question
- New message in conversation
- Inquiry marked as resolved

**Benefits:**
- Customers get answers before ordering
- Reduces uncertainty and cart abandonment
- Store owners can clarify product details
- Builds trust and customer satisfaction
- Separate from order system for clarity

**REQUEST FOR ORDER:**

Customers can request for:
- Out of stock products (via inquiry system)
- Custom category or product requests

**ORDER PLACEMENT FLOW:**

When customer clicks "Buy Now" or "Order on WhatsApp":

1. Show customer details form
2. Customer fills: name, phone, address
3. Auto-fill for returning customers
4. Submit details
5. Internal order entry is created in database
6. Order status set to "Pending"
7. WhatsApp opens with pre-filled message
8. Customer sends message to store owner
9. Customer can track order in "My Orders" section
10. Store owner receives push notification of new order

**MY ORDERS SECTION:**

Customer can view:
- All their orders/inquiries
- Order status (Pending, Confirmed, Packed, Shipped, Delivered, Cancelled)
- Order details
- Product details
- Store details
- Timestamp
- Real-time status updates
- Download invoice (if order confirmed)

**MY INQUIRIES SECTION:**

Customer can view:
- All product questions asked
- Conversation history with store owners
- Pending inquiries
- Answered inquiries
- Product links

**ORDER TRACKING:**

Customer can track order status in real-time:
- Pending → Waiting for store confirmation
- Confirmed → Store accepted your order
- Packed → Order is packed and ready
- Shipped → Order is on the way
- Delivered → Order delivered successfully
- Cancelled → Order was cancelled

**PERMISSION INTEGRATION:**

- Request notification permission only when user enables order alerts
- Request notification permission when following first store
- Request storage permission only when user wants to download product images or invoices
- Request camera/gallery permission only when user wants to upload review photos

## PHASE 11 → ORDER TRACKING SYSTEM

**FOR CUSTOMERS:**

After placing order request:

- View order in "My Orders" section
- See current order status
- Receive real-time push notifications on status updates
- View order history
- Track: Pending → Confirmed → Packed → Shipped → Delivered
- Download invoice after confirmation
- Share invoice on WhatsApp

**FOR STORE OWNERS:**

Order tracking management in Order Management section:
- View all incoming orders
- See customer details and product details
- Update order status manually
- Track order completion
- View order analytics
- Generate and send invoices
- Send push notification to customer on status update

Status update flow:
- Accept order (Pending → Confirmed) + Generate Invoice
- Mark as packed (Confirmed → Packed)
- Mark as shipped (Packed → Shipped)
- Mark as delivered (Shipped → Delivered)
- Cancel order (Any status → Cancelled)

**FOR SUPER ADMIN:**

Platform-wide order monitoring:
- View all orders from all stores
- Monitor order status across platform
- Track order metrics
- Analyze order trends
- View problematic orders
- Monitor store performance based on orders
- Invoice generation analytics

**REAL-TIME SYNCHRONIZATION:**

All order data and status updates must sync in real-time across:
- Customer app
- Store owner dashboard
- Super admin dashboard

Use Firebase real-time database updates.

**NOTIFICATION SYSTEM:**

When order status changes:
- Customer receives push notification (if enabled)
- Store owner receives notification for new orders
- Super admin receives summary notifications

**NOTIFICATION PERMISSION:**

Request notification permission when user wants to enable order tracking alerts or order updates.

## PHASE 12 → UI/UX REQUIREMENTS

**DESIGN STYLE:**

Premium, Modern, Luxury, Feminine

**REQUIREMENTS:**

- Mobile-first design
- Smooth animations
- Fast loading
- Clean navigation
- Responsive layout
- Optimized for all screen sizes
- Professional messaging interface
- Clean inquiry forms
- Beautiful invoice templates

## PHASE 13 → BACKEND IMPLEMENTATION

**USE FIREBASE ONLY**

Implement:
- Firebase Authentication
- Firestore Database
- Real-time updates for orders, products, categories, messages, inquiries
- Firebase Cloud Messaging for push notifications
- Secure rules

**DATABASE COLLECTIONS:**

Ensure proper structure for:
- Users (customers, store owners, super admins)
- Stores
- Products
- Categories
- Orders/Inquiries
- Reviews
- Notifications
- Messages/Inquiries (customer questions)
- Invoices
- Store Followers
- Quick Reply Templates

## PHASE 14 → IMAGE STORAGE

**USE CLOUDINARY**

Implement:
- Image compression with customization options (50%, 60%, etc.)
- WebP optimization
- Fast CDN delivery

## PHASE 15 → SECURITY

Implement:
- Role-based authentication
- Store isolation (store owners only see their own data)
- Secure API access
- Protected admin routes
- Firebase security rules
- Input validation
- Admin route protection (/admin accessible only to approved Gmail accounts)
- Privacy-focused permission handling
- Secure data transmission
- Order data protection
- Customer data privacy
- Message encryption for inquiries
- Invoice data security

## PHASE 16 → FREE TIER OPTIMIZATION

Because free plans are used:

Optimize for:
- Minimum storage usage
- Lazy loading
- Pagination for orders, products, customers, messages, invoices
- Efficient database reads/writes
- Compressed images
- Cache optimization
- Indexed queries for faster order retrieval
- Notification batching to reduce function calls
- Efficient messaging system queries

## PHASE 17 → SCALABILITY

Design architecture to support:
- 100+ stores
- 100,000+ customers
- Thousands of products
- Thousands of orders per day
- Real-time updates at scale
- Thousands of daily messages/inquiries
- Thousands of push notifications
- Store following at scale

## PHASE 18 → OUTPUT REQUIRED

Provide:

1. Complete architecture
2. Recommended frontend framework for one codebase across all devices
3. Folder structure
4. Firebase database schema (including orders, messages, inquiries, invoices, followers, notifications collections structure)
5. UI screen flow
6. Authentication flow
7. Permission request flow (context-based)
8. Cloudinary integration flow
9. WhatsApp order flow with customer details form
10. Internal order entry system flow
11. Order tracking flow (customer, store owner, super admin)
12. Product sharing flow
13. Store URL system flow
14. Real-time synchronization flow
15. Push notification system flow
16. Low stock alert system flow
17. Invoice generation and delivery flow
18. Customer inquiry/question system flow
19. In-app messaging system flow
20. Quick reply template system flow
21. Store follow/unfollow system flow
22. Follower notification system flow
23. GitHub workflow
24. Deployment strategy from Google AI Studio → GitHub

Make everything production-ready, scalable, modern, beginner-friendly for mobile-based development, privacy-focused, and optimized for real-world multi-store e-commerce operations with professional customer service capabilities.