Перейти к содержимому
Locali Locali Platform Docs

platform-docs — хаб знаний платформы Locali

Единый источник истины по платформе: бизнес-логика, техническая архитектура по всем проектам (office, kassa-backend, kassa/POS, contracts) и точка сборки knowledge-графа. Цель — чтобы и людям, и Claude было где смотреть, без копий и дрейфа по репозиториям.

🌐 Читать с навигацией, графом связей и поиском: https://docs.lo-cali.com Сайт собирается из этих же файлов (Astro Starlight) — генератор в site/, деплой в deploy/. Как ссылаться из других реп — LINKING.md.

Структура

ARCHITECTURE.md       — кросс-системная архитектура (Офис ↔ Касса ↔ POS): источник истины
PRD.md                — мастер-PRD продукта
architecture/         — технические доки по областям/сервисам (+ pos-terminal-auth-flow.md)
business/             — бизнес-логика и предметная область (номенклатура, склад, учёт, …)
prd/                  — PRD по доменам (accounting, inventory, pos, staffing, …)
frontend-integration/ — контракты API для фронта по доменам (accounting/inventory/…)
graph/                — knowledge-граф кода (graphify): как собирается и раздаётся

Принцип: один источник, не копии

  • Кросс-системные доки живут здесь в единственном экземпляре.
  • Репозитории сервисов не дублируют их, а ставят одну строку-ссылку сюда из своего CLAUDE.md/README.
  • Репо-специфичное (как поднять именно этот сервис) остаётся в самом репо.

Как это потребляется

Люди — читают здесь; в каждом сервисе — указатель на этот репо.

Claude — двумя путями:

  1. Плагин devops1/claude-platform (MCP-хаб + скилл-карта стека) — доступ во всех репо.
  2. graphify индексирует этот репо → hosted MCP (graphify.lo-cali.com) отдаёт доки/архитектуру в любом репо, даже если файла там физически нет.

Граф (graph/)

Федеративный граф кода всех сервисов раздаётся централизованно через graphify (hosted MCP). Этот репо — канонический дом для его доко-слоя: архитектурные и бизнес-доки отсюда попадают в семантический слой графа. Детали сборки — в graph/README.md.

Рост

Сюда складываем новые архитектурные и доменные доки по мере появления проектов — один дом, единые ссылки, общий граф. Артефакты графа (graphify-out/) в git не коммитятся.