Какие артефакты делаешь на текущем проекте?

Какие артефакты делаешь на текущем проекте?

Артефакты BA в проектах

Итак, я готовлю разнообразные артефакты в зависимости от типа проекта и методологии. Артефакт — это любой документ или диаграмма, которая помогает команде понять требования и контекст. Расскажу о каждом.

Артефакты в Agile проектах (80% моей работы)

1. User Stories (ежедневно)

Это основной артефакт. Формат:

US-042: Search by category

Что:
Как покупатель, я хочу фильтровать товары по категориям,
чтобы быстро найти нужное.

Критерии приемки:
- В каталоге есть фильтр "Категория"
- Могу выбрать одну или несколько категорий
- Список товаров обновляется при выборе
- Работает на мобильной и десктоп версии
- Фильтр сохраняется при перезагрузке страницы

Зависимости:
- US-040 (Backend API для категорий) должна быть готова

Design:
- [Ссылка на Figma]

Обычно пишу 10-15 stories в спринт.

2. User Story Map (планирование)

Визуальная карта всех stories по пути пользователя:

        Home    Browse    Cart    Checkout   Delivery   Feedback
US-001  Login   US-010    US-020  US-030     US-040     US-050
US-002  Logout  US-011    US-021  US-031     US-041     US-051
US-003  Profile US-012    US-022  US-032     US-042     US-052

Спринт 1: US-001, US-010, US-020, US-030
Спринт 2: US-002, US-011, US-021, US-031
Спринт 3: US-003, US-012, US-022, US-032

Помогает:

• Видеть полную картину
• Понять, какие stories связаны
• Планировать спринты

3. Mockups/Wireframes (для каждой UI story)

Обычно делаю в Figma:

• Low-fidelity для быстрого обсуждения
• High-fidelity для разработки

Параметры:

• Desktop (1920px), Tablet (768px), Mobile (375px)
• Все состояния: empty, loading, error, success
• Color palette из design system

4. Acceptance Criteria (часть User Story)

Я пишу их в формате Given-When-Then:

When: Пользователь добавляет товар в корзину
Then: 
  Given корзина была пуста
  When нажимает "Add to cart"
  Then товар появляется в корзине
  AND количество обновляется
  AND цена пересчитывается

And коллапс счетчика корзины со звуком
And уведомление в Slack (для analytics)

5. Process Flow Diagrams (для сложных процессов)

Обычно делаю в Draw.io или Miro:

Пример: "Оформление заказа"

┌─────────────┐
│  На сайте   │
└──────┬──────┘
       │
       ▼
┌──────────────────────┐
│ Выбрать товары       │
└──────┬───────────────┘
       │
       ▼
┌──────────────────────┐
│ Перейти в корзину    │
└──────┬───────────────┘
       │
       ▼
    ┌──────────────────────┐
    │ Логин?               │
    └──────┬───────────────┘
           │ (Yes)  (No)
           ▼        ▼
      Регистрация Логин
           │        │
           └────┬───┘
                ▼
         ┌─────────────────┐
         │ Адрес доставки  │
         └────────┬────────┘
                  ▼
         ┌─────────────────┐
         │ Способ доставки │
         └────────┬────────┘
                  ▼
         ┌─────────────────┐
         │ Способ оплаты   │
         └────────┬────────┘
                  ▼
         ┌─────────────────┐
         │ Подтверждение   │
         └────────┬────────┘
                  ▼
         ┌─────────────────┐
         │ Спасибо! Заказ  │
         │     создан      │
         └─────────────────┘

6. Data Dictionary (для сложных систем)

Таблица со всеми терминами, которые используем:

| Термин | Определение | Пример |
|--------|-------------|--------|
| Order | Покупка товаров | ID: ORD-123456 |
| SKU | Уникальный артикул товара | ABC-789-XYZ |
| Conversion | Завершенный заказ | 1000 заказов в день |
| CAC | Customer Acquisition Cost | $50 на клиента |
| Churn | Уход клиента | 5% в месяц |

Артефакты в Waterfall проектах (15% моей работы)

1. Software Requirements Specification (SRS)

Большой документ (50-100 страниц):

• Все требования
• Функциональные и нефункциональные
• Диаграммы и примеры
• Версионирование и история изменений

2. Use Case Diagrams

Визуальная карта всех actors и use cases.

3. Data Flow Diagrams (DFD)

Как данные движутся в системе.

4. Entity Relationship Diagram (ERD)

Структура БД.

Артефакты, которые я НЕ делаю сам

❌ Design mockups (если есть дизайнер)

• Дизайнер делает красиво
• Я review и даю feedback

❌ Technical architecture (если есть tech lead)

• Tech lead определяет, как реализовать
• Я помогаю с бизнес требованиями

❌ Test plans (если есть QA lead)

• QA пишет детальные test cases
• Я помогаю с критериями приемки

Где я храню артефакты

Типичная структура проекта

Проект XYZ
├── Requirements
│   ├── User Stories (Jira)
│   ├── Story Map (Miro)
│   └── Data Dictionary (Confluence)
├── Design
│   ├── Wireframes (Figma)
│   ├── Mockups (Figma)
│   └── Design System (Figma)
├── Analysis
│   ├── Process Flows (Draw.io)
│   ├── Use Case Diagrams (Visio)
│   └── Competitive Analysis (Confluence)
├── Metrics
│   ├── Dashboards (Metabase)
│   ├── Reports (Google Sheets)
│   └── KPI tracking (Spreadsheet)
└── Documentation
    ├── Glossary (Confluence)
    ├── API specs (Swagger/OpenAPI)
    └── Release notes (Confluence)

Как я выбираю, какие артефакты делать

Вопрос 1: Нужно ли это команде?

• Если разработчик говорит "мне нужен mockup", делаю mockup
• Если никто не спрашивает, не делаю

Вопрос 2: Это в JIRA или нет?

• Требования → Jira
• Детали → Confluence
• Визуально → Figma/Draw.io

Вопрос 3: Много ли это займет времени?

• Если простой mockup (30 мин), делаю
• Если сложная диаграмма (3 часа), спрашиваю, нужно ли

Частота обновления артефактов

НА ДЕНЬ:
- User Stories (если добавляю новые)
- Daily comments в Jira (для уточнений)

НА НЕДЕЛЮ:
- Обновляю Acceptance Criteria
- Уточняю Mockups
- Обновляю диаграммы процессов

НА МЕСЯЦ:
- Большой review всей документации
- Удаляю устаревшие артефакты
- Обновляю Data Dictionary

Типичные ошибки

❌ Делаю слишком много артефактов

• Пишу 50-страничный документ, никто не читает
• Результат: потрачено время впустую

❌ Не обновляю артефакты

• Когда требования меняются, забываю обновить
• Результат: документация не совпадает с реальностью

❌ Неправильный уровень детализации

• Слишком высокий уровень → разработчик не понимает
• Слишком подробный → никто не читает

❌ Храню в неправильных местах

• User Story в Word документе
• Mockup в PDF
• Результат: никто не найдет

Итог

Мои артефакты в проектах:

✅ User Stories — основной артефакт (Jira) ✅ Mockups — для UI features (Figma) ✅ Диаграммы — для сложных процессов (Draw.io) ✅ Документация — для большого контекста (Confluence) ✅ Метрики — для отслеживания прогресса (Dashboards)

Все артефакты:

• Актуальны (обновляются)
• Полезны (используются командой)
• Доступны (в правильных местах)
• Уместны (не излишние)