# 🏪 ULTIMATE PREMIUM RETAIL BUSINESS MANAGEMENT APP — FULL PROMPT

---

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

- **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):**
  - 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.

-

## 🎨 UI & Layout

- Premium, modern design with **multiple 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.
- Smooth **transitions & animations** across the entire app:
  - 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)** for quick-add actions:
  - 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 (e.g., 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** across app + AI:
  - 🇬🇧 ENGLISH
  - 🇮🇳 HINGLISH
  - 🇮🇳 HINDI
  - 🇮🇳 MARATHI
  - Language selector in settings + first-time setup.
  - All labels, buttons, messages, notifications, AI responses change accordingly.
- **Home Screen Widget:**
  - Small widget showing Today's Sale + Today's Profit + Quick Bill button.
  - Medium widget showing 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.

---

## 🤖 AI Assistant (Left Side — Persistent)

- Place an AI assistant on the **left side** of the UI:
  - Persistent floating icon/handle on every screen.
  - 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 Appearance:**
  - 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 for ALL subsequent responses, commands, and app UI.
  - Voice speed adjustable (Slow / Normal / Fast).
  - Male/Female voice option.

### AI Capabilities (FULLY FUNCTIONAL — Not Dummy):

**🎙️ 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 to bill (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 with detected items.
- 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 on Dashboard):**
- Opens camera in barcode scanning mode.
- Scan product barcode → item auto-added to bill.
- Continuous scan mode: Scan multiple items one after another without closing camera.
- Beep sound + vibration on successful scan.
- If barcode not in inventory → AI asks "Add new item with this barcode?"

**📈 Top Selling Items:**
- AI can show and speak about top-selling items for chosen periods.
- "Top selling items this week" → shows ranked list + speaks summary.
- "Sabse zyada kya bikta hai?" → AI responds in chosen language.

**📉 Low Stock Prediction:**
- AI predicts which items will go out of stock soon 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:**
- AI continuously monitors: "Stock reduced but no sale recorded."
- Flags possible theft/loss with item name, quantity mismatch, and 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.

**🎉 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.

**🧠 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 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.

**🏷️ 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 Daily Briefing:**
- Every morning (configurable time), AI gives a 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.

**🗣️ AI Customer Service Phrases:**
- AI 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.

**🔍 AI Smart Search:**
- Fuzzy search: Even misspelled or partial names find correct items.
- "Woh blue wala packet" → AI tries to identify from description.
- Category-based voice search: "Sabun dikhao" → shows all soaps.

**📱 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 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.

**🎯 AI Goal Coach:**
- AI 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.

**🔊 AI Voice Responses (Trained Keywords):**
AI is trained with ALL business-related keywords and phrases:
- 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

- **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.

- **Search Bar (Prominent):**
  - Text search with auto-suggestions.
  - Voice search button (microphone icon).
  - Barcode scan button.
  - Recent searches history.

- **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

- **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:**
  - Quick bill creation from lock screen or notification quick tile.
  - Simplified interface for fast billing.
  - Requires PIN/biometric to access.

- **Customer Loyalty Points System:**
  - 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):**
  - 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:**
  - 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.

---

## 📒 Udhar Ledger (Credit Module)

- **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 based on payment history): ⭐⭐⭐⭐⭐
  - 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 based on history).

- **Udhar Interest Calculator (Optional):**
  - 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.

---

## 📊 Analytics & Reports

- **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 (Highly Designed):**
  - 📈 **Sales vs Profit Graph** (daily/weekly/monthly).
    - Line chart with gradient fill.
    - Tap on data point → shows exact values.
  - 📊 **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.

- **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 (Rent, Electricity, Salary, Transport, Purchase, Maintenance, Marketing, Other).
    - Amount, Date, Notes, Receipt photo (optional).
  - 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: Sales / Profit / Bills).
  - 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:**
  - 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):**
  - 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 with staff screen).
  - Indicator on staff device: "Owner is viewing" (optional — owner can toggle visibility).

- **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.

---

## ⚙️ Settings (Tabbed — 5 Tabs)

### 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):
  - Gradient Blue, Claymorphism, Polymorphism, Glassmorphism, Dark Mode, Custom.
  - Live preview before applying.
