← всі звіти · 02-pseudocode.md

sparc_phase: P project: <project-slug> created: <YYYY-MM-DD> author: <name> status: draft | review | approved spec_link: ./01-specification.md

Pseudocode — Псевдокод: логіка кроків без коду — <Project / Feature Name>

Логіка кроків без конкретного коду. Мета — зловити галюцинації і логічні діри ДО того як писати реальний код. Будь-яка людина (не лише розробник) має зрозуміти що відбувається.

High-level flow

Один абзац: вхід → ключові кроки → вихід. Що робить система коли користувач запускає сценарій.

Основний flow

1. Отримуємо <вхід> від <джерело>
2. Перевіряємо що <умова>
   2a. Якщо ні → повертаємо <error>
3. Робимо A якщо B, інакше C
4. Викликаємо <зовнішня система> щоб …
5. Зберігаємо <стан> у <storage>
6. Повертаємо <результат>

Альтернативні flows / сценарії помилок

Scenario 1: …

…

Scenario 2: retry після failure …

…

Ключові структури даних

Без конкретного типу — суть. Що зберігаємо, чому.

Entity A: складається з …, потрібно для …
Entity B: …

Псевдо-функції / responsibilities

Перелік ключових «функцій» (чорних боксів) які треба написати. Без сигнатур, лише призначення.

validate_input(x) → перевіряє що …
fetch_external_data(id) → …
compute_result(a, b) → …
persist_state(state) → …

Інтеграції зі сторонніми системами

API X: який метод, які поля, обмеження rate limit
Сервіс Y: …

Що НЕ робимо у логіці

Якщо у specification було non-goals — нагадати їх тут на рівні логіки.

Відкриті питання

Логічні діри, що не зрозуміло. Розв'язати перед A (Architecture).

…

Sign-off

[ ] Сергій / тех-leader schválив
[ ] Дата approval: <YYYY-MM-DD>
[ ] Перехід на наступну фазу: A (Architecture)