surfaces/.planning/codebase/STRUCTURE.md

Структура (STRUCTURE.md)

• core/:
  • protocol.py — Унифицированные структуры данных (сообщения, файлы, UI).
• adapter/matrix/:
  • bot.py — Главный event-loop Matrix.
  • converter.py — Конвертация событий Matrix-nio ⇄ core/protocol.py.
  • agent_registry.py — Парсинг matrix-agents.yaml.
  • files.py — Работа с вложениями и shared volume.
  • store.py — SQLite база для маппинга чатов Matrix и platform_chat_id.
  • routed_platform.py — Динамический роутинг вызовов к нужным агентам на лету.
• sdk/:
  • interface.py — Интерфейс PlatformClient.
  • real.py — Имплементация WebSocket клиента (AgentApi).
  • mock.py — Мок-клиент для E2E тестов без платформы.
• config/: Конфиги маршрутизации (YAML).
• docs/: Актуальная документация по развертыванию и архитектуре.
• docker-compose*.yml: Продакшн и локальные манифесты для сборки.