# kyanetwork/kyanetworkstation architecture

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

- Interactive diagram: https://gitdiagram.com/kyanetwork/kyanetworkstation
- Repository: https://github.com/kyanetwork/kyanetworkstation

## Overview

KyanetWorkStation is a self-hosted work hub for feedback, WorkTasks, administrative handling, and service status, with optional administrator-facing AI assistance. Users submit feedback or tasks through public pages; the server validates and persists them, and administrators review, update, and export work through the inbox. Projects organize work items, while optional knowledge and Copilot features add cited answers and AI suggestions. The graph preserves README-documented capabilities; some route-level details are unsampled, so documented connections cite the README rather than implying unseen implementation specifics.

Main entry points: [`server/app.js`](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/app.js) (HTTP Application), [`server/ai-knowledge.js`](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-knowledge.js) (Knowledge Assistant), [`server/db.js`](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/db.js) (Application Database), [`server/ai-profiles.js`](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-profiles.js) (AI Profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Public Workstation"]
  node_public_ui["Public Pages"]
  node_admin_ui["Admin Console<br/>[admin.js]"]
end

subgraph group_work["Work Management"]
  node_inbox["Feedback and Tasks<br/>[app.js]"]
  node_export["CSV Export<br/>[admin-export.js]"]
  node_audit["Admin Audit"]
  node_projects["Project Management<br/>[db.js]"]
end

subgraph group_assistant["AI Assistance"]
  node_ai_profiles["AI Profiles<br/>[ai-profiles.js]"]
  node_ai_provider["AI Provider Client<br/>[ai-provider.js]"]
  node_copilot["Admin Copilot<br/>[ai-copilot.js]"]
  node_knowledge_api["Knowledge Assistant<br/>[ai-knowledge.js]"]
  node_knowledge_index["Knowledge Index<br/>[knowledge-base.js]"]
  node_diagnostics["Provider Diagnostics<br/>[ai-diagnostics.js]"]
  node_metrics["AI Metrics<br/>[ai-metrics.js]"]
end

subgraph group_platform["Server Platform"]
  node_app["HTTP Application<br/>[app.js]"]
  node_validation["Request Validation<br/>[validation.js]"]
  node_auth["Admin Sessions<br/>[auth.js]"]
  node_database[("Application Database<br/>[db.js]")]
  node_config["Runtime Configuration<br/>[config.js]"]
  node_logger["Structured Logging<br/>[logger.js]"]
end

subgraph group_integrations["External Integrations"]
  node_status["MeowStatus Cards<br/>[meowstatus.js]"]
  node_notifications["Notification Delivery<br/>[notify.js]"]
  node_webhooks["Webhook Providers<br/>[webhook.js]"]
  node_handoff["Delivery Handoff"]
end

node_visitors(("Visitors"))
node_admins(("Administrators"))
node_ai_service(("AI Provider Service"))
node_meow_service(("MeowStatus Service"))
node_notification_service(("Notification Endpoints"))

node_visitors -->|"submit work"| node_public_ui
node_public_ui -->|"send submissions"| node_app
node_admins -->|"manage work"| node_admin_ui
node_admin_ui -->|"admin requests"| node_app
node_app -->|"validates inputs"| node_validation
node_app -->|"guards admin routes"| node_auth
node_auth -->|"reads and writes sessions"| node_database
node_app -->|"routes work actions"| node_inbox
node_inbox -->|"stores work records"| node_database
node_app -->|"serves bounded export"| node_export
node_app -->|"records admin actions"| node_audit
node_app -->|"routes project actions"| node_projects
node_projects -->|"stores project data"| node_database
node_app -->|"serves status cards"| node_status
node_status -.->|"fetches service status"| node_meow_service
node_app -->|"dispatches notifications"| node_notifications
node_notifications -->|"sends webhook messages"| node_webhooks
node_webhooks -->|"posts messages"| node_notification_service
node_app -->|"exposes delivery recovery"| node_handoff
node_app -->|"routes profile management"| node_ai_profiles
node_ai_profiles -->|"stores profiles"| node_database
node_app -->|"routes suggestions"| node_copilot
node_copilot -->|"uses active profile"| node_ai_profiles
node_copilot -->|"requests suggestions"| node_ai_provider
node_app -->|"routes knowledge queries"| node_knowledge_api
node_knowledge_api -->|"retrieves source passages"| node_knowledge_index
node_knowledge_api -->|"uses active profile"| node_ai_profiles
node_knowledge_api -->|"requests cited answers"| node_ai_provider
node_knowledge_api -->|"stores answer history"| node_database
node_app -->|"routes diagnostics"| node_diagnostics
node_diagnostics -->|"checks profiles"| node_ai_profiles
node_diagnostics -->|"tests provider access"| node_ai_provider
node_copilot -->|"records usage"| node_metrics
node_knowledge_api -->|"records usage"| node_metrics
node_diagnostics -->|"records checks"| node_metrics
node_metrics -->|"stores metric records"| node_database
node_ai_provider -->|"calls configured API"| node_ai_service
node_app -->|"uses runtime settings"| node_config
node_app -->|"logs requests"| node_logger

click node_public_ui "https://github.com/kyanetwork/kyanetworkstation/tree/main/public"
click node_admin_ui "https://github.com/kyanetwork/kyanetworkstation/blob/main/public/admin/admin.js"
click node_app "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/app.js"
click node_validation "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/validation.js"
click node_auth "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/auth.js"
click node_database "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/db.js"
click node_config "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/config.js"
click node_logger "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/logger.js"
click node_inbox "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/app.js"
click node_export "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/admin-export.js"
click node_audit "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/admin-audit-metadata.js"
click node_projects "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/db.js"
click node_status "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/meowstatus.js"
click node_notifications "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/notify.js"
click node_webhooks "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/webhook.js"
click node_handoff "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/notification-handoff.js"
click node_ai_profiles "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-profiles.js"
click node_ai_provider "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-provider.js"
click node_copilot "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-copilot.js"
click node_knowledge_api "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-knowledge.js"
click node_knowledge_index "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/knowledge-base.js"
click node_diagnostics "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-diagnostics.js"
click node_metrics "https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-metrics.js"

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_public_ui,node_admin_ui toneBlue
class node_inbox,node_export,node_audit,node_projects toneAmber
class node_ai_profiles,node_ai_provider,node_copilot,node_knowledge_api,node_knowledge_index,node_diagnostics,node_metrics toneMint
class node_app,node_validation,node_auth,node_database,node_config,node_logger toneRose
class node_status,node_notifications,node_webhooks,node_handoff,node_visitors,node_admins,node_ai_service,node_meow_service,node_notification_service toneIndigo
```

## Components

### Public Workstation

- [Public Pages](https://github.com/kyanetwork/kyanetworkstation/tree/main/public): `public`
- [Admin Console](https://github.com/kyanetwork/kyanetworkstation/blob/main/public/admin/admin.js): `public/admin/admin.js`

### Work Management

- [Feedback and Tasks](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/app.js): `server/app.js`
- [CSV Export](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/admin-export.js): `server/admin-export.js`
- [Admin Audit](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/admin-audit-metadata.js): `server/admin-audit-metadata.js`
- [Project Management](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/db.js): `server/db.js`

### AI Assistance

- [AI Profiles](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-profiles.js): `server/ai-profiles.js`
- [AI Provider Client](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-provider.js): `server/ai-provider.js`
- [Admin Copilot](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-copilot.js): `server/ai-copilot.js`
- [Knowledge Assistant](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-knowledge.js): `server/ai-knowledge.js`
- [Knowledge Index](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/knowledge-base.js): `server/knowledge-base.js`
- [Provider Diagnostics](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-diagnostics.js): `server/ai-diagnostics.js`
- [AI Metrics](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/ai-metrics.js): `server/ai-metrics.js`

### Server Platform

- [HTTP Application](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/app.js): `server/app.js`
- [Request Validation](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/validation.js): `server/validation.js`
- [Admin Sessions](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/auth.js): `server/auth.js`
- [Application Database](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/db.js): `server/db.js`
- [Runtime Configuration](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/config.js): `server/config.js`
- [Structured Logging](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/logger.js): `server/logger.js`

### External Integrations

- [MeowStatus Cards](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/meowstatus.js): `server/meowstatus.js`
- [Notification Delivery](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/notify.js): `server/notify.js`
- [Webhook Providers](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/webhook.js): `server/webhook.js`
- [Delivery Handoff](https://github.com/kyanetwork/kyanetworkstation/blob/main/server/notification-handoff.js): `server/notification-handoff.js`

### Other components

- **Visitors**
- **Administrators**
- **AI Provider Service**
- **MeowStatus Service**
- **Notification Endpoints**

## Connections

- Visitors → Public Pages: submit work (evidence: `README.md`)
- Public Pages → HTTP Application: send submissions (evidence: `README.md`)
- Administrators → Admin Console: manage work (evidence: `README.md`)
- Admin Console → HTTP Application: admin requests (evidence: `README.md`)
- HTTP Application → Request Validation: validates inputs (evidence: `server/app.js`)
- HTTP Application → Admin Sessions: guards admin routes (evidence: `server/app.js`)
- Admin Sessions → Application Database: reads and writes sessions (evidence: `server/auth.js`)
- HTTP Application → Feedback and Tasks: routes work actions (evidence: `README.md`)
- Feedback and Tasks → Application Database: stores work records (evidence: `README.md`)
- HTTP Application → CSV Export: serves bounded export (evidence: `README.md`)
- HTTP Application → Admin Audit: records admin actions (evidence: `README.md`)
- HTTP Application → Project Management: routes project actions (evidence: `server/app.js`)
- Project Management → Application Database: stores project data (evidence: `server/db.js`)
- HTTP Application → MeowStatus Cards: serves status cards (evidence: `README.md`)
- MeowStatus Cards → MeowStatus Service: fetches service status (evidence: `README.md`)
- HTTP Application → Notification Delivery: dispatches notifications (evidence: `README.md`)
- Notification Delivery → Webhook Providers: sends webhook messages (evidence: `server/notify.js`)
- Webhook Providers → Notification Endpoints: posts messages (evidence: `server/webhook.js`)
- HTTP Application → Delivery Handoff: exposes delivery recovery (evidence: `README.md`)
- HTTP Application → AI Profiles: routes profile management (evidence: `server/app.js`)
- AI Profiles → Application Database: stores profiles (evidence: `server/ai-profiles.js`)
- HTTP Application → Admin Copilot: routes suggestions (evidence: `README.md`)
- Admin Copilot → AI Profiles: uses active profile (evidence: `server/ai-copilot.js`)
- Admin Copilot → AI Provider Client: requests suggestions (evidence: `server/ai-copilot.js`)
- HTTP Application → Knowledge Assistant: routes knowledge queries (evidence: `README.md`)
- Knowledge Assistant → Knowledge Index: retrieves source passages (evidence: `server/ai-knowledge.js`)
- Knowledge Assistant → AI Profiles: uses active profile (evidence: `server/ai-knowledge.js`)
- Knowledge Assistant → AI Provider Client: requests cited answers (evidence: `server/ai-knowledge.js`)
- Knowledge Assistant → Application Database: stores answer history (evidence: `server/ai-knowledge.js`)
- HTTP Application → Provider Diagnostics: routes diagnostics (evidence: `server/app.js`)
- Provider Diagnostics → AI Profiles: checks profiles (evidence: `server/ai-diagnostics.js`)
- Provider Diagnostics → AI Provider Client: tests provider access (evidence: `server/ai-diagnostics.js`)
- Admin Copilot → AI Metrics: records usage (evidence: `server/ai-copilot.js`)
- Knowledge Assistant → AI Metrics: records usage (evidence: `server/ai-knowledge.js`)
- Provider Diagnostics → AI Metrics: records checks (evidence: `server/ai-diagnostics.js`)
- AI Metrics → Application Database: stores metric records (evidence: `server/ai-metrics.js`)
- AI Provider Client → AI Provider Service: calls configured API (evidence: `README.md`)
- HTTP Application → Runtime Configuration: uses runtime settings (evidence: `server/app.js`)
- HTTP Application → Structured Logging: logs requests (evidence: `server/app.js`)
