# truongthaitiendat/project-laptrinhjava architecture

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

- Interactive diagram: https://gitdiagram.com/truongthaitiendat/project-laptrinhjava
- Repository: https://github.com/truongthaitiendat/project-laptrinhjava

## Overview

LivingDocs is a web application for managing and automatically generating technical documentation. Users enter through the Next.js interface; the Java service provides authentication, document and template workflows, while its AI interoperability service requests generation or updates from the Python engine and stores resulting versions and change logs. The engine extracts code entities, including Java entities via its AST parser. The tree also shows administration, knowledge-base, workflow, GitHub, billing, and notification capabilities. Some connections are documented in sampled source; unsampled subsystem relationships are intentionally not asserted.

Main entry points: [`frontend/src/services/api.ts`](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/services/api.ts) (API client), [`backend/src/main/java/com/livingdocs/service/AiInteropService.java`](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiInteropService.java) (Document workflows), [`frontend/src/app/page.tsx`](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/page.tsx) (App and dashboard), [`backend/src/main/java/com/livingdocs/service/AiEngineClientService.java`](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiEngineClientService.java) (Engine client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app_pages["App and dashboard<br/>[page.tsx]"]
  node_knowledge["Knowledge base<br/>[page.tsx]"]
  node_workflow_ui["Workflow UI<br/>[page.tsx]"]
  node_diff_ui["Diff viewer<br/>[page.tsx]"]
  node_admin_ui["Admin UI<br/>[page.tsx]"]
  node_frontend_api["API client<br/>[api.ts]"]
end

subgraph group_backend["Core backend"]
  node_document_api["Document endpoints"]
  node_doc_workflows["Document workflows"]
  node_versioning["Version history"]
  node_version_store[("Version and change data")]
  node_template_api["Templates"]
end

subgraph group_ai["AI documentation"]
  node_ai_controller["AI endpoints"]
  node_ai_interop["AI orchestration"]
  node_ai_client["Engine client"]
  node_engine_api["Generation engine<br/>[main.py]"]
  node_java_ast["Java AST parser<br/>[java_parser.py]"]
end

subgraph group_identity["Identity and access"]
  node_auth_controller["Authentication"]
  node_user_controller["User administration"]
  node_user_store[("User repository")]
end

subgraph group_integrations["External integrations"]
  node_github_api["GitHub integration<br/>[GitHubService.java]"]
  node_billing["Billing"]
  node_notifications["Notifications"]
end

node_user(("User"))

node_user -->|"uses"| node_app_pages
node_app_pages -.->|"requests data"| node_frontend_api
node_knowledge -.->|"requests data"| node_frontend_api
node_workflow_ui -.->|"requests data"| node_frontend_api
node_diff_ui -.->|"requests data"| node_frontend_api
node_admin_ui -.->|"requests data"| node_frontend_api
node_frontend_api -.->|"calls API"| node_auth_controller
node_auth_controller -->|"reads and saves"| node_user_store
node_user_controller -->|"reads and saves"| node_user_store
node_document_api -.->|"delegates"| node_doc_workflows
node_doc_workflows -->|"requests generation"| node_ai_client
node_ai_client -->|"HTTP requests"| node_engine_api
node_engine_api -->|"parses Java"| node_java_ast
node_doc_workflows -->|"saves AI versions"| node_version_store
node_versioning -->|"reads and writes"| node_version_store
node_doc_workflows -->|"loads template"| node_template_api
node_github_api -.->|"may trigger alerts"| node_notifications

click node_app_pages "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/page.tsx"
click node_knowledge "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/knowledge-base/page.tsx"
click node_workflow_ui "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/workflow/page.tsx"
click node_diff_ui "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/diff/page.tsx"
click node_admin_ui "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/admin/page.tsx"
click node_frontend_api "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/services/api.ts"
click node_auth_controller "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/AuthController.java"
click node_user_controller "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/UserController.java"
click node_user_store "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/repository/UserRepository.java"
click node_document_api "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/DocumentController.java"
click node_doc_workflows "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiInteropService.java"
click node_versioning "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/VersioningService.java"
click node_version_store "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/repository/DocumentVersionRepository.java"
click node_template_api "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/TemplateService.java"
click node_github_api "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/GitHubService.java"
click node_billing "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/PaymentService.java"
click node_notifications "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/ZaloNotificationService.java"
click node_ai_controller "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/AiInteropController.java"
click node_ai_interop "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiInteropService.java"
click node_ai_client "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiEngineClientService.java"
click node_engine_api "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/ai-engine/app/main.py"
click node_java_ast "https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/ai-engine/app/parser/java_parser.py"

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_app_pages,node_knowledge,node_workflow_ui,node_diff_ui,node_admin_ui,node_frontend_api,node_user toneBlue
class node_document_api,node_doc_workflows,node_versioning,node_version_store,node_template_api toneAmber
class node_ai_controller,node_ai_interop,node_ai_client,node_engine_api,node_java_ast toneMint
class node_auth_controller,node_user_controller,node_user_store toneRose
class node_github_api,node_billing,node_notifications toneIndigo
```

## Components

### Web interface

- [App and dashboard](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Knowledge base](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/knowledge-base/page.tsx): `frontend/src/app/knowledge-base/page.tsx`
- [Workflow UI](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/workflow/page.tsx): `frontend/src/app/workflow/page.tsx`
- [Diff viewer](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/diff/page.tsx): `frontend/src/app/diff/page.tsx`
- [Admin UI](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/app/admin/page.tsx): `frontend/src/app/admin/page.tsx`
- [API client](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### Core backend

- [Document endpoints](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/DocumentController.java): `backend/src/main/java/com/livingdocs/controller/DocumentController.java`
- [Document workflows](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiInteropService.java): `backend/src/main/java/com/livingdocs/service/AiInteropService.java`
- [Version history](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/VersioningService.java): `backend/src/main/java/com/livingdocs/service/VersioningService.java`
- [Version and change data](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/repository/DocumentVersionRepository.java): `backend/src/main/java/com/livingdocs/repository/DocumentVersionRepository.java`
- [Templates](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/TemplateService.java): `backend/src/main/java/com/livingdocs/service/TemplateService.java`

### AI documentation

- [AI endpoints](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/AiInteropController.java): `backend/src/main/java/com/livingdocs/controller/AiInteropController.java`
- [AI orchestration](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiInteropService.java): `backend/src/main/java/com/livingdocs/service/AiInteropService.java`
- [Engine client](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/AiEngineClientService.java): `backend/src/main/java/com/livingdocs/service/AiEngineClientService.java`
- [Generation engine](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/ai-engine/app/main.py): `ai-engine/app/main.py`
- [Java AST parser](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/ai-engine/app/parser/java_parser.py): `ai-engine/app/parser/java_parser.py`

### Identity and access

- [Authentication](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/AuthController.java): `backend/src/main/java/com/livingdocs/controller/AuthController.java`
- [User administration](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/controller/UserController.java): `backend/src/main/java/com/livingdocs/controller/UserController.java`
- [User repository](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/repository/UserRepository.java): `backend/src/main/java/com/livingdocs/repository/UserRepository.java`

### External integrations

- [GitHub integration](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/GitHubService.java): `backend/src/main/java/com/livingdocs/service/GitHubService.java`
- [Billing](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/PaymentService.java): `backend/src/main/java/com/livingdocs/service/PaymentService.java`
- [Notifications](https://github.com/truongthaitiendat/project-laptrinhjava/blob/main/backend/src/main/java/com/livingdocs/service/ZaloNotificationService.java): `backend/src/main/java/com/livingdocs/service/ZaloNotificationService.java`

### Other components

- **User**

## Connections

- User → App and dashboard: uses
- App and dashboard → API client: requests data
- Knowledge base → API client: requests data
- Workflow UI → API client: requests data
- Diff viewer → API client: requests data
- Admin UI → API client: requests data
- API client → Authentication: calls API
- Authentication → User repository: reads and saves (evidence: `backend/src/main/java/com/livingdocs/controller/AuthController.java`)
- User administration → User repository: reads and saves (evidence: `backend/src/main/java/com/livingdocs/controller/UserController.java`)
- Document endpoints → Document workflows: delegates
- Document workflows → Engine client: requests generation (evidence: `backend/src/main/java/com/livingdocs/service/AiInteropService.java`)
- Engine client → Generation engine: HTTP requests (evidence: `backend/src/main/java/com/livingdocs/service/AiEngineClientService.java`)
- Generation engine → Java AST parser: parses Java (evidence: `ai-engine/app/main.py`)
- Document workflows → Version and change data: saves AI versions (evidence: `backend/src/main/java/com/livingdocs/service/AiInteropService.java`)
- Version history → Version and change data: reads and writes (evidence: `backend/src/main/java/com/livingdocs/service/VersioningService.java`)
- Document workflows → Templates: loads template (evidence: `backend/src/main/java/com/livingdocs/service/AiInteropService.java`)
- GitHub integration → Notifications: may trigger alerts
