Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,189 @@
+# 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)
+
+1. Прочитай docs/blocks/00-rules.md — это приоритет
+2. Прочитай docs/instructions/00-system-prompt.md
+3. Следуй плану в docs/blocks/PLAN.md
+
+### Для разработчиков
+
+1. Установи Python 3.12+
+2. Установи PostgreSQL
+3. Скопируй .env.example → .env
+4. Заполни .env (см. комментарии)
+5. pip install -r requirements.txt
+6. lembic upgrade head
+7. 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*
+*Этот файл самообновляется системными агентами*