6.1 KiB
VoIdea — Голос Идей
О проекте
VoIdea — гибридное приложение (мобильное + веб) для фиксации и проработки идей с помощью группового ИИ-анализа.
Ключевые возможности
- 🎙️ Голосовой ввод идей
- 🤖 11 ИИ-агентов для анализа
- 🔄 Синхронизация между устройствами
- 🔒 Защита данных (шифрование AES-256)
- 🌐 Работа оффлайн (PWA)
Структура проекта
voidea/ ├── app/ # Код приложения │ ├── agents/ # 11 системных агентов │ ├── core/ # Ядро (config, base, security) │ ├── models/ # Модели данных │ ├── api/ # API endpoints │ ├── services/ # Бизнес-логика │ ├── integrations/ # Внешние сервисы (AI, OAuth) │ └── design-tokens/ # Сгенерированные стили ├── docs/ # Документация │ ├── blocks/ # Блоки проекта (00-rules, PLAN...) │ ├── design-system/ # Дизайн-система (tokens.json) │ ├── instructions/ # Инструкции для AI и людей │ ├── specs/ # Спецификации │ ├── adr/ # Architecture Decision Records │ ├── backlog/ # Отложенные задачи │ ├── runbook/ # Runbook для админа │ └── insights/ # Наблюдения ObserverAgent ├── tests/ # Тесты │ ├── unit/ # Модульные │ └── integration/ # Интеграционные ├── CHANGELOG/ # История версий └── project.json # Машиночитаемое описание
Быстрый старт
Для AI (OpenCode)
- Прочитай docs/blocks/00-rules.md — это приоритет
- Прочитай docs/instructions/00-system-prompt.md
- Следуй плану в docs/blocks/PLAN.md
Для разработчиков
- Установи Python 3.12+
- Установи PostgreSQL
- Скопируй .env.example → .env
- Заполни .env (см. комментарии)
- pip install -r requirements.txt
- lembic upgrade head
- uvicorn app.main:app --reload --port 8020
Конфигурация
Переменные окружения
Все переменные описаны в .env.example:
`ash
Core
PROJECT_NAME=VoIdea PROJECT_VERSION=1.0.0 SERVER_PORT=8020
Database
DB_HOST=localhost DB_PORT=5432 DB_NAME=voidea DB_USER=voidea
AI
AI_YANDEX_KEY= AI_GIGACHAT_KEY=
OAuth
OAUTH_YANDEX_ID= OAUTH_GOOGLE_ID= `
Подробнее: .env.example
Версионирование
Формат: MAJOR.MINOR.PATCH (SemVer)
- MAJOR (1.x.x): полный релиз, breaking changes
- MINOR (x.1.x): новый функционал
- PATCH (x.x.1): багфиксы
CHANGELOG хранится в CHANGELOG/ по версиям. Подробнее: docs/blocks/VERSIONS.md
Дизайн-система
Единый источник истины: docs/design-system/tokens.json
Включает:
- Цвета (primary, background, text, semantic)
- Типографика (font-family, size, weight)
- Отступы, радиусы, тени
- 3 темы: system (auto), dark, light
Генераторы:
- generators/css_generator.py → CSS Variables
- generators/swift_generator.py → Swift
- generators/kotlin_generator.py → Kotlin XML
Агенты
Системные агенты (автоматизация)
| Агент | Назначение |
|---|---|
| DocAgent | Документация |
| AuditAgent | Соблюдение правил |
| SecurityAgent | Безопасность |
| SpecAgent | Версионирование |
| ObserverAgent | Наблюдение за пользователями |
| QATesterAgent | Функциональное тестирование |
| FixAgent | Исправление багов |
| UITestAgent | Визуальное тестирование |
| RolloutAgent | Постепенное развёртывание |
| EvolutionAgent | Саморазвитие |
| BacklogAgent | Управление задачами |
Запуск: автоматически (pre-commit, push, cron) или вручную (админ-панель).
ИИ-агенты (анализ идей)
11 ролей: Координатор, Организатор, Бизнес-аналитик, Юрист, Финансовый консультант, Архитектор, Тестировщик, UI-дизайнер, SMM-специалист, Лайф-коуч, Эксперт по доступности.
Промпты: docs/agent_prompts.yaml
Документация
| Документ | Описание |
|---|---|
| docs/blocks/00-rules.md | Правила проекта (приоритет) |
| docs/blocks/PLAN.md | План реализации |
| docs/blocks/AUDIT.md | Система аудита |
| docs/blocks/BACKLOG.md | Система задач |
| docs/blocks/VERSIONS.md | Правила версионирования |
| docs/blocks/GLOSSARY.md | Глоссарий |
| docs/instructions/ | Инструкции для AI и людей |
| docs/runbook/ | Runbook для администратора |
Контакты
Owner: License: AGPL-3.0 Версия:
TODO: Перед началом разработки
- Установить PostgreSQL локально
- Создать виртуальное окружение
- Настроить .env
- Запустить Block 1: Core
Обновлён: 2026-05-10 Этот файл самообновляется системными агентами