How dpkb-dev/springai-med-qa works
This is a Spring Boot medical consultation and claims-assessment backend. Its primary workflow accepts a patient chat request, builds session-aware context, streams an LLM response with scoped medical RAG, and retains conversation memory; REST endpoints also manage sessions and RAG documents. Separate claims workflows assess policy clauses and consistency, and evaluate underwriting eligibility. The graph preserves these documented capabilities and the shared security, persistence, audit, and rate-limit layers. Arrows are limited to relationships visible in excerpts, SOURCE INDEX references, or README statements; unsampled wiring is omitted.
Main entry points: MedChatSessionService.java Session management · ClaimProcessingService.java Claim orchestration · MedRetrievalService.java Scoped retrieval · ChatStreamService.java Chat streaming
Components 28
API and workflows
- Chat API
src/main/java/com/med/qa/controller/ChatController.java - Session API
src/main/java/com/med/qa/controller/SessionController.java - Chat streaming
src/main/java/com/med/qa/service/ChatStreamService.java
Medical RAG
- RAG administration
src/main/java/com/med/qa/controller/RagAdminController.java - Document ingestion
src/main/java/com/med/qa/rag/MedDocumentService.java - Scoped retrieval
src/main/java/com/med/qa/rag/MedRetrievalService.java - RAG advisor
src/main/java/com/med/qa/rag/MedRagAdvisorFactory.java - Vector store
Session memory
- Session management
src/main/java/com/med/qa/service/MedChatSessionService.java - Chat memory repository
src/main/java/com/med/qa/memory/MedSpringAiChatMemoryRepository.java - Memory storage adapter
src/main/java/com/med/qa/memory/repository/MedChatMemoryRepository.java - Redis message cache
src/main/java/com/med/qa/memory/cache/RedisMessageCache.java - Session lock
src/main/java/com/med/qa/memory/lock/SessionLockService.java - MySQL session store
src/main/java/com/med/qa/mapper/ChatSessionMapper.java
Claims and underwriting
- Claims APIs
src/main/java/com/med/qa/controller/ClaimsController.java - Claim assessment API
src/main/java/com/med/qa/controller/ClaimAssessmentController.java - Claim orchestration
src/main/java/com/med/qa/service/claims/ClaimProcessingService.java - Consistency review
src/main/java/com/med/qa/service/claims/ClaimConsistencyService.java - Claim eligibility
src/main/java/com/med/qa/service/claims/ClaimEligibilityService.java - Policy eligibility API
src/main/java/com/med/qa/controller/PolicyEligibilityController.java - Underwriting rules
src/main/java/com/med/qa/service/underwriting/PolicyEligibilityService.java - Declared conditions
src/main/java/com/med/qa/mapper/DeclaredConditionMapper.java
Shared platform
- Authentication and access
src/main/java/com/med/qa/security/ApiKeyAuthFilter.java - Operation auditing
src/main/java/com/med/qa/service/AuditService.java - Rate limiting
src/main/java/com/med/qa/common/ratelimit/RateLimitService.java - API errors and results
src/main/java/com/med/qa/common/exception/GlobalExceptionHandler.java
Other components
- Patient or staff
- Chat model
Connections 26
- Patient or staff → Chat API: submits chat
README.md - Chat API → Chat streaming: streams through
src/main/java/com/med/qa/controller/ChatController.java - Chat streaming → RAG advisor: adds advisor
src/main/java/com/med/qa/service/ChatStreamService.java - Chat streaming → Chat model: streams prompt
src/main/java/com/med/qa/service/ChatStreamService.java - RAG advisor → Scoped retrieval: retrieves context
- Scoped retrieval → Vector store: searches vectors
src/main/java/com/med/qa/rag/MedRetrievalService.java - RAG administration → Document ingestion: ingests or deletes
src/main/java/com/med/qa/controller/RagAdminController.java - RAG administration → Scoped retrieval: previews search
src/main/java/com/med/qa/controller/RagAdminController.java - Document ingestion → Vector store: writes documents
src/main/java/com/med/qa/rag/MedDocumentService.java - Patient or staff → Session API: manages sessions
- Session API → Session management: delegates session work
src/main/java/com/med/qa/controller/SessionController.java - Session management → MySQL session store: reads and writes
src/main/java/com/med/qa/service/MedChatSessionService.java - Session management → Redis message cache: uses cache
src/main/java/com/med/qa/service/MedChatSessionService.java - Session management → Session lock: locks mutations
src/main/java/com/med/qa/service/MedChatSessionService.java - Chat memory repository → Memory storage adapter: delegates storage
src/main/java/com/med/qa/memory/MedSpringAiChatMemoryRepository.java - Claims APIs → Claim orchestration: orchestrates claims
- Claim assessment API → Claim orchestration: requests assessment
- Claim orchestration → Consistency review: delegates consistency
src/main/java/com/med/qa/service/claims/ClaimProcessingService.java - Claim orchestration → Claim eligibility: delegates eligibility
src/main/java/com/med/qa/service/claims/ClaimProcessingService.java - Claim eligibility → Scoped retrieval: retrieves policy clauses
src/main/java/com/med/qa/service/claims/ClaimEligibilityService.java - Claim eligibility → Chat model: extracts clause facts
src/main/java/com/med/qa/service/claims/ClaimEligibilityService.java - Consistency review → Chat model: extracts document facts
src/main/java/com/med/qa/service/claims/ClaimConsistencyService.java - Policy eligibility API → Underwriting rules: checks eligibility
- Claim orchestration → Underwriting rules: delegates policy check
src/main/java/com/med/qa/service/claims/ClaimProcessingService.java - Underwriting rules → Declared conditions: loads declarations
src/main/java/com/med/qa/service/underwriting/PolicyEligibilityService.java - Session management → Operation auditing: marks audited action
src/main/java/com/med/qa/service/MedChatSessionService.java