# 🏪 ULTIMATE PREMIUM RETAIL BUSINESS MANAGEMENT APP — COMPLETE MERGED PROMPT

---

## ⚠️ CRITICAL DEVELOPMENT RULES (READ FIRST)

```
#REMEMBER:
"Do not start a new project or rewrite big parts.
Only add or minimally change code to implement what I ask.
Keep all existing screens, flows, models, and data working exactly as before.
Do not rename or delete any classes, files, functions, or fields unless I clearly say so.
Modify only the necessary parts and mark them with // NEW or // UPDATED".
```

---

## 📋 MVP vs Future Phases Tagging System

Mark every feature as:
| Tag | Meaning |
|-----|---------|
| **[PHASE 1 - MVP]** | Core features for initial launch |
| **[PHASE 2]** | Important features for 2nd release |
| **[PHASE 3]** | Advanced/Premium features for later |

**Feature Flags / Remote Config Requirement:**
- Implement a remote-config system (Firebase Remote Config).
- Turn individual features ON/OFF per shop without app update.
- Examples: Gamification, CRM, Supplier Module, Advanced AI Features.
- Owner can enable/disable modules from settings.

---

Build a premium, production-ready business management mobile app for a retail store with **1 Owner** and **multiple Staff members**, each using login/signup on separate devices.

Use a **real-time cloud database (Firebase)** with **offline support + auto-sync**.

---

## 🔐 Authentication & Security [PHASE 1 - MVP]

### Owner Signup/Login:
- Email + Password registration.
- Phone number (OTP) login option.
- Biometric login (Fingerprint / Face ID) after first login.
- 4-digit Security PIN as backup login.
- "Forgot Password" with email reset link.

### Staff Signup/Login:
- Owner generates a unique **Staff Invite Code** or **QR Code**.
- Staff joins shop using invite code + creates personal profile.
- Staff profile includes: Name, Photo, Phone, Role Tag (Cashier / Manager / Helper).
- Staff cannot access app until Owner **approves** their join request.

### Session Management:
- Auto logout after inactivity (configurable: 5 / 15 / 30 min / Never).
- Owner can **remotely force logout** any staff device instantly.
- Track all login/logout timestamps with device info.

### Anti-Screenshot Mode (Owner Toggle):
- Prevent staff from taking screenshots of sensitive data (sales, profits, analytics).

### Two-Factor Authentication (2FA): [PHASE 2]
- Optional 2FA for Owner login (extra security layer).

### Panic Mode / Stealth Lock:
- Owner can set a secret PIN that, when entered, hides all sensitive data (profit, analytics, expenses) — useful when showing the phone to others.
- Voice command: "Safety lock" / "Stealth mode on karo" triggers this mode.

---

## 🎨 UI & Layout [PHASE 1 - MVP]

### Theme Options:
- 🔵 **GRADIENT BLUE** — Clean gradient-based professional look.
- 🟤 **CLAYMORPHISM** — Soft 3D clay-style card elements.
- 🔶 **POLYMORPHISM** — Multi-layered depth UI with shadows.
- 🔮 **GLASSMORPHISM** — Frosted glass transparent panels with blur.
- 🌙 **DARK MODE (AMOLED BLACK)** — True black dark theme for OLED screens.
- 🌈 **CUSTOM THEME** — Owner picks primary, secondary, accent colors manually.

*(Each theme must have its own distinct layout structure, card designs, badges, icons, button styles, and premium visuals.)*

### Splash Screen:
- Animated premium splash with shop logo + app branding on launch.

### Onboarding Screens (First Time Only):
- 3–4 swipeable intro screens explaining app features with Lottie animations.
- "Get Started" → Signup/Login.

### Owner Onboarding Wizard [PHASE 1 - MVP]: // NEW
After first login, a 5–10 step wizard:
1. Add basic shop details (Name, Logo, Address, GST).
2. Add key categories and 10–20 top items.
3. Select modules to enable (Udhar, CRM, Suppliers, Gamification).
4. Set up first staff member (optional).
5. Choose theme and language.
6. Quick billing tutorial.

*This prevents overwhelming new users.*

### Contextual Tooltips & "First Time" Guides: // NEW
- On every new screen, show subtle guided tips (coach-marks).
- Explain 6–7 important buttons the first time only.
- "Don't show again" option.
- "Reset tips" option in settings.

### Animations & Transitions:
- Page transitions (slide, fade, scale).
- Button press ripple effects.
- Card expand/collapse animations.
- Pull-to-refresh with custom animation.
- Skeleton loading screens (not just spinners).
- Haptic feedback on key actions (bill save, delete, etc.).

### Floating Action Buttons (FAB):
- Expandable FAB (tap → shows: Add Item, New Bill, Add Customer, Add Expense).

### Header (Top Bar):
- Left: Shop Logo (circular/rounded) + Shop Name (stylized).
- Center: Current screen title.
- Right: Notification Bell (with red badge count) + Overflow Menu (⋮).

### Bottom Navigation (fixed, always visible, 5 tabs):
- 🏠 Dashboard | 🧾 Billing | 📒 Udhar Ledger | 📊 Analytics | ⚙️ Settings
- Active tab: Animated icon + label + accent color highlight.
- Inactive: Muted icon, no label.
- Smooth tab-switch animation.

### Clear Visual Difference Between Modes:
- 🔒 **Staff Mode** — Locked features greyed out with lock icon overlay + "Owner Only" badge.
- 🔓 **Owner Mode** — Full access, all features unlocked, gold/premium badge shown.

### Product Images:
- Shown in item list (grid view + list view toggle).

### Bill Animation:
- Professional, smooth Lottie animation when a bill is generated.
- Examples: receipt printing effect, checkmark burst, confetti for big sales.

### Quick Edit Bill:
- Swipe on recent bill → Edit option.
- Owner can set time limit for edits (e.g., within 30 min / 1 hour / same day).

### Multi-language Support:
- 🇬🇧 ENGLISH
- 🇮🇳 HINGLISH
- 🇮🇳 HINDI (हिंदी)
- 🇮🇳 MARATHI (मराठी)
- Language selector in settings + first-time setup.
- All labels, buttons, messages, notifications, AI responses change accordingly.

### Advanced Localization Infrastructure: // NEW
- All texts via localization files (ARB/JSON).
- Ability to push updated translations without full app update.
- Structure ready for adding more languages later.

### Home Screen Widget: [PHASE 2]
- Small widget: Today's Sale + Today's Profit + Quick Bill button.
- Medium widget: Top 3 selling items + sales graph mini preview.

### Notification Center (In-App):
- Dedicated notification screen (bell icon tap).
- Categories: Stock Alerts, Udhar Reminders, Staff Activity, Payment Received, AI Alerts, System.
- Mark as read / Clear all.

### Quick Actions from App Icon (Long Press):
- New Bill, Search Item, Today's Sales, Open AI Assistant.

### System-Wide Search (Command Palette): // NEW [PHASE 2]
- Global search bar (or voice command).
- Search across: Items, Customers, Udhar, Bills, Settings, Help Articles.
- Keyboard shortcut support (for tablets with keyboards).
- Recent searches history.
- AI-powered fuzzy search.

---

## 🤖 AI Assistant (Left Side — Persistent) [PHASE 1 - MVP]

### Placement & Appearance:
- Persistent floating icon/handle on every screen (left side).
- Tap → Opens AI chat/command panel (slide-in from left).
- Long press (3 seconds) on Dashboard → Opens **Camera for Barcode Billing**.
- Drag handle up/down to reposition.

### AI Visual Design:
- Well-designed, BIG, visually premium AI panel.
- Animated AI avatar/mascot (e.g., friendly robot or shop assistant character).
- Chat-style interface with speech bubbles.
- Microphone button (hold to speak / tap to toggle).
- Text input option for typing commands.

