# SalvageDB Bot - Telegram бот для проверки VIN номеров

Telegram бот для проверки и декодирования VIN номеров автомобилей с интеграцией Oracle database.

## Основные возможности

- 🔍 **Проверка VIN номеров** - валидация и декодирование
- 📊 **Статистика использования** - трекинг пользователей и запросов  
- 🚗 **Поиск фотографий** - интеграция с внешними сервисами
- 👨‍💼 **Админ панель** - управление и мониторинг
- 🔐 **Авторизация** - система ролей и доступов

## Быстрый старт

### Разработка
```bash
uv run -m watchfiles --filter python 'uv run main.py'
```

Бот будет автоматически перезапускаться при изменении исходных файлов.

### Продакшн (Docker)
```bash
docker-compose up -d
```

## Структура документации

- **[[Gitea-Actions]]** - настройка CI/CD автоматизации
- **[[Harbor-Registry]]** - конфигурация Docker registry
- **[[Docker-Setup]]** - развертывание с помощью Docker
- **[[User-Tracking]]** - система отслеживания пользователей
- **[[Development]]** - руководство для разработчиков

## Технологии

- **Python 3.12+** - основной язык разработки
- **aiogram 3.x** - Telegram Bot API
- **Oracle Database** - хранение данных
- **Docker** - контейнеризация
- **Gitea Actions** - CI/CD pipeline