mirror of
https://github.com/wasrusgen/zov-tech.git
synced 2026-06-03 15:04:50 +00:00
Backend: - Лист ClientNotes (auto-create через ensure_sheet) — колонки manager_tg_id, client_key, note, updated_at. - Ключ клиента: «p:7XXXXXXXXXX» если есть телефон ≥10 цифр, иначе «n:<имя в lower>». Привязан к менеджеру. - POST /api/client_note — без поля note читает текущую, с note — upsert (хард-кап 4000 символов). Frontend в карточке клиента (#/clients/client/<key>): - Новый блок «📝 Примечание» сверху над списком подборов - Textarea + дата обновления в meta - Кнопка «🎤 Диктовать» — Web Speech API (ru-RU) · interimResults показывает прямо во время речи · final-результаты добавляются к baseText · красная пульсация во время записи · graceful degrade если SR недоступен (Telegram WebApp на iOS) - Кнопка «Сохранить» → PUT в /api/client_note + статус «✓ сохранено» CSS: .client-note-block, .btn-mic, .btn-mic.rec (pulse animation), .note-status.ok / .err. Cache bust v=20260513y. |
||
|---|---|---|
| .github/workflows | ||
| backend | ||
| backend-py | ||
| bot | ||
| deploy | ||
| design-drafts | ||
| docs | ||
| miniapp | ||
| .gitignore | ||
| .tmp_ssh.py | ||
| README.md | ||
ZOV Tech — AI-подбор кухонной техники
Telegram-бот + MiniApp для подбора техники под кухню фабрики ЗОВ. Менеджер заполняет с клиентом чек-лист → нейросеть собирает предложение → менеджер получает результат за минуту.
Структура
zov-tech/
├── bot/ — Telegram-бот (Python + aiogram)
├── miniapp/ — MiniApp (HTML + JS, хост на GitHub Pages)
├── backend/ — Google Apps Script (бэкенд + работа с Sheets)
├── docs/ — Документация (ТЗ, deployment, decisions)
└── .claude/ — настройки Claude Code (вне репо)
Стек
| Слой | Технология |
|---|---|
| Бот | Python 3.10+, aiogram 3.x |
| AI | Anthropic Claude (Haiku 4.5) |
| MiniApp | Vanilla JS + HTML, без сборки |
| Backend | Google Apps Script (Web App) |
| БД | Google Sheets (на старте), PostgreSQL (после роста) |
| Хостинг бота | VPS (Selectel / Timeweb) |
| Хостинг MiniApp | GitHub Pages |
Быстрый старт (когда будет код)
cd bot
python -m venv .venv
.venv\Scripts\activate # Windows
pip install -r requirements.txt
copy .env.example .env # заполнить токены
python main.py
Документация
- Техническое задание — полное ТЗ продукта.
Контакты
Куратор / заказчик: Василий (@wasrusgen) Канал: @wasrusgen1