Skip to content

Режимы Установки

Выбирайте Самый Узкий Режим Под Задачу

Практически codex-django используется в трех режимах:

  1. Runtime library mode, когда проекту нужны только переиспользуемые Django-модули.
  2. Scaffold mode, когда разработчик генерирует или расширяет Codex-shaped проект через codex-django-cli.
  3. Contributor mode, когда меняется сама библиотека codex-django.

Runtime Library Mode

Ставьте только пакет и те extras, которые реально нужны вашему Django-проекту:

pip install codex-django
pip install "codex-django[cli]"
pip install "codex-django[dev]"

Этот режим нужен командам, которые используют runtime-модули core, system, booking, notifications и cabinet.

Scaffold Mode

Используйте companion CLI package, когда нужно создать новый проект или добавить в него feature scaffolds:

pip install "codex-django[cli]"
# или: pip install codex-django-cli
codex-django init myproject
codex-django add-client-cabinet --project myproject
codex-django add-booking --project myproject
codex-django add-notifications --app system --project myproject

CLI больше не является частью runtime-дистрибутива. Его лучше воспринимать как project-construction tooling, которое зависит от codex-django, а не как business runtime code внутри того же пакета.

Contributor Mode

Если вы меняете сам codex-django, поднимайте полное development-окружение:

uv sync --extra dev
uv run pytest
uv run mypy src/
uv run pre-commit run --all-files
uv build --no-sources

Production Guidance

  • generated project code должен жить в вашем application repository;
  • scaffolding лучше считать developer-time или build-time активностью;
  • production images должны тянуть только те зависимости, которые реально нужны runtime-приложению;
  • не завязывайте production container на interactive CLI flows без явной операционной причины.

Что Читать Дальше