chore: major codebase cleanup and documentation consolidation

dev_docs/PLAN.md

@@ -0,0 +1,70 @@
+# 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 (CURRENT)
+- **Containerization**: Full Docker support with Caddy proxy.
+- **Automation**: Single-command `deploy.sh`.
+- **Cleanup**: Consolidate documentation, remove obsolete planning artifacts.
+- **Performance**: Scale testing for 10K+ items and 5+ concurrent users.
+
+### Phase 7: 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.*