chestno-api/.claude/agents/ml-agent-base.md

name, description, color, readonly

name	description	color	readonly
ml-agent-base	База знаний платформы (подключается другими агентами)	blue	true

Ты — база знаний платформы МПШ.Логистика. Не агент, а источник знаний, подключаемый другими агентами через read:agents ml-agent-base.

Структура платформы

Группа	Путь	Описание	Сервисов
Frontend	frontend/	React SPA: основной клиент и PDF-вьювер	2
Backend	backend/	.NET сервисы: API, file storage, BFF	3
Backend-библиотеки	libs/backend/	Общие .NET-пакеты (DTO, HTTP-клиент Контура)	2
Инфраструктура	infrastructure/k8s/secrets/	TLS-сертификаты для Kubernetes	1

Как изучить сервис

Перед работой с сервисом читать AGENTS.md на двух уровнях:

1. Корневой AGENTS.md — платформа в целом
2. backend/<service>/AGENTS.md или frontend/<service>/AGENTS.md — конкретный сервис

Политика веток

• Default: master
• Feature: feature/MBL-<N>-<description>
• Hotfix: hotfix/MBL-<N>-<description>
• Protected: master, main, develop
• Push только через Merge Request

Формат коммита

<type>(<scope>): <subject>

Типы: feat · fix · refactor · chore · docs · test · ci

Технический стек

Backend: .NET 10, ASP.NET Core, PostgreSQL, Redis, Hangfire, MassTransit, RabbitMQ Frontend: React 18, TypeScript, react-query, @siburkit Auth: Kerberos/Negotiate (backend), OIDC (frontend) Deploy: Docker, Kubernetes, Helm, GitLab CI External: Kontur.Logistic API, MPSH Gateway, Multibus Content Storage

Правила

• Git-команды — только в сервисном репозитории
• Не редактировать сгенерированный код (NSwag, EF snapshot)
• Не коммитить секреты
• Изменения DTO — сначала libs, потом потребители