How wassimkraiem243/claimguardai works
ClaimGuard AI turns uploaded healthcare claims into normalized envelopes, validates them against 15 payer rules, and presents results for human review. The Phase 1 UI drives ingestion and validation through the FastAPI API; the engine records auditable outcomes. Separate dashboard and findings capabilities support seeded findings and optional Ollama explanations. The sampled sources show the core ingestion, validation, audit, and UI calls; unsampled dashboard and findings wiring is shown only where documented, with uncertain links omitted.
Main entry points: engine.py Rule engine · validation.py Validation route · phase1-api.ts Web API client · ingest_claim.py Ingestion use case
Components 21
User experience
- Phase 1 flow
apps/web/components/PreSubmissionFlow.tsx - Web API client
apps/web/lib/phase1-api.ts
API workflows
- FastAPI application
apps/api/app/main.py - Claim ingestion route
apps/api/app/routers/claims.py - Ingestion use case
apps/api/app/services/ingest_claim.py - Format parsers
apps/api/app/infrastructure/parsers - Envelope mapping
apps/api/app/mappers/normalizer.py - Normalized claim
apps/api/app/domain/normalized_claim.py - Validation route
apps/api/app/routers/validation.py - Validation service
apps/api/app/services/rule_validation.py
Validation engine
- Rule engine
apps/api/app/infrastructure/rule_engine/core/engine.py - Claim context
apps/api/app/infrastructure/rule_engine/core/context.py - R001–R015 rules
apps/api/app/infrastructure/rule_engine/rules - Policy store
apps/api/app/infrastructure/rule_engine/stores/policy_store.py
Insights and state
- Audit adapter
apps/api/app/infrastructure/rule_engine/audit_hook.py - Audit log
apps/api/app/infrastructure/audit_log.py - Findings and analysis
apps/api/app/routers/findings.py - Ollama analysis
apps/api/app/infrastructure/ollama.py - Dashboard and metrics
apps/api/app/routers/dashboard.py - Application storage
apps/api/app/repositories/store.py
Other components
- Claim reviewer
Connections 20
- Claim reviewer → Phase 1 flow: uses
README.md - Phase 1 flow → Web API client: requests
apps/web/components/PreSubmissionFlow.tsx - Web API client → Claim ingestion route: uploads claims
README.md - Web API client → Validation route: submits envelope
README.md - FastAPI application → Claim ingestion route: registers
apps/api/app/main.py - FastAPI application → Validation route: registers
apps/api/app/main.py - Claim ingestion route → Ingestion use case: ingests upload
- Ingestion use case → Format parsers: selects parser
apps/api/app/services/ingest_claim.py - Format parsers → Envelope mapping: normalizes claim
apps/api/app/infrastructure/parsers/pack_fhir_parser.py - Ingestion use case → Normalized claim: returns claims
apps/api/app/services/ingest_claim.py - Validation route → Audit adapter: audits validation
apps/api/app/routers/validation.py - Validation route → Validation service: delegates validation
apps/api/app/routers/validation.py - Validation service → Rule engine: validates claim
apps/api/app/routers/validation.py - Audit adapter → Rule engine: runs validation
apps/api/app/infrastructure/rule_engine/audit_hook.py - Rule engine → Claim context: builds context
apps/api/app/infrastructure/rule_engine/core/engine.py - Rule engine → Policy store: loads policy
apps/api/app/infrastructure/rule_engine/core/engine.py - Rule engine → R001–R015 rules: dispatches rules
apps/api/app/infrastructure/rule_engine/core/engine.py - Audit adapter → Audit log: writes audit events
apps/api/app/infrastructure/rule_engine/audit_hook.py - Findings and analysis → Ollama analysis: explains findings
- Dashboard and metrics → Application storage: reads dashboard data