AGENTS.md — public-api

Назначение уровня

Этот уровень описывает целевую сервисную границу public-api, а также разницу между текущим API-scaffold и будущим внешним контрактом.

Содержание

public-api/
├── AGENTS.md     # ← вы здесь
└── README.md     # назначение, статус, протоколы, зависимости

Ключевые концепции уровня

• Multi-protocol API — единый сценарий через REST, RPC и WebSocket.
• Cache + Actualize + Watch — целевая модель работы клиента с данными.

Когда смотреть сюда

• Нужно понять внешний контракт системы.
• Нужно разобраться, как публичный API связывается с внутренними сервисами.

Когда НЕ смотреть сюда

• Нужны административные endpoints → ../admin-api/.
• Нужен текущий минимальный runtime-код → backend/cmd/api-server и backend/internal/httpserver.

Связано

• README.md
• ../../20-architecture/adr/0015-multi-protocol-public-api.md
• ../../20-architecture/schemas/api/AGENTS.md

Соглашения

• Не путайте текущий api-server scaffold с полной реализацией public-api.