eojuma/Business-OS

Business OS is an AI-powered operating system for hardware stores in Africa. Manage inventory, sales, customer credit, and finances through natural language instead of notebooks and spreadsheets. Go/Gin backend, Next.js frontend, modular monolith architecture. # Business OS AI-powered operating system for hardware stores in Africa. Replaces notebooks, spreadsheets, and WhatsApp with a natural-language interface for inventory, sales, customer credit, and financial management. ## Status Milestones 1–3 are done and tested live end to end — not just compiling, actually run against a real Postgres database and a real browser. Signup, products, inventory, sales, customer credit, and daily reports all work through the actual frontend, not just curl. | Module | Backend | Frontend | Status | |---|---|---|---| | `auth` | ✅ | ✅ (login, signup) | Built & tested — register, login, JWT issuing, business-existence validation | | `business` | ✅ | ✅ (via signup) | Built & tested — create (public), get/update (JWT-scoped) | | `products` | ✅ | ✅ | Built & tested — full CRUD, price stored as int64 cents | | `inventory` | ✅ | ✅ | Built & tested — stock levels + movement ledger, atomic via DB transaction | | `sales` | ✅ | ✅ | Built & tested — multi-item sales, decrements stock, supports customer credit, all in one transaction | | `customers` | ✅ | ✅ | Built & tested — profiles, credit limit enforcement, above-balance query | | `reports` | ✅ | ✅ | Built & tested — daily sales aggregated via Postgres `SUM`/`GROUP BY`, not loaded row-by-row | | Dashboard | — | ✅ | Today's sales, low-stock count, calls real endpoints | | `suppliers` | ✅ | — | Profiles, outstanding balances, and payments | | `purchases` | ✅ | — | Draft purchases, goods receipt, stock and supplier debt updates | | `finance` | ✅ | — | Expenses, profit, cash flow, and date-filtered summaries | | `notifications` | ✅ | — | Low-stock notifications with severity and product context | | `analytics` | ✅ | — | Overview, top-profit products, and slow-moving products | | `assistant` | ✅ | ✅ | Natural-language sale preview and explicit confirmation flow | ## Stack - **Backend:** Go, Gin, GORM, PostgreSQL, Redis - **Frontend:** Next.js 14 (App Router), React, Tailwind CSS - **Auth:** JWT - …