UpCore

1. Общие сведения

UpCore предназначен для компаний с крупными ИТ-департаментами и командами разработки. Система анализирует код без ручных отчетов от разработчиков и формирует управленческие показатели по специалистам, проектам, стекам и всей организации.

2. Функциональные характеристики

2.1 Анализ исходного кода

• подключение репозиториев и загрузка истории изменений;
• очистка изменений от шума: автогенерация, копипаст, переименования, синтаксические изменения;
• определение фактических изменений: добавление, удаление, модификация строк, выражений, функций и модулей;
• расчет цикломатической, когнитивной, логической и технологической сложности;
• учет особенностей языков и фреймворков, включая легаси-код и новые технологии.

2.2 Оценка эффективности

• расчет трудоемкости кода в часах и денежном выражении;
• сравнение ожидаемых трудозатрат со временем из событий, табелей или ворклогов;
• учет более 50 факторов: стадия проекта, состав команды, сложность задач, объем вклада, качество результата, баги, код-ревью, архитектурная ценность;
• выявление аномалий эффективности, снижения производительности, выгорания и рисков срыва сроков;
• контроль динамики после внедрения новых процессов и ИИ-инструментов.

2.3 Грейдинг и развитие специалистов

• определение реального грейда разработчика;
• сравнение специалиста со средними показателями проекта, стека, компании и рынка;
• выявление over-skill и under-skill относительно задач проекта;
• формирование индивидуального плана развития;
• подготовка отчетов для performance review, 1-1, онбординга, ротации и кадровых решений.

2.4 Управление проектами и подрядчиками

• рейтинг проектов по эффективности, качеству кода и рискам;
• прогноз сроков завершения работ на основе фактической эффективности команды;
• аудит внешних команд и проверка реального объема выполненной разработки;
• оценка финансового результата по проектам и специалистам;
• подбор разработчиков под проекты по технологическому профилю и фактическим компетенциям.

2.5 ИИ-ассистент

• поиск данных в системе на естественном языке;
• объяснение причин неэффективности разработчика, команды или проекта;
• подсветка аномалий и факторов оценки;
• подготовка планов бесед, ревью и рекомендаций для руководителей;
• анализ эффективности использования ИИ-инструментов и истории промптов.

3. Архитектура и интеграции

UpCore состоит из веб-интерфейса, серверного API, модуля анализа кода, расчетной математической модели, хранилища данных, модуля интеграций и ИИ-ассистента. Компоненты могут быть развернуты в изолированном контуре заказчика.

Интеграции

• Git-репозитории: GitLab, GitHub, Bitbucket и совместимые Git-серверы;
• таск-менеджеры и ворклоги: Jira, YouTrack, Redmine и другие системы через API;
• SSO и учетные записи: LDAP, SAML, OpenID Connect;
• корпоративная отчетность: BI-дашборды, CSV/JSON-выгрузки, API;
• LLM-модули: on-prem модель или внешний провайдер по согласованию с заказчиком.

Безопасность

• поддерживается установка без доступа к интернету;
• доступ пользователей разграничивается по ролям;
• исходный код может анализироваться в контуре заказчика без передачи наружу;
• журналируются действия пользователей и системные события;
• резервное копирование и хранение данных настраиваются по политике заказчика.

4. Установка

4.1 Требования к окружению

4.2 Порядок установки в контуре заказчика

1. Согласовать архитектуру развертывания, список интеграций и требования ИБ.
2. Подготовить серверы, доменное имя, TLS-сертификат, учетные записи и доступ к СУБД.
3. Получить дистрибутив UpCore и лицензионный ключ от правообладателя.
4. Развернуть контейнеры приложения через Docker Compose или Kubernetes-манифесты.
5. Заполнить конфигурацию: адреса сервисов, параметры БД, SSO, Git-интеграции, права доступа.
6. Выполнить миграции БД и первичную проверку состояния сервисов.
7. Подключить пилотные репозитории и запустить первичный анализ.
8. Проверить отчеты, роли пользователей и журнал событий.

4.3 SaaS-подключение

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

5. Эксплуатация

Раздел описывает порядок повседневной эксплуатации UpCore после установки или подключения SaaS-доступа. Инструкция предназначена для администратора системы, руководителей разработки и сотрудников, отвечающих за сопровождение продукта у заказчика.

5.1 Роли пользователей

• Администратор управляет настройками, пользователями, интеграциями и правами доступа.
• Руководитель ИТ смотрит сводные показатели компании, проекты, риски и финансовый результат.
• Руководитель проекта анализирует команду, сроки, трудозатраты и качество результата.
• Тимлид использует отчеты для ревью, 1-1, развития команды и распределения задач.
• HR смотрит грейды, динамику онбординга, ИПР и кадровые риски.
• Разработчик видит личные показатели, обратную связь и план развития.

5.2 Основные сценарии

1. Подключить проект, репозиторий и источник рабочих часов.
2. Запустить первичный анализ истории кода.
3. Проверить дашборды эффективности, грейдов, рисков и финансового результата.
4. Настроить регулярный анализ новых merge request, задач и релизов.
5. Использовать отчеты для управления проектом, развития специалистов и контроля подрядчиков.

