# 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) [ACTIVE]
- **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](.planning/milestones/v1.14.22-ROADMAP.md) (2026-04-23)
- <details><summary>Previous Phases (Legacy Environment)</summary>

### Phase 4: Field Validation (COMPLETED ✓)
### Phase 5: Core V2 Features (COMPLETED ✓)
### Phase 6: Deployment & Scale (COMPLETED ✓)
</details>

---

## 5. Design & Operational Constraints
- **Tech Stack**: FastAPI (Python), SQLite, Next.js (TypeScript), Tailwind CSS.
<<<<<<< HEAD
- **UI Fidelity**: Premium density, Lucide icons, **NO UPPERCASE**, **NO BOLD FONTS**.
- **Security**: Mandatory auth, immutable audit logs.
=======
- **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.