| Направление | Django: два-три проекта и проверенные стартовые пути | Внешний эталон и основание | Ограничение выбора |
|---|---|---|---|
| Модульность и границы | [PostHog: `pyproject.toml`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/pyproject.toml#L562-L595) [@R_posthog]<br>[Open edX platform: `pyproject.toml`](https://github.com/openedx/openedx-platform/blob/872a112306a366c5ed1ba1b7dae5d0239b437536/pyproject.toml#L691-L740) [@R_openedx-platform]<br>[pretalx: `doc/developer/architecture/structure.rst`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/doc/developer/architecture/structure.rst#L79-L165) [@R_pretalx] {факт} | [Spring Modulith (Java)](https://docs.spring.io/spring-modulith/reference/fundamentals.html) — явные API модулей и структурная верификация. [@modulith] {факт} | Отличать заявленную раскладку от исполняемых запретов зависимости. {гипотеза} |
| Доменный слой | [Zulip: `zerver/actions/message_send.py`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/zerver/actions/message_send.py#L1-L40) [@R_zulip]<br>[pretix: `src/pretix/base/services/orders.py`](https://github.com/pretix/pretix/blob/4119d04fbadf60c18dd930214e20c2a3672e2a83/src/pretix/base/services/orders.py#L1-L65) [@R_pretix]<br>[pretalx: `src/pretalx/submission/domain/submission.py`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/src/pretalx/submission/domain/submission.py#L1-L60) [@R_pretalx] {факт} | [eShop (.NET/C#)](https://github.com/dotnet/eShop) — публичное reference-приложение для сопоставления доменной модели и границ. [@eshop] {факт} | Три разных способа назвать и ограничить доменную операцию; универсальный победитель не назначается. {гипотеза} |
| ORM, данные и миграции без простоя | [Saleor: `.github/workflows/test-migrations-compatibility.yml`](https://github.com/saleor/saleor/blob/532023db50ac9d48b41f898e990c141805046c01/.github/workflows/test-migrations-compatibility.yml#L54-L72) [@R_saleor]<br>[Zulip: `docs/subsystems/schema-migrations.md`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/docs/subsystems/schema-migrations.md#L13-L65) [@R_zulip]<br>[PostHog: `docs/published/handbook/engineering/safe-django-migrations.md`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/docs/published/handbook/engineering/safe-django-migrations.md#L7-L44) [@R_posthog] {факт} | [GitLab (Rails/Ruby)](https://docs.gitlab.com/development/database/avoiding_downtime_in_migrations/) — документированные фазы миграций без простоя. [@gitlab_migrations] {факт} | Нужны фактические rollout-ограничения, а не только makemigrations --check. {гипотеза} |
| API REST и GraphQL | [Django REST Framework: `rest_framework/serializers.py`](https://github.com/encode/django-rest-framework/blob/41764f1f8cfb6d40b77b58c97cf9aeaab57c6b5c/rest_framework/serializers.py#L1-L40) [@R_django-rest-framework]<br>[Django Ninja: `ninja/operation.py`](https://github.com/vitalik/django-ninja/blob/a7b306f03ae281101ff24735843eaa4f1a5f6871/ninja/operation.py#L1-L40) [@R_django-ninja]<br>[Saleor: `saleor/graphql/core/mutations.py`](https://github.com/saleor/saleor/blob/532023db50ac9d48b41f898e990c141805046c01/saleor/graphql/core/mutations.py#L1-L40) [@R_saleor] {факт} | [Shopify GraphQL API](https://shopify.dev/docs/api/admin-graphql/latest) — версионированный контракт, scopes, запросы и лимиты. [@shopify]<br>[Stripe API/webhooks](https://docs.stripe.com/webhooks) — явно оговорённые внешние события и повторная доставка. [@stripe] {факт} | REST — DRF/Ninja, GraphQL — Saleor; коммерческий API сравнивается по опубликованному контракту. {гипотеза} |
| Аутентификация, роли и права на объект | [authentik: `authentik/rbac/models.py`](https://github.com/goauthentik/authentik/blob/4438009d3aceec1013f82824d94732302939f952/authentik/rbac/models.py#L1-L35) [@R_authentik]<br>[django-ansible-base: `ansible_base/rbac/models/role.py`](https://github.com/ansible/django-ansible-base/blob/b302bfd5fc9c94af92089ccc892b911b1d870b56/ansible_base/rbac/models/role.py#L1-L40) [@R_django-ansible-base]<br>[NetBox: `netbox/utilities/querysets.py`](https://github.com/netbox-community/netbox/blob/251458b89a5eb2f5fe0d20ecd1140ba08f141a9c/netbox/utilities/querysets.py#L114-L146) [@R_netbox] {факт} | [Keycloak (Java)](https://www.keycloak.org/docs/latest/server_admin/index.html) — единая документация realms, ролей и управляемых ресурсов. [@keycloak] {факт} | Аутентификация, право на объект и фильтрация queryset — разные проверки. {гипотеза} |
| Мультиарендность | [Zulip: `zerver/models/realms.py`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/zerver/models/realms.py#L1-L40) [@R_zulip]<br>[Pulp Core: `pulpcore/app/viewsets/base.py`](https://github.com/pulp/pulpcore/blob/e8439a81c33b6a6aaa34612ba51eed7712e3be09/pulpcore/app/viewsets/base.py#L315-L349) [@R_pulpcore]<br>[django-tenants: `django_tenants/middleware/main.py`](https://github.com/django-tenants/django-tenants/blob/52b74e05d59bab38e0bb87a1533f26100ddd9ffb/django_tenants/middleware/main.py#L13-L54) [@R_django-tenants] {факт} | [Keycloak (Java)](https://www.keycloak.org/docs/latest/server_admin/index.html) — различает realms и organizations как контракты идентификации. [@keycloak] {факт} | Realm/domain, строковая изоляция и схема PostgreSQL не эквивалентны; NetBox tenant не security boundary. {гипотеза} |
| Фоновые и периодические задачи | [Procrastinate: `procrastinate/contrib/django/django_connector.py`](https://github.com/procrastinate-org/procrastinate/blob/58c4b34dec0414a7c4713dd221e06ebd4c86b525/procrastinate/contrib/django/django_connector.py#L1-L40) [@R_procrastinate]<br>[Pulp Core: `docs/admin/learn/architecture.md`](https://github.com/pulp/pulpcore/blob/e8439a81c33b6a6aaa34612ba51eed7712e3be09/docs/admin/learn/architecture.md#L63-L79) [@R_pulpcore]<br>[pretix: `src/pretix/base/services/tasks.py`](https://github.com/pretix/pretix/blob/4119d04fbadf60c18dd930214e20c2a3672e2a83/src/pretix/base/services/tasks.py#L162-L187) [@R_pretix] {факт} | [Oban (Elixir)](https://oban.hexdocs.pm/Oban.html) — транзакционная постановка задач с Ecto и управляемые очереди. [@oban] {факт} | Procrastinate/Pulp — PostgreSQL-контур, pretix — вариант Celery; проверять версию интеграции. {гипотеза} |
| События, outbox, вебхуки и интеграции | [PostHog: `products/conversations/backend/models/email_outbox_message.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/products/conversations/backend/models/email_outbox_message.py#L9-L51) [@R_posthog]<br>[Saleor: `saleor/webhook/models.py`](https://github.com/saleor/saleor/blob/532023db50ac9d48b41f898e990c141805046c01/saleor/webhook/models.py#L1-L40) [@R_saleor]<br>[Zulip: `zerver/lib/queue.py`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/zerver/lib/queue.py#L437-L466) [@R_zulip] {факт} | [Spring Modulith (Java)](https://docs.spring.io/spring-modulith/reference/events.html) — Event Publication Registry хранится в бизнес-транзакции. [@modulith_events]<br>[Stripe webhooks](https://docs.stripe.com/webhooks) — публично оговорены дубликаты событий. [@stripe] {факт} | Это разные гарантии: PostHog persisted outbox, Saleor webhook-модель, Zulip on_commit. Дополнительные пути PostHog приведены ниже. {гипотеза} |
| Поиск | [Zulip: `docs/subsystems/full-text-search.md`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/docs/subsystems/full-text-search.md#L1-L40) [@R_zulip]<br>[Mozilla Add-ons Server: `src/olympia/search/utils.py`](https://github.com/mozilla/addons-server/blob/82ae8abd1f35259f0188c2da279a7123419ac832/src/olympia/search/utils.py#L24-L35) [@R_addons-server]<br>[Read the Docs: `readthedocs/search/tasks.py`](https://github.com/readthedocs/readthedocs.org/blob/5776b40da8797b8161cb5f9384e08e6af4c1b133/readthedocs/search/tasks.py#L24-L55) [@R_readthedocs] {факт} | [Elasticsearch (Java)](https://www.elastic.co/docs/solutions/search) — отдельные контракты индексации, релевантности и переиндексации. [@elastic] {факт} | Сравниваются точки интеграции; качество ранжирования не измерялось. {гипотеза} |
| Файлы и хранилища | [Paperless-ngx: `src/documents/consumer.py`](https://github.com/paperless-ngx/paperless-ngx/blob/f1ae9c00ac02df7b5c8c4b6d3e8c7db08555fb17/src/documents/consumer.py#L67-L95) [@R_paperless-ngx]<br>[Pulp Core: `pulpcore/app/models/domain.py`](https://github.com/pulp/pulpcore/blob/e8439a81c33b6a6aaa34612ba51eed7712e3be09/pulpcore/app/models/domain.py#L15-L70) [@R_pulpcore]<br>[Label Studio: `label_studio/io_storages/base_models.py`](https://github.com/HumanSignal/label-studio/blob/c33ee9009325732a17e948f9fab5d58c289e94e4/label_studio/io_storages/base_models.py#L52-L90) [@R_label-studio] {факт} | [Rails Active Storage (Ruby)](https://guides.rubyonrails.org/active_storage_overview.html) — документированный жизненный цикл файла и адаптеры облачных хранилищ. [@rails_storage] {факт} | Найти также cleanup и восстановление; они не исследовались глубоко. {гипотеза} |
| Кеш | [Zulip: `zerver/lib/cache.py`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/zerver/lib/cache.py#L1-L40) [@R_zulip]<br>[Paperless-ngx: `src/documents/caching.py`](https://github.com/paperless-ngx/paperless-ngx/blob/f1ae9c00ac02df7b5c8c4b6d3e8c7db08555fb17/src/documents/caching.py#L21-L63) [@R_paperless-ngx]<br>[Read the Docs: `readthedocs/proxito/cache.py`](https://github.com/readthedocs/readthedocs.org/blob/5776b40da8797b8161cb5f9384e08e6af4c1b133/readthedocs/proxito/cache.py#L11-L73) [@R_readthedocs] {факт} | [Rails caching (Ruby)](https://guides.rubyonrails.org/caching_with_rails.html) — различает уровни кеша и связи инвалидации. [@rails_cache] {факт} | Кеш queryset и кеш выдаваемого документа имеют разные области корректности. {гипотеза} |
| Производительность под нагрузкой | [Healthchecks: `hc/api/views.py`](https://github.com/healthchecks/healthchecks/blob/92afbc8abfb9220478d7bad73c44da9ea2c64d2e/hc/api/views.py#L1-L35) [@R_healthchecks]<br>[Saleor: `saleor/graphql/core/dataloaders.py`](https://github.com/saleor/saleor/blob/532023db50ac9d48b41f898e990c141805046c01/saleor/graphql/core/dataloaders.py#L1-L40) [@R_saleor]<br>[Zulip: `docs/subsystems/performance.md`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/docs/subsystems/performance.md#L1-L61) [@R_zulip] {факт} | [Rails performance guide (Ruby)](https://guides.rubyonrails.org/tuning_performance_for_deployment.html) — связывает настройку конкурентности с памятью и характером нагрузки. [@rails_performance] {факт} | Healthchecks: Django-стенд отдельно от Go production; у Saleor aggregate requests, не измерение данного dataloader. {гипотеза} |
| Наблюдаемость | [PostHog: `posthog/otel_metrics.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/posthog/otel_metrics.py#L43-L82) [@R_posthog]<br>[NetBox: `netbox/netbox/metrics.py`](https://github.com/netbox-community/netbox/blob/251458b89a5eb2f5fe0d20ecd1140ba08f141a9c/netbox/netbox/metrics.py#L1-L40) [@R_netbox]<br>[django-ansible-base: `docs/lib/observability.md`](https://github.com/ansible/django-ansible-base/blob/b302bfd5fc9c94af92089ccc892b911b1d870b56/docs/lib/observability.md#L1-L40) [@R_django-ansible-base] {факт} | [OpenTelemetry (включая .NET/Java)](https://opentelemetry.io/docs/concepts/signals/) — единые понятия traces, metrics, logs и контекст. [@otel] {факт} | Наличие exporter ещё не определяет полезные SLO и cardinality. {гипотеза} |
| Настройки и фича-флаги | [PostHog: `products/feature_flags/backend/models/feature_flag.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/products/feature_flags/backend/models/feature_flag.py#L1-L60) [@R_posthog]<br>[AWX: `awx/conf/registry.py`](https://github.com/ansible/awx/blob/3c76e236c270b831f0f71465c3e0d7fae040c83a/awx/conf/registry.py#L1-L35) [@R_awx]<br>[django-ansible-base: `docs/lib/dynamic_config.md`](https://github.com/ansible/django-ansible-base/blob/b302bfd5fc9c94af92089ccc892b911b1d870b56/docs/lib/dynamic_config.md#L1-L40) [@R_django-ansible-base] {факт} | [Unleash (TypeScript)](https://docs.getunleash.io/concepts/feature-flags) — жизненный цикл флагов и устаревание конфигурации. [@unleash] {факт} | Настройка приложения и флаг постепенного rollout рассматриваются отдельно. {гипотеза} |
| Плагины и расширяемость | [Wagtail: `wagtail/hooks.py`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/wagtail/hooks.py#L1-L40) [@R_wagtail]<br>[Nautobot: `nautobot/docs/development/apps/index.md`](https://github.com/nautobot/nautobot/blob/6ee21767ca49ab8c7bc8463590ab5f1d75ff0f6d/nautobot/docs/development/apps/index.md#L47-L61) [@R_nautobot]<br>[InvenTree: `src/backend/InvenTree/plugin/registry.py`](https://github.com/inventree/InvenTree/blob/9478c25a70696feddafbff139e6f41d3b0abe78d/src/backend/InvenTree/plugin/registry.py#L1-L55) [@R_inventree] {факт} | [Rails Engines (Ruby)](https://guides.rubyonrails.org/engines.html) — namespaced-контракт расширяемого приложения. [@rails_engines] {факт} | У Baserow дополнительный comparator, но его experimental plugin API не равно стабильному SDK. {гипотеза} |
| Аудит и история изменений | [django-pghistory: `pghistory/core.py`](https://github.com/Opus10/django-pghistory/blob/629ace9eed6461b160f55ba3a5cab2b339dd8e5b/pghistory/core.py#L1-L40) [@R_django-pghistory]<br>[Wagtail: `wagtail/log_actions.py`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/wagtail/log_actions.py#L1-L40) [@R_wagtail]<br>[django-ansible-base: `ansible_base/activitystream/models/entry.py`](https://github.com/ansible/django-ansible-base/blob/b302bfd5fc9c94af92089ccc892b911b1d870b56/ansible_base/activitystream/models/entry.py#L1-L40) [@R_django-ansible-base] {факт} | [Keycloak events (Java)](https://www.keycloak.org/docs/latest/server_admin/index.html) — события пользователей и администраторов как отдельный журнал. [@keycloak] {факт} | История модели, пользовательский аудит и security events имеют разные цели. {гипотеза} |
| Уведомления | [Zulip: `zerver/lib/email_notifications.py`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/zerver/lib/email_notifications.py#L1-L40) [@R_zulip]<br>[Healthchecks: `hc/api/transports.py`](https://github.com/healthchecks/healthchecks/blob/92afbc8abfb9220478d7bad73c44da9ea2c64d2e/hc/api/transports.py#L56-L85) [@R_healthchecks]<br>[pretalx: `src/pretalx/mail/domain/send.py`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/src/pretalx/mail/domain/send.py#L1-L65) [@R_pretalx] {факт} | [Rails Action Mailer (Ruby)](https://guides.rubyonrails.org/action_mailer_basics.html) — публичный контракт формирования и фоновой отправки почты. [@rails_mail] {факт} | Не считать transport доказательством idempotency или гарантированного получения. {гипотеза} |
| Импорт, экспорт и отчёты | [CVAT: `cvat/apps/dataset_manager/formats/registry.py`](https://github.com/cvat-ai/cvat/blob/cde80590ce4a61a54722c13786b7430682403901/cvat/apps/dataset_manager/formats/registry.py#L14-L29) [@R_cvat]<br>[DefectDojo: `dojo/tools/factory.py`](https://github.com/DefectDojo/django-DefectDojo/blob/8b12d80ae30904fed44f5a84ff71f28da14bebaf/dojo/tools/factory.py#L11-L44) [@R_defectdojo]<br>[Ghostwriter: `ghostwriter/reporting/models.py`](https://github.com/GhostManager/Ghostwriter/blob/0de4aa3799763931c8c2b470cf83ff0b857c74b0/ghostwriter/reporting/models.py#L1-L35) [@R_ghostwriter] {факт} | [Spring Batch (Java)](https://docs.spring.io/spring-batch/reference/readersAndWriters.html) — раздельные reader/processor/writer контракты пакетной обработки. [@springbatch]<br>[JasperReports (Java)](https://github.com/Jaspersoft/jasperreports) — шаблонный вывод в PDF/табличные и офисные форматы. [@jasper] {факт} | Форматный registry, импорт scanner-данных и отчётный документ — разные стартовые модули. {гипотеза} |
| Админка и back-office | [Wagtail: `wagtail/admin/viewsets/model.py`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/wagtail/admin/viewsets/model.py#L1-L40) [@R_wagtail]<br>[Django Oscar: `src/oscar/apps/dashboard/apps.py`](https://github.com/django-oscar/django-oscar/blob/d0a70850abf8e4229d4971aa7e8f4643326ec9f3/src/oscar/apps/dashboard/apps.py#L1-L35) [@R_django-oscar]<br>[NetBox: `netbox/netbox/views/generic/object_views.py`](https://github.com/netbox-community/netbox/blob/251458b89a5eb2f5fe0d20ecd1140ba08f141a9c/netbox/netbox/views/generic/object_views.py#L39-L79) [@R_netbox] {факт} | [ActiveAdmin (Rails/Ruby)](https://activeadmin.info/documentation.html) — публичные ресурсы, формы и авторизация административного интерфейса. [@activeadmin] {факт} | Django admin не единственный вариант server-side back-office. {гипотеза} |
| Формы, шаблоны и HTMX | [pretalx: `src/pretalx/common/views/helpers.py`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/src/pretalx/common/views/helpers.py#L11-L49) [@R_pretalx]<br>[django-htmx: `src/django_htmx/middleware.py`](https://github.com/adamchainz/django-htmx/blob/feee7a4897cb1a38ff613ef1aa390eca135c7c66/src/django_htmx/middleware.py#L17-L63) [@R_django-htmx]<br>[Wagtail: `wagtail/admin/forms/models.py`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/wagtail/admin/forms/models.py#L1-L40) [@R_wagtail] {факт} | [Rails + Hotwire Turbo](https://turbo.hotwired.dev/handbook/introduction) — документированные partial navigation и server-rendered updates. [@turbo] {факт} | Наличие HX-header требует проверки границ URL и прав, не только шаблона. {гипотеза} |
| Async и Channels | [Channels: `channels/consumer.py`](https://github.com/django/channels/blob/531894e5b2a825168e16fd82f1766f748f71faf4/channels/consumer.py#L25-L92) [@R_channels]<br>[Paperless-ngx: `src/paperless/consumers.py`](https://github.com/paperless-ngx/paperless-ngx/blob/f1ae9c00ac02df7b5c8c4b6d3e8c7db08555fb17/src/paperless/consumers.py#L1-L46) [@R_paperless-ngx]<br>[Django Ninja: `ninja/operation.py`](https://github.com/vitalik/django-ninja/blob/a7b306f03ae281101ff24735843eaa4f1a5f6871/ninja/operation.py#L1-L40) [@R_django-ninja] {факт} | [Phoenix Channels (Elixir)](https://phoenix.hexdocs.pm/channels.html) — явные socket/channel процессы и topics для realtime. [@phoenix] {факт} | Различать async request handling, WebSocket consumer и durable background job. {гипотеза} |
| i18n | [Weblate: `weblate/trans/models/translation.py`](https://github.com/WeblateOrg/weblate/blob/bdc9c3dbc7052408e1ffac3a962225571254fd77/weblate/trans/models/translation.py#L1-L40) [@R_weblate]<br>[Wagtail: `wagtail/models/i18n.py`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/wagtail/models/i18n.py#L1-L40) [@R_wagtail]<br>[pretalx: `doc/developer/translating.rst`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/doc/developer/translating.rst#L1-L55) [@R_pretalx] {факт} | [Rails I18n (Ruby)](https://guides.rubyonrails.org/i18n.html) — локали, pluralization и fallback в одном официальном руководстве. [@rails_i18n] {факт} | Перевод интерфейса, перевод контента и локализованный поиск различаются. {гипотеза} |
| Безопасность | [django-allauth: `allauth/core/internal/ratelimit.py`](https://github.com/pennersr/django-allauth/blob/231d55eea8634a0bd781aa8debd17d60905f645b/allauth/core/internal/ratelimit.py#L1-L53) [@R_django-allauth]<br>[pretalx: `src/pretalx/common/views/helpers.py`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/src/pretalx/common/views/helpers.py#L35-L42) [@R_pretalx]<br>[authentik: `authentik/rbac/models.py`](https://github.com/goauthentik/authentik/blob/4438009d3aceec1013f82824d94732302939f952/authentik/rbac/models.py#L1-L35) [@R_authentik] {факт} | [Rails security guide (Ruby)](https://guides.rubyonrails.org/security.html) — систематизированы CSRF, XSS, sessions и угрозы загрузки файлов. [@rails_security]<br>[Keycloak (Java)](https://www.keycloak.org/docs/latest/server_admin/index.html) — проверка протокольных и административных границ доверия. [@keycloak] {факт} | Точки проверки rate limiting, безопасного URL и авторизации; полноценный security audit не выполнялся. {гипотеза} |
| Тестирование | [Zulip: `docs/testing/philosophy.md`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/docs/testing/philosophy.md#L1-L40) [@R_zulip]<br>[Django Ninja: `ninja/testing/client.py`](https://github.com/vitalik/django-ninja/blob/a7b306f03ae281101ff24735843eaa4f1a5f6871/ninja/testing/client.py#L1-L40) [@R_django-ninja]<br>[pretalx: `pyproject.toml`](https://github.com/pretalx/pretalx/blob/d36cd30c525a80bed63dd1d7ac4483a498c9248c/pyproject.toml#L165-L199) [@R_pretalx] {факт} | [Rails tests (Ruby)](https://guides.rubyonrails.org/testing.html) — разделяет unit, integration и browser system tests. [@rails_tests] {факт} | Процент покрытия и набор сценариев следует оценивать раздельно. {гипотеза} |
| CI и гейты качества | [NetBox: `.github/workflows/ci.yml`](https://github.com/netbox-community/netbox/blob/251458b89a5eb2f5fe0d20ecd1140ba08f141a9c/.github/workflows/ci.yml#L126-L148) [@R_netbox]<br>[Open edX platform: `.github/workflows/lint-imports.yml`](https://github.com/openedx/openedx-platform/blob/872a112306a366c5ed1ba1b7dae5d0239b437536/.github/workflows/lint-imports.yml#L1-L38) [@R_openedx-platform]<br>[Saleor: `.github/workflows/test-migrations-compatibility.yml`](https://github.com/saleor/saleor/blob/532023db50ac9d48b41f898e990c141805046c01/.github/workflows/test-migrations-compatibility.yml#L54-L72) [@R_saleor] {факт} | [ArchUnit (Java)](https://www.archunit.org/userguide/html/000_Index.html) — исполняемые проверки слоёв и циклов между пакетами. [@archunit] {факт} | CI definition не доказывает required branch protection и успешность последнего запуска. {гипотеза} |
| Обновление Django | [Wagtail: `.github/workflows/test.yml`](https://github.com/wagtail/wagtail/blob/ae4a16dee644638019dd508b448a5315000745f7/.github/workflows/test.yml#L16-L36) [@R_wagtail]<br>[django CMS: `.github/workflows/test.yml`](https://github.com/django-cms/django-cms/blob/e87eef5bb40d7f674195295f39a0dc60c12b5664/.github/workflows/test.yml#L21-L42) [@R_django-cms]<br>[Zulip: `docs/subsystems/django-upgrades.md`](https://github.com/zulip/zulip/blob/cba94dddf49ca6014ba508354d26d1e1622070f4/docs/subsystems/django-upgrades.md#L1-L36) [@R_zulip] {факт} | [Rails upgrade guide (Ruby)](https://guides.rubyonrails.org/upgrading_ruby_on_rails.html) — описанный процесс проверки приложения при обновлении фреймворка. [@rails_upgrade] {факт} | Совместимость main и совместимость стабильного релиза сравниваются отдельно. {гипотеза} |
| Документация архитектурных решений | [Mozilla Kitsune: `docs/architecture/decisions/0001-record-architecture-decisions.md`](https://github.com/mozilla/kitsune/blob/a401eb94d694764c20e7290044632e1d2ce5720d/docs/architecture/decisions/0001-record-architecture-decisions.md#L1-L19) [@R_kitsune]<br>[Read the Docs: `docs/dev/design/index.rst`](https://github.com/readthedocs/readthedocs.org/blob/5776b40da8797b8161cb5f9384e08e6af4c1b133/docs/dev/design/index.rst#L1-L10) [@R_readthedocs]<br>[Open edX platform: `docs/decisions/0038-standardize-rest-api-url-structure.rst`](https://github.com/openedx/openedx-platform/blob/872a112306a366c5ed1ba1b7dae5d0239b437536/docs/decisions/0038-standardize-rest-api-url-structure.rst#L1-L55) [@R_openedx-platform] {факт} | [Spring Modulith (Java)](https://docs.spring.io/spring-modulith/reference/fundamentals.html) — связывает модель модулей, документацию и структурную проверку. [@modulith]<br>[GitLab (Rails/Ruby)](https://docs.gitlab.com/development/architecture/) — публичный контекст границ многочисленных компонентов. [@gitlab_architecture] {факт} | Наличие ADR проверено; актуальность каждого решения относительно кода ещё требует извлечения. {гипотеза} |

**Дополнительные адреса outbox PostHog:** [PostHog: `products/conversations/backend/signals.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/products/conversations/backend/signals.py#L405-L444) [@R_posthog], [PostHog: `products/conversations/backend/api/tickets.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/products/conversations/backend/api/tickets.py#L1625-L1640) [@R_posthog], [PostHog: `products/conversations/backend/tasks/email.py`](https://github.com/PostHog/posthog/blob/8c06f93e475605c7795e9b133f6f5b2af7de39a0/products/conversations/backend/tasks/email.py#L213-L288) [@R_posthog]. {факт}

**Покрытие карты:** 27 строк, у каждой два-три Django-ориентира и один-два внешних ориентира; объединённое направление обновлений и ADR разделено для точности. {гипотеза}
