- Java 71.5%
- TypeScript 22%
- Vue 4.9%
- JavaScript 0.6%
- Dockerfile 0.4%
- Other 0.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| .agents/skills/add-setting | ||
| ai-service | ||
| audio-service | ||
| auth-service | ||
| build-logic | ||
| chat-service | ||
| config | ||
| config-client | ||
| config-common | ||
| config-service | ||
| docker | ||
| docs | ||
| file-service | ||
| gateway-service | ||
| gradle/wrapper | ||
| mchat-common | ||
| scripts | ||
| tasks | ||
| web-client | ||
| .dockerignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| build.gradle.kts | ||
| dev.env.example | ||
| docker-compose.yml | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| README.md | ||
| settings.gradle.kts | ||
| TODO.md | ||
mchat — платформа чата
Высоконагруженная микросервисная платформа чата: WebSocket-сообщения в реальном времени, хранение документов, асинхронное распознавание речи (STT) и ИИ-ассистенты (LLM + RAG).
Единый Gradle-монорепозиторий из семи сервисов и одного библиотечного модуля поверх Java 25 и Spring Boot 4.1.1. Полное описание архитектуры и правила разработки — в AGENTS.md.
Стек
| Слой | Технология |
|---|---|
| Runtime | Java 25 (LTS), виртуальные потоки включены во всех сервисах |
| Framework | Spring Boot 4.1.1, Spring Framework 7, Spring Cloud 2025.1.x (Oakwood) |
| Сборка | Gradle (Kotlin DSL), Spring Boot BOM + Spring AI BOM |
| Вход | Spring Cloud Gateway (реактивный стек) |
| Данные | PostgreSQL 18 (пользователи, настройки), MongoDB 7.0 (история чатов), Redis 8 (Pub/Sub, векторный поиск и лимит попыток входа) |
| Брокер | Apache Kafka 4 (KRaft) |
| Файлы | SeaweedFS (S3 API, клиент — MinIO Java SDK) |
| Веб-клиент | Vue 3 + TypeScript, Vite, Tailwind CSS (каталог web-client/, вне Gradle-сборки) |
| Мониторинг | Prometheus 3.13 (LTS) + Grafana 13.2: метрики /actuator/prometheus, обзорный дашборд из репозитория |
| Развёртывание | Docker, Docker Compose, многоэтапная сборка с layered JAR |
Версии инфраструктурных образов и схема взаимодействия сервисов — docs/architecture.md.
Быстрый старт
Требования: JDK 25, Docker с плагином Compose (v2), openssl (для dev-сертификатов).
cp dev.env.example .env # заполните пароли, MCHAT_CONFIG_ENCRYPTION_KEY и MCHAT_AUTH_AI_SERVICE_CLIENT_SECRET
./scripts/generate-dev-tls.sh # dev-CA + серверная пара в docker/certs; напечатает установку CA
docker compose up -d --build # сборка образов + запуск инфраструктуры и сервисов
docker compose ps # статус и healthcheck
curl --cacert docker/certs/public/ca.crt https://localhost:8080/actuator/health # health через gateway
Метрики и дашборд — часть стенда. Prometheus (http://localhost:9090) scrape'ит
/actuator/prometheus всех семи сервисов, Grafana (http://localhost:3001, вход admin и пароль
GRAFANA_ADMIN_PASSWORD из .env) открывается с провижиненным datasource и обзорным дашбордом.
Что отдаётся, как проверять и что делать, если цель недоступна —
docs/observability.md.
Публичный вход — HTTPS (https://localhost:8080). TLS терминирует gateway: SPA, API и WebSocket
(wss) ходят по защищённой схеме. Сертификаты выпускает scripts/generate-dev-tls.sh — локальный CA
и серверная пара для localhost; без них docker compose up останавливается с сообщением о
bind-mount (docker/certs), поэтому шаг обязателен и стоит в быстром старте. Скрипт печатает команду
установки CA в доверенные — до неё curl и браузер сертификату не доверяют (обойти проверку на один
запрос можно curl --cacert docker/certs/public/ca.crt …). Перевыпуск — --force, срок для проверки
предупреждения об истечении — --days 7; ротация не требует перезапуска gateway. Подробности —
docs/getting-started.md, эксплуатация и диагностика —
docs/operations.md.
Мастер-ключ секретов обязателен. Каталог объявляет секретную запись — ключ соединения с моделью
(mchat.ai.connections.<name>.apikey), поэтому без MCHAT_CONFIG_ENCRYPTION_KEY config-service
не стартует: это fail-closed, а не поломка — лучше не подняться, чем писать ключи открытым текстом.
Значение — Base64 от 32 байт (ключ AES-256-GCM), оно же шифрует секреты в БД; второй обязательный
секрет — MCHAT_AUTH_AI_SERVICE_CLIENT_SECRET: им ai-service читает снимок своих настроек, потому что
владелец с секретами отдаёт снимок только своему клиенту mchat-ai-service. В dev.env.example оба
заполнены учебными значениями; пустыми их не пропускает compose (останавливается с подсказкой).
Ротация ключа соединения из админки, порядок первого запуска и проверка — docs/getting-started.md,
контракт соединений — docs/api/ai-connections.md.
Остановка — docker compose down (с ключом -v — вместе с томами данных). Переменные окружения и
shell, проверка отдельных сервисов, уже существующий том (config_db, file_db) — docs/getting-started.md.
Документация
Техническая документация — в docs/: гиды (запуск, архитектура, эксплуатация, разработка, статус, веб-клиент) и справка по контрактам каждого сервиса.
| Что | Где |
|---|---|
| Карта документации: что где искать и как её вести | docs/README.md |
| Правила разработки (контекст для агента и людей) | AGENTS.md |
| Кросс-сервисные правила: каналы, настройки, стиль и гейты | docs/rules/README.md |
| Входящий бэклог идей | TODO.md |
| Реестр тасок | tasks/README.md |