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

docs: refactor documentation for portability and SSOT v1.2.7

Browse Source
This commit is contained in:
Daniel Bedeleanu
2026-04-11 11:57:13 +03:00
parent 96fe655f72
commit 432cd28ca5
9 changed files with 103 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
requirements.md
View File

@@ -6,16 +6,15 @@ A unified system to maintain an inventory of "items" and their quantities, inclu
## 2. Core Constraints & System Elements
### 2.1 Main Application Server (Linux Backend)
* **Target Environment:** Dockerized Linux Environment.
* **Framework:** Python (FastAPI) + SQLite database.
* **Users & Security:** Support multiple authenticated users (PBKDF2 local + optional LDAP).
* **Audit Compliance:** All operations maintain a strict audit log (unique UUIDs, details).
See [dev_docs/TECH_STACK.md](dev_docs/TECH_STACK.md) for detailed backend specifications.
- **Target Environment:** Dockerized Linux Environment.
- **Users & Security:** Support multiple authenticated users (PBKDF2 local + optional LDAP).
- **Audit Compliance:** All operations maintain a strict audit log (unique UUIDs, details).
### 2.2 Client Interface (PWA - Progressive Web App)
* **Unified Interface:** A single Web Application (Next.js or similar) that is fully responsive. It functions as the administration dashboard on desktop and as a mobile application on phones/tablets.
* **Installation:** Installed on mobile devices directly via the browser ("Add to Home Screen") to bypass App Stores. Completely managed by the main Linux Server.
* **Offline Mode:** Service Workers and local browser storage (IndexedDB) must cache the inventory catalog, allowing offline check-ins/check-outs. Modifications are synced to the Linux server upon network reconnection.
* **Hardware Access:** Must natively tap into the device's camera via HTML5 APIs to capture barcode data or full images.
See [dev_docs/TECH_STACK.md](dev_docs/TECH_STACK.md) for frontend libraries and architecture.
- **Offline Mode:** Service Workers and local browser storage (IndexedDB) must cache the inventory catalog.
- **Hardware Access:** Must natively tap into the device's camera via HTML5 APIs.
### 2.3 Scanning & AI processing Cost-Optimization Strategy (Crucial)
* **Routine Operations (Check-in / Check-out):** Utilize client-side, offline Javascript libraries (e.g., `html5-qrcode`) to read 1D/2D barcodes directly in the browser's camera. This executes entirely on the local device unconditionally and uses no AI cloud credits.