SA Guide
Knowledge base · browser tools · offline-friendly

System Analysis / Essential Guide

Рабочая база знаний системного аналитика

Требования, BPMN, API, интеграции, данные, безопасность, документация и практические инструменты — в одном интерактивном справочнике.

  • 01Requirements
  • 02Architecture
  • 03Delivery
64практических тем
20+интерактивных сценариев
10рабочих инструментов
100%локальная работа данных

База знаний

От бизнес-задачи до проверяемого решения

Справочник организован по рабочему маршруту аналитика. Поиск фильтрует весь материал, а закладки сохраняются только в вашем браузере.

Актуализировано: август 2026 · OWASP Top 10:2025 · OpenAPI 3.2.0

01 / START

Что делать при получении задачи

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

  1. Зафиксировать бизнес-цель.Понять проблему, ожидаемый эффект и критерии успеха.
  2. Собрать контекст.Документация, интервью, текущий процесс, ограничения.
  3. Смоделировать сценарии.Happy path, альтернативы, ошибки и исключения.
  4. Спроектировать поведение системы.Данные, интеграции, роли, правила и NFR.
  5. Согласовать требования.Разработка, QA, бизнес и владельцы смежных систем.
  6. Сопроводить реализацию.Change-анализ, ответы команде, приемка и актуализация.
Рабочий вопрос

«Что изменится для бизнеса или пользователя, если мы реализуем эту задачу?»

High valueLow effortделать в первую очередь
High valueHigh effortпланировать и декомпозировать
Low valueLow effortбрать при наличии ресурса
Low valueHigh effortпересмотреть необходимость

02 / OUTPUT

Артефакты системного анализа

Артефакт нужен не ради документа, а чтобы убрать неоднозначность между участниками проекта.

RequirementsFR, NFR, acceptance criteria
Process modelsBPMN, activity, state
Interactionsequence, API contracts, events
DataER, logical model, dictionaries
UXwireframes, states, validation
Qualitytraceability, test cases, checklists

03 / REQUIREMENTS

Виды требований

Функциональные

Что система должна делать: сценарии, расчеты, валидация, CRUD, интеграции и бизнес-правила.

Система должна позволять пользователю выгружать отчет в CSV с учетом выбранных фильтров.

Нефункциональные

Как система должна работать: производительность, доступность, безопасность, масштабируемость, наблюдаемость.

95% запросов поиска должны завершаться не более чем за 800 мс при штатной нагрузке.

Качественное требование

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

04 / CHANGE

Жизненный цикл требований и Change Management

DraftReviewApprovedImplementedVerified
  • Baseline — зафиксируйте согласованную версию объема;
  • Change request — отделяйте изменение от уточнения;
  • Impact analysis — оцените UI, API, данные, процессы, тесты, сроки и миграции;
  • Decision — фиксируйте автора, дату, причину и выбранный вариант;
  • Communication — обновляйте связанные артефакты и заинтересованных участников.

05 / TRACE

Трассировка требований

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

Business goalRequirementScenarioAcceptanceTest / Release
Контроль

Требование без цели — кандидат на удаление. Требование без критерия проверки — источник споров на приемке.

06 / NFR

NFR catalog: что нельзя забыть

Performance

p95/p99 latency, throughput, payload

Availability

SLA/SLO, деградация, окна работ

Scalability

рост нагрузки, горизонтальное масштабирование

Reliability

retry, idempotency, recovery

Security

auth, access, audit, secrets

Data

retention, RPO/RTO, backup, deletion

Observability

logs, metrics, traces, alerts

Accessibility

keyboard, contrast, assistive tech

Измеримость

«Система должна работать быстро» — не NFR. «p95 ответа GET /orders ≤ 400 ms при 300 RPS» — проверяемое требование.

07 / PEOPLE

Стейкхолдеры

Определите, кто принимает решения, кто пользуется системой, кто реализует изменения и кто владеет зависимостями.

Business

заказчик, product owner, руководство

Users

конечные пользователи и администраторы

Delivery

разработчики, QA, DevOps

Experts

архитекторы, DBA, security, владельцы интеграций

Практика

Используйте матрицу «влияние × интерес» и заранее определяйте формат коммуникации для каждой группы.

08 / EXPERIENCE

UX/UI принципы для аналитика

Понятностьдействие и результат читаются без инструкции
Feedbackloading, success, empty и error states
Preventionвалидация предотвращает ошибки до отправки
Accessibilityклавиатура, фокус, контраст и touch targets
Consistencyодинаковые паттерны ведут себя одинаково
Responsiveсценарий не ломается на мобильном

