Твои первые действия на проекте, который до тебя вел другой Backend разработчик

Первые действия при переходе на существующий проект

Это критический момент. Неправильный старт может привести к проблемам. Дам мой проверенный процесс.

День 1: Информационное погружение

Встреча с предыдущим разработчиком (1 час)

Я задаю ключевые вопросы:

• Архитектура проекта? (MVC, layered, microservices?)
• Стек технологий? (Node версия, фреймворк, ORM, БД)
• Как разворачивается? (Docker, serverless, traditional)
• Процесс CI/CD?
• Какие известные проблемы и tech debt?
• Какие баги регулярно появляются?
• Кто на фронте? Какие метрики важны для бизнеса?

Читаю README и документацию (30 мин)

Ищу: README.md, ARCHITECTURE.md, docs/, GETTING_STARTED.md

Клонирую и запускаю локально (30 мин)

git clone <repo>
cd project
node --version  # Совпадает ли с .nvmrc?
npm install
npm run dev
npm test

Если что-то не работает — это ПЕРВАЯ проблема, которую нужно решить. Red flags:

• README устаревший
• Тесты падают
• Нет .env.example
• Нет .nvmrc (Node.js версия не специфицирована)

День 1-2: Исследование кодовой базы

Структура проекта

src/
  ├── controllers/
  ├── services/
  ├── repositories/
  ├── models/
  ├── middleware/
  ├── utils/
  ├── config/
  └── types/

tests/
  ├── unit/
  ├── integration/
  └── e2e/

Читаю главный entry point — понимаю, как стартует приложение

Изучаю бизнес-логику — смотрю основные use cases

Понимаю flow: Controller → Service → Repository → Database

День 2-3: Проверка качества

npm run lint       # Проверяю style
npm run format     # Форматирование
npm run test:coverage  # Тесты и coverage
npm audit          # Уязвимости в зависимостях

Red flags:

• Coverage < 50%
• Падающие тесты
• Hardcoded secrets в коде
• .env в git истории

День 3: Инфраструктура

Читаю Dockerfile — как собирается production image?

Проверяю:

• Multi-stage build?
• NODE_ENV=production?
• Security (non-root user)?

Читаю docker-compose.yml — как запускается локально?

Смотрю CI/CD конфиг (.github/workflows/main.yml)

Что происходит при push?

• Линтер
• Тесты
• Сборка
• Деплой?

Мониторинг и логирование

• Как смотреть логи?
• Какой monitoring инструмент?
• Какие алерты настроены?

День 4: Встречи с team

Sync с фронтом — какие проблемы с API? Какие фичи планируются?

Встреча с PM — какие метрики важны? Какой roadmap?

Встреча с DevOps — как работает деплой? Какие были incidents?

День 5: Первый contribution

Я беру что-то SMALL:

• Обновить README
• Исправить опечатку в комментариях
• Добавить missing type
• Оптимизировать 1 query

Не новую фичу. Просто чтобы понять process:

git checkout -b docs/update-readme
# edit files
npm test
git commit -m "docs: update README"
git push origin docs/update-readme
# Create PR → получить feedback

Во время code review я учусь:

• Какие standards в проекте?
• Как ревьюеры дают feedback?
• Какие паттерны приветствуются?

Документирование findings

Создаю onboarding guide

# Onboarding Guide

## Setup
1. Clone
2. npm install
3. cp .env.example .env
4. docker compose up (для БД)
5. npm run dev

## Architecture
[Объясняю структуру]

## Key Concepts
[Что знать]

## Common Tasks
[Как добавить endpoint, etc.]

## Known Issues
[Что плохо и почему]

Список improvements

При обходе кода я отмечаю:

• Setup scripts broken? (severity: high, time: 2h)
• Test coverage 45%? (severity: medium, time: 20h)
• Documentation outdated? (severity: low, time: 4h)

Red flags, на которые я сразу реагирую

Технические:

• No tests
• Tests consistently failing
• No monitoring в production
• No CI/CD pipeline
• Secrets в git
• Documentation != reality

Процесс:

• No code review
• Deploy directly without process
• Только один человек знает как работает
• No communication с другими

На каждый флаг я:

1. Спрашиваю, почему так
2. Понимаю контекст
3. Предлагаю решение
4. Документирую как issue

Checklist завершения onboarding

• Код запускается локально
• Тесты проходят
• Архитектуру понимаю
• Знаю как разворачивается
• Первый PR created & merged
• Business rules знаю
• Знаю кто за что отвечает
• Onboarding guide написан
• Top-3 improvement areas выявлены
• Могу самостоятельно добавить простую фичу

Итог

День 1: Встречи, README, запуск локально

День 2-3: Deep dive в код, проверка качества

День 4: Встречи с team

День 5: Первый contribution

После 2 недель: понимаю 80% проекта, могу взять среднюю задачу

Этот подход систематичен и помогает быстро адаптироваться, не совершая дорогостоящих ошибок.