194ad734e11532a3eabd96924b89bd58d831a364
VoIdeaAI — голосовой AI-ассистент для идей
VoIdeaAI — PWA для генерации, проработки и сохранения идей с помощью группового ИИ-анализа (26 агентов). V2.0: роли, тарифы, админ-панель (8 вкладок), лендинг, юридические страницы, аналитика, SEO, in-app документация, systemd-деплой.
Быстрый старт
# 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
Статус реализации 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/user-guide.md— руководство пользователяdocs/admin-guide.md— руководство администратораCHANGELOG/v2.0.md— все изменения v2.0
Тесты
pytest -v
pytest --cov=app
Лицензия
AGPL-3.0
Description
Languages
Makefile
37.5%
Python
29.1%
TypeScript
13.5%
Dart
11.5%
HTML
7.5%
Other
0.7%