095df98ceba1d0a924e2e56bce5bbd283da0e207
- Added backend.yaml.example with AI, DB, auth, and logging schema - Added frontend.yaml.example with API and feature flag schema - Added network.yaml.example with ports and SSL schema - Added docker.yaml.example with resource and volume schema - Added secrets.yaml.example as a template for sensitive data - All files include comprehensive comments documenting every variable
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
Description
Languages
Python
95.7%
TypeScript
1.4%
Cython
1.1%
C
1%
C++
0.6%