Files
voidea/README.md
T

3.6 KiB
Raw Blame History

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

Документация

Тесты

pytest -v
pytest --cov=app

Лицензия

AGPL-3.0