Files

Claude Agent a659f3bafb docs: cleanup stale documentation and fix outdated references

- Delete README-ORACLE-MODES.md (references Docker infra that doesn't exist)
- Delete .claude/HANDOFF.md (completed CI/CD session handoff, no longer needed)
- Fix api/README.md: correct run command to ./start.sh, update test commands
  to use ./test.sh instead of deleted test_app_basic.py/test_integration.py
- Fix scripts/HANDOFF_MAPPING.md: mark deleted scripts as removed
- Remove dead README-ORACLE-MODES.md link from README doc table

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-25 22:23:21 +00:00

2.3 KiB

Raw Blame History

GoMag Import Manager - FastAPI Application

Admin interface si orchestrator pentru importul comenzilor GoMag in Oracle ROA.

Componente

Core

main.py - Entry point FastAPI, lifespan (Oracle pool + SQLite init), file logging
config.py - Settings via pydantic-settings (citeste .env)
database.py - Oracle connection pool + SQLite schema + helpers

Routers (HTTP Endpoints)

Router	Prefix	Descriere
health	/health, /api/health	Status Oracle + SQLite
dashboard	/	Dashboard HTML cu stat cards
mappings	/mappings, /api/mappings	CRUD ARTICOLE_TERTI + CSV
articles	/api/articles	Cautare NOM_ARTICOLE
validation	/api/validate	Scanare + validare SKU-uri
sync	/sync, /api/sync	Import orchestration + scheduler

Services (Business Logic)

Service	Rol
mapping_service	CRUD pe ARTICOLE_TERTI (Oracle)
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)
scheduler_service	APScheduler - sync periodic configurabil din UI

Rulare

pip install -r requirements.txt
# INTOTDEAUNA via start.sh din project root (seteaza Oracle env vars)
cd .. && ./start.sh

Testare

# Din project root:
./test.sh ci       # Teste rapide (unit + e2e, ~30s, fara Oracle)
./test.sh full     # Teste complete (inclusiv Oracle, ~2-3 min)
./test.sh unit     # Doar unit tests
./test.sh e2e      # Doar browser tests (Playwright)
./test.sh oracle   # Doar Oracle integration

Dual Database

Oracle - date ERP (ARTICOLE_TERTI, NOM_ARTICOLE, COMENZI)
SQLite - tracking local (sync_runs, import_orders, missing_skus, scheduler_config)

Logging

Log files in ../logs/sync_comenzi_YYYYMMDD_HHMMSS.log Format: 2026-03-11 14:30:25 | INFO | app.services.sync_service | mesaj

2.3 KiB Raw Blame History