Files
crm.clientright.ru/erv_ticket/DEBUG_MODE_README.md

152 lines
5.6 KiB
Markdown
Raw Permalink Normal View History

# 🔧 Режим отладки - Отключение SMS верификации
## 📌 Описание
Режим отладки позволяет работать с формой ERV Ticket **без отправки реальных SMS-сообщений**, экономя баланс на SMS во время разработки и тестирования.
---
## ✅ Что делает режим отладки?
Когда `DEBUG_MODE = true`:
1. **SMS не отправляется** - запрос к SigmaSMS API не выполняется
2. **Принимается любой 6-значный код** - вместо реального кода из SMS
3. **Визуальные индикаторы** - в интерфейсе появляются пометки 🔧 DEBUG
4. **Отладочные логи** - в консоли браузера выводится информация о процессе
---
## 🚀 Как использовать
### 1. Включить режим отладки (по умолчанию):
Откройте файл `debug-config.js`:
```javascript
var DEBUG_MODE = true; // ✅ Режим отладки включен
```
### 2. Тестирование формы с отладкой:
1. Откройте форму в браузере
2. Введите любой номер телефона
3. Нажмите "Отправить SMS"
4. Увидите сообщение: **"🔧 РЕЖИМ ОТЛАДКИ: Введите любой 6-значный код"**
5. Введите **ЛЮБЫЕ 6 цифр**, например: `123456`
6. Нажмите "Подтвердить"
7. ✅ Доступ к форме открыт!
### 3. Выключить режим отладки (для продакшена):
Откройте файл `debug-config.js`:
```javascript
var DEBUG_MODE = false; // ❌ Режим отладки выключен
```
Теперь форма работает в **нормальном режиме**:
- SMS отправляется реально через SigmaSMS API
- Требуется реальный код из SMS
---
## 🔍 Проверка текущего режима
Откройте консоль браузера (F12) и посмотрите на сообщения:
### В режиме отладки:
```
🔧 DEBUG CONFIG загружен. DEBUG_MODE = true
🔧 DEBUG MODE: SMS отключена. Код: 123456
🔧 DEBUG MODE: Код принят (любой 6-значный): 999999
```
### В нормальном режиме:
```
🔧 DEBUG CONFIG загружен. DEBUG_MODE = false
```
---
## 📂 Файлы, затронутые изменениями
1. **`debug-config.js`** ⭐ - Главный файл конфигурации (меняйте только его!)
2. **`js/common.js`** - Логика SMS-верификации (модифицирован)
3. **`index.php`** - Подключение debug-config.js
---
## ⚠️ Важные замечания
### ❗ Перед деплоем на продакшен:
1. **ОБЯЗАТЕЛЬНО** установите `DEBUG_MODE = false` в `debug-config.js`
2. Проверьте, что SMS отправляются реально
3. Протестируйте с реальным номером телефона
### 💡 Рекомендации:
- Используйте **DEBUG_MODE = true** только на DEV/TEST серверах
- Добавьте `debug-config.js` в `.gitignore`, если нужно разное поведение на разных средах
- Для автоматизации можно создать два конфига: `debug-config.dev.js` и `debug-config.prod.js`
---
## 🐛 Отладка проблем
### Проблема: "Неверный код" даже в режиме отладки
**Решение**:
- Убедитесь, что вводите ровно **6 цифр**
- Проверьте в консоли: `DEBUG_MODE = true`
- Убедитесь, что `debug-config.js` загружен **ДО** `common.js`
### Проблема: SMS все равно отправляются
**Решение**:
- Очистите кеш браузера (Ctrl+F5)
- Проверьте консоль: должно быть `DEBUG_MODE = true`
- Убедитесь, что `debug-config.js` подключен в `index.php`
---
## 📊 Экономия на SMS
При активной разработке (10-20 тестов в день):
- **Без режима отладки**: ~300-600 SMS в месяц = **1500-3000 руб.**
- **С режимом отладки**: 0 SMS = **0 руб.** 💰
---
## 🔐 Безопасность
⚠️ **ВНИМАНИЕ**: Режим отладки **НЕ БЕЗОПАСЕН** для продакшена!
- Любой может пройти SMS-верификацию с любым кодом
- Используйте **ТОЛЬКО** на закрытых DEV/TEST серверах
- Всегда выключайте перед публикацией
---
## 📝 История изменений
**23.10.2025** - Создан режим отладки:
- ✅ Добавлен `debug-config.js`
- ✅ Модифицирован `common.js`
- ✅ Обновлен `index.php`
- ✅ Создана документация
---
## 💬 Техническая поддержка
Если возникли вопросы - проверьте:
1. Консоль браузера (F12)
2. Файл `debug-config.js`
3. Порядок подключения скриптов в `index.php`
**Всё работает?** Отлично! 🎉 Можно спокойно разрабатывать без траты денег на SMS!