docs: обновление прогресса и инструкций по деплою

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Денис Шкабатур
2026-02-11 13:07:29 +03:00
parent fa9de0d94d
commit 16cce2e99b

View File

@@ -1,6 +1,6 @@
# Грибы Крыма — Прогресс разработки
## Статус: В разработке
## Статус: Готово к деплою
## Архитектура
@@ -8,27 +8,24 @@
- **Framework**: Next.js 15 (App Router) + React 19
- **Language**: TypeScript (strict mode)
- **Styling**: Tailwind CSS 4
- **Data**: Статические JSON/TS файлы (без БД)
- **Deploy**: Static export → самохост на git.dshkabatur.ru
- **Data**: Статические TS-файлы (без БД)
- **Deploy**: Static export → Docker (nginx)
### Структура страниц
| Страница | Route | Описание |
|----------|-------|----------|
| Главная | `/` | Hero, избранные грибы, сезон сейчас |
| Энциклопедия | `/encyclopedia` | Каталог всех грибов с фильтрами |
| Карточка гриба | `/encyclopedia/[slug]` | Детальная страница гриба |
| Календарь | `/calendar` | Интерактивный календарь грибника |
| Справочник | `/guide` | Правила сбора, советы, первая помощь |
| Страница | Route | Статус |
|----------|-------|--------|
| Главная | `/` | Готово |
| Энциклопедия | `/encyclopedia` | Готово |
| Карточка гриба | `/encyclopedia/[slug]` | Готово (20 видов) |
| Календарь | `/calendar` | Готово |
| Справочник | `/guide` | Готово |
| 404 | `/*` | Готово |
### Компоненты
- `Header` — навигация, логотип
- `Footer` — контакты, копирайт
- `MushroomCard` — карточка гриба в каталоге
- `MushroomDetail` — детальная информация
- `SeasonCalendar` — календарь по месяцам
- `SearchBar` — поиск с автодополнением
- `FilterPanel` — фильтры (съедобность, сезон, место)
- `EdibilityBadge` — бейдж съедобности
### Данные
- 20 видов грибов Крыма (14 съедобных/условно-съедобных + 6 ядовитых)
- Достоверные описания с научными названиями
- Календарь сезонности по месяцам
- 6 разделов справочника грибника
---
@@ -37,56 +34,57 @@
### Фаза 1: Настройка
- [x] Cursor rules
- [x] Файл прогресса
- [ ] Инициализация Next.js проекта
- [ ] Настройка Tailwind CSS
- [ ] Базовый layout (Header/Footer)
- [x] Инициализация Next.js проекта
- [x] Настройка Tailwind CSS
- [x] Базовый layout (Header/Footer)
### Фаза 2: Данные
- [ ] Типы TypeScript для грибов
- [ ] База данных грибов (20+ видов Крыма)
- [ ] Фотографии грибов
- [x] Типы TypeScript для грибов
- [x] База данных грибов (20 видов Крыма)
- [x] Фотографии грибов (Unsplash)
### Фаза 3: Страницы
- [ ] Главная страница
- [ ] Энциклопедия (каталог + фильтры)
- [ ] Детальная страница гриба
- [ ] Календарь грибника
- [ ] Справочник грибника
- [x] Главная страница (hero + сезон + карточки)
- [x] Энциклопедия (каталог + поиск + фильтры)
- [x] Детальная страница гриба
- [x] Календарь грибника (интерактивный)
- [x] Справочник грибника
### Фаза 4: Полировка
- [ ] Адаптивность (mobile/tablet/desktop)
- [ ] SEO мета-теги
- [ ] Анимации и переходы
- [ ] Accessibility проверка
- [x] Адаптивность (mobile/tablet/desktop)
- [x] SEO мета-теги
- [x] Природная цветовая палитра
- [x] 404 страница
### Фаза 5: Деплой
- [ ] Git репозиторий
- [ ] Деплой на сервер
- [x] Docker + nginx конфигурация
- [x] Git репозиторий (локальный)
- [ ] Push на git.dshkabatur.ru (требуется SSH-ключ или токен)
- [ ] Запуск на сервере
---
## Детали реализации
## Инструкции по деплою
### Данные о грибах
Каждый гриб содержит:
- Научное название (латынь)
- Русское название (одно или несколько)
- Классификация съедобности: съедобный / условно-съедобный / несъедобный / ядовитый
- Описание: шляпка, ножка, мякоть, споровый порошок
- Места произрастания в Крыму
- Сезон сбора (по месяцам)
- Похожие виды (двойники)
- Фотографии
### 1. Настроить SSH-ключ
```bash
ssh-keygen -t ed25519 -C "shkabaturd@yandex.ru"
# Добавить публичный ключ в Gitea: Settings → SSH Keys
```
### Календарь
- 12 месяцев, интерактивный
- При клике на месяц — список грибов сезона
- Визуальная шкала обилия (мало/средне/много)
- Текущий месяц выделен
### 2. Создать репозиторий на Gitea
Через веб-интерфейс https://git.dshkabatur.ru создать репозиторий `grib`
### Справочник
- Правила безопасного сбора
- Как отличить ядовитые от съедобных
- Первая помощь при отравлении
- Способы приготовления
- Снаряжение грибника
### 3. Добавить remote и push
```bash
cd /Users/den/src/ts/grib
git remote add origin ssh://git@dshkabatur.ru:2222/denis/grib.git
git push -u origin main
```
### 4. На сервере
```bash
git clone ssh://git@dshkabatur.ru:2222/denis/grib.git
cd grib
docker compose up -d --build
```