# 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