- Font Size (Small / Medium / Large — for accessibility).
- Bill Header/Footer customization (custom text like "Thank You! Visit Again!").

### Tab 2: 💾 Data & Backup
- **History View:**
  - All transactions, inventory changes, login history, activity log.
  - Searchable and filterable.
- **Reset History** (Owner only):
  - Selective reset: Bills only / Inventory only / Udhar only / Everything.
  - Requires PIN confirmation.
  - Creates backup before reset automatically.
- **One-Tap Full Shop Backup:**
  - Backup all data to cloud (Firebase).
  - Shows backup size and last backup timestamp.
  - Auto-backup: Daily / Weekly / Manual only.
- **One-Tap Shop Transfer:**
  - Transfer entire shop data to new phone in 1 click.
  - Generates transfer code → Enter on new device → Full restore.
- **Export Data:**
  - Export all data as Excel/CSV for accounting.
  - Export customer list, inventory list, bill history separately.
- **Import Data:**
  - Import inventory from Excel/CSV file.
  - Bulk add items.

### Tab 3: ⚡ Operations
- **Inventory Settings:**
  - Low stock threshold (global default + per item override).
  - Auto-reorder alerts.
  - Enable/disable product images.
  - Category management (add/edit/delete categories with colors/icons).
  - Unit management (Piece, Kg, Gram, Liter, ML, Box, Carton, Dozen, Meter).
  - Barcode settings (auto-generate or manual entry).
- **Billing Settings:**
  - Bill number prefix (e.g., "SHOP-0001").
  - Bill number sequence (auto-increment).
  - Default tax slab.
  - Discount permissions for staff (allow/deny).
  - Refund permissions for staff.
  - Maximum bill edit time.
  - Receipt template selection.
  - Enable/disable bill sound effects.
  - Held bills (enable/disable).
  - Quick billing items (pin frequently sold items).
- **Loyalty Points Settings:**
  - Enable / Disable.
  - Points per ₹ spent.
  - Redemption value per point.
  - Point expiry period.
  - Tier system settings.
- **Share Item List:**
  - Export inventory as PDF / Excel / WhatsApp message.
  - Generate shareable catalog with images and prices.
- **Daily WhatsApp Summary:**
  - Enable / Disable.
  - Time to send (e.g., 9 PM daily).
  - Summary includes: Sales, Profit, Expenses, Staff performance, Low stock, Udhar reminders.
  - Send to: Owner's WhatsApp (configurable number).
- **Auto Price Update Reminder:**
  - Remind to review prices every X days (30/60/90 days).
  - Shows items not updated since longest time.
- **Printer Settings:**
  - Bluetooth printer connection.
  - Printer paper size (58mm / 80mm).
  - Test print.
  - Auto-print on bill save (enable/disable).

### Tab 4: 👤 Staff Management
- **Staff List:**
  - All staff members with: Photo, Name, Role, Status (Active/Inactive), Join Date.
- **Add Staff:**
  - Generate invite code / QR code.
  - Set role: Cashier / Manager / Helper / Custom.
- **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.
  - All data created by staff remains in system.
- **Staff Performance:**
  - Quick view of each staff's KPIs.
- **Shift Management:**
  - Define shifts (Morning / Evening / Night / Custom).
  - Assign staff to shifts.
  - Track shift adherence.

### Tab 5: ❓ Help & Support
- **Help Center:**
  - Searchable FAQs.
  - Feature tutorials (step-by-step with screenshots/GIFs).
  - Video guides (embedded or linked).
- **Contact Support:**
  - WhatsApp support chat.
  - Email support.
  - Phone support.
  - In-app feedback form.
- **Report a Bug:**
  - Bug report with automatic device info, app version, screenshot attachment.
- **Feature Request:**
  - Suggest new features.
- **Demo Mode:**
  - Demo login credentials for testing.
  - Pre-filled sample data (items, bills, customers, analytics).
  - Banner: "DEMO MODE — Data will not be saved."
- **App Info:**
  - Version number.
  - Terms & Conditions.
  - Privacy Policy.
  - Open source licenses.
- **Rate the App:**
  - Link to Play Store / App Store rating.
- **What's New:**
  - Changelog showing recent updates and new features.

