Игорь Надеин 9491811425 docs: Add comprehensive documentation

Documentation Structure:
- MULTI_USER_AUTH.md (250 lines): Multi-user authentication guide
  - Architecture overview
  - Encryption mechanism (Fernet/AES-128)
  - User flow diagrams
  - API reference
  - Security considerations

- MIGRATION_GUIDE.md (120 lines): Migration instructions
  - Single-user to multi-user migration
  - Step-by-step guide
  - Data backup procedures
  - Rollback instructions

- DOCKER_QUICKSTART.md (100 lines): Quick Docker start
  - Prerequisites
  - 5-minute setup guide
  - Common commands
  - Troubleshooting

- DOCKER_GUIDE.md (400 lines): Complete Docker guide
  - Architecture details
  - Development workflow
  - Volume management
  - Network configuration
  - Resource limits
  - Logging and debugging

- PRODUCTION_DEPLOYMENT.md (500 lines): Production operations
  - 7-service architecture diagram
  - Deployment procedures
  - Monitoring setup (Prometheus, Grafana)
  - Management commands
  - Backup/restore
  - Security checklist
  - Scaling strategies
  - Troubleshooting guide

- CHANGELOG.md: Version history and release notes

2025-11-03 14:21:39 +03:00

3.0 KiB

Raw Blame History

🐳 Docker Quick Start

Запуск за 3 шага

1️⃣ Создайте .env файл

Windows:

copy .env.example .env
notepad .env

Linux/Mac:

cp .env.example .env
nano .env

Укажите в .env:

TELEGRAM_BOT_TOKEN=your_bot_token_from_botfather

2️⃣ Запустите

Windows:

start.bat

Linux/Mac:

chmod +x start.sh
./start.sh

Или через docker-compose:

docker-compose up -d

3️⃣ Готово! 🎉

Бот запущен и работает в фоне.

Управление

Просмотр логов

docker-compose logs -f

(Ctrl+C для выхода)

Остановка

docker-compose down

Перезапуск

docker-compose restart

Статус

docker-compose ps

Makefile (для удобства)

Если установлен make:

make help     # Показать все команды
make up       # Запустить
make down     # Остановить
make logs     # Логи
make restart  # Перезапуск
make shell    # Войти в контейнер
make backup   # Создать backup данных

Где хранятся данные?

./data/             → Пользовательские данные
  ├── users.json          (учетные данные, зашифрованные)
  └── .encryption_key     (ключ шифрования)

./logs/             → Логи бота

./temp_documents/   → Временные файлы (Excel/XML)

⚠️ ВАЖНО: Сделайте backup ./data/.encryption_key!

Обновление бота

# Остановка
docker-compose down

# Обновление кода
git pull

# Пересборка и запуск
docker-compose build
docker-compose up -d

Или через Makefile:

make update

Troubleshooting

"docker-compose: command not found"

Установите Docker и Docker Compose:

Бот не запускается

# Проверьте логи
docker-compose logs

# Проверьте .env файл
cat .env  # Linux/Mac
type .env  # Windows

Недостаточно прав (Linux)

# Добавьте пользователя в группу docker
sudo usermod -aG docker $USER

# Выйдите и войдите заново

Полная документация

📖 docs/DOCKER_GUIDE.md - Подробное руководство

Нужна помощь?

Проверьте docs/DOCKER_GUIDE.md
Посмотрите логи: docker-compose logs -f
Проверьте статус: docker-compose ps

3.0 KiB Raw Blame History Unescape Escape