5.3 Регламент эксплуатации

• первичный анализ выполняется при подключении проекта;
• регулярная обработка выполняется по расписанию или по событиям репозитория;
• администратор проверяет статус интеграций и очередей анализа;
• резервное копирование БД и конфигурации выполняется не реже одного раза в сутки;
• обновления устанавливаются в тестовом контуре, затем в промышленном;
• критичные инциденты передаются в поддержку правообладателя.

5.4 Первый вход и подготовка к работе

1. Администратор входит в систему по выданной учетной записи или через SSO.
2. Проверяет реквизиты организации, часовой пояс, календарь рабочих дней и базовую валюту расчетов.
3. Создает рабочие группы: организация, проекты, команды, роли пользователей.
4. Добавляет руководителей, тимлидов, HR и разработчиков либо выполняет импорт из корпоративной учетной системы.
5. Проверяет доступ к журналу событий, странице интеграций и системному мониторингу.

5.5 Подключение проекта

1. Создать карточку проекта и указать стек, команду, период анализа и ответственного руководителя.
2. Подключить Git-репозиторий через токен доступа, SSH-ключ или сервисную учетную запись.
3. Подключить источник задач и рабочих часов: Jira, YouTrack, Redmine, табель или API заказчика.
4. Сопоставить пользователей UpCore с авторами коммитов, merge request и задач.
5. Настроить исключения: служебные ветки, автогенерируемые файлы, внешние библиотеки, тестовые репозитории.
6. Сохранить настройки и запустить первичный анализ.

5.6 Запуск анализа и контроль выполнения

• Статус анализа отображается в очереди обработки и в карточке проекта.
• При первичном запуске система загружает историю репозитория, связывает ее с задачами и рассчитывает базовые метрики.
• Повторный анализ выполняется инкрементально: обрабатываются новые изменения, задачи, ревью и ворклоги.
• Если источник данных временно недоступен, задание переводится в статус ожидания или ошибки с указанием причины.
• Администратор может перезапустить расчет, изменить расписание или отключить источник данных.

5.7 Работа с отчетами

• Отчет разработчика показывает эффективность, вклад, качество результирующего кода, динамику и сравнение с командой.
• Отчет проекта показывает рейтинг, потери, сложность, размер, длительность, прирост и риски сроков.
• Отчет по коду показывает вклад участников, архитектурную сложность, качество ревью и уровень багов.
• Руководитель использует отчеты для планирования, performance review, контроля подрядчиков и перераспределения задач.
• Данные могут выгружаться в согласованном формате или передаваться в BI-систему через API.

5.8 Управление пользователями и доступом

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

5.9 Резервное копирование и восстановление

• Резервному копированию подлежат база данных, конфигурация, ключи интеграций и системные настройки.
• Рекомендуемый режим: ежедневная копия БД, хранение не менее 30 календарных дней, проверка восстановления не реже одного раза в квартал.
• Восстановление выполняется администратором из последней корректной копии с последующей проверкой интеграций и отчетов.
• Для SaaS-формата порядок резервного копирования определяется регламентом поставщика сервиса.

5.10 Типовые ситуации

5.11 Настройка регулярной синхронизации

1. Открыть раздел интеграций и выбрать подключенный источник данных.
2. Указать расписание синхронизации: по событию, каждый час, ежедневно или по индивидуальному расписанию.
3. Задать глубину обработки истории и период, за который данные должны попадать в отчеты.
4. Включить уведомления об ошибках синхронизации для администратора и ответственного руководителя.
5. Сохранить настройки и выполнить тестовый запуск.

5.12 Обновление версии

1. Получить пакет обновления, описание изменений и инструкцию по миграции.
2. Создать резервную копию БД, конфигурации и ключей интеграций.
3. Установить обновление в тестовом контуре и проверить вход, интеграции, расчеты и отчеты.
4. Согласовать окно работ для промышленного контура.
5. Установить обновление, выполнить миграции и проверить состояние сервисов.
6. При критической ошибке выполнить откат на предыдущую версию по резервной копии.

5.13 Мониторинг и журналы

5.14 Обработка инцидентов

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

5.15 Завершение работы пользователя

1. Пользователь завершает работу через выход из учетной записи.
2. При смене сотрудника администратор блокирует учетную запись и проверяет права на проекты.
3. Исторические данные сохраняются в отчетах, если это требуется для аналитики и договорной отчетности.
4. При удалении данных администратор действует по утвержденному регламенту заказчика и политике обработки персональных данных.

5.16 Контрольный список после ввода в эксплуатацию

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

6. Жизненный цикл и сопровождение

• Развитие продукта выполняется правообладателем ООО «Дексмобайл».
• Новые версии выпускаются по мере готовности функциональных улучшений и исправлений.
• Поддержка внедрения и обучения предоставляется в течение первых двух месяцев пилотного проекта.
• Ошибки регистрируются через электронную почту поддержки или согласованную систему Service Desk.
• Критичные ошибки обрабатываются приоритетно, сроки реакции фиксируются в договоре сопровождения.
• Документация обновляется при изменении функций, требований к установке или регламента эксплуатации.

7. Сведения о правообладателе