09 / DISCOVERY

Методы сбора информации

Анализ документоврегламенты, старые ТЗ, инструкции, схемы
Интервьюэкспертные знания и реальные проблемы
Наблюдениекак процесс выполняется фактически
Workshopсинхронизация нескольких ролей за одну сессию
Данные и логипроверка гипотез на фактическом поведении системы

10 / DISCOVERY

Discovery, Impact Mapping и Story Mapping

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

Problem statementкто испытывает проблему, где и почему она важна
Outcomeкакое изменение поведения или метрики ожидается
Impact MapGoal → Actors → Impacts → Deliverables
Story Mapсквозной пользовательский путь и релизные срезы
Практика

Если обсуждение сразу начинается с «сделаем кнопку / очередь / микросервис», вернитесь к цели, актору, текущему сценарию и измеримому результату.

11 / SCENARIO

Use Cases

Use Case полезен, когда важна последовательность взаимодействия и варианты поведения системы.

ActorКто инициирует сценарий
PreconditionsЧто должно быть истинно до старта
Main flowУспешная последовательность шагов
AlternativesОшибки и варианты
PostconditionsСостояние системы после завершения
Мини-пример

Пользователь оформляет заказ → система валидирует корзину → резервирует остатки → создаёт заказ → запускает оплату. Если остаток изменился, система возвращает конфликт и предлагает обновить корзину.

12 / STORY

User Stories

Как [роль], я хочу [возможность], чтобы [ценность].

INVEST: Independent · Negotiable · Valuable · Estimable · Small · Testable.

Given пользователь авторизован
When он подтверждает заказ
Then система создаёт заказ и показывает его номер

13 / ACCEPT

Acceptance Criteria и BDD

Критерии приемки описывают наблюдаемое поведение системы, а не способ реализации.

Scenario: успешная оплата
Given заказ находится в статусе awaiting_payment
And платежный метод доступен
When пользователь подтверждает оплату
Then платеж создается один раз
And заказ переходит в paid
And публикуется событие OrderPaid
  • позитивный сценарий;
  • альтернативы и ошибки;
  • границы данных;
  • повторный запрос / idempotency;
  • права доступа;
  • наблюдаемый результат и side effects.

14 / PROCESS

BPMN

Проверить заказ
Создать заказ
  • Task — единица работы;
  • Event — начало, конец, таймер, сообщение;
  • Gateway — ветвление и синхронизация;
  • Sequence Flow — порядок выполнения;
  • Pool / Lane — участники и ответственность.

15 / DMN

DMN и бизнес-правила

DMN удобно применять, когда результат определяется набором правил: тариф, лимит, eligibility, скидка, маршрут согласования.

СуммаRiskРешение
< 100 000LowAuto approve
≥ 100 000LowManager review
AnyHighSecurity review
Разделение ответственности

BPMN отвечает на «какой процесс», DMN — «по какому правилу принято решение».

16 / MODEL

UML / C4: какую диаграмму выбрать

Sequenceвременной порядок вызовов и сообщений
Stateжизненный цикл сущности и переходы
Componentкомпоненты и зависимости
Deploymentокружения, узлы и размещение
C4 Contextсистема, пользователи, внешние системы
C4 Containerприложения, сервисы, БД и связи

17 / ESTIMATE

Техники оценки задач

Planning Poker

командная относительная оценка story points

T-Shirt Sizing

быстрая грубая оценка XS → XL

Affinity

группировка задач относительно друг друга

Three-point

optimistic / likely / pessimistic

18 / CONTRACT

API как контракт

Для аналитика API — это формализованный контракт между потребителем и поставщиком данных.

GET /api/orders/123
200 OK
{
  "id": 123,
  "status": "paid"
}
Requestmethod, path, query, headers, body
Responsestatus, headers, schema
Errorscodes, message, details, retryability
Rulesauth, idempotency, limits, versioning

19 / API DESIGN

Проектирование API: чеклист контракта

Resource model

URI, идентификаторы, связи

Operations

methods, commands, side effects

Schemas

required, nullable, formats, examples

Errors

stable code, message, details

Collections

pagination, filter, sort

Evolution

compatibility, deprecation, versioning

Protection

auth, scopes, rate limits

Diagnostics

request-id, correlation-id, tracing

Idempotency

Для операций с риском повторной доставки явно определите поведение повторного запроса и ключ идемпотентности.

20 / ACCESS

Authentication, Authorization, OAuth/OIDC

Authentication

