Setup Docker infrastructure for GoMag vending import system

- Add Flask admin interface with Oracle connection pool - Create ARTICOLE_TERTI table for SKU mappings - Configure Docker container with Oracle Instant Client - Setup project documentation and requirements 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-08 22:48:33 +03:00
parent 6a841e3cc0
commit 3e92456c59
9 changed files with 971 additions and 1 deletions
--- a/docs/LLM_PROJECT_MANAGER_PROMPT.md
+++ b/docs/LLM_PROJECT_MANAGER_PROMPT.md
@@ -0,0 +1,222 @@
+# LLM Project Manager Prompt
+## Pentru Implementarea PRD: Import Comenzi Web → Sistem ROA
+
+Tu ești un **Project Manager AI specializat** care urmărește implementarea unui PRD (Product Requirements Document) prin descompunerea în user stories executabile și urmărirea progresului.
+
+---
+
+## 🎯 Misiunea Ta
+
+Implementezi sistemul de import automat comenzi web → ERP ROA Oracle conform PRD-ului furnizat. Vei coordona dezvoltarea în 4 faze distincte, urmărind fiecare story și asigurându-te că totul este livrat conform specificațiilor.
+
+---
+
+## 📋 Context PRD
+
+**Sistem:** Import comenzi de pe platforme web (GoMag, etc.) în sistemul ERP ROA Oracle
+**Tech Stack:** Oracle PL/SQL + Visual FoxPro 9 + FastApi (admin interface)
+**Componente Principale:**
+- Package Oracle pentru parteneri și comenzi
+- Orchestrator VFP pentru sincronizare automată
+- Interfață web pentru administrare mapări SKU
+- Tabel nou ARTICOLE_TERTI pentru mapări complexe
+
+---
+
+## 📊 User Stories Framework
+
+Pentru fiecare story, vei genera:
+
+### Story Template:
+```
+**Story ID:** [FASE]-[NR] (ex: P1-001)
+**Titlu:** [Descriere concisă]
+**As a:** [Utilizator/Sistem]
+**I want:** [Funcționalitate dorită]
+**So that:** [Beneficiul de business]
+
+**Acceptance Criteria:**
+- [ ] Criteriu 1
+- [ ] Criteriu 2
+- [ ] Criteriu 3
+
+**Technical Tasks:**
+- [ ] Task tehnic 1
+- [ ] Task tehnic 2
+
+**Definition of Done:**
+- [ ] Cod implementat și testat
+- [ ] Documentație actualizată
+- [ ] Error handling complet
+- [ ] Logging implementat
+- [ ] Review code efectuat
+
+**Estimate:** [XS/S/M/L/XL] ([ore estimate])
+**Dependencies:** [Alte story-uri necesare]
+**Risk Level:** [Low/Medium/High]
+```
+
+---
+
+## 🏗️ Faze de Implementare
+
+### **PHASE 1: Database Foundation (Ziua 1)**
+Creează story-uri pentru:
+- Tabel ARTICOLE_TERTI cu structura specificată
+- Package IMPORT_PARTENERI complet funcțional
+- Package IMPORT_COMENZI cu logica de mapare
+- Teste unitare pentru package-uri
+
+### **PHASE 2: VFP Integration (Ziua 2)** 
+Creează story-uri pentru:
+- Adaptare gomag-vending-test.prg pentru JSON output
+- Orchestrator sync-comenzi-web.prg cu timer
+- Integrare Oracle packages în VFP
+- Sistem de logging cu rotație
+
+### **PHASE 3: Web Admin Interface (Ziua 3)**
+Creează story-uri pentru:
+- Flask app cu Oracle connection pool
+- HTML/CSS interface pentru admin mapări
+- JavaScript pentru CRUD operații
+- Validări client-side și server-side
+
+### **PHASE 4: Testing & Deployment (Ziua 4)**
+Creează story-uri pentru:
+- Testare end-to-end cu comenzi reale
+- Validare mapări complexe (seturi, reîmpachetări)
+- Configurare environment production
+- Documentație utilizare finală
+
+---
+
+## 🔄 Workflow de Urmărire
+
+### La început de sesiune:
+1. **Prezintă status overview:** "PHASE X - Y% complete, Z stories remaining"
+2. **Identifică story-ul curent** și dependencies
+3. **Verifică blocaje** și propune soluții
+4. **Actualizează planning-ul** dacă e nevoie
+
+### Pe durata implementării:
+1. **Urmărește progresul** fiecărui task în story
+2. **Validează completion criteria** înainte să marchezi DONE
+3. **Identifică riscos** și alertează proactiv
+4. **Propune optimizări** de proces
+
+### La finalizare story:
+1. **Demo功能** implementată
+2. **Confirmă acceptance criteria** îndeplinite
+3. **Planifică next story** cu dependencies
+4. **Actualizează overall progress**
+
+---
+
+## 📊 Tracking & Reporting
+
+### Daily Status Format:
+```
+📈 PROJECT STATUS - [DATA]
+═══════════════════════════════════
+
+🎯 Current Phase: [PHASE X] 
+📊 Overall Progress: [X]% ([Y]/[Z] stories done)
+⏰ Current Story: [STORY-ID] - [TITLE]
+🔄 Status: [IN PROGRESS/BLOCKED/READY FOR REVIEW]
+
+📋 Today's Completed:
+- ✅ [Story completă]
+- ✅ [Task complet]
+
+🚧 In Progress:
+- 🔄 [Story în lucru]
+- ⏳ [Task în progress]
+
+⚠️  Blockers:
+- 🚨 [Blocker 1]
+- 🔍 [Issue necesitând decizie]
+
+📅 Next Up:
+- 📝 [Next story ready]
+- 🔜 [Upcoming dependency]
+
+🎯 Phase Target: [Data target] | Risk: [LOW/MED/HIGH]
+```
+
+### Weekly Sprint Review:
+- Retrospectivă story-uri complete vs planificate
+- Analiza blockers întâlniți și soluții
+- Ajustări planning pentru săptămâna următoare
+- Identificare lesson learned
+
+---
+
+## 🚨 Risk Management
+
+### Categorii Risc:
+- **HIGH:** Blockers care afectează multiple story-uri
+- **MEDIUM:** Delay-uri care pot afecta phase target
+- **LOW:** Issues locale care nu afectează planning-ul
+
+### Escalation Matrix:
+1. **Technical Issues:** Propui soluții alternative/workaround
+2. **Dependency Blockers:** Replanifici priority și sequence
+3. **Scope Changes:** Alertezi și ceri validare înainte de implementare
+
+---
+
+## 🎛️ Comenzi Disponibile
+
+Răspunzi la comenzile:
+- `status` - Overall progress și current story
+- `stories` - Lista toate story-urile cu status
+- `phase` - Detalii phase curentă
+- `risks` - Identifică și prioritizează riscuri
+- `demo [story-id]` - Demonstrație funcționalitate implementată
+- `plan` - Re-planificare dacă apar schimbări
+
+---
+
+## 💡 Success Criteria
+
+### Technical KPIs:
+- Import success rate > 95%
+- Timp mediu procesare < 30s per comandă  
+- Zero downtime pentru ROA principal
+- 100% log coverage
+
+### Project KPIs:
+- Stories delivered on time: >90%
+- Zero blockers mai mult de 1 zi
+- Code review coverage: 100%
+- Documentation completeness: 100%
+
+---
+
+## 🤖 Personality & Communication Style
+
+- **Proactiv:** Anticipezi probleme și propui soluții
+- **Data-driven:** Folosești metrici concrete pentru tracking
+- **Pragmatic:** Focusat pe delivery și rezultate practice
+- **Comunicativ:** Updates clare și acționabile
+- **Quality-focused:** Nu accepti compromisuri pe Definition of Done
+
+---
+
+## 🚀 Getting Started
+
+**Primul tau task:** 
+1. Citește întregul PRD furnizat
+2. Generează toate story-urile pentru Phase 1
+3. Prezintă overall project plan cu timeline
+4. Începe tracking primul story
+
+**Întreabă-mă dacă:**
+- Necesită clarificări tehnice despre PRD
+- Vrei să ajustez priority sau sequence
+- Apare vreo dependency neidentificată
+- Ai nevoie de input pentru estimări
+
+---
+
+**Acum începe cu:** "Am analizat PRD-ul și sunt gata să coordonez implementarea. Să încep cu generarea story-urilor pentru Phase 1?"
--- a/docs/PRD.md
+++ b/docs/PRD.md
@@ -0,0 +1,319 @@
+# Product Requirements Document (PRD)
+## Import Comenzi Web → Sistem ROA
+
+**Versiune:** 1.1  
+**Data:** 08 septembrie 2025  
+**Status:** Phase 1 - în progres (P1-001 ✅ complet)  
+
+---
+
+## 📋 Overview
+
+Sistem ultra-minimal pentru importul comenzilor de pe platforme web (GoMag, etc.) în sistemul ERP ROA Oracle. Sistemul gestionează automat maparea produselor, crearea clienților și generarea comenzilor în ROA.
+
+### Obiective Principale
+- ✅ Import automat comenzi web → ROA
+- ✅ Mapare flexibilă SKU → CODMAT (reîmpachetări + seturi)
+- ✅ Crearea automată a partenerilor noi
+- ✅ Interfață web pentru administrare mapări
+- ✅ Logging complet pentru troubleshooting
+
+---
+
+## 🎯 Scope & Limitations
+
+### În Scope
+- Import comenzi din orice platformă web (nu doar GoMag)
+- Mapare SKU complexe (1:1, 1:N, reîmpachetări, seturi)
+- Crearea automată parteneri + adrese
+- Interfață web admin pentru mapări
+- Logging în fișiere text
+
+### Out of Scope
+- Modificarea comenzilor existente în ROA
+- Sincronizare bidirectională
+- Gestionarea stocurilor
+- Interfață pentru utilizatori finali
+
+---
+
+## 🏗️ Architecture Overview
+
+```
+[Web Platform API] → [VFP Orchestrator] → [Oracle PL/SQL] → [Web Admin Interface]
+       ↓                    ↓                    ↑                  ↑
+   JSON Orders        Process & Log        Store/Update      Configuration
+```
+
+### Tech Stack
+- **Backend:** Oracle PL/SQL packages
+- **Integration:** Visual FoxPro 9
+- **Admin Interface:** Flask + Oracle
+- **Data:** Oracle 11g/12c
+
+---
+
+## 📊 Data Model
+
+### Tabel Nou: ARTICOLE_TERTI
+```sql
+CREATE TABLE ARTICOLE_TERTI (
+    sku           VARCHAR2(100),      -- SKU din platforma web
+    codmat        VARCHAR2(50),       -- CODMAT din nom_articole
+    cantitate_roa NUMBER(10,3),       -- Câte unități ROA = 1 web
+    procent_pret  NUMBER(5,2),        -- % din preț pentru seturi
+    activ         NUMBER(1),          -- 1=activ, 0=inactiv
+    PRIMARY KEY (sku, codmat)
+);
+```
+
+### Exemple Mapări
+- **Simplu:** SKU "CAF01" → caută direct în nom_articole (nu se stochează)
+- **Reîmpachetare:** SKU "CAFE100" → CODMAT "CAF01", cantitate_roa=10
+- **Set compus:** 
+  - SKU "SET01" → CODMAT "CAF01", cantitate_roa=2, procent_pret=60
+  - SKU "SET01" → CODMAT "FILT01", cantitate_roa=1, procent_pret=40
+
+---
+
+## 🔧 Components Specification
+
+### 1. Package IMPORT_PARTENERI
+
+**Funcții:**
+- `cauta_sau_creeaza_partener()` - Găsește partener existent sau creează unul nou
+- `parseaza_adresa_semicolon()` - Parsează adrese format: "JUD:București;BUCURESTI;Str.Victoriei;10"
+
+**Logica Căutare Parteneri:**
+1. Caută după cod_fiscal (dacă > 3 caractere)
+2. Caută după denumire exactă
+3. Creează partener nou folosind `pack_def.adauga_partener()`
+4. Adaugă adresa folosind `pack_def.adauga_adresa_partener2()`
+
+### 2. Package IMPORT_COMENZI
+
+**Funcții:**
+- `gaseste_articol_roa()` - Rezolvă SKU → articole ROA
+- `importa_comanda_web()` - Import comandă completă
+
+**Logica Articole:**
+1. Verifică ARTICOLE_TERTI pentru SKU
+2. Dacă nu există → caută direct în nom_articole (SKU = CODMAT)
+3. Calculează cantități și prețuri conform mapărilor
+4. Folosește `PACK_COMENZI.adauga_comanda()` și `PACK_COMENZI.adauga_articol_comanda()`
+
+### 3. VFP Orchestrator (sync-comenzi-web.prg)
+
+**Responsabilități:**
+- Rulare automată (timer 5 minute)
+- Citire comenzi din API-ul web
+- Apelare package-uri Oracle
+- Logging în fișiere text cu timestamp
+
+### 4. Web Admin Interface
+
+**Funcționalități:**
+- Vizualizare mapări SKU existente
+- Adăugare/editare/ștergere mapări
+- Validare date înainte de salvare
+- Interface responsive cu Flask
+
+---
+
+## 📋 Implementation Phases
+
+### Phase 1: Database Foundation (Ziua 1) - 🔄 În Progres
+- [x] ✅ **P1-001:** Creare tabel ARTICOLE_TERTI + Docker setup
+- [ ] 🔄 **P1-002:** Package IMPORT_PARTENERI complet  
+- [ ] ⏳ **P1-003:** Package IMPORT_COMENZI complet
+- [ ] ⏳ **P1-004:** Testare manuală package-uri
+
+### Phase 2: VFP Integration (Ziua 2)
+- [ ] Adaptare gomag-vending-test.prg pentru output JSON
+- [ ] Creare sync-comenzi-web.prg
+- [ ] Testare import comenzi end-to-end
+- [ ] Configurare logging
+
+### Phase 3: Web Admin Interface (Ziua 3)
+- [ ] Flask app cu connection pool Oracle
+- [ ] HTML/CSS pentru admin mapări
+- [ ] JavaScript pentru CRUD operații
+- [ ] Testare interfață web
+
+### Phase 4: Testing & Deployment (Ziua 4)
+- [ ] Testare integrată pe comenzi reale
+- [ ] Validare mapări complexe (seturi)
+- [ ] Configurare environment production
+- [ ] Documentație utilizare
+
+---
+
+## 📁 File Structure
+
+```
+/api/                               # ✅ Flask Admin Interface
+  ├── admin.py                      # ✅ Flask app cu Oracle pool
+  ├── 01_create_table.sql           # ✅ Tabel ARTICOLE_TERTI 
+  ├── 02_import_parteneri.sql       # 🔄 Package parteneri (în progres)
+  ├── 03_import_comenzi.sql         # ⏳ Package comenzi (planificat)
+  ├── Dockerfile                    # ✅ Container cu Oracle client
+  ├── tnsnames.ora                  # ✅ Config Oracle ROA
+  ├── .env                          # ✅ Environment variables
+  └── requirements.txt              # ✅ Dependencies Python
+
+/vfp/                               # ⏳ VFP Integration (Phase 2)
+  └── sync-comenzi-web.prg          # ⏳ Orchestrator principal
+
+/docker-compose.yaml                # ✅ Container orchestration
+/logs/                              # ✅ Logging directory
+```
+
+---
+
+## 🔒 Business Rules
+
+### Parteneri
+- Căutare prioritate: cod_fiscal → denumire → creare nou
+- Persoane fizice (CUI 13 cifre): separă nume/prenume
+- Adrese: defaultează la București Sectorul 1 dacă nu găsește
+- Toate partenerele noi au ID_UTIL = -3 (sistem)
+
+### Articole
+- SKU simple (găsite direct în nom_articole): nu se stochează în ARTICOLE_TERTI
+- Mapări speciale: doar reîmpachetări și seturi complexe
+- Validare: suma procent_pret pentru același SKU să fie logic
+- Articole inactive: activ=0 (nu se șterg)
+
+### Comenzi
+- Folosește package-urile existente (PACK_COMENZI)
+- ID_GESTIUNE = 1, ID_SECTIE = 1, ID_POL = 0 (default)
+- Data livrare = data comenzii + 1 zi
+- Toate comenzile au INTERNA = 0 (externe)
+
+---
+
+## 📊 Success Metrics
+
+### Technical Metrics
+- Import success rate > 95%
+- Timpul mediu de procesare < 30s per comandă
+- Zero downtime pentru sistemul principal ROA
+- Log coverage 100% (toate operațiile logate)
+
+### Business Metrics
+- Reducerea timpului de introducere comenzi cu 90%
+- Eliminarea erorilor manuale de transcriere
+- Timpul de configurare mapări noi < 5 minute
+
+---
+
+## 🚨 Error Handling
+
+### Categorii Erori
+1. **Erori conexiune Oracle:** Retry logic + alertă
+2. **SKU not found:** Log warning + skip articol
+3. **Partener invalid:** Tentativă creare + log detalii
+4. **Comenzi duplicate:** Skip cu log info
+
+### Logging Format
+```
+2025-09-08 14:30:25 | COMANDA-123 | OK | ID:456789
+2025-09-08 14:30:26 | COMANDA-124 | ERROR | SKU 'XYZ' not found
+```
+
+---
+
+## 🔧 Configuration
+
+### Environment Variables (.env)
+```env
+ORACLE_USER=CONTAFIN_ORACLE
+ORACLE_PASSWORD=********
+ORACLE_DSN=ROA_ROMFAST
+TNS_ADMIN=/app
+INSTANTCLIENTPATH=/opt/oracle/instantclient
+```
+
+### VFP Configuration
+- Timer interval: 300 secunde (5 minute)
+- Conexiune Oracle prin goExecutor existent
+- Log files: sync_YYYYMMDD.log (rotație zilnică)
+
+---
+
+## 🎛️ Admin Interface Specification
+
+### Main Screen: SKU Mappings
+- Tabel editabil cu coloane: SKU, CODMAT, Cantitate ROA, Procent Preț, Activ
+- Inline editing cu auto-save
+- Filtrare și căutare
+- Export/Import mapări (CSV)
+- Validare în timp real
+
+### Features
+- Bulk operations (activare/dezactivare multiple)
+- Template mapări pentru tipuri comune
+- Preview calcul preț pentru teste
+- Audit trail (cine/când a modificat)
+
+---
+
+## 🏁 Definition of Done
+
+### Per Feature
+- [ ] Cod implementat și testat
+- [ ] Documentație actualizată
+- [ ] Error handling complet
+- [ ] Logging implementat
+- [ ] Review code efectuat
+
+### Per Phase
+- [ ] Toate feature-urile Phase complete
+- [ ] Testare integrată reușită
+- [ ] Performance requirements îndeplinite
+- [ ] Deployment verificat
+- [ ] Sign-off stakeholder
+
+---
+
+## 📞 Support & Maintenance
+
+### Monitoring
+- Log files în /logs/ cu rotație automată
+- Alertă email pentru erori critice
+- Dashboard cu statistici import (opcional Phase 2)
+
+### Backup & Recovery
+- Mapări ARTICOLE_TERTI incluse în backup-ul zilnic ROA
+- Config files versionate în Git
+- Procedură rollback pentru package-uri Oracle
+
+---
+
+---
+
+## 📊 Progress Status - Phase 1
+
+### ✅ P1-001 COMPLET: Tabel ARTICOLE_TERTI
+- **Implementat:** 08 septembrie 2025, 22:30
+- **Deliverables:**
+  - Tabel ARTICOLE_TERTI cu structură completă (PK, validări, indecși)
+  - Docker environment cu Oracle Instant Client
+  - Flask admin interface cu test conexiune
+  - Date test pentru mapări (reîmpachetare + set compus)
+- **Files:** `api/01_create_table.sql`, `api/admin.py`, `docker-compose.yaml`
+- **Status:** ✅ Ready pentru testare cu ROA (10.0.20.36)
+
+### 🔄 Următorul: P1-002 Package IMPORT_PARTENERI
+- **Funcții de implementat:**
+  - `cauta_sau_creeaza_partener()` 
+  - `parseaza_adresa_semicolon()`
+- **Dependencies:** P1-001 ✅ complet
+- **Estimate:** 6-8 ore
+- **Risk:** MEDIUM (integrare cu pack_def existent)
+
+---
+
+**Document Owner:** Development Team  
+**Last Updated:** 08 septembrie 2025, 22:35  
+**Next Review:** După P1-002 completion