How shruthik2307/landsync works
LANDSYNC synchronizes cadastral, municipal, and satellite-derived land data, reconciles parcels, and presents results for review. The main workflow is user upload, document parsing, reconciliation, and result inspection. The frontend is a React client; the README describes a single FastAPI service serving both the SPA and /api/*. Major documented capabilities include interactive parcel and imagery maps, conflict review, provenance, labeling, and exports. Some backend route implementations and UI screens were not sampled, so their internal connections are omitted unless documented or indexed.
Main entry points: main.py FastAPI application · landsync_service.py Dataset and reconciliation service · App.jsx Application flow · ResultView.jsx Results and review
Components 22
Frontend
- Application flow
src/App.jsx - Upload screen
src/components/screens/UploadScreen.jsx - API client
src/api.js
API and ingestion
- FastAPI application
backend/main.py - Upload endpoint
backend/routes/upload.py - Document parsing
backend/ingestion/router.py - Canonical parcel model
backend/ingestion/models.py - Conflict, parcel, and process routes
backend/routes - Export routes
backend/routes/export.py
Reconciliation
- Dataset and reconciliation service
backend/services/landsync_service.py - Reconciliation pipeline
engine/pipeline.py - Matching and conflict analysis
engine - TGRAC data integration
backend/services/tgrac_service.py - ML scoring service
backend/services/ml_service.py
Review and imagery
- Results and review
src/components/screens/ResultView.jsx - Parcel and imagery maps
src/components/gis/LandsyncMap.jsx - Provenance display
src/components/result/Provenance.jsx - Imagery services and routes
backend/services/imagery_service.py - Labeling and provenance routes
backend/routes/labeling.py
Platform services
- Authentication routes
backend/routes/auth.py - Database models and sessions
backend/database.py
Other components
- Land data user
Connections 20
- Land data user → Application flow: uses
- Application flow → Upload screen: renders
src/App.jsx - Upload screen → API client: submits data
- API client → FastAPI application: sends API requests
- FastAPI application → Upload endpoint: registers
backend/main.py - Upload endpoint → Document parsing: dispatches parsing
backend/routes/upload.py - Document parsing → Canonical parcel model: normalizes to
backend/ingestion/router.py - FastAPI application → Conflict, parcel, and process routes: registers
backend/main.py - Dataset and reconciliation service → Reconciliation pipeline: runs
backend/services/landsync_service.py - Reconciliation pipeline → Matching and conflict analysis: uses
engine/pipeline.py - Dataset and reconciliation service → ML scoring service: consults
backend/services/landsync_service.py - Dataset and reconciliation service → TGRAC data integration: loads TGRAC data
backend/services/landsync_service.py - FastAPI application → Imagery services and routes: registers imagery routes
- Application flow → Results and review: renders results
src/App.jsx - Results and review → Parcel and imagery maps: displays parcel map
- Results and review → Provenance display: displays provenance
- FastAPI application → Authentication routes: registers
backend/main.py - Authentication routes → Database models and sessions: queries users
backend/routes/auth.py - FastAPI application → Labeling and provenance routes: registers
backend/main.py - FastAPI application → Export routes: registers
backend/main.py