Daniel Bedeleanu
dacf7d2921
Discussion locked in 4 key decisions: 1. YAML Format: All configs standardized on YAML (backend.yaml, frontend.yaml, network.yaml, docker.yaml) for better structure and validation 2. Secrets Management: Separate config/secrets.yaml file (git-ignored) with config/secrets.yaml.example template + strong documentation 3. Examples: Commit all .yaml.example files for developer onboarding 4. Scripts: Audit bash scripts for redundancy, then convert all needed ones to Python for native YAML parsing and cleaner architecture Immediate deprecation of inventory.env (no fallback after Phase 7). Discussion log preserved in 07-DISCUSSION-LOG.md Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
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:
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.
🏗 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.
🔐 Security & Constraints
AI agents and developers MUST strictly follow the rules defined in 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