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 остается основным операционным исполнителем.