Axios RIC — Ricostruzione Carriera Scuola

Modernizzazione dell'applicativo RIC (Ricostruzione Carriera del personale della scuola) dal gestionale legacy PowerBuilder + Sybase SQL Anywhere verso stack moderno, con il motore di calcolo riconvertito e validato contro i risultati storici.

Contenuto del repository

Percorso	Cosa contiene
Ric/, lib/	Sorgenti originali PowerBuilder (.srw/.srd/.sru/.srf/.srm/.srs)
rocchi.zip	Archivio originale dell'export PowerBuilder
server/	Backend TypeScript (Express + Knex + mysql2) — API e motore di calcolo (src/engine/)
client/	Frontend React (Refine + Ant Design + Vite)
build/screens/	Specifiche schermate generate dai .srd (metadati per la webapp)
build/*.sql, build/*.csv	Schema MariaDB e inventari della migrazione
tools/	Script di migrazione (SQL Anywhere → MariaDB), screenshot, PDF
Analisi-RIC-*.pdf, *.md	Analisi funzionale/tecnica e note di handover

Non versionati (vedi .gitignore): node_modules/ e client/dist/ (rigenerabili), e gli artefatti binari di migrazione da alcuni GB (installer ASA9, copie di EDSGU.db, export grezzi). Se serve versionarli, si usa Git LFS.

Il motore di calcolo

Convertito da ~19.000 righe di PowerScript in TypeScript (server/src/engine/), validato riga per riga contro il golden in ric_full:

• Anzianità (ue_anz 601/602) — 59/60 gruppi · Inquadramento (ue_inq 801/802/901/902) — 59/59
• Importi DPR (4 regimi) — 1045 celle · Stipendio base CCNL (3 regimi) — 328/328 · Totale CCNL 2011 — 189/189

Runner di validazione: cd server && npm run engine:check.

Avvio (sviluppo)

# backend (porta 3350) — richiede MariaDB con database ric_full
cd server && npm install
DB_USER=ric_app DB_PASSWORD=ric_app_dev npx tsx watch src/index.ts

# frontend (porta 5200)
cd client && npm install && npx vite --port 5200

Deploy

Documentato a parte: servizi systemd (ric-server :3350, ric-client :5200) su server Debian/LXC, con MariaDB locale (ric_full, subset delle tabelle RIC).