# SmartStore

> SmartStore is multi-store inventory management and GST billing software for retail shops. Each store gets an isolated ledger for stock, suppliers, billing, discounts, returns and profit trends; the platform owner manages every store from one CRM.

## What it does
- Live stock ledger: purchase price, supplier, purchase and stock dates, low-stock alerts, every movement signed by the user who made it.
- GST billing: point-of-sale counter, per-line discounts checked against store rules, printable tax invoices, stock deducted on checkout, bills can be voided with automatic restock.
- Discount engine: store default cap, price-band caps, per-product caps and quantity offers that apply themselves.
- Returns: purchase and issue returns logged with reason, date and supplier; returned units and value shown on the dashboard.
- Profit intelligence: revenue, cost and profit by week, month or year; top sellers; stock movement in vs returned.
- Roles: platform owner (CRM), store owner (admin) and store workers, all through one sign-in.
- Multi-tenant: every record is scoped to its store; suspending a store blocks its logins immediately.

## Pages
- [Home](https://smart-store.duckdns.org/): overview, features, how it works, FAQ.
- [Features](https://smart-store.duckdns.org/#features)
- [How it works](https://smart-store.duckdns.org/#how-it-works)
- [FAQ](https://smart-store.duckdns.org/#faq)

## Technical
- Web application (React + FastAPI + MongoDB). Runs in any modern browser; no install for staff.
- Data model: products, stock entries, bills, returns, issues, users and stores, each carrying a store id.

## Optional
- [Full description](https://smart-store.duckdns.org/llms-full.txt)