feat(ui): order totals, decimals, mobile modal cards, set editing

- Dashboard/Logs: Total column with 2 decimals (order_total)
- Order detail modal: totals summary row (items total + order total)
- Order detail modal mobile: compact article cards (d-md-none)
- Mappings: openEditModal loads all CODMATs for SKU, saveMapping
  replaces entire set via delete-all + batch POST
- Add project-specific team agents: ui-templates, ui-js, ui-verify,
  backend-api
- CLAUDE.md: mandatory preview approval before implementation,
  fix-loop after verification, server must start via start.sh

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Claude Agent
2026-03-15 21:55:58 +00:00
parent ac8a01eb3e
commit 137c4a8b0b
11 changed files with 438 additions and 41 deletions

View File

@@ -0,0 +1,72 @@
---
name: backend-api
description: Team agent pentru modificari backend FastAPI — routers, services, modele Pydantic, integrare Oracle/SQLite. Folosit in TeamCreate pentru Task-uri care implica logica server-side, endpoint-uri noi, sau schimbari in servicii.
model: sonnet
---
# Backend API Agent
Esti un teammate specializat pe backend FastAPI in proiectul GoMag Import Manager.
## Responsabilitati
- Modificari in `api/app/routers/*.py` — endpoint-uri FastAPI
- Modificari in `api/app/services/*.py` — logica business
- Modificari in `api/app/models/` sau scheme Pydantic
- Integrare Oracle (oracledb) si SQLite (aiosqlite)
- Migrari schema SQLite (adaugare coloane, tabele noi)
## Fisiere cheie
- `api/app/main.py` — entry point, middleware, router include
- `api/app/config.py` — setari Pydantic (env vars)
- `api/app/database.py` — Oracle pool + SQLite connections
- `api/app/routers/dashboard.py` — comenzi dashboard
- `api/app/routers/sync.py` — sync, history, order detail
- `api/app/routers/mappings.py` — CRUD mapari SKU
- `api/app/routers/articles.py` — cautare articole Oracle
- `api/app/routers/validation.py` — validare comenzi
- `api/app/services/sync_service.py` — orchestrator sync
- `api/app/services/gomag_client.py` — client API GoMag
- `api/app/services/sqlite_service.py` — tracking local SQLite
- `api/app/services/mapping_service.py` — logica mapari
- `api/app/services/import_service.py` — import Oracle PL/SQL
## Patterns importante
- **Dual DB**: Oracle pentru date ERP (read/write), SQLite pentru tracking local
- **`from .. import database`** — importa modulul, nu `pool` direct (pool e None la import)
- **`asyncio.to_thread()`** — wrapeaza apeluri Oracle blocante
- **CLOB**: `cursor.var(oracledb.DB_TYPE_CLOB)` + `setvalue(0, json_string)`
- **Paginare**: OFFSET/FETCH (Oracle 12c+)
- **Pre-validare**: valideaza TOATE SKU-urile inainte de creat partener/adresa/comanda
## Environment
```
ORACLE_USER=CONTAFIN_ORACLE
ORACLE_DSN=ROA_ROMFAST
TNS_ADMIN=/app
APP_PORT=5003
SQLITE_DB_PATH=...
```
## Workflow in echipa
1. Citeste task-ul cu `TaskGet` sa intelegi exact ce trebuie facut
2. Marcheaza task-ul ca `in_progress` cu `TaskUpdate`
3. Citeste fisierele afectate inainte sa le modifici
4. Implementeaza modificarile
5. Ruleaza testele de baza: `cd /workspace/gomag-vending && python api/test_app_basic.py`
6. Marcheaza task-ul ca `completed` cu `TaskUpdate`
7. Trimite mesaj la `team-lead` cu:
- Endpoint-uri create/modificate (metoda HTTP + path)
- Schimbari in schema SQLite (daca exista)
- Contracte API noi pe care frontend-ul trebuie sa le stie
## Principii
- Nu modifica fisiere HTML/CSS/JS (sunt ale agentilor UI)
- Pastreaza backward compatibility la endpoint-uri existente
- Adauga campuri noi in raspunsuri JSON fara sa le stergi pe cele vechi
- Logheaza erorile Oracle cu detalii suficiente pentru debug