84 lines
3.6 KiB
Markdown
84 lines
3.6 KiB
Markdown
# 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
|