Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.royalratsproductions.ru/llms.txt

Use this file to discover all available pages before exploring further.

Обзор архитектуры

CROWN/RRP построен как модульная система вокруг Discord runtime. Основная задача архитектуры — разделить ядро, доменные модули, интеграции, хранение данных и эксплуатационные процессы.

Слои

  • Core — общие сервисы, настройки, доступы, безопасность, UI-основа, диагностика и фоновые задачи.
  • Modules — функциональные области: банк, фракции, заявки, реестры, социальные функции, сессии и другие модули.
  • Services — фоновые обработчики, восстановление, обслуживание и runtime-наблюдаемость.
  • Integrations — внешние API и адаптеры.
  • Infrastructure — запуск, деплой, окружение, проверки и восстановление.
Core не должен зависеть от модулей. Модули используют публичные сервисы Core и не должны напрямую вызывать внешние интеграции, если для этого есть общий сервисный путь.

UI и доступ

Discord-интерфейсы строятся по общему UI-контракту: компактные экраны, кнопка возврата, подтверждение опасных действий и ограничение количества кнопок. Доступ к служебным действиям проходит через централизованные проверки ролей, прав и состояния модуля.

Устойчивость

Состояние, которое влияет на экономику, заявки и активные операции, хранится в постоянных хранилищах. Фоновые процессы рассчитаны на повторный запуск: они восстанавливают незавершенные заявки, повторно читают активные кредиты и избегают дублей операций.

Будущее направление

Проект постепенно движется к разделению Discord-исполнителя, веб-панели и серверного слоя данных. Текущий код уже содержит переходные контракты для будущего общего backend-слоя, но Discord runtime остается основным операционным исполнителем.