diff --git a/docs/CONFIG.md b/docs/CONFIG.md index 660e66f..d181886 100644 --- a/docs/CONFIG.md +++ b/docs/CONFIG.md @@ -32,6 +32,7 @@ redmine: period: precision: date default_from: "2026-06-01" + # default_to можно не указывать — тогда конец периода будет сегодня default_to: "2026-06-30" dynamic: false last_used: @@ -73,6 +74,23 @@ email: `last_used.from` / `last_used.to` записываются автоматически при `--commit`. Вручную редактировать не требуется. +### `period.default_to` — необязательное окончание периода + +Если `period.default_to` не задан, а `period.default_from` задан, инструмент +использует сегодняшнюю дату в качестве конца периода. + +```yaml +period: + default_from: "2026-07-01" + # default_to отсутствует → конец периода = сегодня +``` + +Это предотвращает устаревание периода, когда отчёт генерируется автоматически +(`--send`, `--commit`) без явного `--date`. + +Аналогично работает `DEFAULT_TO_DATE`: если переменная не задана, а +`DEFAULT_FROM_DATE` задана, конец периода = сегодня. + ### `--commit` — автофиксация периода Флаг `--commit` сохраняет использованный период в YAML-конфиг, чтобы следующий запуск автоматически начинался с нового периода. @@ -353,6 +371,10 @@ vim ~/.config/redmine-reporter/config.yml | `--init-config --force` | Перезаписать существующий YAML | | `--config-path PATH` | Сохранить YAML по указанному пути (по умолчанию `~/.config/redmine-reporter/config.yml`) | +Если `DEFAULT_TO_DATE` не задана, а `DEFAULT_FROM_DATE` задана, сгенерированный +YAML будет содержать пустое `default_to`, и при запуске инструмент использует +сегодняшнюю дату. + ### Проверка после миграции ```bash