Full-stack Restaurant Point of Sale - Flask web app with live browser demo

Live Demo | Documentation

Click the button above to launch the full app with database in your browser. No installation needed.

Or try the static demo (no server, runs in browser only).

Fast food cashiers need a simple POS. This handles:

• Customer registration
• Menu ordering (19 items across 4 categories)
• Bill calculation (18% tax, 1% service charge)
• Receipt generation

Originally built with Tkinter + MySQL, reengineered to Flask + SQLite with MVC architecture, tests, Docker, and CI/CD.

Browser → Flask Routes → Services → SQLAlchemy Models → SQLite

See docs/architecture.md for details.

docker-compose up
# Open http://localhost:5000

# Clone
git clone https://github.com/lAteralthInklAbs/resto-pos.git
cd resto-pos

# Install
pip install -r requirements.txt

# Run
python app.py
# Open http://localhost:5000

# Login: admin / admin

The live demo implements the complete 5-screen POS flow:

1. Login - Cashier authentication
2. Dashboard - Main menu with actions
3. Customer Registration - Optional customer details
4. Order Entry - Menu items grouped by category with quantity selection
5. Payment & Receipt - Bill with tax/service charge, payment, printable receipt

No server required - runs entirely in the browser using JavaScript and localStorage.

# Run all tests
make test
# or
pytest tests/ -v

# Run linter
make lint
# or
ruff check src/ tests/

# Full CI check
make ci

resto-pos/
├── app.py              # Flask app factory
├── src/
│   ├── models.py       # SQLAlchemy models
│   ├── routes.py       # Flask blueprints
│   ├── services.py     # Business logic
│   ├── config.py       # Configuration
│   └── seed_data.py    # Menu data seeder
├── templates/          # Jinja2 HTML templates
├── static/             # CSS and JavaScript
├── tests/              # pytest tests
├── demo/               # GitHub Pages demo
├── legacy/             # Original Tkinter code
└── docs/               # Documentation

MIT - see LICENSE

Built with Flask, SQLAlchemy, and Bootstrap 5