No description
  • Java 71.5%
  • TypeScript 22%
  • Vue 4.9%
  • JavaScript 0.6%
  • Dockerfile 0.4%
  • Other 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-19 16:47:40 +05:00
.agents/skills/add-setting MC-069 — Общая библиотека config-common: единый разбор каталога настроек 2026-10-12 09:26:07 +05:00
ai-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
audio-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
auth-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
build-logic MC-110 — TLS на публичном входе: HTTPS на gateway, сертификаты и проброс схемы 2026-10-17 15:50:19 +05:00
chat-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
config MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
config-client MC-105 — Выравнивание @param/@throws в Javadoc: включить в профиле форматтера 2026-10-15 22:22:15 +05:00
config-common MC-105 — Выравнивание @param/@throws в Javadoc: включить в профиле форматтера 2026-10-15 22:22:15 +05:00
config-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
docker MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
docs MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
file-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
gateway-service MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
gradle/wrapper MC-091 — build-logic: типизированные плагины вместо apply(from = …) 2026-10-14 23:47:20 +05:00
mchat-common MC-105 — Выравнивание @param/@throws в Javadoc: включить в профиле форматтера 2026-10-15 22:22:15 +05:00
scripts MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
tasks MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
web-client MC-110 — TLS на публичном входе: HTTPS на gateway, сертификаты и проброс схемы 2026-10-17 15:50:19 +05:00
.dockerignore MC-091 — build-logic: типизированные плагины вместо apply(from = …) 2026-10-14 23:47:20 +05:00
.editorconfig MC-002 — Единый стиль кода: Spotless + Eclipse JDT в сборке 2026-10-05 20:47:41 +05:00
.gitattributes Базовый каркас проекта 2026-10-04 14:04:25 +05:00
.gitignore MC-110 — TLS на публичном входе: HTTPS на gateway, сертификаты и проброс схемы 2026-10-17 15:50:19 +05:00
AGENTS.md MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
build.gradle.kts MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
dev.env.example MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
docker-compose.yml MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
gradle.properties MC-001 — Auth: схема пользователей, регистрация и Argon2id credentials 2026-10-05 20:06:12 +05:00
gradlew Базовый каркас проекта 2026-10-04 14:04:25 +05:00
gradlew.bat Базовый каркас проекта 2026-10-04 14:04:25 +05:00
README.md MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00
settings.gradle.kts MC-091 — build-logic: типизированные плагины вместо apply(from = …) 2026-10-14 23:47:20 +05:00
TODO.md MC-112 — Наблюдаемость: Prometheus и Grafana, отдача метрик 2026-10-19 16:47:40 +05:00

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