How nirmal-aim/trinetra works
TRINETRA is a web platform for volumetric cadastral registration and vertical-property intelligence. Government users authenticate, ingest survey evidence, and follow a documented capture-to-registration workflow: preprocessing, floor extraction, candidate generation, optimization, mandatory validation, then ULPIN/passport issuance. Registered properties support GIS viewing, subsurface utilities, encroachment review, and temporal change detection; assistant queries and audit logs are separate capabilities. The backend pipeline excerpt shows candidate creation, QAOA, validation, and minting, but does not expose every API-to-service call. Other subsystem links follow the README’s documented responsibilities.
Main entry points: main.py FastAPI app · models.py Property records · pipeline_service.py Property pipeline · App.tsx Web app
Components 22
Web application
- Web app
trinetra/src/App.tsx - Evidence intake
trinetra/src/screens/DataIngestion/DataIngestion.tsx - API client
trinetra/src/services/api.ts - City cadastre data
trinetra/src/data/realCityCadastreData.ts - Public verification
trinetra/src/pages/PublicVerifyPage.tsx
Backend API
- FastAPI app
backend/app/main.py - Authentication
backend/app/api/auth.py - Dataset intake
backend/app/api/datasets.py
Cadastral workflow
- Preprocessing
backend/app/api/preprocessing.py - Floor extraction
backend/app/api/extraction.py - Volume candidates
backend/app/api/candidates.py - Property pipeline
backend/app/services/pipeline_service.py - QUBO / QAOA
backend/app/services/qaoa_service.py - Cadastral validation
backend/app/services/validation_service.py - ULPIN / passport
backend/app/services/ulpin_service.py
Property records
- Database sessions
backend/app/database.py - Property records
backend/app/models/models.py
Spatial operations
- GIS properties
backend/app/api/gis.py - Spatial monitoring
backend/app/api/spatial.py - GIS assistant
backend/app/api/assistant.py - Audit logs
backend/app/api/audit.py
Other components
- Government user
Connections 25
- Government user → Web app: uses
- Web app → Evidence intake: routes to
- Web app → Public verification: routes to
- Evidence intake → API client: requests data
- API client → FastAPI app: calls REST API
- FastAPI app → Authentication: mounts router
- FastAPI app → Dataset intake: mounts router
- FastAPI app → Preprocessing: mounts router
- FastAPI app → Floor extraction: mounts router
- FastAPI app → Volume candidates: mounts router
- FastAPI app → GIS properties: mounts router
- FastAPI app → Spatial monitoring: mounts router
- FastAPI app → GIS assistant: mounts router
- FastAPI app → Audit logs: mounts router
- Dataset intake → Property pipeline: ingests evidence
- Property pipeline → QUBO / QAOA: builds and runs
- Property pipeline → Cadastral validation: validates candidate
- Property pipeline → ULPIN / passport: issues identifier
- Property pipeline → Property records: creates records
- Authentication → Property records: reads users
- Database sessions → Property records: maps records
- GIS properties → Property records: reads property data
- Spatial monitoring → Property records: reads spatial records
- Audit logs → Property records: reads audit records
- City cadastre data → Web app: provides map data