# Diet & Healthy Weight Reference App — План разработки

## Описание проекта

Статическое веб-приложение — справочник методик похудения и поддержания здорового веса.
Полностью serverless, деплой на любой статик-хостинг (Vercel, Netlify, GitHub Pages).

## Стек технологий

- **Runtime**: Vite 6 + React 19 + TypeScript 5
- **Стили**: Tailwind CSS 4 + clsx
- **Роутинг**: React Router 7 (client-side)
- **Данные**: Статические JSON/TS модули (без API)
- **Хранение**: localStorage для закладок / настроек
- **Сборка**: Vite → статический бандл

## Архитектура

```
src/
  components/   — переиспользуемые UI-компоненты
  pages/        — страницы приложения
  data/         — контент: методики, категории
  hooks/        — кастомные React-хуки
  utils/        — утилиты (расчёт BMI и др.)
  types/        — TypeScript типы
  assets/       — изображения, иконки
```

## Фичи (в порядке приоритета)

### Phase 1 — Фундамент
- [x] Инициализация проекта (Vite + React + TS + Tailwind)
- [ ] Базовая структура приложения и роутинг
- [ ] Layout: header, footer, навигация
- [ ] Главная страница с обзором

### Phase 2 — Контент
- [ ] Модель данных для методик
- [ ] Данные: минимум 15 методик по категориям
- [ ] Страница списка методик с фильтрами
- [ ] Страница детальной информации о методике

### Phase 3 — Интерактивность
- [ ] Поиск по методикам (instant search)
- [ ] Фильтрация по категориям, сложности, эффективности
- [ ] BMI-калькулятор
- [ ] Закладки (favorites) через localStorage
- [ ] Сравнение методик (до 3 шт)

### Phase 4 — Полировка
- [ ] Тёмная / светлая тема
- [ ] Адаптивный дизайн (mobile-first)
- [ ] Анимации переходов
- [ ] SEO мета-теги
- [ ] Деплой на GitHub Pages / Vercel

## Прогресс

| Дата | Что сделано | Коммит |
|------|-------------|--------|
| 2026-02-11 | Создан план, cursor rules, инициализация проекта | — |

## Принципы разработки

1. **Коммит на каждую фичу** — атомарные, понятные коммиты
2. **100% агентная разработка** — cursor rules покрывают все паттерны
3. **TypeScript strict mode** — никаких `any`
4. **Переиспользуемые компоненты** — DRY
5. **Доступность (a11y)** — семантический HTML, ARIA
6. **Производительность** — lazy loading, минимум бандла