Подтверждает, кто выполняет действие: session, token, MFA, federation.

  • OIDC — identity layer поверх OAuth 2.0;
  • access token — доступ к API;
  • refresh token — обновление доступа;
  • JWT — формат токена, а не протокол авторизации.

Authorization

Определяет, что разрешено.

  • RBAC — доступ через роли;
  • ABAC — правила по атрибутам;
  • Scopes — границы полномочий токена;
  • resource ownership — доступ к конкретным объектам.

21 / REST

REST

REST опирается на ресурсы, единообразный интерфейс и отсутствие серверного состояния сессии между запросами.

2xxSuccess200, 201, 204
3xxRedirect301, 304
4xxClient error400, 401, 403, 404
5xxServer error500, 502, 503

22 / SOAP

SOAP

SOAP использует XML-сообщения и формальный контракт WSDL. Чаще встречается в enterprise-интеграциях с требованиями к WS-* стандартам.

КритерийSOAPREST
КонтрактWSDLOpenAPI / договоренность
ФорматXMLJSON, XML и др.
TransportHTTP, SMTP и др.обычно HTTP
Enterprise securityWS-SecurityTLS + OAuth/JWT

23 / GRAPH

GraphQL

Клиент описывает требуемую структуру ответа. Схема строго типизирована и служит контрактом.

query {
  user(id: "789") {
    name
    posts(limit: 5) { title }
  }
}

24 / INTEGRATE

Паттерны интеграций

Request / Responseбыстрый ответ нужен вызывающей стороне
Async messageразвязка по времени и нагрузке
Eventуведомление о произошедшем факте
WebhookHTTP callback от источника
Batch / Fileмассовый периодический обмен
CDCпоток изменений данных
Выбор

Сначала определите требования к latency, объему, гарантии доставки, порядку, повторной обработке и допустимой связности систем.

25 / EVENTS

Очереди, Kafka и Event-Driven

Что фиксировать в контракте

  • event name и бизнес-смысл;
  • schema + version;
  • key / partitioning;
  • producer / consumers;
  • ordering requirements;
  • retention.

Что происходит при ошибке

  • delivery semantics;
  • retry/backoff;
  • dead-letter queue;
  • duplicate handling;
  • poison message;
  • replay strategy.
event: OrderPaid
eventId: 01J...
occurredAt: 2026-08-12T12:30:00Z
aggregateId: order-123
version: 2
payload: { ... }

26 / RELIABILITY

Reliability patterns

Timeout

ограничивает ожидание зависимости

Retry + backoff

повторяет только временные ошибки

Idempotency

повтор не создает двойной эффект

Circuit breaker

прерывает лавину вызовов

Outbox

согласует запись данных и публикацию события

Saga

координирует распределенную бизнес-транзакцию

DLQ

изолирует необрабатываемые сообщения

Reconciliation

находит и чинит расхождения постфактум

27 / CHANNELS

Webhooks, polling и файловый обмен

  • Webhook: подпись/HMAC, timestamp, retry policy, idempotency, ответ 2xx;
  • Polling: interval, cursor/watermark, rate limit, delta updates;
  • File/SFTP: naming, encoding, schema, delimiter, checksum, atomic upload, archive;
  • Batch: cut-off time, partial failure, reprocessing, reconciliation report.

28 / SERVICES

Микросервисная архитектура

Что дает

  • независимое масштабирование;
  • изолированные релизы;
  • явные границы ответственности;
  • технологическая автономность.

Что усложняет

  • сетевые ошибки и задержки;
  • распределенные транзакции;
  • наблюдаемость и трассировку;
  • совместимость контрактов.
Не цель сама по себе

Для небольшого продукта модульный монолит часто проще и дешевле эксплуатации.

29 / DOMAIN

Domain-Driven Design

Domainпредметная область
Bounded Contextграница модели и языка
Ubiquitous Languageединая терминология бизнеса и ИТ
Aggregateграница целостности связанных объектов
Domain Eventзначимый факт, произошедший в домене

30 / DATA

Базы данных

RelationalPostgreSQL, MySQL · ACID
DocumentMongoDB · flexible schema
Key-valueRedis · cache and sessions
ColumnCassandra · high write scale
GraphNeo4j · connected data
SearchElasticsearch · full-text
Нормализация

1NF — атомарность; 2NF — отсутствие частичных зависимостей; 3NF — отсутствие транзитивных зависимостей. Денормализация применяется осознанно ради чтения и производительности.

31 / CONSISTENCY

Транзакции и согласованность данных

