# akabot2026/aka-docs architecture

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

- Interactive diagram: https://gitdiagram.com/akabot2026/aka-docs
- Repository: https://github.com/akabot2026/aka-docs

## Overview

This repository is Akabot’s documentation content, not the documentation-site runtime. Contributors update English pages, optionally mirror them in Vietnamese and add shared media, then submit changes for review; after merge, a GitHub Action notifies the separate build repository, which publishes the site. README documents the product-module and activity-package scope; sampled source was limited to maintainer scripts, which are excluded here.

Main entry points: [`docs/center`](https://github.com/akabot2026/aka-docs/tree/main/docs/center) (Akabot Center), [`docs/studio`](https://github.com/akabot2026/aka-docs/tree/main/docs/studio) (Akabot Studio), [`docs/agent`](https://github.com/akabot2026/aka-docs/tree/main/docs/agent) (Akabot Agent), [`docs/data-service`](https://github.com/akabot2026/aka-docs/tree/main/docs/data-service) (Data Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_modules["Product documentation"]
  node_center["Akabot Center"]
  node_studio["Akabot Studio"]
  node_agent["Akabot Agent"]
  node_data_service["Data Service"]
  node_vision["Akabot Vision"]
  node_insight["Akabot Insight"]
  node_hub["Akabot Hub"]
  node_integration["Integration Service"]
end

subgraph group_activities["Activity documentation"]
  node_activity_packages["Activity packages"]
end

subgraph group_shared["Shared content and publishing"]
  node_review["Maintainer review"]
  node_translations["Vietnamese translations"]
  node_media["Shared media"]
end

node_contributor(("Contributor"))
node_build_repo["Build repository"]
node_published_site["Akabot documentation site"]

node_contributor -->|"edits pages"| node_center
node_contributor -->|"edits pages"| node_studio
node_contributor -->|"edits pages"| node_agent
node_contributor -->|"edits pages"| node_data_service
node_contributor -->|"edits pages"| node_vision
node_contributor -->|"edits pages"| node_insight
node_contributor -->|"edits pages"| node_hub
node_contributor -->|"edits pages"| node_integration
node_contributor -->|"edits pages"| node_activity_packages
node_contributor -.->|"mirrors changes"| node_translations
node_contributor -->|"adds media"| node_media
node_contributor -->|"opens pull request"| node_review
node_review -->|"merge notifies"| node_build_repo
node_build_repo -->|"publishes updates"| node_published_site

click node_center "https://github.com/akabot2026/aka-docs/tree/main/docs/center"
click node_studio "https://github.com/akabot2026/aka-docs/tree/main/docs/studio"
click node_agent "https://github.com/akabot2026/aka-docs/tree/main/docs/agent"
click node_data_service "https://github.com/akabot2026/aka-docs/tree/main/docs/data-service"
click node_vision "https://github.com/akabot2026/aka-docs/tree/main/docs/vision"
click node_insight "https://github.com/akabot2026/aka-docs/tree/main/docs/insight"
click node_hub "https://github.com/akabot2026/aka-docs/tree/main/docs/hub"
click node_integration "https://github.com/akabot2026/aka-docs/tree/main/docs/integration-service"
click node_activity_packages "https://github.com/akabot2026/aka-docs/tree/main/docs/activities"
click node_translations "https://github.com/akabot2026/aka-docs/tree/main/i18n/vi"
click node_media "https://github.com/akabot2026/aka-docs/tree/main/static"

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_center,node_studio,node_agent,node_data_service,node_vision,node_insight,node_hub,node_integration toneBlue
class node_activity_packages toneAmber
class node_review,node_translations,node_media toneMint
class node_contributor,node_build_repo,node_published_site toneIndigo
```

## Components

### Product documentation

- [Akabot Center](https://github.com/akabot2026/aka-docs/tree/main/docs/center): `docs/center`
- [Akabot Studio](https://github.com/akabot2026/aka-docs/tree/main/docs/studio): `docs/studio`
- [Akabot Agent](https://github.com/akabot2026/aka-docs/tree/main/docs/agent): `docs/agent`
- [Data Service](https://github.com/akabot2026/aka-docs/tree/main/docs/data-service): `docs/data-service`
- [Akabot Vision](https://github.com/akabot2026/aka-docs/tree/main/docs/vision): `docs/vision`
- [Akabot Insight](https://github.com/akabot2026/aka-docs/tree/main/docs/insight): `docs/insight`
- [Akabot Hub](https://github.com/akabot2026/aka-docs/tree/main/docs/hub): `docs/hub`
- [Integration Service](https://github.com/akabot2026/aka-docs/tree/main/docs/integration-service): `docs/integration-service`

### Activity documentation

- [Activity packages](https://github.com/akabot2026/aka-docs/tree/main/docs/activities): `docs/activities`

### Shared content and publishing

- **Maintainer review**
- [Vietnamese translations](https://github.com/akabot2026/aka-docs/tree/main/i18n/vi): `i18n/vi`
- [Shared media](https://github.com/akabot2026/aka-docs/tree/main/static): `static`

### Other components

- **Contributor**
- **Build repository**
- **Akabot documentation site**

## Connections

- Contributor → Akabot Center: edits pages
- Contributor → Akabot Studio: edits pages
- Contributor → Akabot Agent: edits pages
- Contributor → Data Service: edits pages
- Contributor → Akabot Vision: edits pages
- Contributor → Akabot Insight: edits pages
- Contributor → Akabot Hub: edits pages
- Contributor → Integration Service: edits pages
- Contributor → Activity packages: edits pages
- Contributor → Vietnamese translations: mirrors changes
- Contributor → Shared media: adds media
- Contributor → Maintainer review: opens pull request
- Maintainer review → Build repository: merge notifies
- Build repository → Akabot documentation site: publishes updates
