Steven-Ngoma/Mpepo-Kitchen-
Domaine:
socioeconomicType de record:
software
Créateur:
Ste
Hôte:
Complete. Point-of-Sale system with flutter mobile app, Fast API backend and e-invoicing integration for restaurant management
# 🍽️ Mpepo Kitchen POS System
A complete Point-of-Sale system for restaurants with integrated e-invoicing and tax compliance.
## 🚀 Features
- **Flutter Mobile App** - Cross-platform POS interface
- **FastAPI Backend** - High-performance REST API
- **E-Invoicing Integration** - Tax Authority compliance
- **Real-time Calculations** - Automatic tax and total computation
- **Offline Support** - Queue transactions when offline
- **Sales Reporting** - Daily sales and tax reports
## 🛠️ Tech Stack
### Backend
- **FastAPI** - Modern Python web framework
- **SQLAlchemy** - Database ORM
- **SQLite** - Lightweight database
- **Pydantic** - Data validation
### Frontend
- **Flutter** - Cross-platform mobile framework
- **Dart** - Programming language
- **Provider** - State management
- **Material Design** - UI components
## 📱 Screenshots
*Mobile POS interface with product catalog, cart management, and checkout process*
## 🏃♂️ Quick Start
### Backend Setup
```bash
# Install dependencies
pip install -r requirements.txt
# Initialize database
python seed_db.py
# Start server
python main.py
```
### Flutter App Setup
```bash
cd flutter_files
flutter pub get
flutter run
```
## 📚 API Documentation
Interactive API documentation available at: `localhost`
### Key Endpoints
- `GET /products` - Product catalog
- `POST /transactions` - Process sales
- `POST /tax-authority/submit-invoice` - E-invoicing
- `GET /reports/daily-sales` - Sales reports
## 🏗️ Architecture
```
├── models/ # Database models
├── routes/ # API endpoints
├── schemas/ # Data validation
├── crud/ # Database operations
└── flutter_files/ # Mobile application
├── lib/
│ ├── models/ # Data models
│ ├── screens/ # UI screens
│ └── services/ # Business logic
└── pubspec.yaml
```
## 💼 Business Features
### Point of Sale
- Product catalog with categories
- Shopping cart management
- Tax calculations (16% VAT)
- Receipt generation
### E-Invoi …