79 lines
3.2 KiB
Markdown
79 lines
3.2 KiB
Markdown
# 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.*
|