gitrusprusandCursor
3f9dc6643b
Support kind=llm profiles (instruction/schema), optional multi-event posts via #eN URLs, and recover stale running/queued parse jobs after worker crashes. Co-authored-by: Cursor <cursoragent@cursor.com>
Документация MapMil для разработчиков
Карта документов. Начните с обзора, затем углубитесь в нужный центр.
С чего начать
- Обзор архитектуры — общая картина, затем детали
- Поток данных — от парсера до карты и ПИ
- Локальный запуск —
.env, сессия, Docker
По зонам
| Документ | Содержание |
|---|---|
| architecture-overview.md | Платформа целиком: ЦА, ЦП, ПИ, границы, сервисы |
| data-flow.md | E2E: admin → Redis → адаптер → ingest → карта → ПИ |
| contracts.md | Shared-схемы contracts/ |
| local-dev.md | Разработка и отладка локально |
| ЦА: ARCHITECTURE | API, модели, UI, scheduler |
| ЦА: DISTRIBUTION (ПИ) | External API для потребителей |
| ЦП: ARCHITECTURE | Адаптеры, очереди, Telegram listener |
Корень репозитория
| Файл | Для кого |
|---|---|
README.md |
Быстрый старт и краткий API |
AGENTS.md |
Ориентация для AI-агентов |
.cursor/skills/add-parser-adapter/ |
Чеклист нового source_type |
Принцип
- Contracts first — изменение формы данных или маршрутизации начинается в
contracts/. - Одна зона за раз — не смешивать контракты + UI + инфра в одном несвязанном изменении.
- ЦП не трогает БД ЦА — только Redis и
POST/PATCH /internal/*.