# TFM aInventory (2026 Edition)

A unified, offline-first Inventory Management System built as a Progressive Web App (PWA). Features include AI-powered label extraction (OCR), local barcode/QR scanning, and multi-user authentication with LDAP support.

---

## 🚀 Quick Start (Production)

For production environments, Docker is the recommended deployment method:

```bash
git clone <repository-url> tfm-inventory
cd tfm-inventory
cp inventory.env.example inventory.env
# Edit inventory.env with your JWT_SECRET_KEY and AI keys
./deploy.sh production
```

- **Frontend**: http://localhost:8917 (or https://localhost:8909 via proxy)
- **Backend API**: http://localhost:8916/docs

For detailed deployment instructions (Docker vs Standalone), see **[DEPLOYMENT.md](DEPLOYMENT.md)**.

---

## 🏗 Technical Overview
*   **Backend:** FastAPI (Python 3.12+)
*   **Frontend:** Next.js 15+ (React PWA) with responsive Tailwind CSS
*   **Database:** SQLite (SQLAlchemy) with Dexie.js (IndexedDB) for client-side sync.
*   **AI Engine:** Google Gemini (Primary) & Anthropic Claude (Fallback).

For more details on system logic, see **[PROJECT_ARCHITECTURE.md](PROJECT_ARCHITECTURE.md)**.

---

## 🔐 Security & Constraints
AI agents and developers MUST strictly follow the rules defined in **[AI_RULES.md](AI_RULES.md)**.

- **No Uppercase UI**: All labels/headers must be normal case.
- **No Bold Fonts**: Text hierarchy is achieved through size and color.
- **Offline-First**: All features must function without an active network connection.

---

## 📦 Production Distribution
To generate a clean production package:
`python3 scripts/save_version.py --patch` (or `--minor`/`--major`)

---

**Last Updated**: 2026-04-23  
**Version**: 1.14.6