🦆 Rubber Duck Debugging as a Service (RDDaaS)

Rubber Duck Debugging as a Service. Дебажь код, выговаривайся и решай проблемы, не покидая браузер.

RDDaaS — это высокотехнологичное воплощение метода «утенка». Вместо того чтобы мучить коллег или говорить в пустоту, ты объясняешь проблему интерактивной уточке. Она внимательно слушает и крякает в ответ в нужные моменты, подталкивая твой мозг к озарению.

---

✨ Почему это круто?

• 🔒 Zero Logs (Local-First): Обработка голоса происходит только в твоем браузере через Web Audio API. Никаких серверов, никакой записи, полная приватность.
• ⚡ High Performance: Никаких тяжелых LLM и задержек API. Только чистый, эмпатичный «кря» мгновенно после того, как ты замолчал.
• 🦆 Психотерапия для кода: Уточка не осуждает твой try-catch с пустым блоком или unwrap(). Она просто слушает.

---

🛠 Tech Stack (MVP)

• Frontend: SvelteKit (Static Adapter).
• Logic: Web Audio API для анализа аудиопотока и детекции тишины.
• 2D\3D Selectable animations: (реактивность на громкость голоса):
  • 2D Animation: SVG + CSS Transitions - для минимальной нагрузки.
  • 3D Animation: Three.js + Threlte - для тех, кому важен визуал
• Storage: localStorage для сохранения твоих локальных рекордов и настроек.

---

🗺 Roadmap

📍 Phase 1: MVP (В разработке)

Core-механика взаимодействия пользователя и уточки.

• Voice Activity Detection (VAD): Детектор тишины на клиенте (уточка понимает, когда ты закончил мысль).
• Auto-Quack Engine: Система воспроизведения звуков quack.wav с рандомной вариацией тональности.
• Visual Feedback: Анимированная SVG-уточка, реагирующая на амплитуду голоса.
• "I Solved It!" Button: Кнопка для фиксации победы над багом (итерация счетчика рекордов).

📍 Phase 2: Gamification (Local Only)

Добавление фана без необходимости бэкенда.

• Joke Achievements: Система локальных ачивок («Полуночный ковбой», «Сеньор Помидор», «Кря-мастер»).
• Sound Themes: Наборы звуков (8-bit, Метал, Сочувственный шепот).
• Debug Journal: Локальное сохранение лога твоих побед (только текст, только в твоем браузере).

📍 Phase 3: Expansion (Future)

Масштабирование и монетизация.

• Rust Backend (Axum): Облачная синхронизация профиля и кросс-платформенные настройки.
• Rust MCP server (Axum): MCP сервер для LLM. Отвечает случайными кряками, нужно API-keys, rate-limit, tower-governor.
• metrics server: метрики запросов - на сколько запросов было отвечено.
• Duck Shop & Battle Pass: Кастомизация (уточка-хакер, уточка в худи, скины за ачивки).
• IDE Extensions: Плагины для VS Code и JetBrains для вызова уточки горячей клавишей.
• Local-First LLM: Опциональное подключение микро-моделей (через WebGPU) для тех, кому нужно, чтобы уточка иногда задавала наводящие вопросы.

---

🚀 Как запустить локально

# Клонируй репозиторий
git clone https://github.com/Ku6epXBOCTuK/rubber-duck.git

# Установи зависимости
npm install

# Запусти dev-сервер
npm run dev

---

🤝 Contributing

Если ты знаешь, как сделать "Кря" на 10% эффективнее или хочешь нарисовать новый скин для уточки — welcome в Pull Requests!

Disclaimer: Проект не несет ответственности за осознание того, что баг всё это время был в опечатке в имени переменной.