P01

stalha2110

Mar 26th, 2026

Never

Not a member of GistPad yet? Sign Up, it unlocks many cool features!

None 95.59 KB | Writing | 0 0

copy raw download clone embed print report

# 🏪 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: [email protected]
- 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

RAW Paste Data Copied

# 🏪 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