Backend Structure

Структура backend knowledge-db

Расположение кода

/
├── cmd/
│   ├── kb-server/   # API + UI + Telegram bot + MCP
│   └── kb-cli/      # validate, init
├── internal/
│   ├── kb/          # работа с data/, валидация, дерево тем
│   ├── api/         # HTTP handlers, роутинг
│   ├── ingestion/   # интерфейс Ingester, pipeline
│   ├── mcp/          # MCP endpoint /api/mcp
│   └── ui/          # embed статики (embed.go, static/)
├── web/             # React исходники
└── .cursor/skills/  # agent skills

internal/kb

• Валидация структуры базы (темы 2–3 уровня, узлы с {dirname}.md и frontmatter)
• Чтение дерева тем, списка узлов
• Путь к базе — KB_DATA_PATH (env)

internal/api

• Роутинг: net/http.ServeMux (Go 1.22+)