Перейти к основному содержимому

Архитектура CodeGraph

CodeGraph ведёт проект от продуктовой задачи до выпуска: хранит требования, распределяет работу между людьми и ИИ, проверяет изменения и собирает результаты перед релизом.

ЗадачаЦель и критерии
РаботаИсполнитель и результат
ПроверкиТесты, ревью и риски
ВыпускОтветственный и решение
Связь задачи, требований, кода, проверок и решения о выпуске.

Архитектурный принцип

CodeGraph хранит связи между проектом, требованиями, изменениями, проверками, рисками и решениями. Git, трекер и CI/CD остаются источниками исходных данных.

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

Контекст системы

CPO, CTO и команда принимают решения. CodeGraph связывает их с Git, трекером, CI/CD, документами, ИИ-моделями и анализаторами.

Контекст системы CodeGraphЛюди принимают решения, исходные данные приходят из Git, трекера, CI/CD и документов, а ИИ-модели и анализаторы готовят результаты проверки.CPO, CTO и командаЦели и правилаПроверка и решенияCodeGraphСвязи объектовПроверки и журналGit и трекерКод, задачи и срокиCI/CD и документыТесты, правила и решенияИИ-модели и анализаторыРазбор, план и проверки
Схема 1. CodeGraph связывает решения людей с данными разработки и результатами анализа.

Поток данных

Каждый этап сохраняет версию, результат и ответственного: задача → требование → изменение → тест → риск → решение.

Поток данных от задачи до решенияЗадача связывается с требованием, изменением, тестом, риском и решением ответственного сотрудника.ЗадачаВерсия иответственныйТребованиеВерсия иответственныйИзменениеВерсия иответственныйТестВерсия иответственныйРискВерсия иответственныйРешениеВерсия иответственный
Схема 2. Сквозная связь результата разработки с решением о выпуске.

Как проходит проект

Таблица данных
ЭтапДействиеРезультат
Продуктовая задачаЗафиксировать цель, пользователя и ожидаемый результатСогласованная задача
ТребованияОписать поведение, ограничения и критерии приёмкиВерсия требований
ПланОпределить работы, зависимости и затронутые системыПлан работ
ВыполнениеИзменить код и подготовить тестыИзменение и связанные тесты
ПроверкиПровести тесты, ревью, архитектурную и AppSec-проверкиРезультаты и открытые риски
ВыпускРассмотреть результаты и рискиРешение ответственного

Какие данные хранит платформа

Таблица данных
ОбъектСоставОсновные пользователи
ПроектЦель, срок, ответственный, зависимости и обязательстваCPO и руководитель проекта
ЗадачаИсполнитель, разрешённые действия, результат и критерии приёмкиМенеджер продукта и команда
ТребованиеВерсия, ожидаемое поведение и ограниченияМенеджер продукта и CTO
ИзменениеЗапрос на слияние, затронутые функции и сервисыРазработчик и архитектор
ТестСценарий, версия запуска и результатQA и ответственный за требование
РискПоследствие, срок, ответственный и решениеАрхитектор, CISO и CPO
РешениеАвтор, дата, выбранное действие и комментарийОтветственный за соответствующий этап

Как работают люди и ИИ

Человек ставит задачу

Формулирует цель, принимает требования и назначает ответственного.

ИИ выполняет отдельный шаг

Разбирает документы, ищет связи, готовит изменение или собирает результаты.

Проверку выполняет другая роль

Автор изменения не остаётся единственным проверяющим.

Работа останавливается при пробеле

Следующий шаг не запускается без данных, прав, критерия или обязательного результата.

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

Что показывает граф свойств кода

Таблица данных
Входные данныеЧто получает командаЧто проверяет инженер
Требование и версия репозиторияЗатронутые функции, сервисы и зависимостиДинамические вызовы и конфигурационные связи
Изменение кодаЗатронутые компоненты и связанные тестыСоответствие ожидаемому поведению
Правило безопасностиПути данных, точки входа и найденные нарушенияДопустимость исключения и остаточного риска

Граф свойств кода показывает структуру и возможные последствия изменения. Решение принимает ответственный сотрудник.

Компоненты платформы

Проекты и требования

Хранят цели, сроки, требования, зависимости и решения.

Выполнение задач

Передаёт работу людям и ИИ с указанными правами и результатом.

Граф кода

Строит связи между компонентами, данными, изменениями и тестами.

Интеграции

Получают данные из Git, трекера, CI/CD и документов.

Хранилища и аудит

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

Где находятся основные записи

Таблица данных
ИсточникОсновная записьЧто хранит CodeGraph
GitКод и история измененийСсылку на версию и затронутые элементы
ТрекерЗадача, срок и исполнительИдентификатор и связь с требованием
CI/CDЗапуск и результат тестаСсылку, время и состояние проверки
ДокументыТребования и решенияВерсию и источник
CodeGraphСвязи и журнал анализаСвязи объектов, открытые риски и журнал решений

Один проект от требования до решения

Ограничить административные действия

Тестовые данные
Требование: роль администратора проверяется до изменения лимита.
Изменение: PR-842 затронул маршрутизатор и сервис политик.
Тест: AC-14 — 18 из 18 сценариев пройдены.
Риск: у общей библиотеки аудита нет назначенного владельца.
Решение: архитектор принимает риск или блокирует выпуск.

Тестовые данные показывают формат связи требования, изменения, теста, риска и решения.

Что проверить на пилоте

  • Пилот проводится для одного проекта с заранее согласованными показателями.
  • До запуска фиксируются затраты времени, сроки, переделки и дефекты.
  • Качество результата проверяется по тем же правилам до и после внедрения.
  • Решение о расширении принимается после сравнения результатов.

Сверить архитектуру

На встрече сверим этапы проекта, основные данные, компоненты платформы и правила доступа.

Сверить архитектуру

Обновлено: 29 августа 2026