### Language Selection (Accessible from Settings + First Setup):
- 🇬🇧 ENGLISH
- 🇮🇳 HINGLISH
- 🇮🇳 HINDI (हिंदी)
- 🇮🇳 MARATHI (मराठी)
- Changes ALL app text, labels, notifications, AI responses.
- Confirmation: "Change language to Hindi? App will restart."

---

## 🔔 Automation & Notifications System

- **Push Notifications:**
  - 📦 Low stock alert (item name + remaining qty).
  - 📒 Udhar promise date due today (customer name + amount).
  - 💰 Online payment received (amount + sender).
  - 🧾 Daily sales summary (evening).
  - 🕵️ Theft/Loss detection alert.
  - 👤 Staff fraud alert (severity-based).
  - 🎯 Daily goal achieved celebration.
  - 📊 Weekly business report ready.
  - 💡 AI business tip of the day.
  - 🎉 Festival preparation reminder.
  - 📅 Auto price update reminder.
  - 👤 New staff join request.
  - 🔐 Login from new device alert.
  - 📦 Item expiry warning.
  - 🏆 Staff leaderboard updates.

- **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 — no notifications between set times).
  - 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 (if enabled).
  - Daily summary → Auto-send to owner WhatsApp.
  - Bill saved → Auto-reduce inventory.
  - Refund processed → Auto-restock inventory + adjust profit.
  - Online payment detected → Auto-link to bill.
  - Offline → Show "No internet. Bills will sync automatically." banner.
  - Back online → Show "Back online! Syncing..." → "All synced ✓"

- **Scheduled Reports:**
  - Daily report: Auto-generated at end of day.
  - Weekly report: Every Monday morning.
  - Monthly report: 1st of every month.
  - Delivered via: Push notification + WhatsApp + Email (configurable).

---

## 💰 Expense Manager (Dedicated Sub-Module)

- **Add Expense:**
  - Amount.
  - Category: Rent, Electricity, Water, Salary, Transport/Delivery, Purchase/Restock, Maintenance/Repairs, Marketing/Advertising, Packaging, Miscellaneous, Custom categories.
  - Date (auto or manual).
  - Payment mode (Cash / Online / Card).
  - Notes.
  - Receipt photo (camera capture or gallery upload).
  - Recurring expense toggle (daily / weekly / monthly).

- **Expense Dashboard:**
  - Total expenses today / this week / this month / this year.
  - Category-wise breakdown (pie chart).
  - Monthly expense trend (bar chart).
  - Budget vs Actual comparison.
  - "Profit = Revenue - COGS - Expenses" → true net profit.

- **Budget Setting:**
  - Set monthly budget per category.
  - Alert when approaching budget limit (80%, 100%).
  - Visual: Budget utilization bar per category.

- **Recurring Expenses:**
  - Auto-add recurring expenses (e.g., rent on 1st of every month).
  - Reminder before due date.

---

## 📦 Supplier / Vendor Management

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

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

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

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

---

## 👥 Customer Relationship Management (CRM)

- **Customer Database:**
  - Auto-saved from bills (name + phone).
  - 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 (WhatsApp).
  - Festival greetings to all/selected customers.
  - New product announcements.
  - Special offer notifications.

