How thunderskull7/verifygrid works
VerifyGrid is a web platform for reconciling uploaded datasets, investigating discrepancies, recording review decisions, and producing cryptographically verifiable audit history. Auditors authenticate, select a project, upload and profile files, configure mappings and rules, run verification, then inspect, review, sign off, and export results; supervisors provide independent approval. The graph preserves major documented capabilities, but several route and service implementations were not sampled, so uncertain links are shown as unverified rather than asserted.
Main entry points: verification_engine.py Verification engine · router.py API router · api.ts Typed API client · App.tsx Workspace UI
Components 31
Auditor interface
- Workspace UI
frontend/src/App.tsx - Authentication UI
frontend/src/components/AuthScreen.tsx - Reconciliation wizard
frontend/src/components/ReconciliationWizard.tsx - Results inspector
frontend/src/components/VerificationResultsView.tsx - Review controls
frontend/src/components/BulkReviewModal.tsx - Audit history
frontend/src/components/AuditHistoryView.tsx - Typed API client
frontend/src/services/api.ts - Auth context
frontend/src/context/AuthContext.tsx
API and governance
- API router
backend/app/api/v1/router.py - Authentication routes
backend/app/api/v1/endpoints/auth.py - Verification routes
backend/app/api/v1/endpoints/verification.py - Review routes
backend/app/api/v1/endpoints/review.py - Audit routes
backend/app/api/v1/endpoints/audit.py - Upload and profiling routes
backend/app/api/v1/endpoints/uploads.py - Auth and project guards
backend/app/api/deps.py
Reconciliation services
- Streaming ingestion
backend/app/services/ingestion.py - Dataset profiling
backend/app/services/profiling_service.py - Preprocessing
backend/app/services/preprocessing.py - Verification engine
backend/app/services/verification_engine.py - Rule evaluation
backend/app/services/rule_engine.py - Payment aggregation
backend/app/services/aggregation_engine.py - Financial materiality
backend/app/services/materiality_engine.py - Exception clustering
backend/app/services/clustering_service.py - Review decisions
backend/app/services/review_service.py - Chained audit logging
backend/app/services/audit_service.py - Report export
backend/app/services/export_service.py
Persistent records
- Database sessions
backend/app/db/session.py - Verification records
backend/app/models/verification_run.py - User records
backend/app/models/user.py
Other components
- Auditor / Supervisor
- SQL database
Connections 38
- Auditor / Supervisor → Workspace UI: uses
- Workspace UI → Authentication UI: renders
frontend/src/App.tsx - Workspace UI → Reconciliation wizard: renders
frontend/src/App.tsx - Workspace UI → Audit history: renders
frontend/src/App.tsx - Authentication UI → Typed API client: authenticates through
frontend/src/components/AuthScreen.tsx - Auth context → Typed API client: manages token
frontend/src/context/AuthContext.tsx - Reconciliation wizard → Typed API client: requests reconciliation
frontend/src/components/ReconciliationWizard.tsx - Reconciliation wizard → Results inspector: shows outcomes
- Results inspector → Review controls: opens review
- Review controls → Typed API client: submits decisions
frontend/src/components/BulkReviewModal.tsx - Audit history → Typed API client: requests history
- Typed API client → API router: calls API
- API router → Authentication routes: registers routes
backend/app/api/v1/router.py - API router → Verification routes: registers routes
backend/app/api/v1/router.py - API router → Review routes: registers routes
backend/app/api/v1/router.py - API router → Audit routes: registers routes
backend/app/api/v1/router.py - API router → Upload and profiling routes: registers routes
backend/app/api/v1/router.py - Authentication routes → Auth and project guards: uses dependencies
backend/app/api/v1/endpoints/auth.py - Review routes → Auth and project guards: uses dependencies
backend/app/api/v1/endpoints/review.py - Review routes → Exception clustering: calls
backend/app/api/v1/endpoints/review.py - Review routes → Review decisions: calls
backend/app/api/v1/endpoints/review.py - Audit routes → Chained audit logging: calls
backend/app/api/v1/endpoints/audit.py - Upload and profiling routes → Streaming ingestion: handles files
- Verification routes → Verification engine: runs checks
- Verification engine → Preprocessing: uses
backend/app/services/verification_engine.py - Verification engine → Dataset profiling: uses
backend/app/services/verification_engine.py - Verification engine → Rule evaluation: evaluates rules
backend/app/services/verification_engine.py - Verification engine → Payment aggregation: reconciles allocations
backend/app/services/verification_engine.py - Verification engine → Financial materiality: calculates exposure
backend/app/services/verification_engine.py - Verification engine → Exception clustering: groups exceptions
backend/app/services/verification_engine.py - Review decisions → Chained audit logging: records decisions
backend/app/services/review_service.py - Verification routes → Report export: exports reports
- Database sessions → SQL database: opens sessions
backend/app/db/session.py - Authentication routes → User records: reads users
backend/app/api/v1/endpoints/auth.py - Audit routes → SQL database: queries audit data
backend/app/api/v1/endpoints/audit.py - Review decisions → Verification records: updates run state
backend/app/services/review_service.py - Verification engine → Verification records: persists outcomes
backend/app/services/verification_engine.py - Chained audit logging → SQL database: writes audit events