chetoru

t.me/chetoru_bot — Telegram-бот русско-чеченского словаря. Миссия проекта — помочь сохранить чеченский язык.

Словарные данные предоставлены проектом dosham.app.

Возможности

• Перевод — отправьте слово на русском или чеченском; работает и инлайн-режим (@chetoru_bot слово) в любом чате
• Умный поиск — подсказки лемм для словоформ («яблоками» → «Яблоко»), пословный разбор фраз, ё/е и палочка в любом написании (г1ала, гIала, гӏала)
• Грамматика — карточка с частью речи, формами слова и устойчивыми выражениями
• 🎲 /random — случайное чеченское слово
• 🧠 /quiz — викторина в обе стороны (узнавание и воспроизведение), очки, дневные серии 🔥, рейтинг /top; в группах — нативные опросы
• 📖 /wotd — слово дня по подписке, каждое утро в 9:00
• ✍️ /check — проверка чеченской орфографии (или сообщение с точки: .дала безам бу); инлайн-проверка @chetoru_bot . текст

Стек

Go · SQLite (WAL, автомиграции goose) · Redis (кэш переводов, спеллчека и грамматики) · OpenRouter (AI-форматирование статей и спеллчек) · GraphQL API dosham.app

main → internal/net (Telegram handlers) → internal/business → internal/repository
                                        ↘ internal/cache (Redis) · internal/ai (OpenRouter)

Запуск

go build ./... && go test ./...

Переменная	Назначение
TG_BOT_TOKEN	токен бота (обязательно)
DB_PATH	путь к SQLite (по умолчанию ./database.db)
REDIS_ADDR, REDIS_PASSWORD	Redis; без него бот работает, но без кэша
OPENROUTER_API_KEY, OPENROUTER_MODEL	AI-функции; без ключа отключаются
TG_ADMIN_ID	админ-команды (/stats, /missing, /moderate, /broadcast, /ai)
TG_MOD_CHAT_ID	чат модерации словарных пар
DONATION_LINK	ссылка в сообщении о поддержке
PAYMENT_PROVIDER_TOKEN	Telegram Payments для подписки на безлимитный спеллчек
DOSHAM_API_URL	переопределение API (для тестов)

Миграции применяются автоматически при старте. Деплой — Docker (Dockerfile в корне).