bede/tfm_ainventory
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

chore: archive v1.14.22 milestone

Browse Source
This commit is contained in:
Daniel Bedeleanu
2026-04-23 16:26:27 +03:00
parent d9b60b6b89 7c4441a962
commit 41a1f7d548
29 changed files with 494 additions and 664 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
dev_docs/PLAN.md
View File

@@ -1,7 +1,7 @@
# TFM aInventory — Project Plan & Roadmap
**Current Version**: 1.13.0+ (Phase 5/6)
**Status**: Stable, field-validated
**Current Version**: v1.14.22
**Status**: MILESTONE 7 SHIPPED | 🟢 PHASE 8 START
**Last Updated**: 2026-04-23
---
@@ -11,68 +11,44 @@ A unified inventory management system that eliminates manual data entry through
---
## 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.
## 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. 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.
## 3. Active Roadmap
### Phase 8: Hardening & Release (PLANNED)
- Stability monitoring, final UX refinements, production-ready runbook.
- **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. Design & Operational Constraints
## 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.
- **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.
- **UI Fidelity**: Premium density, Lucide icons, **NO UPPERCASE**, **NO BOLD FONTS**.
- **Security**: Mandatory auth, immutable audit logs.
---
## 6. Backlog (V3+)
- Advanced analytics & turnover trends.
- Multi-warehouse federation & inter-location transfers.
- Multi-warehouse federation.
- Localization (Portuguese, Spanish).
- Custom field schemas.
---
*For active tasks, see SESSION_STATE.md.*