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

14
dev_docs/ARCHIVE_LOGS.md
View File

@@ -1,10 +1,16 @@
### [2026-04-11 12:05] v1.2.6: Hotfix - Missing Icon Imports
**Purpose:** Fixed `ReferenceError: Layers is not defined` and `ChevronDown is not defined` errors by adding missing imports in `admin/page.tsx` and `app/page.tsx`.
### [2026-04-11 12:15] v1.2.7: Documentation Refactor & Portability
**Purpose:** Consolidated technical stack information into a single source of truth (`dev_docs/TECH_STACK.md`) and removed absolute paths from all AI-facing documents to ensure the project can be moved across environments without breaking references.
**Modified Files:**
- `frontend/app/admin/page.tsx`
- `frontend/app/page.tsx`
- `dev_docs/TECH_STACK.md` (New)
- `GEMINI.md` (Refined)
- `AI_RULES.md` (Cleaned)
- `PLAN.md` (Referenced tech stack)
- `requirements.md` (Referenced tech stack)
- `dev_docs/SESSION_STATE.md` (Path cleanup)
- `VERSION.json`
### [2026-04-11 12:05] v1.2.6: Hotfix - Missing Icon Imports
### [2026-04-11 11:58] v1.2.5: UI Icon Synchronization
### [2026-04-11 11:45] v1.2.4: Offline Auth & UX Polish

15
dev_docs/SESSION_HISTORY.md
View File

@@ -5,6 +5,21 @@ Entries are added here when a new AI session starts.
---
**[Archived: 2026-04-11]**
**Status**: UI Readability Refactor Completed (v1.2.2). Ready for Phase 6.
**Current AI Agent**: Gemini (Antigravity)
**Context**:
- **UI Readability**: System-wide removal of `uppercase` and `tracking-*`. Font sizes increased from 9px/10px to xs/sm. Title Case applied to major buttons.
- **Rules Compliance**: All changes logged in `ARCHIVE_LOGS.md` and `VERSION.json`.
- **Git**: Working on branch `dev`. Path persisted in `.git_path`.
**Next Steps**:
1. **Proceed to Phase 6: Audit Log Dashboard UI**. The backend already has `Log` models, but the frontend needs a more comprehensive view beyond the current "Audit History" modal if requested, OR finalize the existing ones.
2. Enable LDAP and test with real server (from v1.2.1 goals).
3. Deploy v1.2.2 to stable branch if user confirms.
---
### Handover Archive (Auto-Archived)
**Status**: v1.2.1 Infrastructure Stable.
**Current AI Agent**: Gemini (Antigravity)

16
dev_docs/SESSION_STATE.md
View File

@@ -1,13 +1,15 @@
# AI Session State - HANDOVER
**Status**: UI Readability Refactor Completed (v1.2.2). Ready for Phase 6.
**Status**: v1.2.6 Hotfixed & UX Polished. Persistent Gemini Context Created.
**Current AI Agent**: Gemini (Antigravity)
**Context**:
- **UI Readability**: System-wide removal of `uppercase` and `tracking-*`. Font sizes increased from 9px/10px to xs/sm. Title Case applied to major buttons.
- **Rules Compliance**: All changes logged in `ARCHIVE_LOGS.md` and `VERSION.json`.
- **Git**: Working on branch `dev`. Path persisted in `.git_path`.
- **Offline Auth**: LDAP users now have local password hash caching (v1.2.4).
- **UI Affordance**: Added `ChevronDown` to selects and softened password dots.
- **Icon Sync**: Unified iconography (Layers = Categories, Package = Item Types).
- **Memory**: Created [GEMINI.md](../GEMINI.md) as the persistent entry point for this agent.
- **Version**: Currently at **v1.2.6**. Commit log in `ARCHIVE_LOGS.md`.
**Next Steps**:
1. **Proceed to Phase 6: Audit Log Dashboard UI**. The backend already has `Log` models, but the frontend needs a more comprehensive view beyond the current "Audit History" modal if requested, OR finalize the existing ones.
2. Enable LDAP and test with real server (from v1.2.1 goals).
3. Deploy v1.2.2 to stable branch if user confirms.
1. **Phase 6: Advanced Audit Dashboard**. Current logs exist but could use a dedicated page with filtering.
2. Final testing of offline LDAP login (Basement simulation).
3. Verification of icon consistency in any new screens.

25
dev_docs/TECH_STACK.md Normal file
View File

@@ -0,0 +1,25 @@
# TECHNICAL STACK - SINGLE SOURCE OF TRUTH
This document defines the official technology stack for the Inventory System. All components must adhere to these versions and libraries.
## 🟢 Backend (API & Data)
- **Language:** Python 3.12+ (Optimized for performance and type safety)
- **Framework:** [FastAPI](https://fastapi.tiangolo.com/) (Async ASGI)
- **Database:** SQLite (SQLAlchemy) - Local file-based persistence
- **Validation:** Pydantic v2
- **Auth:** Hybrid LDAP (python-ldap) + PBKDF2 local password hash caching (v1.2.4)
- **AI Engine:** Google GenAI SDK (Gemini 2.0 Flash) - Location: `backend/ai/`
## 🔵 Frontend (Web & PWA)
- **Architecture:** [Next.js](https://nextjs.org/) 15+ (App Router)
- **Styling:** Tailwind CSS (Readability-first config: No uppercase/tracking-widest)
- **Icons:** [Lucide Icons](https://lucide.dev/) (React components)
- **Offline persistence:** [Dexie.js](https://dexie.org/) (IndexedDB wrapper)
- **Scanner:** `html5-qrcode` (Client-side, offline-only)
- **Sync:** Axios with bulk-sync idempotency (UUID-based)
## 🏗 Operations & Tooling
- **PWA Deployment:** `next-pwa` (Service Workers + Manifest.json)
- **HTTPS Proxy:** `local-ssl-proxy` (Required for mobile camera access)
- **Version Control:** Git (Local-first, path in `.git_path`)
- **Isolation:** Python `.venv` and Node `node_modules`