# AI AutoReview
AI Code Review бот для российских Git-платформ (B2B, предлагается внедрять бота в компании git-платформы)



## Elevator Pitch

Интеграция AI, автоматизация Review кода на российских git-платформах.

Одна из задач, которую AI агенты делают наиболее эффективно - ревью существующего кода. На нашем рынке всё ещё не распространено внедрение AI агентов внутри отечественных git-платформ. Мы можем предложить простую интеграциюю такой системы в git-систему любой компании. В итоге компания получает интеграцию с нашей системой, а мы - комиссию за подписку на нашу систему от компании владельца git-системы.

## Lean Canvas

<img src="lean_canvas.png">

### 1. Сегменты потребителей

Компании, имеющие собственные git-системы внутри своих отделов разработки

Открытые отечественные git-платформы

Разработчики с git-репозиториями

### 2. Проблема

Отсутствие современной технологии ревью кода у отечественных git-платформ.

Неавтоматизированное ревью кодовой базы у компаний со своей git-платформой.

### 3. Уникальная ценность

AI Code Review бот для российских Git-платформ

### 4. Решение

Готовый инструмент и интеграции для корпораций

Готовый инструмент для пользователей открытых git-платформ

Готовое приложение, подвязывающееся по git к репозиторию и анализирующее его

### 5. Каналы

Яндекс директ

Рассылка прямых предложений git-платформам

Участие в межорганизационных конференциях


### 6. Потоки прибыли

Формат подписки для пользователей существующих открытых git-платформ и пользователей приложения.

Тариф для компаний (для доступа всех сотрудников одной компании к системе)

### 7. Структура издержек

Реклама

Поддержка хостинга AI агентов, либо корпоративная закупка существующих AI агентов у поставщиков

Выплаты сотрудникам, тех. администраторам

### 8. Ключевые метрики

Количество использованний AI-агентов для ревью

Количество сайтов, подключивших систему


## Основные роли
Backend-Разработчики - пишет код с бизнес-логикой и связкой с AI-ботами, создаёт pull/merge requests, получает ревью.

UI/UX Designer - проектирует логику пользовательского пути (UX) и отрисовывает визуальный интерфейс (UI).

Fontend-Разработчики - берет проекты дизайнеров и пишет frontend.

Team Lead - Проверяет код, принимает решения по merge, следит за качеством.

DevOps / Администратор Git-платформы - настраивает интеграции, управляет доступами.

## User Stories
### Для разработчиков-клиентов:
Как разработчик, я хочу получать автоматические комментарии к коду, чтобы быстрее находить ошибки.

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

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

Как разработчик, я хочу видеть уровень критичности замечаний, чтобы понимать приоритет.

Как разработчик, я хочу интеграцию с Git, чтобы не выходить из привычной среды.

### Для тимлидов-клиентов:
Как тимлид, я хочу получать предварительное AI-ревью, чтобы экономить время.

Как тимлид, я хочу фильтровать замечания AI, чтобы видеть только важное.

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

### Для DevOps:
Как администратор, я хочу легко интегрировать бота, чтобы быстро внедрить систему.

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

### Для компании:
Как компания, я хочу снизить время ревью кода, чтобы ускорить релизы.

Как компания, я хочу централизованное решение, для автоматического review кода.

### Общие:
Как пользователь, я хочу видеть историю ревью, чтобы отслеживать изменения.

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

## Приоритизация функционала (MoSCoW)
### Must Have (обязательно)
Автоматическое ревью PR

Комментарии прямо в Git

Интеграция с Git-платформами

Базовый анализ кода (ошибки, стиль)

### Should Have (желательно)

Классификация критичности

Настройка правил

История ревью

### Could Have (можно позже)

Статистика по команде

Расширенные рекомендации (архитектура)

UI-дэшборд

### Won’t Have (пока не делаем)
Полная замена человека-ревьюера

Deep анализ архитектуры уровня senior## MVP

## MVP
Скелет:

Интеграция с Git (webhook / API)

Анализ pull request

Генерация комментариев

Базовые правила (линтинг + простая логика)

Главная цель: бот уже реально помогает ревьюить код

## MLP
Добавляем "вау":

Умные рекомендации (не только ошибки)

Приоритизация замечаний

Красивый UI/дашборд

Аналитика по проекту

Настройка правил

Цель: пользователи ХОТЯТ этим пользоваться, а не просто могут

## Две главные истории из MVP и требования

1. Автоматическое ревью PR
Функциональные требования:
Система принимает webhook от Git
Анализирует diff PR
Генерирует комментарии
Публикует их в PR
Нефункциональные требования:
Время ответа ≤ 10 секунд
Поддержка ≥ 1000 PR/день
Надёжность (99.5% uptime)
Безопасность (только read-only доступ к коду)

2. Интеграция с Git-платформой
Функциональные требования:
Подключение через API/token
Настройка репозитория
Включение/выключение бота
Поддержка популярных Git-систем
Нефункциональные требования:
Простота установки (≤ 15 минут)
Документация
Масштабируемость
Совместимость с разными версиями Git-серверов

| Раздел              | Содержание |
|--------------------|-----------|
| Роли               | Developer, Team Lead, UI/UX Designer, DevOps |
| Кол-во User Stories| 15 |
| Основная ценность  | Автоматизация code review |
| Must Have          | Авто-ревью, комментарии, интеграция с Git |
| Should Have        | Критичность, история, настройки |
| Could Have         | Аналитика, UI, расширенные рекомендации |
| MVP                | Интеграция + анализ PR + комментарии |
| MLP                | Умные рекомендации + UI + аналитика |
| Ключевая история 1 | Автоматическое ревью PR |
| Ключевая история 2 | Интеграция с Git |
| НФ требования      | Быстродействие, масштабируемость, безопасность |

<img src="diag1.png">