How crown-commercial-service/ccs-scale-cat-service works
This is the Spring Boot Tenders API used by the Government Commercial Agency’s Contract Award Service. Its broad workflow is API requests for procurement and assessment operations, followed by domain processing, persistence or external-service interaction, and API responses. The tree shows distinct procurement, assessment, document, search, and OCDS capabilities. Evidence is uneven: excerpts support several service-to-dependency relationships, while most controller wiring and unsampled services are represented only as subsystem nodes, without asserted call chains.
Main entry points: DocumentUploadService.java Document uploads · MultiStageEventService.java Multi-stage events · AgreementsService.java Agreement service · AssessmentsController.java Assessment routes
Components 28
API access
- Assessment routes
src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java - Tender routes
src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/TendersController.java - Q&A routes
src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/QuestionAndAnswerController.java - Search routes
src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/SearchSessionController.java
Procurement lifecycle
- Procurement events
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementEventService.java - Procurement projects
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementProjectService.java - Multi-stage events
src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java - OCDS releases
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ocds - Search sessions
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java - Session cleanup
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java
Assessment
- Assessment calculation
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentCalculationService.java - Assessment criteria
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentDimensionCriteriaService.java - Scoring algorithms
src/main/java/uk/gov/crowncommercial/dts/scale/cat/assessment - G-Cloud assessment
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java
Integrations and data
- Document uploads
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java - Jaggaer client
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java - Agreement service
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java - Conclave service
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java - Q&A client
src/main/java/uk/gov/crowncommercial/dts/scale/cat/clients/QuestionAndAnswerClient.java - Tenders database
src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/RetryableTendersDBDelegate.java - Search session store
src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/SearchFilterSessionRepository.java - Document metadata
src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo
Other components
- API client
- Document upload service
- S3 storage
- Jaggaer
- Agreements service
- Conclave
Connections 21
- API client → Assessment routes: requests
- API client → Tender routes: requests
- API client → Q&A routes: requests
- API client → Search routes: requests
- Assessment routes → Assessment calculation: dispatches
- Tender routes → Procurement events: dispatches
- Q&A routes → Q&A client: uses
- Search routes → Search sessions: dispatches
- Assessment calculation → Scoring algorithms: uses
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentService.java - G-Cloud assessment → Tenders database: saves results
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java - Multi-stage events → Jaggaer client: retrieves suppliers
src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java - Multi-stage events → Tenders database: saves event
src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java - Agreement service → Q&A client: requests templates
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java - Document uploads → Document upload service: uploads document
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java - Document uploads → S3 storage: copies document
- Document uploads → Document metadata: stores metadata
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java - Search sessions → Search session store: reads and writes
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java - Session cleanup → Search session store: cleans sessions
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java - Jaggaer client → Jaggaer: calls API
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java - Conclave service → Conclave: retrieves profiles
src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java - Agreement service → Agreements service: requests data