diff --git a/USER_GUIDE.md b/USER_GUIDE.md new file mode 100644 index 00000000..4c1708c5 --- /dev/null +++ b/USER_GUIDE.md @@ -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.* diff --git a/VERSION.json b/VERSION.json index 06d4c523..fa37b63b 100644 --- a/VERSION.json +++ b/VERSION.json @@ -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" ] } diff --git a/backend/logs/backend.log b/backend/logs/backend.log index 447c2f8d..b6396e02 100644 --- a/backend/logs/backend.log +++ b/backend/logs/backend.log @@ -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 diff --git a/export_prod.sh b/export_prod.sh index 25ed1116..ad0a497a 100755 --- a/export_prod.sh +++ b/export_prod.sh @@ -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/"