# Changelog

Краткое резюме по основным версиям (подробности — ниже на этой странице).

## 2.1.0 (2025‑10‑27)

- Добавлена генерация тестовых самоподписанных сертификатов (`--test-cert`, `make test-cert`, `test_certificate.sh`)
- Расширена документация (testing guide, cheatsheet, project structure)

## 2.0.0 (2025‑10‑27)

- Интеграция с Nginx Proxy Manager (API)
- Makefile, systemd timer/service, авто-режим

## 1.0.0 (2025‑10‑26)

- Первый релиз: LE+reg.ru DNS-01, bash/ps1 версии


---

## Appendix (migrated from docs/CHANGELOG.md)
<!-- MIGRATED_FROM_DOCS:CHANGELOG.md -->

## 📋 Журнал изменений (Changelog)

### [2.1.0] - 2025-10-27

#### 🆕 Добавлено

##### Генерация тестовых SSL сертификатов
- ✨ **Новый класс `TestCertificateGenerator`** - генерация самоподписанных сертификатов
- ✨ **Команда `--test-cert`** в Python скрипте для создания тестовых сертификатов
- ✨ **Скрипт `test_certificate.sh`** - автономное создание через OpenSSL
- ✨ **Команда `make test-cert`** в Makefile для быстрого тестирования

##### Документация
- 📘 **TESTING_GUIDE.md** (370+ строк) - полное руководство по тестированию
  - Обход лимитов Let's Encrypt (5 сертификатов в неделю)
  - Сравнение методов создания сертификатов
  - Примеры для CI/CD и Docker
  - Переход с тестовых на production
  - Частые вопросы и решения
  
- 📘 **PROJECT_STRUCTURE.md** - структура проекта
  - Описание всех файлов
  - Список возможностей
  - Технологии
  
- 📘 **CHEATSHEET.md** - быстрая шпаргалка
  - Основные команды
  - Сценарии использования
  - Частые ошибки и решения
  - Workflow разработки

##### Функциональность
- ✨ Поддержка **неограниченного количества** тестовых сертификатов
- ✨ **Мгновенное создание** (1-2 секунды) без DNS валидации
- ✨ **Автоматическая загрузка** тестовых сертификатов в NPM
- ✨ **Полная совместимость** структуры с Let's Encrypt
- ✨ **Wildcard поддержка** для тестовых сертификатов

#### 🔧 Улучшено

##### Python скрипт
- Добавлен импорт библиотеки `cryptography` с проверкой установки
- Новые параметры командной строки:
  - `--test-cert` - создание тестового сертификата
  - `--auto` - явное указание автоматического режима
- Улучшенная обработка тестовых сертификатов в NPM
- Детальное логирование процесса генерации

##### Makefile
- Добавлена команда `make test-cert` с красивым выводом
- Информационные сообщения о преимуществах тестовых сертификатов
- Предупреждения о безопасности

##### README.md
- Раздел "Создание тестового самоподписанного сертификата"
- Обновленное содержание с ссылкой на тестовые сертификаты
- Примеры использования тестовых сертификатов
- Интеграция с NPM для тестовых сертификатов
- Ссылки на дополнительную документацию

#### 🎯 Преимущества

##### Для разработчиков
- ✅ **Нет лимитов** - неограниченное количество сертификатов
- ✅ **Быстро** - создание за 1-2 секунды
- ✅ **Офлайн** - работает без интернета
- ✅ **Идентичная структура** - те же файлы что и Let's Encrypt

##### Для тестирования
- ✅ **CI/CD friendly** - быстрое создание в pipeline
- ✅ **Docker ready** - легко встраивается в контейнеры
- ✅ **Staging окружения** - идеально для тестовых серверов
- ✅ **Локальная разработка** - HTTPS на localhost

#### 📊 Статистика

- **Строк кода**: 1,411 (Python скрипт)
- **Строк в Makefile**: 415
- **Строк документации**: 2,200+
- **Команд в Makefile**: 13
- **Режимов работы**: 4 (obtain, renew, auto, test-cert)

---

### [2.0.0] - 2025-10-27

#### 🆕 Добавлено
- ✨ Интеграция с Nginx Proxy Manager (NPM)
- ✨ Класс `NginxProxyManagerAPI` для управления сертификатами через API
- ✨ Автоматическая загрузка сертификатов в NPM
- ✨ Автоматическое обновление сертификатов в NPM
- ✨ Автоматическая проверка срока действия
- ✨ Настраиваемый порог обновления (`renewal_days`)
- ✨ Makefile для автоматизации установки/удаления
- ✨ Systemd service + timer
- ✨ Cron автоматизация

#### 🔧 Улучшено
- Консолидация документации в единый README.md
- Подробное логирование с статусами операций
- Валидация конфигурации
- Улучшенная обработка ошибок

#### 📘 Документация
- Полное руководство по NPM интеграции
- Быстрый старт за 3 команды
- Примеры автоматизации

---

### [1.0.0] - 2025-10-26

#### 🆕 Первый релиз
- Python скрипт для Let's Encrypt через reg.ru API
- Bash скрипт с certbot-dns-regru
- PowerShell версия для Windows
- DNS-01 валидация
- Wildcard сертификаты
- Базовая документация

---

### Roadmap (Планы)

#### [2.2.0] - Планируется
- [ ] Веб-интерфейс для управления
- [ ] Поддержка множественных доменов
- [ ] Notifications (email, telegram)
- [ ] Grafana dashboard для мониторинга
- [ ] Backup сертификатов

#### [3.0.0] - Будущее
- [ ] Поддержка других DNS провайдеров
- [ ] Cloudflare API
- [ ] Route53 (AWS)
- [ ] Google Cloud DNS

---

### Типы изменений
- `🆕 Добавлено` - новый функционал
- `🔧 Улучшено` - улучшения существующего функционала
- `🐛 Исправлено` - исправление багов
- `🗑️ Удалено` - удаленный функционал
- `🔒 Безопасность` - изменения безопасности
- `📘 Документация` - изменения в документации

---

**Версионирование**: Semantic Versioning (MAJOR.MINOR.PATCH)
- **MAJOR**: Несовместимые изменения API
- **MINOR**: Новый функционал с обратной совместимостью
- **PATCH**: Исправления багов