Initial commit: MVP+ wish board with FastAPI + Tailwind

2026-08-05 17:06:36 +05:00
commit cd945a6128
@@ -0,0 +1,103 @@
+# 🎯 Wish Board — Доска желаний
+
+Интерактивная доска желаний с drag & drop, real-time синхронизацией и AI-генерацией идей.
+
+## 🚀 Быстрый старт
+
+```bash
+# Клонировать
+git clone <url>
+cd wish-board
+
+# Установить зависимости
+pip install -r requirements.txt
+
+# Запустить сервер
+python server.py
+
+# Открыть http://localhost:4000
+```
+
+## 📋 MVP+ Функционал
+
+### Базовый функционал
+- ✅ Доски с цветами
+- ✅ Списки (TODO/Doing/Done)
+- ✅ Карточки с drag & drop
+- ✅ Real-time синхронизация через WebSocket
+- ✅ SQLite для хранения данных
+
+### MVP+ Функционал
+- 🖼️ Изображения товаров
+- 💰 Цена и ссылка на товар
+- 💬 Комментарии
+- 📊 Статус (хочу/в процессе/куплено/отложено)
+- 🏷️ Категории/теги
+- ⭐ Рейтинг желаемости (1-5 звёзд)
+- 🔍 Поиск и фильтры
+- 📁 Архив купленных товаров
+- 💵 Итого (сумма всех желаний)
+- 💾 Автосохранение
+
+## 🛠️ Технологии
+
+- **Backend:** Python 3.11+, FastAPI, SQLite, WebSocket
+- **Frontend:** HTML5, Tailwind CSS, Vanilla JS
+- **Real-time:** WebSocket (FastAPI)
+- **Storage:** SQLite (WAL mode)
+
+## 📁 Структура проекта
+
+```
+wish-board/
+├── server.py          # FastAPI сервер
+├── index.html         # Frontend (SPA)
+├── requirements.txt   # Зависимости Python
+├── README.md          # Документация
+└── wish.db           # База данных (SQLite)
+```
+
+## 🎯 Roadmap
+
+### Phase 1: MVP+ (текущий)
+- [x] Базовая структура
+- [x] Drag & drop
+- [x] Real-time синхронизация
+- [ ] Изображения и цены
+- [ ] Статусы и категории
+- [ ] Поиск и фильтры
+- [ ] Архив и итоги
+
+### Phase 2: Улучшения
+- [ ] Тёмная тема
+- [ ] PWA (установка как приложение)
+- [ ] Экспорт/импорт (JSON backup)
+- [ ] Горячие клавиши
+- [ ] Контекстное меню
+
+### Phase 3: AI-фичи
+- [ ] AI-генерация идей (Ollama)
+- [ ] Автозаполнение по ссылке
+- [ ] Анализ цен (история)
+
+### Phase 4: Коллаборация
+- [ ] Регистрация/логин
+- [ ] Общие доски
+- [ ] Комментарии других пользователей
+- [ ] Голосование
+
+## 🤝 Вклад
+
+1. Форкнуть проект
+2. Создать ветку (`feature/your-feature`)
+3. Запушить изменения
+4. Создать Pull Request
+
+## 📄 Лицензия
+
+MIT License
+
+---
+
+**Создано:** 2024
+**Автор:** Nikita (Ufa)