TFM aInventory — Project Plan & Roadmap

Current Version: 1.13.0+ (Phase 5/6) Status: Stable, field-validated Last Updated: 2026-04-23

1. Project Mission

A unified inventory management system that eliminates manual data entry through AI-powered label extraction, works offline in the field, and provides immutable audit trails for enterprise security.

2. Core Requirements (Validated)

✓ Item CRUD: Full inventory tracking with barcode/PN support.
✓ Offline Scanning: QR/Barcode scanning via browser (html5-qrcode).
✓ AI Extraction: Automatic item detail extraction from photos (Gemini 2.0 / Claude 3.5).
✓ PWA & Offline Sync: IndexedDB storage with UUID-based conflict resolution.
✓ Enterprise Auth: LDAP integration + PBKDF2 local credential caching.
✓ Audit Log: Immutable history of all changes, deletions are traced.
✓ PWA: Installable on iOS/Android, works without network.

3. Roadmap: Phases 4–7

Phase 4: Field Validation (COMPLETED ✓)

Deploy to pilot sites, collect feedback, fix mobile UX blockers.

Phase 5: Core V2 Features (COMPLETED ✓)

Quick Quantity Adjustment: Hybrid UI (+/- and tap-to-edit).
Search & Filtering: Advanced modal-based search.
Export/Reports: CSV/Excel exports for compliance.

Phase 6: Deployment & Scale (COMPLETED ✓)

Containerization: Full Docker support with Caddy proxy.
Automation: Single-command deploy.sh (now deploy.py).
Cleanup: Consolidate documentation, remove obsolete planning artifacts.
Performance: Scale testing for 10K+ items and 5+ concurrent users.

Phase 7: Config Consolidation (COMPLETED ✓)

Centralization: All config in config/ folder (YAML format).
Automation: Bash scripts converted to Python (scripts/).
SSOT Architecture: network.yaml established as Master IP/Port authority.
Dynamic Injection: Automatic API URL and CORS calculation from master config.
D-06 Load Order: Env Vars > YAML > Defaults.
Deprecation: inventory.env and legacy .sh scripts completely removed.

Phase 8: Hardening & Release (PLANNED)

Stability monitoring, final UX refinements, production-ready runbook.

4. Design & Operational Constraints

Tech Stack: FastAPI (Python), SQLite, Next.js (TypeScript), Tailwind CSS.
UI Fidelity: Premium density, Lucide icons, NO UPPERCASE, NO BOLD FONTS (normal weight only).
Database: Single-instance SQLite (WAL mode). Multi-instance is v3+.
Security: Mandatory auth, no bypasses, immutable audit logs.
AI: Multi-provider resilience (Gemini primary, Claude fallback).

5. Decision Log Summary

Reset Planning (2026-04-22): Refocused on v2 stable release, deferred complex analytics to v3.
Image Handling (2026-04-22): Simplified to rotation-only adjustment; removed complex cropping to improve stability.
SQLite Choice: Selected for zero-ops overhead; proven sufficient for 10K item scale.

6. Backlog (V3+)

Advanced analytics & turnover trends.
Multi-warehouse federation & inter-location transfers.
Localization (Portuguese, Spanish).
Custom field schemas.

For active tasks, see SESSION_STATE.md.

3.2 KiB Raw Blame History Unescape Escape