# crown-commercial-service/ccs-scale-cat-service architecture

> Architecture diagram of the GitHub repository crown-commercial-service/ccs-scale-cat-service, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crown-commercial-service/ccs-scale-cat-service
- Repository: https://github.com/crown-commercial-service/ccs-scale-cat-service

## Overview

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: [`src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java`](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java) (Document uploads), [`src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java`](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java) (Multi-stage events), [`src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java`](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java) (Agreement service), [`src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java`](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java) (Assessment routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API access"]
  node_assess_api["Assessment routes"]
  node_tender_api["Tender routes"]
  node_qa_api["Q&amp;A routes"]
  node_search_api["Search routes"]
end

subgraph group_procurement["Procurement lifecycle"]
  node_procurement_service["Procurement events"]
  node_project_service["Procurement projects"]
  node_multi_stage["Multi-stage events"]
  node_ocds["OCDS releases"]
  node_search_service["Search sessions"]
  node_search_cleanup["Session cleanup"]
end

subgraph group_assessment["Assessment"]
  node_assessment_calc["Assessment calculation"]
  node_assessment_dims["Assessment criteria"]
  node_assessment_scoring["Scoring algorithms"]
  node_gcloud["G-Cloud assessment"]
end

subgraph group_integrations["Integrations and data"]
  node_doc_service["Document uploads"]
  node_jaggaer["Jaggaer client"]
  node_agreements["Agreement service"]
  node_conclave["Conclave service"]
  node_qanda_client["Q&amp;A client"]
  node_tenders_db[("Tenders database")]
  node_search_repo[("Search session store")]
  node_document_repo[("Document metadata")]
end

node_user(("API client"))
node_document_upload_api["Document upload service"]
node_s3[("S3 storage")]
node_jaggaer_system["Jaggaer"]
node_agreement_system["Agreements service"]
node_conclave_system["Conclave"]

node_user -.->|"requests"| node_assess_api
node_user -.->|"requests"| node_tender_api
node_user -.->|"requests"| node_qa_api
node_user -.->|"requests"| node_search_api
node_assess_api -.->|"dispatches"| node_assessment_calc
node_tender_api -.->|"dispatches"| node_procurement_service
node_qa_api -.->|"uses"| node_qanda_client
node_search_api -.->|"dispatches"| node_search_service
node_assessment_calc -->|"uses"| node_assessment_scoring
node_gcloud -.->|"saves results"| node_tenders_db
node_multi_stage -->|"retrieves suppliers"| node_jaggaer
node_multi_stage -->|"saves event"| node_tenders_db
node_agreements -->|"requests templates"| node_qanda_client
node_doc_service -->|"uploads document"| node_document_upload_api
node_doc_service -.->|"copies document"| node_s3
node_doc_service -.->|"stores metadata"| node_document_repo
node_search_service -->|"reads and writes"| node_search_repo
node_search_cleanup -->|"cleans sessions"| node_search_repo
node_jaggaer -->|"calls API"| node_jaggaer_system
node_conclave -->|"retrieves profiles"| node_conclave_system
node_agreements -.->|"requests data"| node_agreement_system

click node_assess_api "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java"
click node_tender_api "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/TendersController.java"
click node_qa_api "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/QuestionAndAnswerController.java"
click node_search_api "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/SearchSessionController.java"
click node_procurement_service "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementEventService.java"
click node_project_service "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementProjectService.java"
click node_multi_stage "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java"
click node_ocds "https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ocds"
click node_search_service "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java"
click node_search_cleanup "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java"
click node_assessment_calc "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentCalculationService.java"
click node_assessment_dims "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentDimensionCriteriaService.java"
click node_assessment_scoring "https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/assessment"
click node_gcloud "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java"
click node_doc_service "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java"
click node_jaggaer "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java"
click node_agreements "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java"
click node_conclave "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java"
click node_qanda_client "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/clients/QuestionAndAnswerClient.java"
click node_tenders_db "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/RetryableTendersDBDelegate.java"
click node_search_repo "https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/SearchFilterSessionRepository.java"
click node_document_repo "https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_assess_api,node_tender_api,node_qa_api,node_search_api,node_user toneBlue
class node_procurement_service,node_project_service,node_multi_stage,node_ocds,node_search_service,node_search_cleanup,node_s3 toneAmber
class node_assessment_calc,node_assessment_dims,node_assessment_scoring,node_gcloud toneMint
class node_doc_service,node_jaggaer,node_agreements,node_conclave,node_qanda_client,node_tenders_db,node_search_repo,node_document_repo toneRose
class node_document_upload_api,node_jaggaer_system,node_agreement_system,node_conclave_system toneIndigo
```

## Components

### API access

- [Assessment routes](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/AssessmentsController.java`
- [Tender routes](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/TendersController.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/TendersController.java`
- [Q&A routes](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/QuestionAndAnswerController.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/QuestionAndAnswerController.java`
- [Search routes](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/SearchSessionController.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/controller/SearchSessionController.java`

### Procurement lifecycle

- [Procurement events](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementEventService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementEventService.java`
- [Procurement projects](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementProjectService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ProcurementProjectService.java`
- [Multi-stage events](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java`
- [OCDS releases](https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ocds): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ocds`
- [Search sessions](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java`
- [Session cleanup](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java`

### Assessment

- [Assessment calculation](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentCalculationService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentCalculationService.java`
- [Assessment criteria](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentDimensionCriteriaService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentDimensionCriteriaService.java`
- [Scoring algorithms](https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/assessment): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/assessment`
- [G-Cloud assessment](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java`

### Integrations and data

- [Document uploads](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java`
- [Jaggaer client](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java`
- [Agreement service](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java`
- [Conclave service](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java`
- [Q&A client](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/clients/QuestionAndAnswerClient.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/clients/QuestionAndAnswerClient.java`
- [Tenders database](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/RetryableTendersDBDelegate.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/RetryableTendersDBDelegate.java`
- [Search session store](https://github.com/crown-commercial-service/ccs-scale-cat-service/blob/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/SearchFilterSessionRepository.java): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo/SearchFilterSessionRepository.java`
- [Document metadata](https://github.com/crown-commercial-service/ccs-scale-cat-service/tree/develop/src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo): `src/main/java/uk/gov/crowncommercial/dts/scale/cat/repo`

### Other components

- **API client**
- **Document upload service**
- **S3 storage**
- **Jaggaer**
- **Agreements service**
- **Conclave**

## Connections

- 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 (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/AssessmentService.java`)
- G-Cloud assessment → Tenders database: saves results (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ca/GCloudAssessmentService.java`)
- Multi-stage events → Jaggaer client: retrieves suppliers (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java`)
- Multi-stage events → Tenders database: saves event (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/processors/MultiStageEventService.java`)
- Agreement service → Q&A client: requests templates (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/AgreementsService.java`)
- Document uploads → Document upload service: uploads document (evidence: `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 (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/documentupload/DocumentUploadService.java`)
- Search sessions → Search session store: reads and writes (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionService.java`)
- Session cleanup → Search session store: cleans sessions (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/SearchSessionCleanupService.java`)
- Jaggaer client → Jaggaer: calls API (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/JaggaerService.java`)
- Conclave service → Conclave: retrieves profiles (evidence: `src/main/java/uk/gov/crowncommercial/dts/scale/cat/service/ConclaveService.java`)
- Agreement service → Agreements service: requests data