ACIDatomicity, consistency, isolation, durability
Isolationdirty/non-repeatable/phantom reads
Optimistic lockversion/check before update
Pessimistic lockблокировка конкурирующей записи
Strong consistencyсразу видим актуальное состояние
Eventual consistencyвременное расхождение допустимо
Для аналитика

Всегда спрашивайте: что увидит пользователь при гонке изменений, повторе команды, задержке события или частичном падении контура?

32 / CACHE

Кэширование

Cache-aside

приложение само читает/обновляет cache

TTL

сколько допустима устаревшая информация

Invalidation

когда и кто удаляет старое значение

Cache key

какие параметры влияют на результат

Требование «добавить Redis» недостаточно: нужно определить источник истины, допустимую stale-версию, поведение при cache miss и стратегию инвалидации.

33 / MODEL

Моделирование данных + SQL

Создайте несколько сущностей, добавьте атрибуты и получите безопасно нормализованный черновик `CREATE TABLE`.

SQL preview
-- Добавьте хотя бы одну сущность

34 / FLOW

Kanban vs Scrum

Scrum

  • фиксированные спринты;
  • цель спринта и backlog;
  • роли и регулярные события;
  • изменения контролируются внутри итерации.

Kanban

  • непрерывный поток;
  • WIP limits;
  • управление lead/cycle time;
  • приоритет можно менять по мере освобождения capacity.
Meeting timer00:00

35 / DELIVERY

CI/CD

CommitBuildTestDeployObserve

Аналитику важно понимать среды, quality gates, конфигурации, миграции, feature flags и обратимость релиза — это влияет на требования и критерии приемки.

36 / VERIFY

Стратегия тестирования и приемки

Unitлокальная логика компонента
Integrationстык компонентов и инфраструктуры
Contractсовместимость producer/consumer
E2Eкритический сквозной сценарий
Performancelatency, throughput, saturation
Acceptanceбизнес-критерии и expected behavior
Shift left

Ревью требований разработчиком и QA до реализации дешевле, чем исправление неоднозначности после релиза.

37 / OBSERVE

Observability: logs, metrics, traces

Logs

что произошло; structured fields, severity, context.

Metrics

сколько и насколько быстро; rate, errors, duration, saturation.

Traces

где потрачено время в распределенном запросе.

  • correlation/request ID проходит через весь контур;
  • PII и секреты не попадают в логи;
  • есть бизнес-метрики результата, а не только CPU/RAM;
  • alert связан с действием, а не просто с графиком.

38 / OPERATE

Релиз, миграции и эксплуатация

Backward compatibility

старые consumers продолжают работать

Data migration

plan, validation, rollback

Feature flags

контролируемое включение функции

Rollback

что можно откатить и за сколько

Runbook

что делает support при инциденте

Ownership

кто отвечает после релиза

39 / DECIDE

Decision Tree: какой процесс подойдет

Можно ли планировать работу короткими итерациями с регулярной обратной связью?

40 / SECURITY

Security requirements и OWASP Top 10:2025

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

A01Broken Access Control
A02Security Misconfiguration
A03Software Supply Chain Failures
A04Cryptographic Failures
A05Injection
A06Insecure Design
A07Authentication Failures
A08Software or Data Integrity Failures
A09Security Logging & Alerting Failures
A10Mishandling of Exceptional Conditions
Threat modeling

Для критичных сценариев используйте STRIDE/attack scenarios: актив → доверительная граница → угроза → контроль → способ проверки.

OWASP Top 10:2025 ↗

41 / CHECK

Security checklist

Прогресс0%

42 / MEASURE

Метрики продукта и процесса

Lead Timeот запроса до поставки
Cycle Timeвремя активной работы
Adoptionдоля пользователей функции
CSAT / NPSудовлетворенность и лояльность
Правило

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

43 / ANTI-PATTERNS

Типичные ошибки аналитика

  1. Сразу проектировать решениеСначала сформулируйте проблему и ценность.
  2. Игнорировать NFRПроизводительность, безопасность и наблюдаемость должны быть частью требований.
  3. Описывать только happy pathДобавляйте ошибки, повторы, таймауты и edge cases.
  4. Терять трассируемостьСвязывайте цель → сценарий → требование → тест.
  5. Менять требования молчаИзменение должно иметь автора, причину, влияние и историю.

44 / TEMPLATE

Шаблоны документов

45 / GENERATE

Генератор документов

46 / COMMUNICATE

Шаблоны сообщений

47 / webhook и ошибки API в машиночитаемом виде. Актуальная опубликованная версия спецификации — 3.2.0.

Swagger / OpenAPI

