fbenkhelifa/store-manager

Offline-first desktop store management app for Algerian SMBs (POS, inventory, debt tracking). # Store Manager — Offline Desktop App for Algerian SMBs A commercial-oriented desktop application for local store operations: POS, inventory, and debt tracking with offline reliability. ## What is this Store Manager is an offline-first desktop application tailored for Algerian small and medium businesses. It focuses on day-to-day retail workflows with fast local operations and simple deployment. ## Why it exists Many SMBs need reliable operations without permanent internet access or complex IT infrastructure. This app prioritizes practical usability, local data persistence, and low-friction rollout. ## Key product features - POS workflow for daily transactions - Inventory tracking and stock updates - Debt/customer balance tracking - Bilingual interface orientation (Arabic/French) - Single-executable deployment target (`.exe` packaging) ## Architecture / Stack ```mermaid flowchart LR U[Desktop UI\nCustomTkinter] --> A[Application Logic\nPython] A --> D[(SQLite Local Database)] A --> R[Reporting / Receipts] A --> P[Packaging\nExecutable Build] ``` **Planned stack:** Python, CustomTkinter, SQLite, local packaging. ## Installation ### End-user mode (planned release) 1. Download signed `.exe` package 2. Launch app locally (no internet required) 3. Initialize store profile and begin operations ### Developer mode (documentation-first stage) ```bash git clone github.com cd store-manager ``` ## Usage ### Typical session 1. Login to dashboard 2. Register sale (POS) 3. Inventory decrements automatically 4. Optional debt entry updated per customer profile ### Business context Designed for local shop workflows where offline continuity and simple operation are more important than cloud complexity. ## Project structure ```text store-manager/ ├── README.md ├── .gitignore ├── LICENSE └── docs/ └── PRODUCT_BRIEF.md ``` ## Screenshots / Demo Screenshots and demo GIF will be added in `docs/screenshots/` as UI stabilizati …