a659f3bafb
- 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>
62 lines
2.3 KiB
Markdown
62 lines
2.3 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
# INTOTDEAUNA via start.sh din project root (seteaza Oracle env vars)
|
|
cd .. && ./start.sh
|
|
```
|
|
|
|
## Testare
|
|
|
|
```bash
|
|
# 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`
|