omni-pos

byNeo Kgotlaetsho

{ "project_id": "NEO-SYSTEMS-AFRICA-POS-2026", "project_name": "Omni-POS Hybrid Ecosystem", "tagline": "Powered by; Neo Systems Africa!", "architecture": "Modular Micro-Frontend + Go Microservices", "target_platform": "https://www.lovable.dev", "build_instructions": { "mode": "Incremental multi-page SaaS generation", "state_management": "Maintain CHANGELOG.md at root. After each build step, append: Date | Feature | Status (Stable/Pending). Never regenerate completed features. Track Technical Debt separately.", "start_from": "Read CHANGELOG.md first. If missing, create it and begin from Step 1." }, "pages": [ { "order": 1, "name": "Splash Screen", "duration": "2.5s", "animation": "Logo fade-in with 'Neo Systems Africa' pulse", "action": "Check session -> if session exists go to Dashboard else go to Onboarding" }, { "order": 2, "name": "Onboarding", "type": "Slider/Video", "content": [ "Welcome to Omni-POS", "Hybrid Sales + AR Scanning", "AI Assistants: Eliana, Caitlin, Alisha, Florence, Edmund, Neo" ] }, { "order": 3, "name": "AUTH", "methods": ["Biometric", "Phone (OTP)", "Payoneer OAuth"], "security": "FIDO2 for all authentication pages" }, { "order": 4, "name": "Admin Web", "role": "Superuser control", "features": ["User management", "System logs", "Trial overrides", "AI assistant tuning"] }, { "order": 5, "name": "Shop Owner Web", "features": ["Inventory management", "Membership cards", "Sales reports", "Trial analytics"] }, { "order": 6, "name": "Cashier Web", "mode": "Hybrid sales", "features": ["Cart", "Split payment", "M-Pesa STK Push", "Cash/Digital toggle"] }, { "order": 7, "name": "User Mobile", "features": ["AR Scanning (product recognition)", "Cart", "Order history", "Trial status"] } ], "trial_logic": { "type": "3-Day Full Browsing Trial", "restriction": "Payment required only at 'Item Checkout' or 'Trial Expiry'", "price": "P85.00 once-off account opening fee", "flow": "User signs up -> starts 3-day trial -> can browse, add to cart, use AR -> payment triggered at checkout or after day 3" }, "ai_assistants": { "female": [ { "name": "Eliana", "role": "Strategy" }, { "name": "Caitlin", "role": "Tech" }, { "name": "Alisha", "role": "Payments" }, { "name": "Florence", "role": "Support" } ], "male": [ { "name": "Edmund", "role": "Admin" }, { "name": "Neo", "role": "Operations" } ] }, "security_manifest": { "storage_encryption": "AES-256-GCM", "transaction_standard": "PCI-DSS 4.0", "authentication": "FIDO2 (WebAuthn)", "payment_gateways": ["Payoneer", "M-Pesa"] }, "critical_code_snippets": { "split_payment_logic": "function processSplitPayment(cartTotal, cashAmount, digitalMethod) { let remaining = cartTotal - cashAmount; if (remaining > 0) { return initiateDigitalTransaction(digitalMethod, remaining); } return {status: 'SUCCESS', method: 'FULL_CASH'}; }", "mpesa_stk_push": "POST /mpesa/stkpush/v1/process { 'BusinessShortCode': 'NEOPOS', 'Amount': amount, 'PhoneNumber': userPhone, 'CallBackURL': 'https://api.appforcestudio.com/neo/callback' }" }, "changelog_engine": { "file": "CHANGELOG.md", "format": "## [Date] - Feature Name\n- Status: Stable/Pending\n- Notes: ...\n\n### Technical Debt\n- [ ] Unfinished feature 1\n- [ ] Unfinished feature 2", "action": "Before generating any code, read CHANGELOG.md. Only generate features not yet marked Stable. After generating, append entry.", "initial_changelog_content": "# Changelog - Omni-POS Hybrid Ecosystem\n\n## 2026-04-04 - Project Initialization\n- Status: Pending\n- Notes: Configuration loaded. Starting from Splash Screen.\n\n### Technical Debt\n- [ ] None yet\n" }, "backend_microservices": [ { "name": "auth-service", "language": "Go", "features": ["FIDO2", "Phone OTP", "Payoneer OAuth", "Session mgmt"] }, { "name": "trial-service", "language": "Go", "features": ["3-day counter", "Checkout blocker", "P85 fee capture"] }, { "name": "payment-service", "language": "Go", "features": ["Split payment", "M-Pesa STK Push", "Payoneer API"] }, { "name": "inventory-service", "language": "Go", "features": ["Stock", "AR product mapping"] } ], "frontend_frameworks": { "web": "React + Vite (Micro-Frontend modules)", "mobile": "React Native (Expo) for AR + Camera", "admin_dashboard": "React + Tailwind" }, "deployment_notes": { "hosting": "Docker + Kubernetes (optional)", "callback_url_base": "https://api.appforcestudio.com/neo", "env_vars_needed": ["MPESA_CONSUMER_KEY", "MPESA_CONSUMER_SECRET", "PAYONEER_CLIENT_ID", "AES_256_GCM_KEY"] } }