Юниты

Юнит описывает часть реализации с определённой ответственностью. Из него можно открыть исходные файлы, зависимости, правила и связанные спецификации.

Зачем выделять юниты

Одно требование часто затрагивает несколько файлов. Связи с юнитами показывают, за какую часть поведения отвечает каждый участок кода.

Юнит имеет ключ и историю редакций. Он может соответствовать одному файлу или набору файлов, которые выполняют общую роль.

От спецификации к исходным файлам

Связи показывают, где реализовано поведение и какие правила применяются к этим файлам.

НАЗНАЧЕНИЕ ПРОДУКТА

Требования и спецификации

Требование описывает ожидаемое поведение. Связанные интерфейсы, данные и API уточняют, как устроен сценарий.

Почему и что должно существовать

КОНТЕКСТ РЕАЛИЗАЦИИ

Юнит

У юнита есть ключ, тип, файлы, технические зависимости, связи со спецификациями и результаты проверки.

Ответственность и правила реализации

РЕАЛИЗАЦИЯ

Исходные файлы и коммиты

Пути указывают на файлы реализации. Связанные коммиты показывают, какие изменения затронули эти файлы.

Где реализуется поведение

Как связаны спецификации и файлы

Например, юнит диалога согласования может ссылаться на спецификацию интерфейса, связанную операцию API и файлы компонента.

Требование REQ-24 «Утвердить расходы», UI-08 «Диалоговое окно утверждения», API-15 «Утвердить расходы» и D-12 «Расходы» связать с программным модулем U-42 «Диалоговое окно утверждения». Модуль сопоставляется с ApprovalDialog.vue, useApprovalDialog.ts и ApprovalDialog.test.ts в /comComponents/approvals/.

Какие правила действуют для файлов

Общие правила берутся из Code Manifest подсистемы, требования к роли — из типа юнита. Для одного юнита можно добавить отдельные указания.

Тот же диалог утверждения U-42 принадлежит подсистеме внешнего интерфейса и соответствует типу юнитов для компонентов пользовательского интерфейса. Манифест кода подсистемы, правила типа юнита и его собственные указания по реализации определяют изменения в его исходных файлах.

Состав файлов и допустимые связи зависят от правил проекта.

Что хранится в юните

Ключ, тип и история

Ключ связывает редакции одного юнита. Из записи также видны название, подсистема, область проекта и статус.

Исходные файлы

Список путей показывает, какие файлы входят в юнит. В зависимости от его роли это может быть один файл или несколько.

Правила реализации

Для юнита доступны правила подсистемы и типа, а также дополнительные указания для его реализации.

Связи и результаты проверок

По связям можно открыть спецификации, потребителей, зависимости и коммиты. Статус синхронизации и замечания помогают найти изменения, которые нужно проверить.

Примеры состава юнитов

Границы юнита определяются его ответственностью. Правила типа задают, какие файлы могут входить в него.

Фронтенд · КОМПОЗИТ

Компонент формы регистрации

/components/auth/SignupForm.vue
/components/auth/useSignupForm.ts
/components/auth/SignupForm.test.ts

Юнит может объединять форму регистрации, её поведение и тесты, если это предусмотрено типом.

БЭКЭНД · ОДНА РОЛЬ

Действие регистрации пользователя

/app/Actions/Users/
RegisterUserAction.php

Действие в одном файле следует правилам расположения, именования, зависимостей и поведения своего типа.

ИНТЕГРАЦИЯ · КОМПОЗИТ

Адаптер платёжного провайдера

/billing/BillingClient.ts
/billing/billing-contract.ts
/billing/BillingClient.test.ts

Если файлы совместно реализуют один адаптер, их можно включить в один юнит.

В конкретном проекте состав юнитов определяется его архитектурой и типами.

Как используются юниты

Юниты помогают описать существующую реализацию, определить область изменения и проверить результат.

1
СУЩЕСТВУЮЩАЯ КОДОВАЯ БАЗА

Описание существующего кода

Привяжите репозитории к подсистемам и веткам. Unit Discovery сопоставляет выбранные файлы с юнитами и уточняет их типы и прямые зависимости.

2
ПЛАНИРОВАНИЕ ФУНКЦИЙ

Границы изменения

Свяжите спецификации с юнитами, которые их реализуют. Для нового поведения опишите планируемую роль и состав файлов.

3
РЕАЛИЗАЦИЯ

Контекст для реализации

Передайте агенту относящиеся к задаче правила, спецификации, файлы и зависимости.

4
ПРОВЕРКА И ОБСЛУЖИВАНИЕ

Проверка результата

Просмотрите затронутые коммиты и результаты проверок соответствия спецификациям и правилам реализации.

КОНТЕКСТ ПО ПУТИ К ФАЙЛУ

Как агент находит спецификации для файла

Запросите через MCP инструмент trace-file. Он находит связанные юниты и спецификации по пути к файлу.

Используй спецификации Reqode через MCP. Обнови /components/auth/SignupForm.vue по запросу CR-123.
РЕЗУЛЬТАТ ЗАПРОСА

Контекст выбранной ветки и подсистемы

  • Проект, подсистема и ветка
  • Юнит и его тип
  • Правила подсистемы, типа и конкретного юнита
  • Связанные спецификации, файлы и прямые зависимости

Связаться с нами

Поля, отмеченные *, обязательны для заполнения.

0 / 5 000

Можно также написать на info@reqode.com