How comune-di-montesilvano/utenzepa works
UtenzePA is a public-sector property, utilities, and accounting management system. Users work through the Angular application to manage real estate, technical plants, utility contracts and consumption, spending, invoices, and administrative acts; the NestJS API provides the application services backed by MySQL. Invoice intake from PEC/SDI and accounting imports are distinct workflows, alongside the separately scheduled TINN integration. The README establishes the frontend/API/database arrangement; sampled controllers and the source index support only selected internal call edges, so other feature links are left out.
Main entry points: job.py TINN import job · main.py TINN scheduler · app.ts Angular application · plants.service.ts Technical plants
Components 22
User Application
- Angular application
frontend/src/app/app.ts - Session and login
frontend/src/app/services/auth.service.ts
Property And Utilities
- Property and plants
backend/src/apis/asset - Technical plants
backend/src/apis/plants/plants.service.ts - Utilities and supply
backend/src/apis/utility-supply - Contracts and agreements
backend/src/apis/contracts - Third parties
backend/src/apis/third-parties - Administrative acts
backend/src/apis/acts
Finance And Imports
- Budget and commitments
backend/src/apis/budget-commitments - Invoices and payments
backend/src/apis/invoices/invoice.service.ts - PEC SDI intake
backend/src/apis/invoice-import - Accounting import
backend/src/apis/accounting-import/accounting-import.service.ts
API Platform
- NestJS API
backend/src/main.ts - Authentication
backend/src/apis/auth/auth.service.ts - Attachments and photos
backend/src/apis/attachments - Maps and geocoding
backend/src/apis/map - MySQL database
backend/src/core/database/mysql/mysql.module.ts
External Integrations
- TINN scheduler
tinn/app/main.py - TINN import job
tinn/app/job.py - LDAP / Active Directory
Other components
- Public-sector user
- PEC mailbox
Connections 12
- Public-sector user → Angular application: uses
README.md - Angular application → NestJS API: calls API
README.md - NestJS API → MySQL database: uses database
README.md - Authentication → LDAP / Active Directory: authenticates
backend/src/apis/auth/auth.service.ts - Invoices and payments → PEC SDI intake: gets documents
- Technical plants → Technical plants: serves plant requests
backend/src/apis/plants/plants.controller.ts - Utilities and supply → Utilities and supply: reconciles supply
backend/src/apis/utility-supply/utility-supply.controller.ts - TINN scheduler → TINN import job: runs job
tinn/app/main.py - TINN import job → TINN scheduler: uses inbox
tinn/app/job.py - TINN import job → TINN scheduler: extracts data
tinn/app/job.py - TINN import job → TINN scheduler: uses SFTP
tinn/app/job.py - PEC mailbox → PEC SDI intake: supplies invoices
README.md