From bc56befc15a7802926a0e82aabe1e8509ac75255 Mon Sep 17 00:00:00 2001 From: Claude Agent Date: Wed, 25 Mar 2026 22:20:18 +0000 Subject: [PATCH] docs: update project documentation for recent changes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README.md: fix stale pct_total reference → cantitate_roa, add price_sync_service to project tree, update docs/ description (PRD/stories removed), add scripts/ directory, add Documentatie Tehnica section linking all doc files - api/README.md: add missing price_sync_service and invoice_service to services table Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 17 +++++++++++++++-- api/README.md | 2 ++ 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e51af4e..40e8c6f 100644 --- a/README.md +++ b/README.md @@ -110,7 +110,8 @@ gomag-vending/ │ │ │ ├── gomag_client.py # Download comenzi GoMag API │ │ │ ├── sync_service.py # Orchestrare: download→validate→import │ │ │ ├── import_service.py # Import comanda in Oracle ROA -│ │ │ ├── mapping_service.py # CRUD ARTICOLE_TERTI + pct_total +│ │ │ ├── mapping_service.py # CRUD ARTICOLE_TERTI + cantitate_roa +│ │ │ ├── price_sync_service.py # Sync preturi GoMag → Oracle politici │ │ │ ├── sqlite_service.py # Tracking runs/orders/missing SKUs │ │ │ ├── order_reader.py # Citire gomag_orders_page*.json │ │ │ ├── validation_service.py @@ -127,7 +128,8 @@ gomag-vending/ │ ├── test_integration.py # Test C - cu Oracle │ └── requirements.txt ├── logs/ # Log-uri aplicatie (sync_comenzi_*.log) -├── docs/ # Documentatie (PRD, stories) +├── docs/ # Documentatie (Oracle schema, facturare analysis) +├── scripts/ # Utilitare (sync_vending_to_mariusm, create_inventory_notes) ├── screenshots/ # Before/preview/after pentru UI changes ├── start.sh # Script pornire (Linux/WSL) └── CLAUDE.md # Instructiuni pentru AI assistants @@ -447,6 +449,17 @@ curl -X POST http://localhost:5003/api/dashboard/refresh-invoices --- +## Documentatie Tehnica + +| Fisier | Subiect | +|--------|---------| +| [docs/oracle-schema-notes.md](docs/oracle-schema-notes.md) | Schema Oracle: tabele comenzi, facturi, preturi, proceduri cheie | +| [docs/pack_facturare_analysis.md](docs/pack_facturare_analysis.md) | Analiza flow facturare: call chain, parametri, STOC lookup, FACT-008 | +| [scripts/HANDOFF_MAPPING.md](scripts/HANDOFF_MAPPING.md) | Matching GoMag SKU → ROA articole (strategie si rezultate) | +| [README-ORACLE-MODES.md](README-ORACLE-MODES.md) | Configurare Oracle thick/thin mode cu Docker | + +--- + ## WSL2 Note - `uvicorn --reload` **nu functioneaza** pe `/mnt/e/` (WSL2 limitation) — restarta manual diff --git a/api/README.md b/api/README.md index c9cb107..70eb56d 100644 --- a/api/README.md +++ b/api/README.md @@ -26,6 +26,8 @@ Admin interface si orchestrator pentru importul comenzilor GoMag in Oracle ROA. | article_service | Cautare in NOM_ARTICOLE (Oracle) | | import_service | Port din VFP: partner/address/order creation | | sync_service | Orchestrare: read JSONs → validate → import → log | +| price_sync_service | Sync preturi GoMag → Oracle politici de pret | +| invoice_service | Verificare facturi ROA + cache SQLite | | validation_service | Batch-validare SKU-uri (chunks of 500) | | order_reader | Citire gomag_orders_page*.json din vfp/output/ | | sqlite_service | CRUD pe SQLite (sync_runs, import_orders, missing_skus) |