- **Customer Segmentation:**
  - AI auto-segments: Loyal, At-Risk (haven't visited in X days), Lost (no visit in 30+ days), New.
  - Target specific segments with messages/offers.

---

## 🔄 Offline-First Architecture

- **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:**
  - When internet is restored → automatic background sync.
  - Conflict resolution: Last-write-wins with owner override.
  - Sync status indicator:
    - 🟢 Synced.
    - 🟡 Syncing...
    - 🔴 Offline (X items pending sync).

- **Offline Indicators:**
  - Top banner: "📡 No internet. Bills will sync automatically."
  - Each pending item shows "⏳ Pending sync" badge.
  - On reconnect: "✅ Back online! All data synced."

---

## 📱 Responsive Design & Performance

- **Screen Compatibility:**
  - Works on all screen sizes: Small phones (5") to large phones (6.7") to tablets (10"+).
  - Adaptive layouts: Single column on phone, two-column on tablet.
  - Landscape mode support for tablets (billing becomes more spacious).

- **Performance:**
  - App opens in under 2 seconds.
  - Smooth 60fps animations.
  - Lazy loading for long lists (pagination).
  - Image compression for product images.
  - Cache management for fast repeated access.
  - Memory-efficient for low-end Android devices.

- **Accessibility:**
  - Font size options (Small / Medium / Large / Extra Large).
  - High contrast mode.
  - Screen reader compatible labels.
  - Touch target sizes minimum 48x48dp.

---

## 🛡️ Data Security & Privacy

- **Data Encryption:**
  - All data encrypted in transit (HTTPS/SSL).
  - Sensitive data encrypted at rest (PIN, passwords).
  - Firebase security rules: Staff can only access their shop's data.

- **Privacy:**
  - SMS reading permission only for payment detection (clearly explained to user).
  - Camera permission only for barcode/AI camera features.
  - Microphone permission only for voice commands.
  - No data shared with third parties.
  - GDPR-aware data handling.

- **Data Ownership:**
  - Owner owns all data.
  - Owner can export all data anytime.
  - Owner can delete all data permanently.
  - Staff removal doesn't delete historical data (bills, activity logs remain).

---

## 🎮 Gamification & Engagement

- **Staff Gamification:**
  - Daily/Weekly/Monthly challenges:
    - "Sell 50 bills today" → Badge unlock.
    - "Highest single bill" → Trophy.
    - "Zero refunds this week" → Star.
  - Staff XP (experience points) system.
  - Level up badges: Beginner → Pro → Expert → Master Seller.
  - Leaderboard with animated rankings.
  - Owner can set prizes for top performers.

- **Owner Achievements:**
  - Milestone badges: First 100 bills, ₹1 Lakh sales, 1 Year on app, etc.
  - Monthly progress report cards.

- **Daily Streaks:**
  - Consecutive days with bills → streak counter.
  - Special badge for 30-day, 100-day, 365-day streaks.

---

## 🌐 Multi-Store Support (Future-Ready)

- **Architecture Ready for:**
  - Multiple store locations under one owner.
  - Switch between stores.
  - Combined analytics across stores.
  - Staff assigned per store.
  - Inventory transfer between stores.
  *(Can be locked as "Coming Soon" feature for initial release.)*

---

## 🧪 Demo Mode

- **Demo Login:**
  - Email: demo@shopapp.com
  - Password: demo1234
  - Pre-filled data:
    - 50+ sample products with images.
    - 30+ sample bills (various dates).
    - 10+ sample customers with Udhar.
    - Sample expenses.
    - Sample staff members.
    - 3 months of analytics data.
  - Banner on every screen: "🟡 DEMO MODE — Data will not be saved permanently."
  - All features fully functional in demo.
  - "Exit Demo" button → Redirects to real signup.

---

## 🚀 Deployment & Technical Stack

- **Frontend:** Flutter (cross-platform — Android + iOS).
- **Backend:** Firebase (Firestore + Auth + Storage + Cloud Functions + Cloud Messaging).
- **Local DB:** Hive or SQLite (offline-first).
- **AI/ML:** TensorFlow Lite (on-device for camera AI) + Cloud AI APIs for advanced features.
- **Voice:** Google Speech-to-Text + Text-to-Speech APIs (multi-language).
- **Notifications:** Firebase Cloud Messaging (FCM).
- **Payments Detection:** SMS Read API (with permissions).
- **Printing:** ESC/POS Bluetooth thermal printer library.
- **Charts:** fl_chart or syncfusion_flutter_charts.
- **Animations:** Lottie + Flutter built-in animations + Rive.
- **State Management:** Riverpod or BLoC.
- **Image Recognition:** Google ML Kit / TensorFlow Lite models.
- **Barcode:** Google ML Kit Barcode Scanning.

---

## ✅ 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.
- ✅ 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.
- ✅ Gamification for staff engagement.
- ✅ Multi-language support (English, Hinglish, Hindi, Marathi).
- ✅ Bank-level security and data privacy.

**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. The 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 to enhance the app further.
12. The AI should work externally — add real AI integration, not mock responses.

---

Android Runtime Permission System with:

- Camera, sms, microphone, Notification permission
• Pre-permission explanation screen
• Allow, Deny, Retry, Open Settings option
• Premium UI
• Latest Android compatible
• Clean Permission Manager class
• Production ready code