### AI Voice System:
- Communicates through **voice output** (Text-to-Speech with natural voice).
- Supports multiple languages: ENGLISH, HINGLISH, HINDI, MARATHI.
- When user says a language name (e.g., "Hindi"), AI switches to that language.
- Voice speed adjustable (Slow / Normal / Fast).
- Male/Female voice option.

### Central AI Settings Panel (Owner Control): // NEW
One centralized place to control:
- Which AI features are enabled (camera, voice, fraud detection).
- Data used by AI (e.g., allow/not allow customer text analysis).
- Language, tone, and level of automation.
- Voice preferences (speed, gender).
- **Staff cannot change these settings.**

---

### 🎙️ AI Core Capabilities [PHASE 1 - MVP]

#### Voice-Controlled Full App:
Complete app navigation via voice commands:
- "Open Billing" → navigates to Billing tab.
- "Go to Dashboard" → switches to Dashboard.
- "Show Analytics" → opens Analytics.
- "Open Settings" → opens Settings.
- "Search [item name]" → searches item.
- "Open Udhar" → opens Ledger.
- "Show today's sales" → displays today's summary.
- "Show notifications" → opens notification center.

#### Voice Billing (Full Flow):
Create complete bills by speaking:
- "New Bill" → starts fresh bill.
- "Add [Product Name] [Quantity]" → adds item (e.g., "Add Maggi 5").
- "Remove [Product Name]" → removes item from bill.
- "Change quantity of [Product Name] to [number]" → edits quantity.
- "Apply 10% discount" → applies discount.
- "Total kitna hai?" (Hinglish) → AI speaks total amount.
- "Bill save karo" → saves bill.
- "Print karo" → generates PDF/print.
- "Customer name [Name], number [Number]" → adds customer details.
- "Udhar mein daalo" → converts to credit bill.
- "Payment mode cash/online/UPI" → sets payment method.

#### Voice Item Creation:
Add new inventory items entirely via voice:
- "Add new item" → starts item creation.
- "Name: Parle G" → sets name.
- "Price: 10 rupees" → sets price.
- "Stock: 50" → sets quantity.
- "Category: Biscuits" → sets category.
- "GST: 5 percent" → sets tax.
- "Save item" → saves to inventory.

#### AI Camera Billing:
- Take photo of items on counter → AI detects items using image recognition → auto-creates bill.
- Works with common retail products (packaged goods with visible labels).
- If item not recognized: AI asks "Yeh kya item hai?" and lets user confirm/correct.
- Batch scan: Take photo of multiple items at once.

#### AI Camera Stock Count:
- Take photo of shelf → AI counts visible items → compares with inventory records → flags mismatches.

#### Barcode Billing (Long Press AI Button):
- Opens camera in barcode scanning mode.
- Scan product barcode → item auto-added to bill.
- Continuous scan mode: Scan multiple items one after another.
- Beep sound + vibration on successful scan.
- If barcode not in inventory → AI asks "Add new item with this barcode?"

---

### 🎯 Custom Voice Commands / Macros (Owner-Defined) // NEW [PHASE 2]

Owner can define custom shortcuts:

| Voice Command | Action |
|---------------|--------|
| "Evening report" | Opens analytics, reads short summary, shows Udhar due |
| "Check staff today" | Opens staff analytics + attendance |
| "Open shop checklist" / "Dukaan kholne ka checklist chalu karo" | Starts Opening Checklist (shutters, fridges, cash count, cleaning) → Mark tasks done → Save log |
| "Start festival mode [festival name]" / "Festival mode Diwali on karo" | Enable Festival Mode → Load last year's data → Show suggestions |
| "Aaj ka staff report dikhao" | Opens Staff Analytics → Shows presence, bills, revenue, refunds, leaderboard |
| "Udhar follow-ups" / "Aaj kiska udhar vasool karna hai?" | Opens Udhar filtered to "Due today + Overdue" → Reads names + amounts → Offers batch WhatsApp reminders |
| "Supplier summary" / "Supplier ka hisaab batao" | Opens Supplier overview → Shows outstanding dues, pending orders |
| "Big spenders list" / "Is mahine ke top customers dikhao" | Opens Customer Analytics → Filters last 30 days → Shows top customers → Option to send offer |
| "Quiet hours mode" / "DND mode on karo" | Enables DND for non-critical notifications until specified time |
| "Owner away mode" / "Main bahar jaa raha hoon, manager mode on karo" | Elevates chosen staff to delegated rights temporarily |
| "Safety lock" / "Stealth mode on karo" | Triggers Panic/Stealth Lock → Hides sensitive data |
| "Backup now" / "Abhi full backup lo" | Starts immediate full cloud backup → Shows progress → Confirms |
| "Send daily WhatsApp report" / "Aaj ka WhatsApp report bhejo" | Generates summary → Opens WhatsApp with pre-filled report |
| "Training mode for new staff" / "Naye staff ke liye training shuru karo" | Opens Training Center → Starts beginner module |
| "Today's target progress" / "Aaj ka target kitna hua?" | Speaks % achieved, remaining amount, pattern, tips |
| "Reorder essentials" / "Essential items reorder karo" | Filters low stock essentials → Creates purchase order suggestions |
| "Billing speed check" / "Billing speed ka analysis dikhao" | Analyzes avg time per bill per staff → Highlights slow vs fast |

---

### 🧠 AI Deep Analytics & Insights // NEW

#### Top Selling Items:
- "Top selling items this week" → shows ranked list + speaks summary.
- "Sabse zyada kya bikta hai?" → AI responds in chosen language.

#### Low Stock Prediction:
- Predicts which items will go out of stock based on sales velocity.
- Warns 2-3 days before stock finishes.
- "Kal tak kya khatam hoga?" → AI lists items at risk.
- Suggests reorder quantities based on average daily sales.

#### Theft / Loss Detection:
- Monitors: "Stock reduced but no sale recorded."
- Flags possible theft/loss with item name, quantity mismatch, timestamp.
- Weekly theft/loss summary report.

#### Staff Fraud Alert Detection:
AI analyzes patterns:
- Excessive refunds by a single staff member.
- Bills deleted or edited suspiciously.
- Discounts given without authorization.
- Billing during non-shift hours.
- Stock adjustments without sales.

Flags suspicious activity with severity level (Low / Medium / High / Critical).
Owner gets instant push notification for High/Critical alerts.

#### Root Cause Analysis for Sales Drops/Spikes: // NEW [PHASE 2]
- If sales suddenly fall/rise, AI analyzes: weather, day of week, category performance, staff shifts, returns.
- Suggests likely reasons and fixes.

#### Business Health Score & Alerts: // NEW [PHASE 2]
- AI creates simple "Shop Health Score" (0–100).
- Based on: Sales, Profit, Expenses, Udhar, Stock health, Theft risk, Trends.
- Gives tips to improve it.
- Daily/weekly health report.

#### Customer Sentiment Dashboard: // NEW [PHASE 3]
- AI analyzes ratings, feedback messages, Udhar behavior.
- Shows mood trends: "This month, complaints about 'billing speed' increased."
- Suggests improvements.

#### AI Predicts Customer Arrival:
- Predicts busy times / expected customer volume based on historical data.
- "Aaj kitne customers aayenge?" → AI gives estimate.
- Predicts what returning customers are likely to purchase.
- Suggests staffing needs based on predicted traffic.

#### Local Events & Holiday Awareness: // NEW [PHASE 2]
- AI considers local festivals, holidays, sports events (owner inputs calendar).
- Adjusts predictions and suggests special stocking or offers.

---

### 🎓 AI Coaching & Training // NEW

