Files
gomag-vending/api
Claude Agent bb6f3a3b87 feat(sync): /api/sync/health endpoint + dashboard health pill + MALFORMED UI
Backend:
- GET /api/sync/health returns {last_sync_at, last_sync_status,
  last_halt_reason, recent_phase_failures, escalation_phase, is_healthy}.
  healthy when last run was completed (or none yet), no phase has
  tripped the 3-in-a-row escalation, and recent failures <= 1.
- Dashboard + run-level endpoints include `malformed` count so the
  Defecte pill can render.

Frontend:
- Health pill in .sync-card-controls with three states — healthy
  (success green, check icon), warning (amber, triangle), escalated
  (error red, x-octagon + glow). Tooltip exposes the halt reason and
  the top phases with recent failures.
- Status-dot + badge add MALFORMED treatment via --compare orange,
  distinct from ERROR red. DESIGN.md notes the diagnostic rationale
  (ERROR = runtime, MALFORMED = payload source issue).
- Defecte filter pill on dashboard + logs pages. Mobile segmented
  control includes Defecte count. Counts wired to the malformed key.
- startSync() shows a native confirm modal when state is
  halted_escalation — operator override still possible, not silenced.
- ORDER_STATUS.MALFORMED mirror added to shared.js.
- Cache-bust: style.css v46, shared.js v47, dashboard.js v52,
  logs.js v16.

5 endpoint tests cover empty state, completed, failed, escalated,
single-failure warning. Full CI: 257 unit + 33 e2e green.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-22 09:14:46 +00:00
..

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