Files
brand_book/docs/SPRINTS.md
T
AR 15 M4 4f1b611065 docs: инициализация проекта, структура репозитория и проектная документация
- README.md: стек, структура monorepo, git-workflow, быстрый старт
- docs/BRANDBOOK_SCOPE.md: полный состав цифрового брендбука
- docs/SPRINTS.md: план 12 недельных спринтов
- .gitignore: node_modules, .env, .next, .DS_Store, .claude

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22 14:34:50 +05:00

250 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# План спринтов — Брендбук О!Клиника
> Недельные спринты. Каждый спринт = 1 рабочая неделя.
> Базовая дата начала: уточняется при старте разработки.
---
## Обозначения
- **FE** — задача фронтенда (Next.js)
- **BE** — задача бэкенда (NestJS + Prisma)
- **DB** — изменения схемы базы данных
- **Design** — дизайн-решения, требующие согласования
---
## Sprint 1 — Инициализация проекта
**Цель:** Рабочее окружение, monorepo, базовая архитектура.
### Задачи
- [ ] FE: Инициализация Next.js (App Router) в `apps/web`
- [ ] BE: Инициализация NestJS в `apps/api`
- [ ] DB: Подключение PostgreSQL + Prisma, базовая схема
- [ ] Настройка Docker Compose для локальной разработки
- [ ] Настройка monorepo (pnpm workspaces)
- [ ] Создание `.env.example`
- [ ] Git: инициализация репозитория, ветки `main` и `develop`
- [ ] FE: Базовая структура брендбука (layout, навигация по секциям)
- [ ] FE: Подключение шрифта Fira Sans
**Результат спринта:** Запускается `pnpm dev` — открывается пустой брендбук с навигацией.
---
## Sprint 2 — Цвета и типографика (Brand Foundation)
**Цель:** Секция «Фундамент бренда» — цвета и шрифты живые в брендбуке.
### Задачи
- [ ] Design: Получить и зафиксировать все цвета из файла брендбука клиники
- [ ] FE: Создать CSS-переменные / дизайн-токены для всей цветовой палитры
- [ ] FE: Страница «Цвета» — отображение палитры с hex/RGB/HSL, копирование в клик
- [ ] FE: Страница «Типографика» — все стили текста (h1h6, body, caption и т.д.)
- [ ] FE: Живые примеры типографики с Fira Sans
- [ ] FE: Экспорт токенов в JSON (Figma-compatible)
- [ ] Design: Согласование охранных зон и правил применения цветов
**Результат спринта:** Раздел «Фундамент» полностью готов (без логотипа).
---
## Sprint 3 — Базовые компоненты: кнопки и поля ввода
**Цель:** Все варианты кнопок и форм-контролов в брендбуке.
### Задачи
- [ ] FE: Компонент Button (все варианты: primary/secondary/ghost/danger, размеры, состояния)
- [ ] FE: Компонент Input (text, password, focus/error/disabled)
- [ ] FE: Компонент Textarea
- [ ] FE: Компонент Select
- [ ] FE: Компонент Checkbox и Radio
- [ ] FE: Компонент Toggle/Switch
- [ ] FE: Страница брендбука «Компоненты → Кнопки» с документацией
- [ ] FE: Страница брендбука «Компоненты → Форм-контролы»
- [ ] FE: Копирование HTML/CSS кода компонента в один клик
**Результат спринта:** Раздел «Базовые компоненты — кнопки и ввод» готов.
---
## Sprint 4 — Карточки (Cards)
**Цель:** Все типы карточек, используемых на сайте.
### Задачи
- [ ] FE: Карточка врача (DoctorCard) — фото, имя, специализация, кнопка записи
- [ ] FE: Карточка услуги / заболевания
- [ ] FE: Карточка новости — превью, дата, заголовок, анонс, читать далее
- [ ] FE: Карточка отзыва — автор, текст, рейтинг (звёзды), дата
- [ ] FE: Карточка цены — услуга, стоимость, описание
- [ ] FE: Бейджи, теги, алерты (inline и toast)
- [ ] FE: Страница «Компоненты → Карточки» с документацией
**Результат спринта:** Все карточки задокументированы и показаны в брендбуке.
---
## Sprint 5 — Hero-блок и CEO-текст
**Цель:** Ключевые верхние блоки страниц.
### Задачи
- [ ] FE: Hero-блок вариант 1 — фон + заголовок + CTA
- [ ] FE: Hero-блок вариант 2 — иллюстрация сбоку
- [ ] FE: Hero-блок вариант 3 — с встроенной формой записи
- [ ] FE: Блок CEO-текст — фото руководителя, цитата, подпись
- [ ] FE: Блок «Преимущества клиники» — иконки + текст
- [ ] FE: Страница «Блоки → Hero и вступление»
- [ ] Design: Согласование вариантов Hero под разные страницы
**Результат спринта:** Hero и CEO-секция полностью задокументированы.
---
## Sprint 6 — Врачи и профиль врача
**Цель:** Блоки и компоненты, связанные с врачами.
### Задачи
- [ ] FE: Блок «Наши врачи» — сетка карточек с фильтром по специализации
- [ ] FE: Блок «Врач — профиль» (полная страница): фото, биография, специализации, расписание
- [ ] FE: Компонент «Расписание / слоты записи»
- [ ] FE: Компонент навигации (header menu, breadcrumbs)
- [ ] FE: Пагинация
- [ ] FE: Страница «Блоки → Врачи»
**Результат спринта:** Все блоки о врачах готовы.
---
## Sprint 7 — Отзывы и новости
**Цель:** Контентные блоки сайта.
### Задачи
- [ ] FE: Блок отзывов — карусель
- [ ] FE: Блок отзывов — статичная сетка
- [ ] FE: Блок рейтинга (звёзды + количество отзывов)
- [ ] FE: Блок новостей — сетка превью (3 в ряд)
- [ ] FE: Блок новостей — горизонтальный список
- [ ] FE: Блок «Последние новости» для сайдбара
- [ ] FE: Блок услуг / заболеваний — иконки + список
- [ ] FE: Страница «Блоки → Отзывы и новости»
**Результат спринта:** Контентные блоки задокументированы.
---
## Sprint 8 — Формы контакта и модальные окна
**Цель:** Все формы и диалоги взаимодействия с пациентом.
### Задачи
- [ ] FE: Форма записи — короткая (имя, телефон)
- [ ] FE: Форма записи — расширенная (имя, телефон, специализация, врач, дата)
- [ ] FE: Форма записи в модальном окне
- [ ] FE: Контактная форма (имя, email, сообщение)
- [ ] FE: Блок «Контакт» — карта + адрес + часы работы
- [ ] FE: Модальное окно — информационное
- [ ] FE: Модальное окно — подтверждение
- [ ] FE: Страница «Блоки → Формы и контакты»
**Результат спринта:** Все формы и диалоги готовы.
---
## Sprint 9 — Страницы: Главная и Заболевание
**Цель:** Первые две полноразмерные страницы в брендбуке.
### Задачи
- [ ] FE: Страница «Главная» — сборка из утверждённых блоков
- [ ] FE: Страница «Заболевание» — Hero (мини), описание, врачи по теме, форма
- [ ] FE: Раздел «Страницы» в навигации брендбука
- [ ] FE: Адаптивность страниц (desktop / tablet / mobile)
- [ ] Design: Ревью и согласование страниц
**Результат спринта:** 2 страницы задокументированы в брендбуке.
---
## Sprint 10 — Страницы: Врачи, Врач, Цены
**Цель:** Три страницы с ключевым контентом.
### Задачи
- [ ] FE: Страница «Все врачи» — фильтры, сетка, пагинация
- [ ] FE: Страница «Врач (профиль)»
- [ ] FE: Страница «Цены» — фильтры, таблица, форма
- [ ] FE: Таблица цен с сортировкой
- [ ] FE: Адаптивность всех трёх страниц
- [ ] Design: Ревью страниц
**Результат спринта:** Ещё 3 страницы в брендбуке.
---
## Sprint 11 — Страница Контакты и Экспериментальная секция (MVP)
**Цель:** Последняя страница + запуск механизма экспериментов.
### Задачи
- [ ] FE: Страница «Контакты»
- [ ] BE + DB: Модели `Component`, `Page`, `Block` в Prisma
- [ ] BE: CRUD API для компонентов (`/api/components`)
- [ ] BE: CRUD API для страниц (`/api/pages`)
- [ ] FE: Секция «Эксперименты» в брендбуке
- [ ] FE: Форма создания нового экспериментального компонента
- [ ] FE: Список экспериментальных компонентов со статусами
**Результат спринта:** Все страницы готовы, эксперименты — базовый функционал.
---
## Sprint 12 — Деплой, полировка, документация
**Цель:** Финальный релиз и публикация.
### Задачи
- [ ] BE + FE: Полный smoke-тест всего брендбука
- [ ] FE: Мобильная адаптация — финальная проверка всех страниц
- [ ] FE: Accessibility-аудит (WCAG AA)
- [ ] Деплой: настройка CI/CD, публикация на сервере
- [ ] Docs: Создание `docs/deployment.md`
- [ ] Docs: Обновление README.md финальными инструкциями
- [ ] Design: Финальный ревью брендбука
**Результат спринта:** Брендбук задеплоен и доступен по URL.
---
## Сводная таблица
| Спринт | Тема | Ключевой результат |
|--------|---------------------------------------|-----------------------------------------|
| 1 | Инициализация | Запускается пустой брендбук |
| 2 | Цвета и типографика | Раздел «Фундамент» готов |
| 3 | Кнопки и форм-контролы | Базовые компоненты готовы |
| 4 | Карточки | Все карточки задокументированы |
| 5 | Hero и CEO-текст | Ключевые блоки страниц готовы |
| 6 | Врачи | Блоки о врачах готовы |
| 7 | Отзывы и новости | Контентные блоки готовы |
| 8 | Формы и модальные окна | Все формы задокументированы |
| 9 | Страницы: Главная, Заболевание | 2 страницы в брендбуке |
| 10 | Страницы: Врачи, Цены | 3 страницы в брендбуке |
| 11 | Контакты + Эксперименты MVP | Все страницы + система экспериментов |
| 12 | Деплой и полировка | Брендбук живёт в продакшне |
---
## Backlog (вне основных спринтов)
- Тёмная тема
- Экспорт компонентов в Figma
- Drag-and-drop конструктор страниц
- История версий экспериментальных компонентов
- Мультиязычность (если потребуется)
- Раздел «Логотип» (после получения вектора)