🚀 StoreOS

Multi-Tenant Inventory, Sales & Restaurant Management Platform

StoreOS is a full-featured SaaS platform designed for small and medium businesses that need a modern, scalable system to manage inventory, sales, suppliers, payments. It supports multiple companies (multi-tenant architecture), allowing each business to operate independently within the same system.

This project demonstrates professional-level Django development, including modular architecture, REST APIs, role-based access control, and production-ready configuration.

---

🧠 Key Features

🔐 Multi-Tenant Architecture

• Each company has isolated data (products, users, sales, suppliers, etc.).
• Centralized administration while maintaining strict data separation.

📦 Inventory Management

• Categories, items, bulk imports (Excel), low-stock alerts.
• Stock movements, item logs, purchase receptions.

💰 Sales & Checkout Module

• Cart system, checkout flow, payment handling.
• Daily summaries and cash register tracking.

📄 Account & Finance Tools

• Current accounts, supplier management, pending payments.
• Customer tracking and activity history.

🧰 Internal Utilities

• PDF generation, device detection, custom admin extensions, internal wiki for customers.

---

🖼️ Screenshots

---

🛠️ Tech Stack

Backend

• Django (core framework)
• Django REST Framework (API)
• MySQL
• JWT Authentication (SimpleJWT)

Utilities & Libraries

• django-cors-headers
• django-ckeditor
• django-widget-tweaks
• django-extensions
• django-user-agents
• xhtml2pdf
• pandas, pillow
• whitenoise
• gunicorn

---

🏗️ Architecture Overview

StoreOS (SaaS)
│
├── Multi-Tenant Core
│   ├── Company model
│   ├── Company-aware middleware
│   └── Tenant data isolation
│
├── Modules
│   ├── Inventory
│   ├── Sales / Checkout
│   ├── Restaurant
│   ├── Suppliers & Payments
│   ├── Receptions
│   ├── Users & Roles
│   └── Internal Tools (PDF, logs, cyber control)
│
└── API Layer (DRF)
    ├── Auth (JWT)
    ├── CRUD endpoints per module
    └── Pagination / filtering utilities

---

📥 Installation

1. Clone the Repository

git clone https://github.com/GastonLevy/StoreOS
cd StoreOS

2. Create a Virtual Environment

python -m venv venv
source venv/bin/activate      # Linux/macOS
venv\Scripts\activate         # Windows

3. Install Dependencies

pip install -r requirements.txt

4. Configure Environment Variables

SECRET_KEY="your_secret_key"
DEBUG=True
DATABASE_URL="mysql://user:password@localhost/storeos"

5. Apply Migrations & Run

python manage.py migrate
python manage.py runserver

Access at: http://127.0.0.1:8000/

---

📂 Project Structure

StoreOS/
├── accounts/          # Authentication, roles, profiles
├── cash_register/     # Cash management & daily reports
├── checkout/          # Sales workflow & payments
├── cyber_control/     # Device usage tracking module
├── excel_import/      # Bulk import tools
├── inventory/         # Item, categories, stock logs
├── landing_page/      # Public-facing landing page
├── receptions/        # Goods reception workflow
├── self_logs/         # Internal logs
├── self_wiki/         # Customer documentation
├── storeos/           # Core config (settings, urls)
└── users/             # User accounts & permissions

---

🔒 License

StoreOS was built as proprietary software for business environments. It is not open-source and is shared for demonstration and portfolio purposes only.