#### AI-Guided Store Opening & Closing Checklists: [PHASE 2]
- Morning/evening, AI walks staff through voice-driven checklist.
- Items: Shutter, cash drawer count, fridge temperature, expiry checks, cleaning.
- Marks items as done with timestamp and staff name.

#### Staff Onboarding Coach: [PHASE 2]
- New staff can use special training mode.
- AI gives guided practice sessions: Billing, Returns, Udhar.
- Quizzes staff and tracks progress.
- Owner sees training completion status per staff.

#### In-App 'How Do I Do This?' Guide: [PHASE 1]
- Staff can ask: "Bill ko Udhar mein kaise daalu?"
- AI replies with step-by-step instructions.
- Can highlight correct buttons/screens.

#### AI Daily Briefing:
- Every morning (configurable time), AI gives voice briefing:
  - Yesterday's summary (sales, profit, top items).
  - Today's predictions (expected sales, busy hours).
  - Low stock warnings.
  - Udhar reminders due today.
  - Staff schedule for today.
  - Any pending actions.

#### Midday Performance Nudges: // NEW [PHASE 2]
- At configurable times, AI gives quick progress updates.
- "By 2 PM, you've achieved 40% of today's target. Evening usually brings 60%—consider pushing cold drinks."

#### AI Goal Coach:
- Tracks daily/weekly/monthly goals.
- Motivational messages when ahead of target.
- Suggestions when falling behind.
- "Aaj ka target complete hoga?" → AI predicts based on current pace.

#### Owner Stress & Time Management Coach: // NEW [PHASE 3]
- Based on late-night usage, frequent manual work, pending tasks.
- Suggests delegation ideas, simplifying routines, using more automation.

---

### 📈 AI Marketing & Growth // NEW

