# silasworkspace/hqtcsdl_uth architecture

> Architecture diagram of the GitHub repository silasworkspace/hqtcsdl_uth, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/silasworkspace/hqtcsdl_uth
- Repository: https://github.com/silasworkspace/hqtcsdl_uth

## Overview

LivingDocs is intended as an AI-assisted system for managing and updating technical documentation. The likely user journey is through the React frontend to backend capabilities for documents, governance, workflow, integrations and AI-assisted analysis; the tree also indicates identity and notifications. However, the sampled implementation directories contain only placeholders, and the README does not describe runtime wiring. Dashed, unevidenced links therefore mark architectural intent rather than verified calls.

Main entry points: [`backend/api-gateway/src/main/java/com/livingdocs/gateway`](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/api-gateway/src/main/java/com/livingdocs/gateway) (API gateway), [`backend/ai-engine/app`](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app) (AI engine), [`frontend/src`](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/frontend/src) (React application), [`backend/services/document-service/src/main/java/com/livingdocs/document`](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/document-service/src/main/java/com/livingdocs/document) (Document service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interface"]
  node_frontend["React application"]
  node_navigation["Routes and layouts"]
  node_api["API client<br/>[apiClient.js]"]
end

subgraph group_backend["Backend capabilities"]
  node_gateway["API gateway"]
  node_identity["Identity service"]
  node_documents["Document service"]
  node_governance["Governance service"]
  node_workflow["Workflow service"]
  node_integrations["Integration service"]
  node_notifications["Notification service"]
  node_ai["AI engine"]
  node_ast["AST analysis"]
  node_rag["Knowledge retrieval"]
  node_ocr["Multimodal OCR"]
  node_llm["LLM processing"]
end

subgraph group_data["Persistence"]
  node_sql[("SQL Server")]
end

node_user(("Documentation user"))

node_user -.->|"uses"| node_frontend
node_frontend -.->|"routes through"| node_navigation
node_frontend -.->|"requests data"| node_api
node_api -.->|"calls"| node_gateway
node_gateway -.->|"dispatches to"| node_identity
node_gateway -.->|"dispatches to"| node_documents
node_gateway -.->|"dispatches to"| node_governance
node_gateway -.->|"dispatches to"| node_workflow
node_gateway -.->|"dispatches to"| node_integrations
node_gateway -.->|"dispatches to"| node_notifications
node_documents -.->|"requests analysis"| node_ai
node_ai -.->|"analyzes syntax"| node_ast
node_ai -.->|"retrieves knowledge"| node_rag
node_ai -.->|"extracts content"| node_ocr
node_ai -.->|"uses models"| node_llm
node_documents -.->|"persists documents"| node_sql
node_identity -.->|"persists identity"| node_sql
node_workflow -.->|"persists workflow"| node_sql

click node_frontend "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/frontend/src"
click node_navigation "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/frontend/src/app"
click node_api "https://github.com/silasworkspace/hqtcsdl_uth/blob/main/frontend/src/services/api/apiClient.js"
click node_gateway "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/api-gateway/src/main/java/com/livingdocs/gateway"
click node_identity "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/identity-service/src/main/java/com/livingdocs/identity"
click node_documents "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/document-service/src/main/java/com/livingdocs/document"
click node_governance "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/governance-service/src/main/java/com/livingdocs/governance"
click node_workflow "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/workflow-service/src/main/java/com/livingdocs/workflow"
click node_integrations "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/integration-service/src/main/java/com/livingdocs/integration"
click node_notifications "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/notification-service/src/main/java/com/livingdocs/notification"
click node_ai "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app"
click node_ast "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/ast_analyzer"
click node_rag "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/rag"
click node_ocr "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/ocr_multimodal"
click node_llm "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/llm"
click node_sql "https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/infra/mssql"

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_frontend,node_navigation,node_api,node_user toneBlue
class node_gateway,node_identity,node_documents,node_governance,node_workflow,node_integrations,node_notifications,node_ai,node_ast,node_rag,node_ocr,node_llm toneAmber
class node_sql toneMint
```

## Components

### User interface

- [React application](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/frontend/src): `frontend/src`
- [Routes and layouts](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/frontend/src/app): `frontend/src/app`
- [API client](https://github.com/silasworkspace/hqtcsdl_uth/blob/main/frontend/src/services/api/apiClient.js): `frontend/src/services/api/apiClient.js`

### Backend capabilities

- [API gateway](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/api-gateway/src/main/java/com/livingdocs/gateway): `backend/api-gateway/src/main/java/com/livingdocs/gateway`
- [Identity service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/identity-service/src/main/java/com/livingdocs/identity): `backend/services/identity-service/src/main/java/com/livingdocs/identity`
- [Document service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/document-service/src/main/java/com/livingdocs/document): `backend/services/document-service/src/main/java/com/livingdocs/document`
- [Governance service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/governance-service/src/main/java/com/livingdocs/governance): `backend/services/governance-service/src/main/java/com/livingdocs/governance`
- [Workflow service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/workflow-service/src/main/java/com/livingdocs/workflow): `backend/services/workflow-service/src/main/java/com/livingdocs/workflow`
- [Integration service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/integration-service/src/main/java/com/livingdocs/integration): `backend/services/integration-service/src/main/java/com/livingdocs/integration`
- [Notification service](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/services/notification-service/src/main/java/com/livingdocs/notification): `backend/services/notification-service/src/main/java/com/livingdocs/notification`
- [AI engine](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app): `backend/ai-engine/app`
- [AST analysis](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/ast_analyzer): `backend/ai-engine/app/ast_analyzer`
- [Knowledge retrieval](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/rag): `backend/ai-engine/app/rag`
- [Multimodal OCR](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/ocr_multimodal): `backend/ai-engine/app/ocr_multimodal`
- [LLM processing](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/ai-engine/app/llm): `backend/ai-engine/app/llm`

### Persistence

- [SQL Server](https://github.com/silasworkspace/hqtcsdl_uth/tree/main/backend/infra/mssql): `backend/infra/mssql`

### Other components

- **Documentation user**

## Connections

- Documentation user → React application: uses
- React application → Routes and layouts: routes through
- React application → API client: requests data
- API client → API gateway: calls
- API gateway → Identity service: dispatches to
- API gateway → Document service: dispatches to
- API gateway → Governance service: dispatches to
- API gateway → Workflow service: dispatches to
- API gateway → Integration service: dispatches to
- API gateway → Notification service: dispatches to
- Document service → AI engine: requests analysis
- AI engine → AST analysis: analyzes syntax
- AI engine → Knowledge retrieval: retrieves knowledge
- AI engine → Multimodal OCR: extracts content
- AI engine → LLM processing: uses models
- Document service → SQL Server: persists documents
- Identity service → SQL Server: persists identity
- Workflow service → SQL Server: persists workflow