docs: add Romanian User Guide and include in prod export v1.3.4

This commit is contained in:
Daniel Bedeleanu
2026-04-11 12:49:11 +03:00
parent ed06f0b56e
commit 91bdd791d2
4 changed files with 62 additions and 5 deletions

50
USER_GUIDE.md Normal file
View File

@@ -0,0 +1,50 @@
# TFM aInventory - User Guide (Ghid de Utilizare)
Bun venit în sistemul **TFM aInventory**. Acest document explică modul de utilizare a aplicației pentru gestionarea inventarului.
---
## 📱 Instalarea pe Telefon (PWA)
Aplicația este un **Progressive Web App**, ceea ce înseamnă că nu trebuie descărcată din App Store/Google Play.
1. Deschideți URL-ul aplicației în browser (ex: Safari pe iOS sau Chrome pe Android).
2. Apăsați butonul de **Share** (iOS) sau cele **trei puncte** (Android).
3. Selectați **"Add to Home Screen"** (Adaugă pe ecranul principal).
4. Aplicația va apărea acum ca o iconiță pe ecranul dvs. și va funcționa într-un mod imersiv (fără barele browserului).
---
## 🔐 Autentificarea
* **Utilizator Implicit:** La prima instalare, folosiți `Admin` / `admin`.
* **Vă recomandăm schimbarea parolei imediat din secțiunea de Admin.**
* **LDAP:** Dacă administratorul a configurat integrarea, vă puteți loga cu contul de domeniu/companie. Aplicația vă va reține hash-ul parolei pentru a permite logarea în zone fără semnal (ex: subsoluri).
---
## 🔍 Scanarea și Adăugarea de Obiecte
Aplicația suportă două moduri de scanare:
1. **Manual / Barcode:** Scanați un cod de bare existent pentru a găsi sau adăuga un obiect.
2. **AI Label Extraction (OCR):** Folosiți camera pentru a fotografia eticheta unui produs nou. AI-ul va încerca să extragă automat:
* Denumirea produsului (Model/Series)
* Producătorul (Brand)
* Specificațiile tehnice
* Codul de bare
---
## 📂 Organizarea Inventarului
* **Category Groups:** Grupează categoriile (ex: IT, Papetărie, Mobilier).
* **Categories:** Subdiviziuni ale grupurilor.
* **Item Types:** Definește template-uri pentru obiecte (ex: Laptop, Scaun, Tonner).
---
## 📜 Jurnalul de Activitate (Audit Log)
Toate acțiunile (adăugări, modificări, ștergeri) sunt înregistrate în timp real. Puteți consulta istoricul în secțiunea **Logs** pentru a vedea cine și când a operat modificări în stoc.
---
## 📶 Modul Offline
Aplicația este concepută să funcționeze chiar și atunci când nu aveți conexiune la internet în depozit. Datele sunt sincronizate automat când reveniți în zona de acoperire.
---
*Pentru asistență tehnică, contactați administratorul de sistem.*

View File

@@ -1,11 +1,10 @@
{
"version": "1.3.3",
"last_build": "2026-04-11-1246",
"version": "1.3.4",
"last_build": "2026-04-11-1250",
"commit": "PENDING",
"changelog": [
"v1.3.4: Created USER_GUIDE.md (Romanian) for end-users and integrated into export bundle",
"v1.3.3: Added comprehensive project README.md documenting all operational modes",
"v1.3.2: Systemd Standalone: Switched systemd service from Docker to bare-metal (Direct Python/Node management)",
"v1.3.1: Systemd support added (Docker-compose based - DEPRECATED)",
"v1.3.0: Dockerization: Dual-mode architecture, standalone Next.js, Python logger, and prod export script"
"v1.3.2: Systemd Standalone: Switched systemd service from Docker to bare-metal"
]
}

View File

@@ -271,3 +271,9 @@
[2026-04-11 12:45:54] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:46:24] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:46:54] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:47:24] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:47:54] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:48:24] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200
[2026-04-11 12:48:37] [WARNING] [uvicorn.error] Invalid HTTP request received.
[2026-04-11 12:48:37] [INFO] [uvicorn.access] ::ffff:127.0.0.1:0 - "POST /exa.language_server_pb.LanguageServerService/GetUnleashData HTTP/1.1" 404
[2026-04-11 12:48:54] [INFO] [uvicorn.access] ::ffff:192.168.84.140:0 - "GET /items/ HTTP/1.1" 200

View File

@@ -25,6 +25,8 @@ cp start_server.sh "$PROD_DIR/"
cp run_standalone.sh "$PROD_DIR/"
cp install_service.sh "$PROD_DIR/"
cp inventory.service.template "$PROD_DIR/"
cp USER_GUIDE.md "$PROD_DIR/"
cp README.md "$PROD_DIR/INSTALLATION_GUIDE.md"
cp .git_path "$PROD_DIR/" 2>/dev/null || true
cp VERSION.json "$PROD_DIR/"