docs: add CLAUDE.md with project context and process for future sessions

2026-05-12 22:13:23 +03:00
parent faac35302b
commit 507ab62d0a
1 changed files with 151 additions and 0 deletions
@@ -0,0 +1,151 @@
+# Sunset Pass — Проект для Сирпы
+
+## Суть проекта
+Клиент: **Sirpa Lehtinen** (sirpulik@gmail.com)
+Огороженный парк для собак в Финляндии (Saarijärven koirapuisto).
+Нужно разработать **веб/мобильное приложение** системы бронирования.
+
+### Как работает система
+Клиент открывает сайт/приложение → выбирает слот в календаре → платит онлайн → получает PIN → приходит к воротам → вводит PIN → ворота открываются → гуляет → уведомление за X минут → время вышло → выходит.
+
+Одна группа в парке за раз. Без поводка (в Финляндии запрещено, парк — единственное место где можно).
+
+---
+
+## Что уже знаем (из опросника 1)
+
+| Параметр | Ответ |
+|---|---|
+| Размер парка | 2 гектара |
+| Люди одновременно | Одна группа, без посторонних |
+| Слот | Мин 1 час, макс 1 день |
+| Часы работы | 7:00–23:00 каждый день |
+| Оплата | Онлайн |
+| Отмена | За 24 часа |
+| Регистрация | Не нужна (имя + email) |
+| Оборудование ворот | Ничего нет — всё с нуля |
+| PIN | Система генерирует автоматически после оплаты |
+| Брендинг | Название: Saarijärven koirapuisto, логотипа нет |
+| Язык | Финский |
+| Дедлайн | Середина июня 2026 |
+
+---
+
+## Что ещё не знаем (ждём ответа на опросник 2)
+
+Опросник 2 отправлен Сирпе: **https://antonsemenovser.github.io/Sunset-Pass/questionnaire2.html**
+
+Ждём ответа на 24 вопроса:
+- Тип слотов (фиксированные или гибкие)
+- Мультислот (несколько часов подряд)
+- Как далеко вперёд бронировать
+- Самостоятельная отмена
+- Цена за час и тарифы
+- Возврат денег при отмене
+- Счёт-фактура
+- Система замка (критично для интеграции!)
+- Длина PIN, доставка PIN
+- Уведомления (подтверждение, напоминание, предупреждение о конце)
+- Панель управления Сирпы
+- Формат (сайт / PWA / нативное приложение)
+- Язык (только финский или + английский)
+- Логотип и дизайн
+- GDPR и правила пользования
+
+---
+
+## Процесс работы над проектом
+
+### Этапы
+1. ✅ Опросник 1 — базовые требования (получен)
+2. 🔄 Опросник 2 — уточняющие вопросы (отправлен, ждём ответа)
+3. ⏳ Опросник 3 — если после 2 останутся пробелы
+4. ⏳ Написать полное ТЗ
+5. ⏳ Согласовать бюджет и план
+6. ⏳ Разработка
+
+### Как читать ответы клиента
+Ответы приходят как GitHub Issues в репозитории:
+**https://github.com/antonsemenovser/Sunset-Pass/issues**
+
+Команда для чтения нового ответа:
+```
+gh issue list --repo antonsemenovser/Sunset-Pass
+gh issue view [НОМЕР] --repo antonsemenovser/Sunset-Pass
+```
+
+---
+
+## Как отправлять опросники клиенту
+
+### Шаблон письма
+```
+Здравствуйте, Сирпа!
+
+[Контекст — почему новый опросник, что уже сделано]
+
+Пожалуйста, заполните [второй/третий] опросник:
+
+👉 [ССЫЛКА]
+
+С уважением,
+Anton / Kot Kanagrilli Oy
+kotkanagrilli@gmail.com
+```
+
+### Как создать новый опросник
+1. Скопировать `questionnaire2.html` → `questionnaire3.html`
+2. Скопировать `script2.js` → `script3.js`
+3. В HTML изменить: заголовок, вопросы, `src="script3.js"`
+4. В JS изменить: `TOTAL`, список полей в `TRACKED_FIELDS`/`updateProgress()`
+5. `git add . && git commit -m "feat: add questionnaire3" && git push origin gh-pages`
+6. Ссылка: `https://antonsemenovser.github.io/Sunset-Pass/questionnaire3.html`
+
+### Правила хорошего опросника
+- Радиокнопки с вариантами ответа — не textarea
+- Под каждым вопросом поле "Свой комментарий"
+- Где нужен "свой вариант" — поле появляется при выборе
+- Ответ клиента видно в GitHub Issues
+- Тулбар: Заново / Сохранить / Поделиться
+- Кнопка внизу: "Форма по другому вопросу"
+- Предпросмотр справа
+
+---
+
+## Структура файлов проекта
+
+```
+C:\pro\Sunset Pass\
+├── CLAUDE.md                    ← этот файл
+├── index.html                   ← Опросник 1 (заполнен Сирпой)
+├── questionnaire2.html          ← Опросник 2 (отправлен, ждём)
+├── script.js                    ← JS для опросника 1
+├── script2.js                   ← JS для опросника 2
+├── style.css                    ← Общие стили (для всех опросников)
+├── success.html                 ← Страница после отправки
+├── logo.jpg                     ← Лого Kot Kanagrilli Oy
+└── docs/
+    ├── analysis/
+    │   └── 2026-05-12-what-we-know.md   ← Анализ что знаем/не знаем
+    └── superpowers/
+        ├── plans/               ← Планы реализации
+        └── specs/               ← Дизайн-доки
+```
+
+---
+
+## Когда придёт ответ на опросник 2
+
+1. Прочитать issue: `gh issue list --repo antonsemenovser/Sunset-Pass`
+2. Решить — достаточно ли для ТЗ или нужен опросник 3
+3. Если достаточно → писать ТЗ
+4. ТЗ сохранить в `docs/tz/tz-v1.md`
+
+---
+
+## Контакты
+
+- **Клиент:** Sirpa Lehtinen — sirpulik@gmail.com
+- **Наш email:** kotkanagrilli@gmail.com (anton.semenov.ser@gmail.com)
+- **GitHub репо:** https://github.com/antonsemenovser/Sunset-Pass
+- **Живой сайт:** https://antonsemenovser.github.io/Sunset-Pass/