Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,83 @@
+# VoIdeaAI — голосовой AI-ассистент для идей
+
+**VoIdeaAI** — PWA для генерации, проработки и сохранения идей с помощью группового ИИ-анализа (26 агентов). V2.0: роли, тарифы, админ-панель (8 вкладок), лендинг, юридические страницы, аналитика, SEO, in-app документация, systemd-деплой.
+
+## Быстрый старт
+
+```bash
+# Backend
+python -m venv venv
+venv\Scripts\activate
+pip install -e .
+alembic upgrade head
+uvicorn app.main:app --reload --port 8020
+
+# Frontend
+cd webui
+npm install
+npm run dev
+```
+
+## Стек
+
+| Компонент | Технология |
+|-----------|-----------|
+| Бэкенд | Python 3.12+, FastAPI, asyncpg, SQLAlchemy 2.0 |
+| Фронтенд | React 18, TypeScript, Tailwind CSS, PWA |
+| База данных | PostgreSQL (только) |
+| Аутентификация | JWT + bcrypt + OAuth (Яндекс, Google, Apple) |
+| ИИ | OpenAI / YandexGPT / GigaChat (fallback) |
+| Голос | Web Speech API → Whisper API (fallback) |
+| TTS | SpeechSynthesis API (браузер) |
+| Оркестрация | Дирижёр + 13 ролевых агентов + 12 dev/ops агентов |
+
+## Архитектура
+
+```
+Browser (PWA) → FastAPI (StaticFiles) → Conductor → Role Agent → LLM
+                                                            ↓
+                                                     Верификация → Ответ
+```
+
+Подробнее: [`docs/full.md`](docs/full.md)
+
+## Статус реализации v2.0
+
+### ✅ Завершено
+- **Backend**: Роли (owner/admin/moderator/user), тарифы, фидбек, feature gate, seed, config, миграция 002
+- **Admin API**: 22 эндпоинта — пользователи, агенты, логи, отзывы, тарифы, фичи, сервисы, система
+- **Public API**: конфиг, тарифы, фидбек, регистрация с accepted_terms, смена пароля
+- **Frontend API**: `admin.ts`, `config.ts`, `feedback.ts`, `tariffs.ts` — полный API-слой
+- **Landing page**: public `/` с hero, features, CTA
+- **Legal pages**: `/privacy`, `/terms`, `/data-processing`
+- **Admin panel**: 8 вкладок (Users, Agents, Features, Logs, Feedback, Tariffs, Services, System, Docs)
+- **Settings**: профиль, безопасность, голос, тема, интеграции, тариф
+- **In-app docs**: UserGuidePage, HelpFAB, HelpDrawer, AdminDocumentationTab
+- **SEO**: Open Graph, JSON-LD, Twitter Card, robots.txt, sitemap.xml
+- **Analytics**: YandexMetrika + GA conditional components
+- **DevOps**: 3 systemd unit files + deploy.sh
+- **@tailwindcss/typography**: установлен, prose-классы работают
+
+### В процессе / запланировано
+- **Dark styles + CSS wave** (Phase 4) — отложено
+- **OAuth callback E2E тесты** — нужен public URL
+- **Google/Apple OAuth** — ждут API credentials
+- **Push-уведомления** — FCM/APNS stubs в config
+
+## Документация
+
+- [`docs/full.md`](docs/full.md) — полная спецификация
+- [`docs/user-guide.md`](docs/user-guide.md) — руководство пользователя
+- [`docs/admin-guide.md`](docs/admin-guide.md) — руководство администратора
+- [`CHANGELOG/v2.0.md`](CHANGELOG/v2.0.md) — все изменения v2.0
+
+## Тесты
+
+```bash
+pytest -v
+pytest --cov=app
+```
+
+## Лицензия
+
+AGPL-3.0