bede_design
This commit is contained in:
@@ -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,50 +11,38 @@ 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).
|
||||
- **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).
|
||||
@@ -70,10 +58,6 @@ A unified inventory management system that eliminates manual data entry through
|
||||
|
||||
## 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.*
|
||||
|
||||
@@ -2,32 +2,33 @@
|
||||
|
||||
**Active AI:** Gemini CLI
|
||||
**Last Updated:** 2026-04-23
|
||||
**Current Version:** v1.14.20
|
||||
**Status**: ✅ STATCARD TYPOGRAPHY REFINED | 🟢 READY FOR PHASE 8
|
||||
**Current Version:** v1.14.22
|
||||
**Status**: ✅ MILESTONE 7 VERIFIED | 🟢 READY FOR PHASE 8
|
||||
|
||||
---
|
||||
|
||||
## SESSION 44 EXECUTION SUMMARY — StatCard UI Tweak
|
||||
## SESSION 42 EXECUTION SUMMARY — Milestone Audit & Infrastructure Hardening
|
||||
|
||||
### 1. StatCard Typography Adjustment
|
||||
- **Constraint**: Reduced numeric value font size in dashboard cards (`StatCard.tsx`) to match their label text size (`text-base md:text-lg`).
|
||||
- **Rationale**: User feedback indicated the previous large font sizes (`text-2xl md:text-3xl`) were overwhelming and disproportionate to the card's density.
|
||||
### 1. Milestone 7 Audit (COMPLETE)
|
||||
- **Verified Definition of Done**: Confirmed all Phase 7 (Config Consolidation) requirements are met.
|
||||
- **Integration Check**: Fixed a critical gap where `run_standalone.py` was not updating the frontend's `network.json`.
|
||||
- **Legacy Cleanup**: Deleted `start_server.sh`, `inventory.env.template`, and shell-based backup/restore scripts.
|
||||
- **Script Unification**: Converted `backup.sh` and `restore.sh` to modern Python tools (`scripts/restore_prod.py`).
|
||||
|
||||
### 2. Rule Standardization
|
||||
- **AI_RULES.md Updated**: Formally documented the new standard in Section 3 (UI/UX Fidelity Standards). Numeric values in StatCards MUST now match label sizes to maintain visual balance.
|
||||
### 2. UI/UX "Premium" Fidelity Fixes
|
||||
- **Typography**: Removed all `font-weight: 600` and `font-medium` instances to comply with "NO BOLD" rule.
|
||||
- **Copywriting**: Replaced generic "Cancel" buttons with contextual verbs ("Keep Item", "Discard Draft", etc.).
|
||||
- **Consistency**: Fixed uppercase "DELETE" to Title Case "Delete" while preserving safety confirmation logic.
|
||||
|
||||
### 3. Infrastructure Stability
|
||||
- **LDAP Config**: Refactored `auth.py` to use `ConfigManager` for saving settings directly to `backend.yaml`, eliminating legacy JSON side-files.
|
||||
- **Caddy Proxy**: Resolved Port 80 conflict by disabling automatic HTTP->HTTPS redirects in standalone mode.
|
||||
|
||||
---
|
||||
|
||||
## NEXT STEPS (Phase 8: Hardening & Release)
|
||||
|
||||
1. **Extraction Validation**:
|
||||
- Run sample images of RAID cards and NVMe drives to confirm `spare parts - <type>` categorization.
|
||||
2. **UX Refinement**:
|
||||
- Ensure the Admin UI displays these new categories correctly.
|
||||
3. **v1.15.0 Milestone**:
|
||||
- Finalize the release candidate.
|
||||
|
||||
---
|
||||
|
||||
✓ All tasks for this session are implemented, verified, and committed.
|
||||
✓ Services are currently RUNNING in the background.
|
||||
1. **Production Runbook**: Create a finalized guide for production deployment.
|
||||
2. **Stress Testing**: Verify system performance with 10k+ items and multiple users.
|
||||
3. **E2E Validation**: Verify data consistency in multi-page Excel exports and Python management scripts.
|
||||
4. **Final Polish**: Perform a final accessibility and performance audit before v1.15.0 stable release.
|
||||
|
||||
Reference in New Issue
Block a user