TFM aInventory — Project Plan & Roadmap

Current Version: v1.14.22 Status: MILESTONE 7 SHIPPED | 🟢 PHASE 8 START 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. Current State (v1.14.22)

Architecture: Domain-driven YAML configuration (config/).
Management: Unified Python management suite (scripts/).
UI Fidelity: High (Normal weight only, Lucide icons, contextual CTAs).
Core Engine: Stable Item CRUD, AI extraction, and PWA offline sync.

3. Active Roadmap

Phase 7.1: Frontend UI/UX Overhaul (Industrial Precision) [COMPLETED]

Design System Integration: Apply the "Industrial Precision" system from DESIGN.md.
Component Refactoring: Update all UI components to use sharp corners (0px) and bold borders.
Color Palette Update: Implement the high-contrast Caution Orange and tiered black surface system.
Typography Alignment: Apply Space Grotesk while strictly adhering to the "NO BOLD" and "NO UPPERCASE" rules from AI_RULES.md.
Glanceability Optimization: Increase information density in StatCards and Data Tables.

Phase 8: Hardening & Release (PLANNED)

Production Runbook: Finalized guide for production deployment.
Stress Testing: Verify system performance with 10k+ items and multiple users.
E2E Validation: Verify data consistency in multi-page Excel exports.
Final Polish: Performance audit and accessibility sweep.

4. Milestone History

v1.14.22: Config Consolidation & Infrastructure (2026-04-23)
Previous Phases (Legacy Environment)

Phase 4: Field Validation (COMPLETED ✓)

Phase 5: Core V2 Features (COMPLETED ✓)

Phase 6: Deployment & Scale (COMPLETED ✓)

5. 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).
StatCard Rule: Numeric values MUST match label text size for balanced density.
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.

dev

6. Backlog (V3+)

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

3.0 KiB Raw Blame History