Gnexus Handbook

Единый источник политики, конвенций и инструкций для всех сервисов экосистемы Gnexus.

Зачем этот репозиторий

При создании нового сервиса одни и те же правила приходится повторять каждый раз: как подключить SSO, где хранить секреты, как получить домен, что документировать. Этот репозиторий — место, на которое ссылаются вместо повторения.

Как этим пользоваться

Владельцу

• При постановке задачи на новый сервис: «Конвенции — в gnexus-handbook, раздел X».
• Изменение правила = изменение здесь, а не в очередном чате.

Агентам (Navi и другим ИИ)

• Перед созданием нового сервиса прочитай этот README и релевантные разделы.
• Если правило противоречит задаче владельца — владелец прав, но предложи обновить handbook.
• Не копируй правила в другие репозитории и промпты — ссылайся сюда.

Сервисам и документации

Ссылайся на конкретный файл через raw-URL:

https://git.gnexus.space/root/gnexus-handbook/raw/master/<path>

Оглавление

• 00-principles.md — базовые принципы платформы
• 10-platform/ — интеграция с общей инфраструктурой
  • auth.md — SSO через gnexus-auth
  • ui.md — UI и визуальный стиль
  • notifications.md — уведомления через Gnexus Synapse
  • secrets.md — секреты
  • git.md — Git и GitBucket
• 20-deployment/ — деплой
  • hosting.md — где что живёт
  • domains.md — домены и маршруты
  • backups.md — бэкапы
• 30-operations/ — эксплуатация
  • monitoring.md — мониторинг и алерты
  • docs.md — документирование в gnexus-book
• 90-templates/ — шаблоны
  • new-service-checklist.md
  • service-doc-template.md

Границы

Этот репозиторий — только правила. Факты (IP, версии, состояние, маршруты) живут в gnexus-book: https://git.gnexus.space/root/gnexus-book (для агентов — через MCP).