POSEIDON 🛒 — Point-Of-Sale System

Version: 1.2

POSEIDON is an open-source, lightweight yet powerful Point-Of-Sale web app designed for small & medium stores. It delivers an intuitive dashboard, quick-sale workflow, inventory tracking, supplier & customer management, and detailed sales reports — all wrapped in a responsive UI.

---

✨ Key Features

	Feature
⚡ Fast Checkout	Quick-add bestseller list & barcode search
📦 Inventory	Stock alerts (low/soon-expired) & supplier linkage
📈 Reporting	XLSX daily/period reports
🔐 Auth & Roles	Admin / Cashier accounts via Flask-Login
🗄️ DB Options	SQLite for quick start, PostgreSQL for production
🐳 Container Ready	1-command deployment with uWSGI

---

📷 Screenshots

Dashboard	Sales

---

🚀 Quick Start

1. Local Python

python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # edit DB_TYPE etc. if needed
python app.py  # browse http://localhost:5000

2. Docker / Podman

git clone https://github.com/semarainc/poseidon.git
cd poseidon
podman build -t poseidon-pos .
podman run -d --name poseidon -p 8999:8999 --env-file .env poseidon-pos
# uWSGI will serve on port 8999

---

⚙️ Configuration

Variable	Example	Description
SECRET_KEY	super-secret	Flask session key
DB_TYPE	sqlite / postgres	Select DB engine
SQLITE_URI	sqlite:///instance/poseidon.db	Override SQLite path
POSTGRES_URI	postgresql://user:pass@host/db	PostgreSQL URI
POSEIDON_ENV	development / production	Config profile

See .env for template.

---

🏗️ Tech Stack

• Python 3.12, Flask 2, SQLAlchemy
• Bootstrap 5 & FontAwesome
• uWSGI, Docker / Podman

---

🤝 Contributing

Pull requests are welcome! Please open an issue first to discuss major changes.

git clone https://github.com/semarainc/poseidon.git

See CONTRIBUTING.md for coding standards & commit message style.

---

📜 License

Released under the MIT License — see LICENSE for details.

---

🙏 Credits & Attribution

• Trident icon by Freepik on Flaticon.

Contributors

• Ade Wira (Tradewr) — Donatur & Initiator
• Adi Purnama (AdiPurnama12) — Front-End Design

Huge thanks to the open-source community — Flask, Bootstrap, SQLAlchemy, and everyone who makes building web apps a joy!