OpenAPI описывает операции, параметры, схемы, ответы и ошибки REST API в машиночитаемом виде.

openapi: 3.2.0 info: title: Orders API version: 1.0.0 paths: /orders/{id}: get: responses: '200': description: Order found

48 / DECIDE

ADR и журнал решений

Архитектурное решение полезно фиксировать вместе с контекстом, альтернативами и последствиями — иначе через несколько месяцев останется только «так исторически сложилось».

ADR-012: Асинхронная публикация OrderPaid
Status: Accepted
Context: ...
Decision: Kafka topic orders.events.v2
Alternatives: REST callback, RabbitMQ
Consequences: eventual consistency, replay support

49 / GROW

Карьерный путь аналитика

01Junior

сбор и документирование требований

02Middle

самостоятельное проектирование решений

03Senior

архитектурные компромиссы и сложные контуры

04Lead / Principal

практика анализа, стандарты и менторство

50 / SKILLS

Карта компетенций

Отметьте освоенные навыки. Состояние хранится только в `localStorage` этого браузера.

Освоено0%

51 / QUIZ

Проверка знаний

Analyst Workbench

Не только читать — применять

Инструменты ниже работают локально в браузере и помогают быстро проверить формулировку, подготовить acceptance criteria, оценить SLA и риски, а также собрать трассировку решения.

local-firstno backend

52 / TOOL

Requirement Quality Checker

Добавьте требование для проверки

    53 / TOOL

    Acceptance Criteria Builder

    Given ...
    When ...
    Then ...

    54 / TOOL

    SLA / Availability Calculator

    55 / TOOL

    Three-point / PERT Calculator

    56 / TOOL

    HTTP Status Reference

    57 / TOOL

    Risk Matrix

    58 / TOOL

    Traceability Matrix Builder

    GoalRequirementAcceptance / Test

    59 / TOOLS

    Быстрые инструменты

    60 / REQUEST

    API tester

    Тестер выполняет запрос из браузера. Целевой API должен разрешать CORS. Секретные токены сюда вводить не следует.

    Response
    Ответ появится здесь…

    61 / NOTES

    Заметки аналитика

    Заметки не уходят на сервер и сохраняются только в браузере.

    62 / READY

    Чеклист анализа требований

    Готовность0%

    63 / GLOSSARY

    Глоссарий

    Артефакт
    Рабочий продукт анализа: документ, модель, схема, контракт.
    Стейкхолдер
    Заинтересованная сторона, влияющая на решение или испытывающая его влияние.
    Use Case
    Сценарий взаимодействия актора с системой.
    User Story
    Короткое описание ценности с точки зрения роли.
    BPMN
    Нотация моделирования бизнес-процессов.
    REST
    Архитектурный стиль для сетевых API.
    DDD
    Проектирование вокруг предметной области и ее языка.
    CI/CD
    Автоматизация интеграции, проверок и поставки изменений.
    ACID
    Свойства транзакций: atomicity, consistency, isolation, durability.
    ADR
    Architecture Decision Record — короткая фиксация контекста, решения и последствий.
    API Contract
    Формальное соглашение о запросах, ответах, ошибках и ограничениях взаимодействия.
    Backoff
    Увеличение задержки между повторными попытками.
    Bounded Context
    Граница, внутри которой модель и язык домена имеют однозначный смысл.
    CDC
    Change Data Capture — поток изменений из источника данных.
    Circuit Breaker
    Паттерн временного прекращения вызовов нестабильной зависимости.
    Correlation ID
    Идентификатор для трассировки одного бизнес-запроса через несколько систем.
    DLQ
    Dead Letter Queue — очередь сообщений, которые не удалось корректно обработать.
    Eventual Consistency
    Модель, допускающая временное расхождение состояний между компонентами.
    Idempotency
    Свойство операции, при котором повтор не создает дополнительный бизнес-эффект.
    NFR
    Нефункциональное требование: производительность, доступность, безопасность и другие свойства качества.
    Outbox
    Паттерн надежной публикации события вместе с транзакцией изменения данных.
    RPO
    Допустимый объем потери данных, выраженный во времени.
    RTO
    Допустимое время восстановления сервиса.
    Saga
    Паттерн координации распределенной бизнес-транзакции через шаги и компенсации.
    SLA
    Договорный уровень сервиса.
    SLO
    Целевой показатель качества сервиса.
    Traceability
    Связь требования с целью, сценарием, реализацией и проверкой.
    Webhook
    HTTP callback, отправляемый источником при наступлении события.

    64 / LINKS

    Полезные ресурсы