# Проверенные первичные источники

Проверил координатор 2026-09-08. Источники подтверждают технические свойства,
а не доказывают правильность всей предлагаемой методики. Django 5.2 выбран
как конкретная версия справочника для примеров; это не требование версии
целевого проекта. При применении гайда сведения перепроверяются по фактическому стеку.

## Django и фоновые процессы

### S01. Транзакции и действия после commit

`on_commit()` выполняет callback после успешного commit; callback не входит
в завершившуюся транзакцию и его сбой не откатывает её. `ATOMIC_REQUESTS`
не включает middleware и последующую выдачу streaming response.
Следствие для предлагаемого гайда: отдельно описывать границу транзакции,
внешние эффекты и восстановление после сбоя между ними; `on_commit` сам
по себе не доказывает надёжную доставку сообщения.

[Django transactions](https://docs.djangoproject.com/en/5.2/topics/db/transactions/)

### S02. Проверки транзакционного поведения

В Django `TestCase` и `TransactionTestCase` имеют разные условия работы с
транзакциями. Для callback предусмотрен `captureOnCommitCallbacks`.
Нужно отличать проверку зарегистрированного callback от реального взаимодействия
БД, брокера и worker; выбранный тест должен проверять нужное свойство.

[Django testing tools](https://docs.djangoproject.com/en/5.2/topics/testing/tools/)

### S03. Исторические модели в миграциях

При `RunPython` используются исторические модели из переданного registry,
а не прямой импорт текущей модели. Исторические модели не содержат произвольных
пользовательских методов. Повторный прогон миграций нужен отдельно от теста
новой версии приложения.

[Django migrations](https://docs.djangoproject.com/en/5.2/topics/migrations/)

### S04. ORM и обход обычных путей записи

`QuerySet.update()` не вызывает `Model.save()` и сигналы сохранения.
Массовое удаление не вызывает методы `delete()` экземпляров, но посылает
сигналы удаления. Поэтому карту бизнес-правил нельзя строить только по
`save()` и HTTP endpoints: способы записи и удаления должны быть учтены явно.

[Django QuerySet reference](https://docs.djangoproject.com/en/5.2/ref/models/querysets/)

### S05. Валидация моделей

`Model.save()` не запускает `full_clean()` автоматически. Расположение
валидации и ограничения БД необходимо выяснять, а не предполагать по наличию
метода `clean()`.

[Django model instances](https://docs.djangoproject.com/en/5.2/ref/models/instances/)

### S06. Сигналы и точки неявного поведения

Справочник сигналов используется при инвентаризации обработчиков,
подключений и побочных эффектов. Наличие сигнала в коде не доказывает,
что каждый путь изменения данных проходит через него — см. S04.

[Django signals](https://docs.djangoproject.com/en/5.2/ref/signals/)

### S07. Объектные права DRF

Object-level permissions не применяются автоматически к каждому объекту
list endpoint. Проверка создания также требует отдельного пути. В гайде
должны быть раздельные сценарии list/create/detail и изоляции арендаторов,
если DRF и multi-tenancy присутствуют в реальном проекте.

[DRF permissions](https://www.django-rest-framework.org/api-guide/permissions/)

### S08. Повторное выполнение Celery

Режим подтверждения сообщения и сбои worker влияют на повторную доставку.
Celery рекомендует идемпотентность задач; `acks_late` сам по себе не решает
все случаи сбоев. Проектный контракт должен описывать допустимые повторы,
ключи идемпотентности и компенсацию внешних эффектов.

[Celery tasks](https://docs.celeryq.dev/en/stable/userguide/tasks.html)

### S09. Проверки окружения и выпуска

Deployment checklist Django — вход для проверки конфигурации и эксплуатации,
а не готовая политика выпуска любого проекта. Фактические настройки и способ
развёртывания должны фиксироваться отдельно для каждой среды.

[Django deployment checklist](https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/)

## Контроль изменений

### S10. Ограничения локальных Git hooks

Часть локальных hooks можно пропустить через `--no-verify`. Следствие:
локальная проверка улучшает обратную связь, но обязательный контроль должен
быть отдельно обеспечен на стороне системы приёмки.

[Git hooks](https://git-scm.com/docs/githooks)

### S11. GitHub: обязательные проверки, устаревшие approvals, merge queue

GitHub предоставляет protected branches, обязательные checks, сброс
устаревших approvals и merge queue. Документация также указывает, что
некоторые статусы `skipped`/`neutral` удовлетворяют правилам required checks.
Предложение для нашего процесса: отдельный доверенный агрегатор должен
проверять именно выполнение обязательных проверок, их актуальность и источник,
а не только общий зелёный индикатор.

[GitHub protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)

### S12. GitLab: приёмка merge request

Настройки approvals позволяют ограничивать самоодобрение и сбрасывать
approvals после изменений. Конкретные возможности и ограничения зависят
от версии, конфигурации и плана; платформа не выбрана за пользователя.

[GitLab approval settings](https://docs.gitlab.com/user/project/merge_requests/approvals/settings/)

## Проверки и контекст моделей

### S13. Нестабильные тесты

pytest описывает источники flaky tests и варианты работы с ними.
Предложение для гайда: нестабильность хранить как явный дефект с областью
влияния и сроком; повторный запуск до зелёного состояния не считать
самостоятельным доказательством исправления.

[pytest flaky tests](https://docs.pytest.org/en/stable/explanation/flaky.html)

### S14. Проверки последовательностей состояний

Hypothesis поддерживает stateful testing. Это подходящий вариант инструмента
для поиска нарушений инвариантов на последовательностях операций, когда
проект может сформулировать модель состояния и ожидаемые свойства.

[Hypothesis stateful tests](https://hypothesis.readthedocs.io/en/latest/stateful.html)

### S15. Инструкции Claude и принудительные ограничения

Документация Claude Code отличает `CLAUDE.md` как контекст от принудительных
ограничений. Следствие: инструкция в Markdown и способность технически
запретить действие — разные части решения. Политика исполнения должна
проверяться вне свободного текста ответа модели.

[Claude Code memory](https://code.claude.com/docs/en/memory)

### S16. Программный обмен между участниками

Для текущих дебатов используются реальные CLI, поддерживающие программный
запуск, вывод и продолжение сессий. Это механизм обсуждения, не готовая
система автономной разработки целевого проекта.

[Codex non-interactive mode](https://learn.chatgpt.com/docs/non-interactive-mode)
и [Claude Code programmatic usage](https://code.claude.com/docs/en/headless).
