How excelyynxl-a11y/fn-key works
SDOC is an explainable shipping-document verification system. Operators start asynchronous inbox runs, inspect classifications and SI/BL comparisons, resolve uncertain cases, manage learned knowledge, and validate or export results. The documented processing stages run from email classification through attachment parsing, document-role detection, field extraction, normalization, and deterministic comparison; selective AI fallback supports unresolved work. The README documents MongoDB persistence and the broad workflow, while sampled source confirms key UI requests, API routing, pipeline dependencies, and review handling; some subsystem links rely on README documentation because their implementations were not sampled.
Main entry points: pipelineService.js Email processing pipeline · reviewService.js Review handling · runService.js Run orchestration · runController.js Run controller
Components 27
Operations dashboard
- Operations dashboard
client/src/pages/LandingPage.jsx - API client
client/src/services/api.js
API and workflow
- Express API
server/src/app.js - Run controller
server/src/controllers/runController.js - Review controller
server/src/controllers/reviewController.js - Knowledge controller
server/src/controllers/knowledgeController.js - Run orchestration
server/src/services/runService.js - Inbox dataset
server/src/repositories/datasetRepository.js
Verification pipeline
- Email processing pipeline
server/src/services/pipelineService.js - Adaptive classification
server/src/services/adaptiveClassificationService.js - Attachment parsing
server/src/services/fileParserService.js - Document role detection
server/src/services/documentTypeService.js - Field extraction
server/src/services/fieldExtractionService.js - Field normalization
server/src/services/normalizationService.js - Deterministic comparison
server/src/services/comparisonService.js - Structured AI fallback
server/src/services/documentAiService.js
Review and learning
- Review handling
server/src/services/reviewService.js - Knowledge and learning
server/src/services/knowledgeService.js
Persistence and outputs
- Run metrics
server/src/services/metricsService.js - Submission export
server/src/services/submissionService.js - Email results
server/src/models/Email.js - Processing runs
server/src/models/ProcessingRun.js - Review cases
server/src/models/ReviewCase.js - Audit history
server/src/models/AuditEvent.js
Other components
- Operations user
- MongoDB
- OpenAI API
Connections 37
- Operations user → Operations dashboard: operates
README.md - Operations dashboard → API client: requests through
client/src/pages/LandingPage.jsx - API client → Express API: sends HTTP
client/src/services/api.js - Express API → Run controller: routes runs
server/src/app.js - Express API → Review controller: routes reviews
server/src/app.js - Express API → Knowledge controller: routes knowledge
server/src/app.js - Run controller → Run orchestration: starts runs
server/src/controllers/runController.js - Run orchestration → Inbox dataset: loads dataset
server/src/services/runService.js - Run orchestration → Email processing pipeline: processes emails
server/src/services/runService.js - Email processing pipeline → Adaptive classification: classifies
server/src/services/pipelineService.js - Email processing pipeline → Attachment parsing: parses attachments
server/src/services/pipelineService.js - Email processing pipeline → Document role detection: identifies roles
server/src/services/pipelineService.js - Email processing pipeline → Field extraction: extracts fields
server/src/services/pipelineService.js - Email processing pipeline → Field normalization: normalizes fields
server/src/services/pipelineService.js - Email processing pipeline → Deterministic comparison: compares documents
server/src/services/pipelineService.js - Email processing pipeline → Structured AI fallback: falls back to AI
server/src/services/pipelineService.js - Structured AI fallback → OpenAI API: requests structured output
README.md - Run orchestration → Email results: persists results
README.md - Run orchestration → Processing runs: tracks run state
README.md - Run orchestration → Review handling: routes exceptions
README.md - Review controller → Review handling: resolves and retries
server/src/controllers/reviewController.js - Review handling → Email processing pipeline: reprocesses corrections
server/src/services/reviewService.js - Review handling → Review cases: updates cases
server/src/services/reviewService.js - Review handling → Email results: updates reviewed email
server/src/services/reviewService.js - Review handling → Audit history: records decisions
server/src/services/reviewService.js - Review handling → Knowledge and learning: learns phrases
server/src/services/reviewService.js - Knowledge controller → Knowledge and learning: manages knowledge
server/src/controllers/knowledgeController.js - Run controller → Run metrics: gets metrics
server/src/controllers/runController.js - Run controller → Submission export: builds export
server/src/controllers/runController.js - Run controller → Email results: reads results
server/src/controllers/runController.js - Run metrics → Email results: reads email state
server/src/services/metricsService.js - Run metrics → Processing runs: reads run state
server/src/services/metricsService.js - Run metrics → Review cases: reads review state
server/src/services/metricsService.js - Email results → MongoDB: persists in
README.md - Processing runs → MongoDB: persists in
README.md - Review cases → MongoDB: persists in
README.md - Audit history → MongoDB: persists in
README.md