# 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/`).
- **Structure**: Clear separation of `backend.yaml`, `frontend.yaml`, `network.yaml`, `docker.yaml`, `secrets.yaml`.
- **D-06 Load Order**: Env Vars > YAML > Defaults.
- **Deprecation**: `inventory.env` 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.*