# Полное машиночитаемое описание CodeGraph

## Определение

CodeGraph — решение для управляемой разработки цифровых продуктов с участием ИИ. Оно объединяет цикл разработки цифрового продукта (PDLC) и жизненный цикл разработки программного обеспечения (SDLC). Решение связывает портфель инициатив, требования, код, тесты, аудиты и релизные проверки. Статус показывает, что реализовано, что проверено, какие риски открыты и где требуется решение человека.

Цифровая команда — модель управляемого выполнения работы. Граф свойств кода — технический механизм анализа влияния и потока данных. Вместе они образуют рабочую модель CodeGraph.

## Цепочка объектов

1. Продуктовый замысел — утверждённая цель продукта, границы и ответственный за решение.
2. Источник и история — происхождение, версия, автор и контекст утверждения.
3. Функциональные и нефункциональные требования — обязательное поведение и ограничения.
4. Критерий приёмки — наблюдаемое условие с результатом «пройдено» или «не пройдено».
5. Область влияния — затронутые компоненты, символы, пути данных и тесты.
6. Контракт задачи (Task Capsule) — работа, её ответственный, разрешённые действия, условия остановки и необходимые подтверждения.
7. Изменение кода — реализация, связанная с утверждённым требованием.
8. Тест поведения — исполняемая проверка требуемого поведения.
9. Результат проверки — датированный результат указанного метода.
10. Подтверждение роли — результат работы с ссылками на проверяемые материалы.
11. Пробел, исключение или остаточный риск — открытое условие или принятое отклонение.
12. Статус реализации требования — реализовано, частично, не подтверждено или заблокировано.

## Роли и решения

- CodeGraph формирует и проверяет технические подтверждения для согласованных задач.
- Продуктовая команда задаёт замысел, утверждает требования и оценивает продуктовый результат.
- Уполномоченный сотрудник принимает остаточный риск и решение о выпуске.
- Завершение поставки определяется совокупностью требований, изменений, проверок, эксплуатационных данных и решения о выпуске.
- Настройки, учётные данные, подключение заказчика, промышленная готовность и коммерческий статус задаются конфигурацией и условиями проекта.

## Карта страниц

- https://codegraph.ru/ — категория продукта, маршрут инициативы и пример результата.
- https://codegraph.ru/whitepaper.html — модель работы, основные объекты и границы решений.
- https://codegraph.ru/product-delivery.html — путь от замысла до статуса требований.
- https://codegraph.ru/evidence.html — обезличенный пример прослеживаемости, пробелы и текущий статус элементов.
- https://codegraph.ru/digital-team.html — тринадцать ролей, разрешённые действия и границы полномочий.
- https://codegraph.ru/integrations.html — датированная матрица операций интеграций.
- https://codegraph.ru/ai-engineering.html — контроль кода, созданного ИИ.
- https://codegraph.ru/cpg.html — граф свойств кода как механизм анализа влияния.
- https://codegraph.ru/security.html — путь требования безопасности до решения о риске.
- https://codegraph.ru/compliance.html — граница данных и подтверждения технических контролей.
- https://codegraph.ru/platform-operations.html — развёртывание, синхронизация и восстановление.
- https://codegraph.ru/productivity.html — метрики связи требований и реализации.
- https://codegraph.ru/business-efficiency.html — исходный замер, стоимость разрывов и решение по пилоту.
- https://codegraph.ru/docs/ru/index.html — документация на русском языке.
- https://codegraph.ru/docs/en/index.html — документация на английском языке.
- https://codegraph.ru/blog/ — корпоративный блог о PDLC, SDLC и ИИ-агентах.
- https://codegraph.ru/downloads/ — каталог материалов CodeGraph с доступом к плейбуку и паспорту цифровой роли.
- https://codegraph.ru/blog/kogda-kod-perestaet-byt-uzkim-mestom/ — четыре плейбука AI-native PDLC/SDLC и их общая архитектура.
- https://codegraph.ru/downloads/ai-native-pdlc-sdlc-playbook/ — полный PDF-плейбук AI-native PDLC/SDLC.
- https://codegraph.ru/downloads/digital-role-passport/ — паспорт цифровой роли и PDF-шаблон.
- https://codegraph.ru/downloads/digital-role-passport/role-passport.html — HTML-версия паспорта цифровой роли.

## Корпоративные сценарии

- Управление портфелем изменений: https://codegraph.ru/scenarios/portfolio-change-management.html
- Разработка новой функции: https://codegraph.ru/scenarios/feature-delivery.html
- Аудит кодовой базы: https://codegraph.ru/scenarios/codebase-audit.html
- Релизная проверка: https://codegraph.ru/scenarios/release-readiness.html
- Технические контроли: https://codegraph.ru/scenarios/technical-controls.html
- Контроль кода, созданного ИИ: https://codegraph.ru/scenarios/ai-code-control.html

## Структура подтверждений

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

## Следующий шаг

Публичное действие — разбор одной продуктовой инициативы. Результат разбора — рабочая цепочка от продуктового замысла через требования и область влияния к необходимым подтверждениям.