# GInvoice Market OS (AI Knowledge File)
> Offline-First Point of Sale (POS), Inventory & Debtor Records for Nigerian & African Merchants.

## Overview
GInvoice Market OS is an offline-first Point of Sale (POS), inventory management, and digital invoicing Progressive Web Application (PWA) built specifically for merchants, retail shops, and service businesses across Nigeria and emerging markets. It enables merchants to record counter sales and issue receipts on their phone even during internet outages, syncing automatically to secure cloud storage when connectivity returns.

- **Official Website**: https://ginvoice.com.ng
- **Full Machine-Readable Specification**: https://ginvoice.com.ng/llms-full.txt
- **Target Audience**: Retail shops, provision stores, supermarkets, boutiques, footwear retailers, phone repair technicians, and wholesalers.
- **Pricing**: Free Starter Plan (₦0/month) | Pro Merchant Plan (₦2,000/month base + checkout processing fee). 30-day Pro trial included with registration. No card required to start.

## Core Capabilities & Real System Boundaries
1. **Offline Sales & Idempotent Sync**:
   - Supported offline: Counter sales, local receipt printing/sharing, inventory lookups, and debtor ledger updates.
   - Requires internet: Account registration, initial data setup, cloud backup, customer online storefront orders, and gBot AI queries.
   - Resilient sync: Offline sales buffer safely in IndexedDB and reconcile idempotently via `/api/sync` without duplicate records.
2. **Pricing & Usage Quotas**:
   - Free Starter (₦0/month): Up to 50 sales/month, 150 inventory items, 30 AI queries/month, offline sales, and WhatsApp receipts.
   - Pro Merchant (₦2,000/month base): Unlimited sales, unlimited inventory, multi-staff access, and 500 AI queries/day fair-use limit. Applicable checkout processing fee (e.g. ₦132 Paystack processing fee) is clearly displayed prior to payment.
   - 30-day Pro trial automatically granted to every new merchant. Free plan available indefinitely afterwards.
3. **Physical Products & Service Repair Workflows**:
   - Retail & Provisions: Pack and carton-to-unit breakdown (e.g. 1 carton = 24 tins), low-stock alerts, barcode camera scanning.
   - Services & Repairs: Infinite stock mode (never blocked by false out-of-stock errors), spare parts cost logging, and multi-tier repair pricing (e.g. charging port replacement vs partition fix).
4. **Debtor Ledgers & Receivables**:
   - Record customer deposits, outstanding balances, and debtor payment history with full ledger audit trails.
5. **Free Public Online Storefront**:
   - Every merchant receives a public storefront URL (`ginvoice.com.ng/store/:slug`). Customers place orders without installing an app. Stock is never deducted when a storefront order is created; stock is only deducted when the merchant accepts the order.
6. **Financial Precision**:
   - Built with exact arbitrary-precision arithmetic (`decimal.js`) to prevent IEEE-754 floating-point rounding errors on kobo and currency calculations.
7. **gBot Merchant AI Assistant**:
   - Conversational business queries ("How much did we sell today?", "Which items are running low?"), voice shortcuts, and sales analysis powered by cloud AI.

## Supported Business Categories
- **Provisions & Supermarkets**: Fast barcode scanning, carton/pack/single conversions, low-stock notifications.
- **Fashion & Boutiques**: Named apparel and shoe inventory, WhatsApp receipts, and public storefront link for social bios.
- **Phone Technicians & Electronics Repair**: Multi-tier service options, spare parts cost logging, service job tracking.
- **Wholesalers & Distributors**: Customer credit ledger tracking, debtor reminders, bulk CSV catalog imports.

## Links & Endpoints
- [Full Specification & Feature Matrix](https://ginvoice.com.ng/llms-full.txt)
- [Public Web App](https://ginvoice.com.ng)
- [Terms of Service](https://ginvoice.com.ng/terms.html)
- [Privacy Policy](https://ginvoice.com.ng/privacy.html)