#### AI Festival Preparation Mode:
Activate for upcoming festivals (Diwali, Holi, Eid, Christmas, Navratri, etc.):
- AI suggests which items to stock more (based on last year's festival data).
- Expected demand increase percentage.
- Recommended discounts to attract customers.
- Festival-specific product bundles.
- Predicted revenue for festival period.

#### Social Media Post Assistant: // NEW [PHASE 2]
- AI drafts promotional posts for WhatsApp Status / Instagram / Facebook.
- In chosen language.
- Short, medium, and long versions.
- With hashtags and call-to-action.

#### AI WhatsApp Message Generator:
AI generates professional WhatsApp messages for:
- Udhar reminders (polite, firm, or final warning tone).
- Festival greetings to customers.
- New product announcements.
- Special offer notifications.
- Thank you messages after purchase.

#### AI Customer Service Phrases:
- Suggests phrases for staff to use with customers.
- "Customer ko kya bolu?" → AI gives polite responses for common situations:
  - Out of stock items.
  - Price negotiations.
  - Return/refund requests.
  - Loyalty point explanations.

#### AI Business Tips:
- Daily business tip notification (retail-specific).
- Tips on: Display arrangement, upselling, cross-selling, customer retention.
- "Mujhe ek business tip do" → AI provides actionable tip.

#### What-If Pricing Simulator: // NEW [PHASE 3]
- Owner asks: "If I increase Maggi price by ₹2, what happens?"
- AI predicts change in sales volume, profit, risk of losing customers.

#### AI Smart Pricing:
Suggests optimal pricing based on:
- Competitor awareness (manual input of competitor prices).
- Demand patterns.
- Profit margin targets.
- Slow-moving items (suggests markdowns).
- "Yeh item ki price sahi hai?" → AI analyzes and suggests.

---

### ⚡ AI Automation & Workflows // NEW

#### AI Shop Brain (Memory System):
AI remembers EVERYTHING about the shop:
- Which item sells more on which day of the week.
- Seasonal trends (winter vs summer products).
- Customer purchase patterns and preferences.
- Price change history and impact on sales.
- Peak business hours.
- Weather-based sales patterns.

Ask anything: "Monday ko sabse zyada kya bikta hai?" → AI answers from memory.

#### AI Task Automation Suggestions: // NEW [PHASE 2]
- AI notices repetitive manual actions (e.g., sending same summary every night).
- Offers: "Do you want me to automate this as a daily 9 PM WhatsApp summary?"

#### Owner Voice Notes → Action Items: // NEW [PHASE 2]
- Owner speaks: "Reminder: increase cold drink prices next week and talk to Pepsi supplier."
- AI converts to tasks with dates and categories.
- Links to relevant items/suppliers.

#### AI-Guided Physical Stock Take: // NEW [PHASE 2]
- During stock audit, AI guides item by item (voice).
- "Now count Parle G 50g."
- Staff reads counts, AI auto-compares with system.
- Flags discrepancies live.

#### Supplier Negotiation Helper: // NEW [PHASE 3]
- Before calling a supplier, AI prepares talking points:
  - Average orders
  - Payment history
  - Competitor prices (if entered)
  - Suggested target price/credit terms

#### AI Profit Optimizer:
Analyzes all products and suggests:
- Which items to push more (high margin).
- Which items are losing money (low margin / high waste).
- Bundle suggestions for better profits.
- "Profit kaise badhau?" → AI gives specific action plan.

#### AI Expiry Tracker:
- For perishable goods: Track expiry dates.
- AI warns before items expire.
- Suggests discounting near-expiry items.
- "Kya expire hone wala hai?" → AI lists items.

#### Multi-Language Translator for Customer Talks: // NEW [PHASE 2]
- Staff speaks in Hindi; AI instantly shows same phrase in English/Marathi.
- Helps with tourists or out-of-state customers.

#### Fine-Tuning to Owner Preferences: // NEW [PHASE 3]
- AI learns from owner's repeated corrections.
- Preferred profit margins, discount style, customer tone.
- Over time, all suggestions align with those preferences.

---

### 🔊 AI Voice Responses (Trained Keywords):

AI is trained with ALL business-related keywords and phrases:

| Category | Keywords |
|----------|----------|
| **Billing** | bill, receipt, invoice, total, amount, subtotal, grand total, payment, cash, online, UPI, card, change, balance |
| **Inventory** | stock, item, product, quantity, piece, packet, box, carton, dozen, kg, gram, liter, add, remove, update, edit, delete |
| **Financial** | profit, loss, revenue, expense, margin, cost, sale, purchase, earning, income, payment, due, credit, debit |
| **Customer** | customer, buyer, regular, new, loyal, contact, number, name, address |
| **Operations** | open, close, start, stop, show, hide, search, find, create, make, save, print, share, send, cancel, reset, undo, redo |
| **Analytics** | report, graph, chart, analysis, trend, comparison, daily, weekly, monthly, yearly, today, yesterday, this week, this month |
| **Hindi/Hinglish** | "kitna", "dikhao", "banao", "nikalo", "jodna", "hatao", "bachao", "bhejo", "bolo", "batao", "khareedna", "bechna" |
| **Marathi** | "किती", "दाखवा", "बनवा", "काढा", "जोडा", "पाठवा", "सांगा" |

---

## 🏠 Dashboard [PHASE 1 - MVP]

### Welcome Banner:
- "Good Morning/Afternoon/Evening, [Owner/Staff Name]" with animated greeting.
- Shows current date, time, day.
- Weather indicator (optional, location-based).

### Quick Stats Cards (Animated counters):
- 💰 Today's Sale (total revenue).
- 📈 Today's Profit (Sales − Cost − Expenses).
- 🧾 Bills Created Today (count).
- 👥 Customers Served Today.
- 📦 Items in Stock (total count).
- ⚠️ Low Stock Items (count with red badge).
- 📒 Pending Udhar (total amount).

### Daily Goal Tracker:
- Set daily sales/profit goals.
- Visual circular progress bar showing current progress.
- Color changes: Red (0-30%) → Yellow (30-70%) → Green (70-100%) → Gold animation (100%+).
- AI motivational messages based on progress.

### Mini Sales Graph:
- Last 7 days sales trend (sparkline chart).
- Tap to expand to full analytics.

### Inventory Section:
- Toggle: Grid View (cards with images) / List View (compact rows).
- Each item shows: Image, Name, Category, Price (MRP + Selling), Stock quantity, Low stock badge.
- Add / Edit / Remove items.
- GST & Discount fields per item.
- Category tags with color coding.
- Sort by: Name, Price (High/Low), Stock (High/Low), Category, Recently Added, Most Sold.
- Filter by: Category, Price Range, Stock Status, GST Slab.

### Multiple Barcodes / Aliases per Item: // NEW [PHASE 2]
- Allow multiple barcodes for the same product.
- Different packaging, supplier codes all resolve to correct inventory item.
- "Alias" names for searching (e.g., "Maggi" and "Noodles").

### Search Bar (Prominent):
- Text search with auto-suggestions.
- Voice search button (microphone icon).
- Barcode scan button.
- Recent searches history.
- AI Smart Search: Fuzzy search finds items even with misspellings.

### Low Stock Section:
- Dedicated section/card showing items below threshold.
- Red/Orange highlight.
- AI predictions integrated ("Will run out in ~2 days").
- Quick restock button (update quantity directly).

### Recent Activity Feed:
- Last 5-10 activities (bills, stock updates, new customers).
- Scrollable, with timestamps and actor (who did it).

### Quick Action Buttons:
- New Bill, Add Item, Add Expense, Scan Barcode.

---

## 🧾 Billing Module [PHASE 1 - MVP]

### Fast Billing Interface:
- Item search: Text + Voice + Barcode Scan.
- Recently billed items (quick-add chips at top).
- Frequently billed items section.
- Manual item input (for items not in inventory): Name, Price, Qty.
- Quantity adjuster: − / + buttons with manual number input.
- Real-time running total displayed prominently.

### Customer Section (Top of Bill):
- Optional customer name field.
- WhatsApp number with +91 prefix (auto-formatted).
- Auto-suggest existing customers as you type.
- "New Customer" badge for first-time buyers.
- Loyalty points display (if customer is registered).

### Bill Items List:
- Each item row: Image (small), Name, Qty, Rate, GST, Discount, Subtotal.
- Swipe left to remove item.
- Tap to edit quantity/discount.
- Drag to reorder (optional).

### Tax & Discount:
- GST per item (auto-calculated based on item settings).
- GST on total bill (configurable).
- Discount per item OR per bill (percentage or flat amount).
- "MRP vs Selling Price" support.
- Tax breakdown display (CGST + SGST or IGST).

### Payment Mode Selector:
- 💵 Cash
- 📱 UPI / Online
- 💳 Card
- 🔄 Split Payment (part cash + part online) with amount splitter.
- 📒 Udhar (Credit) — auto-redirects to Udhar module.

### Return / Refund Toggle:
- Switch bill to "Return Mode."
- Select items being returned.
- Refund amount auto-calculated.
- Inventory auto-restocked.
- Profit auto-adjusted.
- Refund method: Cash Back / Store Credit / Adjustment in next bill.
- Reason for return (dropdown: Defective, Wrong Item, Customer Changed Mind, Expired, Other).

### Action Buttons:
- ✅ **Paid & Save:**
  - Save bill to database.
  - Tag staff ID (who created the bill).
  - Auto-save customer name & WhatsApp number.
  - Auto-update inventory (reduce stock).
  - Auto-update analytics.
  - Bill completion animation plays.
  - Success sound effect.

- 🖨️ **Print & Share:**
  - Generate professional receipt with:
    - Shop logo, name, address, GST number.
    - Bill number (auto-generated sequential).
    - Date & Time.
    - Items with details.
    - Tax breakdown.
    - Total amount.
    - Payment mode.
    - QR code for digital payment.
    - "Thank You" message (customizable).
    - Loyalty points earned.
  - Share via: WhatsApp, PDF download, Bluetooth Thermal Printer, Email.
  - Receipt templates: Classic, Modern, Minimal (owner can choose).

- 🔄 **Reset:**
  - Clear current bill form.
  - Confirmation popup: "Are you sure?"
  - Auto-save draft before clearing (recoverable).

- 📋 **Save as Draft:**
  - Save incomplete bill for later completion.
  - Draft bills visible in a separate section.
  - Resume billing from draft.

### Bill History (Sub-section):
- All bills listed with: Bill #, Date, Time, Customer, Amount, Staff, Payment Mode.
- Search bills by: Customer name, bill number, date range, amount range.
- Filter by: Payment mode, Staff member, Refund/Sale.
- Quick Edit: Tap on recent bill → Edit (within time limit set by owner).
- Duplicate Bill: Copy items from previous bill to create new one.

### Lock-Screen Billing: [PHASE 3]
- Quick bill creation from lock screen or notification quick tile.
- Simplified interface for fast billing.
- Requires PIN/biometric to access.

### Customer Loyalty Points System: [PHASE 2]
- Configurable: Points per ₹ spent (e.g., 1 point per ₹100).
- Track points per customer.
- Redeem points on future bills (configurable: ₹ value per point).
- Point expiry (optional: after 6 months / 1 year / never).
- Tier system (optional): Bronze → Silver → Gold → Platinum based on total spend.
- Tier benefits: Extra points multiplier, special discounts.

### Bill Animation:
- On bill save: Smooth animation (receipt flying into folder / checkmark burst / confetti for bills above ₹X).
- Sound effect (cash register "cha-ching" or subtle chime — toggle on/off).

### Auto Date & Time:
- Each bill auto-saves accurate date, time, timezone.
- Cannot be manually changed by staff (only owner can edit timestamp in special cases).

### Detect Received Online Payment (via SMS): [PHASE 2]
- App reads payment SMS (UPI/Bank) with user permission.
- Detects successful incoming payments (amount, sender, UPI ID).
- Shows green confirmation badge in notification bar.
- Auto-links payment to current/recent bill where amount matches.
- Notification: "₹500 received from [Name] — Link to Bill #1234?"

### Held Bills / Parked Bills:
- While billing, if customer says "wait" or needs to get something:
- Park current bill → Start new bill → Come back to parked bill later.
- Multiple bills can be parked simultaneously.
- Visual indicator showing number of parked bills.

### Bill Narration / Notes:
- Add custom notes to any bill (e.g., "Customer will pick up tomorrow", "Birthday order").
- Notes visible in bill history.

### Combo / Bundle Billing: [PHASE 2]
- Create product bundles (e.g., "Festival Pack" = Item A + B + C at special price).
- Bundles appear as single item in billing.
- Auto-applies bundle discount.

---

## 💳 Payment Reconciliation Dashboard // NEW [PHASE 2]

### Auto-Match Payments:
- Auto-match online/UPI/card settlements against bills (beyond SMS detection).
- Import bank statements (CSV/Excel) for reconciliation.

### Dashboard View:
- Total payments received today/week/month.
- Matched payments (green).
- Unmatched payments (yellow) — need manual linking.
- Partial settlements (orange).
- Reconciliation status overview.

### Manual Linking:
- Tap unmatched payment → Select bill to link.
- Search bills by amount, date, customer.

### Settlement Reports:
- Payment gateway-wise breakdown.
- Bank-wise breakdown.
- Daily/weekly settlement summary.
- Export for accounting.

---

## 📒 Udhar Ledger (Credit Module) [PHASE 1 - MVP]

### Credit Billing Interface:
- Same as main billing interface for creating credit bills.
- Mandatory: Customer Name + Phone Number.
- Optional: Customer Photo, Address, Aadhaar/ID (for high-value credits).

### Udhar Dashboard:
- Total Udhar Outstanding (big number, red accent).
- Total Customers with Dues.
- Overdue amount (past promise date).
- Today's collections expected.
- This week/month credit given vs collected.

### Customer Udhar Profile:
- Customer photo / avatar.
- Name, Phone, WhatsApp number.
- **Total Due** (prominently displayed).
- **Credit Score / Trust Rating** (AI-calculated): ⭐⭐⭐⭐⭐
- Credit Limit (owner-set maximum Udhar allowed per customer).
- All Udhar bills listed (date, amount, items, status).
- Payment history (when they paid, how much).
- Copy phone number button.

### Paid Now vs Remaining:
- During Udhar bill: Enter amount paid now.
- Auto-calculates remaining balance.
- Partial payment tracking.

### Promise Date:
- Calendar-based date picker for expected repayment.
- Color coding: Green (future), Yellow (today), Red (overdue).
- Snooze/Extend promise date with reason.

### Action Buttons per Customer:
- ✅ **Paid** button:
  - Full payment → clears all dues.
  - Partial payment → enter amount → updates remaining.
  - Payment mode selection (Cash / Online / Adjustment).
  - Auto-updates analytics.

- 📲 **Remind** button:
  - Auto-generates WhatsApp reminder message with:
    - Customer name, total due, bill details, promise date.
    - Tone selector: Polite / Firm / Final Warning.
    - AI-generated message in selected language.
  - Opens WhatsApp with pre-filled message.

- 📞 **Call** button:
  - Direct call to customer.

- 🚫 **Block Credit** button:
  - Block further Udhar for this customer.
  - Staff sees warning when trying to create Udhar bill for blocked customer.

### Udhar Reminders & Notifications:
- Promise date due today → Push notification + in-app badge + AI voice alert.
- Overdue (past promise date) → Escalated notification daily.
- Auto-reminder: Send WhatsApp reminder on promise date morning (configurable).
- Weekly Udhar summary notification to owner.

### Udhar Analytics:
- Top debtors (highest amount due).
- Longest overdue customers.
- Monthly credit given vs collected trends.
- Bad debt prediction (AI identifies customers unlikely to pay).

### Udhar Interest Calculator (Optional): [PHASE 3]
- Owner can enable interest on overdue Udhar.
- Configurable interest rate.
- Auto-calculates accumulated interest.
- Displayed separately in customer profile.

### Customer Group / Category:
- Group customers: Regular, VIP, Risky, Blacklisted.
- Different credit limits per group.
- Visual badges on customer profiles.

---

## 🌐 Public Digital Catalog / Rate List // NEW [PHASE 2]

### Auto-Generated Catalog:
- Shareable catalog link generated from inventory.
- Updates in real-time when inventory changes.

### Catalog Features:
- Search functionality.
- Category filters.
- Product images.
- Prices (MRP and selling price).
- Stock availability indicator (In Stock / Limited / Out of Stock).
- Shop branding (logo, name, contact).

### Sharing Options:
- Shareable URL link.
- QR Code generation (print for shop display).
- WhatsApp share button.
- Embed code for website.

### Customization (Owner):
- Choose which items to show/hide.
- Choose which categories to include.
- Hide prices (show "Call for price").
- Custom banner/message at top.
- Theme matching shop branding.

### Customer View:
- Mobile-optimized web page.
- No app download required.
- Can browse prices from home.
- WhatsApp inquiry button per item.

---

## 📊 Analytics & Reports [PHASE 1 - MVP]

### Overview Cards:
- Total Inventory Value (at cost price).
- Total Sales (day / week / month / year / custom range).
- Total Profit (day / week / month / year / custom range).
- Total Expenses.
- Net Profit (Profit − Expenses).
- Growth percentage compared to previous period.

### Interactive Charts & Graphs:
- 📈 **Sales vs Profit Graph** (daily/weekly/monthly) — Line chart with gradient fill.
- 📊 **Category-wise Sales** (pie chart / donut chart).
- 📉 **Sales Trend** (sparkline for quick view, expandable).
- 📊 **Hourly Sales Heatmap** (which hours are busiest).
- 📊 **Day-of-Week Performance** (which day sells most).
- 📊 **Month-over-Month Comparison** (bar chart).
- 📊 **Year-over-Year Growth** (line chart).

All graphs: Animated on load, smooth transitions when changing date range, tap on data point shows exact values.

### Date Range Selector:
- Today, Yesterday, This Week, Last Week, This Month, Last Month, This Year, Custom Range.
- Compare two periods side by side.

### Top 10 Selling Items:
- Ranked list with quantity sold, revenue generated, profit contributed.
- Date range filterable.
- Visual bar chart.

### Bottom 10 Items (Slow Moving):
- Items with lowest sales.
- AI suggests: Discount, remove from inventory, or rearrange display.

### Profit Margin Analysis:
- Per item profit margin.
- Overall average margin.
- Items with highest and lowest margins.

### Expense Tracking:
- Add expenses with: Category, Amount, Date, Notes, Receipt photo.
- Categories: Rent, Electricity, Salary, Transport, Purchase, Maintenance, Marketing, Other.
- Monthly expense breakdown (category-wise).
- Expense vs Revenue comparison.

### Staff-wise Analytics:
- Bills created per staff member.
- Revenue generated per staff.
- Profit contribution per staff.
- Refunds processed per staff.
- Average bill value per staff.
- Staff leaderboard (ranked by configurable metric).
- Leaderboard badge: 🥇🥈🥉 for top 3.

### Staff Attendance:
- Daily attendance marking (Check-in / Check-out with timestamp).
- Attendance method: Manual / Location-based / QR scan at shop.
- Late arrivals tracking.
- Monthly attendance summary.
- Connect attendance with bills: Show bills made per shift.
- Salary calculation helper (based on attendance + working hours).

### Customer Analytics:
- Total unique customers.
- New vs returning customers.
- Top 10 customers by spend.
- Customer visit frequency.
- Average bill value per customer.
- Customer retention rate.

### Smart Holiday Mode: [PHASE 2]
- AI predicts low/high sales days (festivals, holidays, weekends, local events).
- Visual calendar with color-coded predictions.
- Suggestions for holiday-specific inventory.

### Inventory Analytics:
- Stock turnover rate per item.
- Dead stock identification (items not sold in X days).
- Inventory aging report.
- Reorder suggestions with quantities.

### Live Screen View (Owner Only): [PHASE 3]
- Owner can view staff's billing screen in real-time remotely.
- Thumbnail view of all active staff screens.
- Tap to expand full screen view.
- View-only (owner cannot interact).
- Indicator on staff device: "Owner is viewing" (optional toggle).

### Activity Log (Audit Trail):
- Complete log of who did what, when:
  - Item additions / edits / deletions.
  - Bill creation / edits / refunds / deletions.
  - Udhar additions / payments / edits.
  - Settings changes.
  - Login / logout events.
  - Inventory adjustments.
  - Price changes.
  - Staff additions / removals.
- Filter by: User, Action Type, Date Range.
- Cannot be deleted (even by owner — integrity guarantee).

### Report Export:
- Export reports as: PDF, Excel (CSV), image.
- Auto-email daily/weekly/monthly report to owner (configurable).
- Share reports via WhatsApp.

### Comparison Mode:
- Compare any two periods side by side:
  - This Diwali vs Last Diwali.
  - This month vs Same month last year.
  - Staff A vs Staff B performance.

---

## 💼 Daily Cash Count & Reconciliation Module // NEW [PHASE 2]

### Shift Close Cash Count:
- At shift end, staff enters physical cash count.
- System shows expected cash (based on cash bills - cash refunds).
- Auto-calculates difference.

### Difference Handling:
- If difference exists:
  - Staff must enter reason (dropdown: Counting error, Change given wrong, Theft suspected, Other).
  - Optional: Photo proof.
  - Notes field.

### Cash Count History:
- Daily cash count log.
- Difference trend over time.
- Staff-wise cash handling accuracy.

### Alerts:
- Repeated differences by same staff → Flag for owner.
- Large differences → Immediate notification.

---

## 👥 Owner-Staff Management (Dedicated Section) // NEW [PHASE 1/2]

### 💬 In-App Owner–Staff Chat & Broadcasts: [PHASE 2]

#### 1:1 Chat:
- Secure chat between owner and individual staff.
- Text messages.
- Photo sharing.
- Voice notes.
- Message timestamps.

#### Group Chat:
- Owner can create group with all/selected staff.
- Group announcements.

#### Broadcasts:
- Owner sends broadcast announcements.
- Topics: Policy changes, offers, targets, schedule changes.
- Read receipts per staff (who has seen the message).
- Pin important messages.

### 📅 Staff Leave & Off-Day Management: [PHASE 2]

#### Staff Side:
- Request leave from app.
- Select dates (single day / range).
- Leave type: Sick, Personal, Emergency, Festival, Other.
- Add reason/notes.
- See request status: Pending / Approved / Rejected.

#### Owner Side:
- View all leave requests.
- Approve / Reject with optional notes.
- Monthly leave calendar per staff.
- Leave balance tracking (if applicable).
- Auto-update shift schedules on approval.

### 🚨 Staff Incident & Issue Reporting: [PHASE 2]

#### Staff Can Report:
- Abusive customer (with details).
- Product issue (damage, quality).
- Device/equipment issue.
- Safety concern.
- Other incidents.

#### Report Includes:
- Category selection.
- Description text.
- Photo attachments.
- Timestamp (auto).
- Urgency level.

#### Owner View:
- Categorized incident log.
- Filter by: Staff, Category, Date, Urgency.
- Mark as: Reviewed / In Progress / Resolved.
- Add response/action taken.

### ✅ Escalation & Approval Workflows: [PHASE 2]

For risky actions, staff must get owner approval:
- Refund above ₹X amount.
- Discount above X%.
- Delete bill.
- Edit old bill.
- Manual stock adjustment.
- Credit above limit to customer.

#### Workflow:
1. Staff initiates action → System shows "Requires Owner Approval".
2. Staff adds reason/notes.
3. Push notification sent to owner.
4. Owner reviews in app → Approve / Deny with notes.
5. Staff gets notification of decision.
6. If approved, action is executed.
7. Full audit trail maintained.

### ⏰ Break & Idle Time Tracking: [PHASE 2]

#### Staff Side:
- Simple Start/End break buttons.
- Break types: Lunch, Tea, Personal, Prayer.
- Timer shows break duration.

#### Owner View:
- Total break time per staff per day.
- Idle gaps (time when no billing activity AND not on break).
- Break time vs billing activity correlation.
- Alerts for excessive breaks.

### 📱 Staff Device Management & Trusted Devices: [PHASE 2]

#### Owner Can See:
- Which devices each staff account is logged into.
- Device info: Model, OS, last active time.
- Login history per device.

#### Actions:
- Mark device as "Trusted" (no re-verification needed).
- Revoke device access (force logout).
- Require re-verification on new devices.
- Set max devices per staff account.

#### Security:
- New device login → Owner notification.
- Untrusted device → Limited features until verified.

### 👑 Owner Delegation Mode (Acting Manager): [PHASE 2]

#### Setup:
- Owner selects trusted staff member.
- Sets delegation period (start date/time to end date/time).
- Selects powers to grant:
  - ☐ Approve refunds
  - ☐ View analytics
  - ☐ View profit
  - ☐ Manage shifts
  - ☐ Approve leave requests
  - ☐ Add/edit inventory
  - ☐ View Udhar details
  - ☐ Send broadcast messages

#### During Delegation:
- Staff sees "Acting Manager" badge.
- Access to granted features.
- All actions logged with "Acting Manager" tag.

#### Auto-Expiry:
- Delegation automatically ends at set time.
- Owner can revoke early.
- Notification to both parties.

### 💡 Anonymous Staff Feedback / Suggestion Box: [PHASE 2]

#### Staff Can Submit:
- Anonymous suggestions.
- Anonymous complaints.
- Process improvement ideas.
- Morale/culture feedback.

#### Features:
- Truly anonymous (no way to trace back).
- Categories: Process, Equipment, Schedule, Colleagues, Management, Other.
- Owner sees aggregated feedback.
- Cannot see who submitted what.

#### Owner Actions:
- Mark as: Noted / Will Consider / Implemented / Not Feasible.
- Post public response (staff see response without knowing who asked).

### 📊 Per-Staff KPI Dashboard (Mini View for Staff): [PHASE 1]

Each staff member sees their own key numbers:
- Today's bills created.
- Today's revenue generated.
- Average bill value.
- Refunds processed.
- Current leaderboard rank.
- Week/Month performance trend.
- Streak (consecutive days with bills).
- Badges earned.

**Note:** Does NOT show full shop profit or sensitive owner data.
*Motivates self-improvement without exposing full business details.*

---

## ✅ Staff Task Management & Checklists // NEW [PHASE 2]

### Task Creation (Owner):
- Create daily/weekly tasks.
- Examples: "Clean shelves", "Update prices", "Check expiry", "Arrange display".
- Set frequency: Daily, Weekly, One-time.
- Set due time.
- Assign to specific staff or "Any available".
- Priority: Low, Medium, High.
- Add instructions/notes.
- Require photo proof on completion.

### Task View (Staff):
- See assigned tasks.
- Filter: Today, This Week, Pending, Completed.
- Check off completed tasks.
- Upload photo proof (if required).
- Add completion notes.
- Mark as "Need Help" if stuck.

### AI Reminders:
- AI reminds staff of pending tasks.
- Voice: "You have 2 pending tasks for today."
- Push notifications before due time.

### Task Dashboard (Owner):
- Overview of all tasks.
- Completion rate by staff.
- Overdue tasks highlighted.
- Task history and patterns.

---

## ⚙️ Settings (Tabbed — 5 Tabs) [PHASE 1 - MVP]

### Tab 1: 🏪 Shop Identity
- Shop Name (editable).
- Shop Logo (upload / crop / resize).
- Shop Address.
- Shop Phone & WhatsApp Number.
- GST Number (GSTIN).
- Shop QR Code upload (for payments) with + button to update.
- Theme Selector (visual preview of each theme).
- Live preview before applying.
- Font Size (Small / Medium / Large — for accessibility).
- Bill Header/Footer customization.

### Tab 2: 💾 Data & Backup
- **History View:** All transactions, inventory changes, login history, activity log.
- **Reset History** (Owner only): Selective reset with PIN confirmation.
- **One-Tap Full Shop Backup:** Backup all data to cloud. Auto-backup options.
- **One-Tap Shop Transfer:** Transfer entire shop data to new phone.
- **Export Data:** Export all data as Excel/CSV.
- **Import Data:** Import inventory from Excel/CSV file.

### Sandbox / Test Mode for Owners: // NEW [PHASE 3]
- Separate "Test Space" where owner can:
  - Try price changes, discounts, AI suggestions.
  - Test staff permissions.
  - Practice features.
- Without impacting real data and analytics.
- Clear "TEST MODE" banner.

### Tab 3: ⚡ Operations
- **Inventory Settings:** Low stock threshold, auto-reorder alerts, product images, category management, unit management, barcode settings.
- **Multiple Barcodes per Item:** // NEW — Enable scanning multiple barcodes for same item.
- **Billing Settings:** Bill number prefix/sequence, default tax, discount permissions, refund permissions, max edit time, receipt template, sound effects, held bills, quick billing items.
- **Loyalty Points Settings:** Enable/disable, points per ₹, redemption value, expiry, tiers.
- **Share Item List:** Export inventory as PDF/Excel/WhatsApp.
- **Daily WhatsApp Summary:** Enable/disable, time to send, contents.
- **Auto Price Update Reminder:** Remind every X days.
- **Printer Settings:** Bluetooth connection, paper size, test print, auto-print.

### Tab 4: 👤 Staff Management
- **Staff List:** All staff with photo, name, role, status, join date.
- **Add Staff:** Generate invite code/QR, set role.
- **Staff Permissions (Granular):**
  - ☐ Create Bills
  - ☐ Edit Bills
  - ☐ Delete Bills
  - ☐ Process Refunds
  - ☐ Apply Discounts
  - ☐ View Profit/Analytics
  - ☐ Add/Edit Inventory
  - ☐ Delete Inventory Items
  - ☐ View Udhar
  - ☐ Create Udhar
  - ☐ Mark Udhar Paid
  - ☐ View Activity Log
  - ☐ Access Settings
  - ☐ Export Data
- **Remove Staff:** Deactivate or permanently remove.
- **Staff Performance:** Quick view of each staff's KPIs.
- **Shift Management:** Define and assign shifts, track adherence.

### Tab 5: ❓ Help & Support
- **Help Center:** Searchable FAQs, feature tutorials, video guides.
- **Contact Support:** WhatsApp, Email, Phone, In-app feedback.
- **Report a Bug:** With automatic device info.
- **Feature Request:** Suggest new features.
- **Demo Mode:** Demo login with sample data.
- **App Info:** Version, Terms, Privacy Policy, Licenses.
- **Rate the App:** Link to store rating.
- **What's New:** Changelog.

### Language Selection:
- 🇬🇧 ENGLISH | 🇮🇳 HINGLISH | 🇮🇳 HINDI | 🇮🇳 MARATHI
- Changes ALL app text, labels, notifications, AI responses.

---

## 🔔 Automation & Notifications System [PHASE 1 - MVP]

### Push Notifications:
- 📦 Low stock alert.
- 📒 Udhar promise date due.
- 💰 Online payment received.
- 🧾 Daily sales summary.
- 🕵️ Theft/Loss detection alert.
- 👤 Staff fraud alert.
- 🎯 Daily goal achieved.
- 📊 Weekly business report ready.
- 💡 AI business tip.
- 🎉 Festival preparation reminder.
- 📅 Auto price update reminder.
- 👤 New staff join request.
- 🔐 Login from new device alert.
- 📦 Item expiry warning.
- 🏆 Staff leaderboard updates.
- ✅ Approval request (for escalations). // NEW

### In-App Notification Center:
- All notifications in one place.
- Categorized tabs: All, Stock, Billing, Udhar, Staff, AI, System.
- Read/Unread status.
- Tap notification → Navigate to relevant screen.

### Smart Notifications:
- DND mode (quiet hours).
- Priority levels: Critical (always alert), Important (normal), Info (silent).
- Notification sound customization.

### Automated Actions:
- Low stock → Auto-generate reorder list.
- Udhar overdue → Auto-send WhatsApp reminder.
- Daily summary → Auto-send to owner WhatsApp.
- Bill saved → Auto-reduce inventory.
- Refund → Auto-restock + adjust profit.
- Online payment detected → Auto-link to bill.
- Offline → Show banner, queue changes.
- Back online → Show sync status.

### Scheduled Reports:
- Daily report: End of day.
- Weekly report: Monday morning.
- Monthly report: 1st of month.
- Delivery: Push + WhatsApp + Email (configurable).

---

## 💰 Expense Manager [PHASE 1 - MVP]

### Add Expense:
- Amount, Category, Date, Payment mode, Notes, Receipt photo.
- Categories: Rent, Electricity, Water, Salary, Transport, Purchase, Maintenance, Marketing, Packaging, Miscellaneous, Custom.
- Recurring expense toggle (daily / weekly / monthly).

### Expense Dashboard:
- Total expenses by period.
- Category-wise breakdown (pie chart).
- Monthly trend (bar chart).
- Budget vs Actual comparison.
- True net profit: Revenue - COGS - Expenses.

### Budget Setting: [PHASE 2]
- Set monthly budget per category.
- Alert at 80% and 100% utilization.
- Visual budget bar per category.

### Recurring Expenses:
- Auto-add on schedule.
- Reminder before due date.

---

## 📦 Supplier / Vendor Management [PHASE 2]

### Supplier Profiles:
- Name, Company, Phone, WhatsApp, Email, Address.
- Items supplied (linked to inventory).
- Payment terms.
- Rating (owner rates suppliers).

### Purchase Orders:
- Create purchase orders for suppliers.
- Track status: Ordered → Shipped → Received.
- Auto-update inventory on "Received."
- Purchase history per supplier.

### Supplier Payment Tracking:
- Track payments made.
- Outstanding dues to suppliers.
- Payment reminders.

### Quick Reorder:
- From low stock alert → Tap "Reorder" → Auto-generates order.
- Send order via WhatsApp to supplier.

---

## 👥 Customer Relationship Management (CRM) [PHASE 2]

### Customer Database:
- Auto-saved from bills.
- Manual add with: Name, Phone, WhatsApp, Email, Address, Birthday, Anniversary, Notes.
- Customer photo (optional).
- Tags: Regular, VIP, Wholesale, Retail, Risky.

### Customer Profile View:
- Total spend (lifetime).
- Total bills.
- Last visit date.
- Favorite items (most purchased).
- Loyalty points balance.
- Udhar status.
- Visit frequency.
- AI-predicted next visit.

### Customer Communication:
- WhatsApp message (individual or bulk).
- Birthday/Anniversary auto-greetings.
- Festival greetings.
- New product announcements.
- Special offer notifications.

### Customer Segmentation:
- AI auto-segments: Loyal, At-Risk, Lost, New.
- Target specific segments with messages/offers.

---

## 🔄 Offline-First Architecture [PHASE 1 - MVP]

### Full Offline Operation:
- Create bills offline.
- Add/edit inventory offline.
- Create Udhar entries offline.
- Add expenses offline.
- All data saved to local database (SQLite / Hive).

### Auto-Sync:
- Internet restored → automatic background sync.
- Conflict resolution: Last-write-wins with owner override.
- Sync status indicator: 🟢 Synced | 🟡 Syncing... | 🔴 Offline.

### Offline Indicators:
- Top banner: "📡 No internet. Bills will sync automatically."
- Pending items show "⏳ Pending sync" badge.
- On reconnect: "✅ Back online! All data synced."

---

## 📱 Responsive Design & Performance [PHASE 1 - MVP]

### Screen Compatibility:
- All screen sizes: 5" to 10"+.
- Adaptive layouts.
- Landscape mode support for tablets.

### Performance:
- App opens in under 2 seconds.
- Smooth 60fps animations.
- Lazy loading for long lists.
- Image compression.
- Cache management.
- Memory-efficient for low-end devices.

### Accessibility:
- Font size options.
- High contrast mode.
- Screen reader compatible.
- Touch targets minimum 48x48dp.

---

## 🛡️ Data Security & Privacy [PHASE 1 - MVP]

### Data Encryption:
- All data encrypted in transit (HTTPS/SSL).
- Sensitive data encrypted at rest.
- Firebase security rules.

### Privacy:
- SMS permission only for payment detection.
- Camera permission only for barcode/AI.
- Microphone permission only for voice commands.
- No third-party data sharing.
- GDPR-aware handling.

### Data Ownership:
- Owner owns all data.
- Owner can export anytime.
- Owner can delete permanently.
- Staff removal doesn't delete historical data.

---

## 🎮 Gamification & Engagement [PHASE 2]

### Staff Gamification:
- Daily/Weekly/Monthly challenges.
- XP (experience points) system.
- Level badges: Beginner → Pro → Expert → Master Seller.
- Leaderboard with animated rankings.
- Owner can set prizes.

### Owner Achievements:
- Milestone badges.
- Monthly progress report cards.

### Daily Streaks:
- Consecutive days with bills.
- Special badges for 30-day, 100-day, 365-day streaks.

---

## 🌐 Multi-Store Support (Future-Ready) [PHASE 3]

### Architecture Ready For:
- Multiple store locations.
- Switch between stores.
- Combined analytics.
- Staff assigned per store.
- Inventory transfer between stores.

*(Can be locked as "Coming Soon" for initial release.)*

---

## 🧪 Demo Mode [PHASE 1 - MVP]

### Demo Login:
- Email: demo@shopapp.com
- Password: demo1234

### Pre-filled Data:
- 50+ sample products with images.
- 30+ sample bills.
- 10+ sample customers with Udhar.
- Sample expenses.
- Sample staff members.
- 3 months of analytics data.

### Demo Features:
- Banner: "🟡 DEMO MODE — Data will not be saved permanently."
- All features fully functional.
- "Exit Demo" → Redirects to real signup.

---

## 📱 Android Runtime Permission System [PHASE 1 - MVP]

### Permissions Required:
- 📷 Camera (barcode, AI camera billing).
- 📱 SMS (payment detection).
- 🎤 Microphone (voice commands).
- 🔔 Notifications (push alerts).

### Permission Flow:
1. **Pre-permission explanation screen:**
   - Clear explanation of why permission is needed.
   - What feature requires it.
   - Privacy assurance.

2. **Request Options:**
   - Allow
   - Deny
   - Don't ask again

3. **If Denied:**
   - Show which features won't work.
   - Retry button.
   - "Open Settings" option for manual enable.

4. **Permission Manager Class:**
   - Clean, modular code.
   - Check permission status.
   - Request permission.
   - Handle results.
   - Guide to settings if permanently denied.

5. **UI Requirements:**
   - Premium, friendly UI.
   - Icons representing each permission.
   - Not intrusive or scary.

6. **Compatibility:**
   - Latest Android versions (Android 13+).
   - Backward compatible to Android 8.

---

## 🚀 Deployment & Technical Stack

- **Frontend:** Flutter (cross-platform — Android + iOS).
- **Backend:** Firebase (Firestore + Auth + Storage + Cloud Functions + Cloud Messaging + Remote Config).
- **Local DB:** Hive or SQLite (offline-first).
- **AI/ML:** TensorFlow Lite (on-device) + Cloud AI APIs.
- **Voice:** Google Speech-to-Text + Text-to-Speech APIs.
- **Notifications:** Firebase Cloud Messaging (FCM).
- **Payments Detection:** SMS Read API.
- **Printing:** ESC/POS Bluetooth thermal printer library.
- **Charts:** fl_chart or syncfusion_flutter_charts.
- **Animations:** Lottie + Flutter animations + Rive.
- **State Management:** Riverpod or BLoC.
- **Image Recognition:** Google ML Kit / TensorFlow Lite.
- **Barcode:** Google ML Kit Barcode Scanning.
- **Remote Config:** Firebase Remote Config (feature flags).
- **Localization:** Flutter intl / ARB files.

---

## ✅ FINAL GOAL & RULES

### Goal:
Build a **professional, fast, production-ready, owner-controlled retail business management app** with:

- ✅ Strong real-time analytics and reporting.
- ✅ Powerful, fully functional AI assistant (voice + camera + intelligence).
- ✅ Complete staff tracking, permissions, attendance & fraud detection.
- ✅ Comprehensive owner-staff management (chat, leave, escalations, delegation).
- ✅ WhatsApp automation (reminders, summaries, receipts, greetings).
- ✅ Voice and camera-based billing (barcode + AI image detection).
- ✅ Premium, modern multi-theme UI with smooth animations.
- ✅ Robust offline-first architecture with seamless sync.
- ✅ Complete financial management (sales, profit, expenses, Udhar).
- ✅ Customer CRM with loyalty system.
- ✅ Supplier management.
- ✅ Public digital catalog for customers.
- ✅ Payment reconciliation dashboard.
- ✅ Staff task management & checklists.
- ✅ Gamification for staff engagement.
- ✅ Multi-language support (English, Hinglish, Hindi, Marathi).
- ✅ Bank-level security and data privacy.
- ✅ Feature flags for gradual rollout.
- ✅ Phased development approach (MVP → Phase 2 → Phase 3).

---

### DEVELOPMENT RULES:

1. **Every button & feature must be FULLY WORKING** (not dummy/placeholder).

2. **AI must be FULLY FUNCTIONAL** with real voice input/output, real camera detection, real predictions.

3. **Train AI with ALL business keywords**, phrases, and commands in all 4 languages.

4. **Show animations & effects** while tapping, closing, opening, at EACH interaction.

5. **Provide demo login** with rich sample data to test everything.

6. **App must work OFFLINE FIRST** — never lose data.

7. **All timestamps must be AUTO-GENERATED** (date, time, timezone).

8. **Bottom navigation must ALWAYS be visible**.

9. **App must be FAST** — no lag, no jank, smooth 60fps.

10. **Code must be CLEAN, MODULAR, WELL-COMMENTED** and production-ready.

11. **Add YOUR OWN CREATIVE IDEAS** wherever you see fit.

12. **AI should work externally** — add real AI integration, not mock responses.

13. **Mark code changes with // NEW or // UPDATED** comments.

14. **Do not start a new project or rewrite big parts** — only add/modify necessary code.

15. **Keep all existing screens, flows, models, and data working exactly as before**.

16. **Do not rename or delete any classes, files, functions, or fields** unless clearly instructed.

17. **Follow MVP vs Phase tagging** — don't build everything at once.

18. **Implement feature flags** for gradual feature rollout per shop.

---

## 📋 PHASE SUMMARY

### PHASE 1 - MVP (Launch First):
- Authentication & Security (basic)
- UI & Layout (all themes)
- Owner Onboarding Wizard
- Dashboard
- Billing Module (core features)
- Udhar Ledger
- Basic Analytics
- Settings (all 5 tabs)
- Expense Manager (basic)
- Notifications (core)
- Offline-First Architecture
- AI Assistant (core voice commands, billing, navigation)
- Staff KPI Mini Dashboard
- Demo Mode
- Android Permissions System

### PHASE 2 (Second Release):
- 2FA Authentication
- Home Screen Widgets
- System-Wide Search
- AI Advanced Features (coaching, marketing, automation)
- Payment Reconciliation Dashboard
- Public Digital Catalog
- Owner-Staff Management (chat, leave, incidents, escalations, breaks, devices, delegation, feedback)
- Staff Task Management
- Customer Loyalty Points
- Combo/Bundle Billing
- SMS Payment Detection
- Cash Count & Reconciliation
- Multiple Barcodes per Item
- Smart Holiday Mode
- Supplier Management
- CRM
- Budget Setting
- Gamification
- Local Events Awareness
- Contextual Tooltips

### PHASE 3 (Advanced/Premium):
- Lock-Screen Billing
- Udhar Interest Calculator
- Live Screen View
- What-If Pricing Simulator
- Supplier Negotiation Helper
- Customer Sentiment Dashboard
- Owner Stress Coach
- AI Fine-Tuning to Owner Preferences
- Sandbox/Test Mode
- Multi-Store Support

---

**END OF MERGED PROMPT**