How cs778-s2-2026-aws-challenge/scenario-08-northwind-fnol-agent works
Northwind FNOL Agent supports a claimant’s loss report through evidence capture, claim progression, and next-step planning, with staff taking over ambiguity or high-impact decisions using shared claim context. The backend separates HTTP transport, domain rules, application services, persistence ports, and replaceable adapters. Claimants, claims professionals, operations, and administrators use distinct frontends; administration governs runtime configuration, knowledge, integrations, evaluation, and operations. Edges rely on README architecture and workflow statements or shown frontend routing and calls; unsampled backend wiring is not inferred.
Main entry points: services Use-case services · src/App.jsx Control Plane · api HTTP transport · src/App.jsx Claimant app
Components 22
Claimant experience
- Claimant app
customer/src/App.jsx - Claim API
customer/src/api.js
Staff workbench
- Claims workbench
workbench/src/App.jsx
Claim runtime
- Claim workflow
backend/services/agent.py - Claim state
backend/domain/models.py - Evidence handling
backend/domain/evidence.py - HTTP transport
backend/api - Application runtime
backend/app.py - Use-case services
backend/services - Persistence ports
backend/repositories/protocols.py - MongoDB storage
backend/repositories/mongodb.py - Evidence storage
backend/adapters/evidence_storage.py - External services
backend/services/external_services.py - Claims adapter
backend/adapters/claims_service.py - Knowledge retrieval
backend/domain/retrieval.py
Control plane
- Control Plane
admin/src/App.jsx - Admin API
backend/api/admin.py - Operations and audit
backend/domain/audit.py - Evaluations
backend/domain/evaluation.py
Other components
- Claimant
- Claims professional
- Administrator
Connections 20
- Claimant → Claimant app: reports loss
README.md - Claimant app → Claim API: requests claim data
customer/src/App.jsx - Claim API → HTTP transport: sends requests
README.md - HTTP transport → Application runtime: routes HTTP
README.md - Application runtime → Use-case services: coordinates use cases
README.md - Use-case services → Claim workflow: runs agent
backend/services/turn_reducer.py - Claim workflow → Claim state: progresses claim
- Use-case services → Persistence ports: uses persistence
README.md - Persistence ports → MongoDB storage: persists state
- Use-case services → Evidence storage: stores evidence
backend/services/integrations.py - Use-case services → External services: coordinates handoff
backend/services/external_services.py - External services → Claims adapter: dispatches service
backend/services/external_services.py - Use-case services → Knowledge retrieval: retrieves knowledge
backend/services/integrations.py - Claims professional → Claims workbench: reviews work
README.md - Claims workbench → HTTP transport: uses shared claim state
README.md - Administrator → Control Plane: governs runtime
README.md - Control Plane → Admin API: manages configuration
admin/src/App.jsx - Control Plane → Knowledge retrieval: manages knowledge
admin/src/App.jsx - Control Plane → Evaluations: reviews evaluations
admin/src/App.jsx - Control Plane → Operations and audit: inspects operations
admin/src/App.jsx