119 lines
2.8 KiB
Markdown
119 lines
2.8 KiB
Markdown
# Быстрый старт - Python Moderation Backend
|
||
|
||
## 1. Установка
|
||
|
||
```bash
|
||
cd moderation/backend-py
|
||
|
||
# Создать виртуальное окружение
|
||
python3 -m venv venv
|
||
|
||
# Активировать
|
||
source venv/bin/activate # Linux/Mac
|
||
# или
|
||
venv\Scripts\activate # Windows
|
||
|
||
# Установить зависимости
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
## 2. Настройка .env
|
||
|
||
Отредактируйте корневой `.env` файл (`nakama/.env`):
|
||
|
||
```env
|
||
# Email (ОБЯЗАТЕЛЬНО!)
|
||
EMAIL_PROVIDER=yandex
|
||
YANDEX_SMTP_HOST=smtp.yandex.ru
|
||
YANDEX_SMTP_PORT=465
|
||
YANDEX_SMTP_SECURE=true
|
||
YANDEX_SMTP_USER=ваш_email@yandex.ru
|
||
YANDEX_SMTP_PASSWORD=ваш_пароль_приложения
|
||
EMAIL_FROM=noreply@nakama.guru
|
||
OWNER_EMAIL=admin@example.com
|
||
|
||
# Модерация
|
||
MODERATION_PORT=3001
|
||
MODERATION_BOT_TOKEN=ваш_токен
|
||
|
||
# MongoDB
|
||
MONGODB_URI=mongodb://103.80.87.247:27017/nakama
|
||
```
|
||
|
||
**Важно:** Для Yandex используйте пароль приложения!
|
||
1. Перейдите: https://id.yandex.ru/security
|
||
2. Создайте пароль приложения для "Почта"
|
||
3. Используйте его в `YANDEX_SMTP_PASSWORD`
|
||
|
||
## 3. Создайте админа в MongoDB
|
||
|
||
```javascript
|
||
// В mongosh
|
||
use nakama;
|
||
|
||
db.users.updateOne(
|
||
{ username: "ваш_username" },
|
||
{
|
||
$set: {
|
||
email: "ваш_email@yandex.ru",
|
||
emailVerified: true,
|
||
role: "admin"
|
||
}
|
||
}
|
||
);
|
||
```
|
||
|
||
## 4. Запуск
|
||
|
||
```bash
|
||
# Простой запуск
|
||
python main.py
|
||
|
||
# Или с auto-reload
|
||
uvicorn main:app --reload --host 0.0.0.0 --port 3001
|
||
|
||
# Или через скрипт
|
||
./start.sh
|
||
```
|
||
|
||
## 5. Проверка
|
||
|
||
```bash
|
||
# Health check
|
||
curl http://localhost:3001/health
|
||
|
||
# Config
|
||
curl http://localhost:3001/api/moderation-auth/config
|
||
```
|
||
|
||
## 6. Отправка кода
|
||
|
||
Откройте фронтенд модерации и введите email. Код должен прийти на почту.
|
||
|
||
## Troubleshooting
|
||
|
||
### Email не отправляется
|
||
|
||
Проверьте логи при запуске:
|
||
```
|
||
[Email] Настройка SMTP: {provider: 'yandex', host: 'smtp.yandex.ru', ...}
|
||
```
|
||
|
||
Если видите `user: 'не указан'` или `hasPassword: False` - проверьте `.env`.
|
||
|
||
### 403 Forbidden при send-code
|
||
|
||
Убедитесь, что в базе есть пользователь с:
|
||
- email = тот, что вводите
|
||
- role = 'admin' или 'moderator'
|
||
|
||
### Telegram виджет не работает
|
||
|
||
После успешной авторизации должно быть автоматическое перенаправление.
|
||
Проверьте логи: `[ModerationAuth] Успешная авторизация через виджет`
|
||
|
||
## Production
|
||
|
||
См. `MIGRATION.md` для полных инструкций по развертыванию.
|
||
|