feat(xlsx): make Excel export production-grade

- Add merge cells for project/version groups. - Add numeric Hours column and human-readable Spent Time. - Add version/project/grand totals. - Apply auto-width, freeze panes, auto-filter and styling. - Respect --no-time: keep columns empty, skip totals. - Pass no_time flag through formatter factory to all file formatters. - Add tests for XLSX features and --no-time behavior. Closes #38
chore(release): bump version to 1.6.0
2026-06-29 14:41:37 +07:00 · 2026-06-29 12:38:54 +07:00 · 2026-06-29 12:21:44 +07:00 · 2026-06-29 12:09:58 +07:00 · 2026-06-29 12:02:51 +07:00 · 2026-06-29 11:53:09 +07:00
26 changed files with 2231 additions and 398 deletions
--- a/.gitignore
+++ b/.gitignore
@@ -88,7 +88,7 @@ secrets.json

 # Just in case
 .~*
-report.odt
-report.csv
-report.md
+# Local report outputs
+report.*
+rep.*
 *.html
--- a/README.md
+++ b/README.md
@@ -1,60 +1,56 @@
 # redmine-reporter

-Инструмент для генерации отчётов по задачам в Redmine на основе ваших записей о затраченном времени.
+CLI-инструмент для генерации отчётов по задачам Redmine на основе записей о затраченном времени.

-> Предназначен для внутреннего использования в Eltex. Работает с `https://red.eltex.loc/`.
+Проект предназначен для внутреннего использования с `https://red.eltex.loc/`.

-📄 **Лицензия**: [MIT](./LICENSE) — делайте что угодно.
+Лицензия: MIT.

---
+## Возможности

-## 🔧 Возможности
+- Получение time entries текущего пользователя из Redmine.
+- Авторизация через Redmine API token.
+- Резервная авторизация через логин и пароль для обратной совместимости.
+- Группировка задач по проекту и версии.
+- Перевод статусов задач на русский язык.
+- Вывод в консоль в табличном или компактном виде.
+- Экспорт в ODT, CSV, Markdown, HTML, JSON и Excel (.xlsx).
+- Сводка по затраченному времени (итоги и разбивка по проектам/версиям).
+- Автоматическое определение месяца ODT-отчёта по конечной дате периода.
+- Настройка периода отчёта по умолчанию через `.env` (или автоматически — текущий месяц).
+- Переопределение URL и API-ключа через CLI.
+- Загрузка альтернативного `.env` через `--config`.
+- Загрузка альтернативного `.env` через `--config`.

- Безопасная передача учётных данных через переменные окружения или `.env`
- Два режима вывода: компактный (для копирования) и табличный (для просмотра)
- Группировка задач по проекту и версии
- Перевод статусов на русский язык
- Простой CLI с понятными аргументами
- Поддержка настройки диапазона дат по умолчанию через `.env`
- Экспорт в ODT, CSV и Markdown
-
---
-
-## 🚀 Установка и настройка (продакшен)
-
-### 1. Клонируйте репозиторий
+## Установка

 ```bash
 git clone https://git.akokos.ru/artem.kokos/redmine-reporter.git
 cd redmine-reporter
-```
-
-### 2. Создайте изолированное окружение и установите зависимости
-
-```bash
 python3 -m venv .venv
 source .venv/bin/activate
 pip install --upgrade pip
 pip install .
 ```

-> 💡 Установка в виртуальное окружение — стандарт для Python-инструментов. Это безопасно и не влияет на систему.
+## Настройка

-### 3. Настройте доверие к корпоративному сертификату (обязательно!)
+Создайте файл `.env` в корне проекта. Файл не должен попадать в git.

-По умолчанию Python использует собственный набор сертификатов (`certifi`), который **не включает** внутренние CA Eltex.  
-Чтобы избежать ошибки `CERTIFICATE_VERIFY_FAILED`, выполните **один раз**:
+Рекомендуемый вариант авторизации:

-```bash
-cat /etc/ssl/certs/ca-certificates.crt >> $(python -m certifi)
+```ini
+REDMINE_URL=https://red.eltex.loc/
+REDMINE_API_KEY=ваш_api_token
+REDMINE_AUTHOR=Иванов Иван Иванович
+
+DEFAULT_FROM_DATE=2026-01-01
+DEFAULT_TO_DATE=2026-01-31
 ```

-> ✅ Это безопасно: вы просто добавляете доверенные системные сертификаты к Python.  
-> ❌ Не используйте `verify=False` — это создаёт уязвимость.
+Если задан `REDMINE_API_KEY`, он используется в первую очередь. Значения из `.env` можно переопределить через CLI: `--url`, `--api-key`, `--author`, а также загрузить другой файл конфигурации через `--config`.

-### 4. Настройте учётные данные и (опционально) даты
-
-Создайте файл `.env` в корне проекта (**никогда не коммитьте его!**):
+Резервный вариант авторизации:

 ```ini
 REDMINE_URL=https://red.eltex.loc/
@@ -62,99 +58,152 @@ REDMINE_USER=ваш.логин
 REDMINE_PASSWORD=ваш_пароль
 REDMINE_AUTHOR=Иванов Иван Иванович

-# Опционально: диапазон дат по умолчанию
 DEFAULT_FROM_DATE=2026-01-01
 DEFAULT_TO_DATE=2026-01-31
 ```

-Альтернатива — задать переменные вручную:
+Переменные окружения:

-```bash
-export REDMINE_URL=https://red.eltex.loc/
-export REDMINE_USER=ваш.логин
-export REDMINE_PASSWORD=...
-export REDMINE_AUTHOR="Иванов Иван Иванович"
-export DEFAULT_FROM_DATE=2026-01-01
-export DEFAULT_TO_DATE=2026-01-31
-```
+| Переменная | Обязательность | Описание |
+| --- | --- | --- |
+| `REDMINE_URL` | Да | URL Redmine. |
+| `REDMINE_API_KEY` | Да, если нет логина и пароля | Redmine API token. |
+| `REDMINE_USER` | Да, если нет токена | Логин Redmine. |
+| `REDMINE_PASSWORD` | Да, если нет токена | Пароль Redmine. |
+| `REDMINE_AUTHOR` | Нет | Имя автора для ODT-отчёта. |
+| `DEFAULT_FROM_DATE` | Нет | Начальная дата периода по умолчанию в формате `YYYY-MM-DD`. |
+| `DEFAULT_TO_DATE` | Нет | Конечная дата периода по умолчанию в формате `YYYY-MM-DD`. |
+| `REDMINE_VERIFY` | Нет | Настройка TLS-проверки для Redmine API. |

-> 🔐 Рекомендуется использовать аккаунт с минимальными правами (только чтение time entries и задач).
-> 💡 Если `DEFAULT_FROM_DATE` и `DEFAULT_TO_DATE` не заданы, используется встроенный диапазон: `2025-12-19--2026-01-31`.
+`REDMINE_VERIFY` поддерживает значения:

---
+- пустое значение или отсутствие переменной: `/etc/ssl/certs/ca-certificates.crt`;
+- `true`, `1`, `yes`, `on`: стандартная проверка сертификатов `requests`;
+- `false`, `0`, `no`, `off`: отключить проверку сертификатов;
+- любой другой текст: путь к CA bundle.

-## ▶️ Использование
+Отключать проверку сертификатов не рекомендуется.

-Перед каждым запуском активируйте окружение:
+## Использование

 ```bash
 source .venv/bin/activate
 ```

-Затем:
+Отчёт за период по умолчанию (текущий месяц или из `.env`):

 ```bash
-# Отчёт за период по умолчанию (из .env или встроенный)
 redmine-reporter
+```

-# Отчёт за произвольный период (переопределяет .env)
+Отчёт за произвольный период:
+
+```bash
 redmine-reporter --date 2026-02-01--2026-02-28
+```

-# Компактный вывод (удобно копировать в письмо)
+Период должен быть задан в формате `YYYY-MM-DD--YYYY-MM-DD`. Начальная дата не может быть позже конечной.
+
+Переопределение URL и API-ключа из `.env`:
+
+```bash
+redmine-reporter --url https://red.example.com --api-key ваш_токен
+```
+
+Использование альтернативного конфигурационного файла:
+
+```bash
+redmine-reporter --config /path/to/.env
+```
+
+Компактный вывод:
+
+```bash
 redmine-reporter --compact
-
-# Экспорт в ODT с указанием автора (если не задано в .env)
-redmine-reporter --output report.odt --author "Иванов Иван Иванович"
 ```

-> 💡 **Автоматика в ODT-отчёте**:
-> - Месяц в заголовке определяется **автоматически** по дате окончания периода (`to_date`).
->   Например: `2025-12-20--2026-01-15` → **«Январь»**.
-> - Имя автора берётся из переменной окружения `REDMINE_AUTHOR` (в `.env`) или CLI-аргумента `--author`.
-> - Первая пустая строка из шаблона `template.odt` **автоматически удаляется**.
+Подробный или отладочный вывод:

-Пример содержимого `.env` с автором:
-
-```ini
-REDMINE_URL=https://red.eltex.loc/
-REDMINE_USER=ваш.логин
-REDMINE_PASSWORD=ваш_пароль
-REDMINE_AUTHOR=Иванов Иван Иванович
-DEFAULT_FROM_DATE=2026-01-01
-DEFAULT_TO_DATE=2026-01-31
+```bash
+redmine-reporter --verbose
+redmine-reporter --debug
 ```

-Пример вывода в ODT (заголовок):
-> **Иванов Иван Иванович. Отчёт за месяц Январь.**
+Вывод версии:

-Пример консольного вывода:
-```
-✅ Total issues: 7 [2026-01-01--2026-01-31]
-╒════════════╤═══════════╤══════════════════════════════════════╤═══════════╤════════════╕
-│ Проект     │ Версия    │ Задача                               │ Статус    │ Затрачено  │
-╞════════════╪═══════════╪══════════════════════════════════════╪═══════════╪════════════╡
-│ Камеры     │ v2.5.0    │ 12345. Поддержка нового датчика      │ В работе  │ 2.00h      │
-│            │           │ 12346. Исправить утечку памяти       │ Решена    │ 2.00h      │
-│ ПО         │ <N/A>     │ 12350. Обновить документацию         │ Ожидание  │ 12.00h     │
-╘════════════╧═══════════╧══════════════════════════════════════╧═══════════╧════════════╛
+```bash
+redmine-reporter --version
 ```

---
+Экспорт:

-## 🛠 Разработка
+```bash
+redmine-reporter --output report.odt
+redmine-reporter --output report.csv
+redmine-reporter --output report.md
+redmine-reporter --output report.html
+redmine-reporter --output report.json
+redmine-reporter --output report.xlsx
+```

-Для участия в разработке:
+JSON-отчёт:
+
+- массив объектов с полями `project`, `version`, `issue_id`, `subject`, `status`, `time`;
+- UTF-8, читаемый машиной.
+
+Excel-отчёт (.xlsx):
+
+- одна таблица с заголовками и строками данных;
+- шапка выделена жирным;
+- каждая строка содержит полные значения проекта и версии.
+
+CSV-отчёт:
+
+- файл сохраняется в UTF-8 с BOM (`utf-8-sig`) для корректного отображения кириллицы в Microsoft Excel;
+- каждая строка содержит полные значения проекта и версии (в отличие от консольного и Markdown-вывода, где повторяющиеся значения скрыты для компактности).
+
+HTML-отчёт:
+
+- полноценный HTML-документ с `<meta charset="utf-8">`;
+- корректно отображается в браузере и почтовых клиентах.
+
+ODT-отчёт:
+
+- месяц в заголовке определяется по `to_date`;
+- имя автора берётся из `--author`, затем из `REDMINE_AUTHOR`;
+- если автор не задан, поле автора остаётся пустым.
+
+Вывод без затраченного времени:
+
+```bash
+redmine-reporter --no-time
+```
+
+Сводка по времени (итоги и разбивка по проектам):
+
+```bash
+redmine-reporter --summary
+```
+
+## Разработка
+
+Установка зависимостей для разработки:

 ```bash
 pip install -e ".[dev]"
-pytest
-black .
-isort .
 ```

---
+Проверки:

-> 🔒 **Важно**:  
-> - Никогда не коммитьте `.env`, пароли или логины.
-> - Файл `.gitignore` уже исключает все чувствительные артефакты.  
-> - Инструмент работает только в режиме **чтения** — он не может изменять данные в Redmine.
+```bash
+pytest
+ruff check redmine_reporter tests
+black redmine_reporter tests
+isort redmine_reporter tests
+```
+
+## Безопасность
+
+- Не коммитьте `.env`, API token, пароль или логин.
+- Используйте аккаунт с минимальными правами, достаточными для чтения time entries и задач.
+- Инструмент работает только в режиме чтения и не изменяет данные в Redmine.
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"

 [project]
 name = "redmine-reporter"
-version = "1.4.0"
+version = "1.6.0"
 description = "Redmine time-entry based issue reporter for internal use"
 readme = "README.md"
 authors = [{ name = "Artem Kokos", email = "artem-kokos@mail.ru" }]
@@ -23,6 +23,7 @@ dependencies = [
    "tabulate>=0.9.0",
    "python-dotenv>=1.0.0",
    "odfpy>=1.4.0",
+    "openpyxl>=3.1.0",
 ]

 [project.optional-dependencies]
@@ -51,3 +52,10 @@ target-version = ['py39']
 [tool.isort]
 profile = "black"
 multi_line_output = 3
+
+[tool.mypy]
+warn_unused_configs = true
+
+[[tool.mypy.overrides]]
+module = ["odf.*", "redminelib.*", "tabulate", "openpyxl.*"]
+ignore_missing_imports = true
--- a/redmine_reporter/init.py
+++ b/redmine_reporter/init.py
@@ -1 +1 @@
-__version__ = "1.4.0"
+__version__ = "1.6.1"
--- a/redmine_reporter/cli.py
+++ b/redmine_reporter/cli.py
@@ -1,56 +1,97 @@
-import os
-import sys
 import argparse
+import logging
+import os
+import re
+import sys
+from datetime import datetime
 from typing import List, Optional
-from redminelib.resources import Issue

-from .config import Config
+from . import __version__
 from .client import fetch_issues_with_spent_time
-from .report_builder import build_grouped_report
-from .formatters.factory import get_formatter_by_extension, get_console_formatter
+from .config import Config
+from .formatters.factory import get_console_formatter, get_formatter_by_extension
+from .report_builder import build_grouped_report, calculate_summary


 def parse_date_range(date_arg: str) -> tuple[str, str]:
    if "--" not in date_arg:
        raise ValueError("Date range must be in format YYYY-MM-DD--YYYY-MM-DD")
    parts = date_arg.split("--", 1)
-    if len(parts) != 2:
-        raise ValueError("Invalid date range format")
-    return parts[0].strip(), parts[1].strip()
+
+    from_date, to_date = parts[0].strip(), parts[1].strip()
+    date_pattern = r"\d{4}-\d{2}-\d{2}"
+    if not re.fullmatch(date_pattern, from_date) or not re.fullmatch(date_pattern, to_date):
+        raise ValueError("Date range must be in format YYYY-MM-DD--YYYY-MM-DD")
+
+    try:
+        start = datetime.strptime(from_date, "%Y-%m-%d").date()
+        end = datetime.strptime(to_date, "%Y-%m-%d").date()
+    except ValueError as e:
+        raise ValueError("Date range contains invalid calendar date") from e
+
+    if start > end:
+        raise ValueError("Date range start must be less than or equal to end")
+
+    return start.isoformat(), end.isoformat()


 def main(argv: Optional[List[str]] = None) -> int:
    parser = argparse.ArgumentParser(
        prog="redmine-reporter",
-        description="Generate Redmine issue report based on your time entries."
+        description="Generate Redmine issue report based on your time entries.",
    )
    parser.add_argument(
        "--date",
        default=Config.get_default_date_range(),
-        # help="Date range in format YYYY-MM-DD--YYYY-MM-DD (default: %(default)s)"
-        help="Date range in format YYYY-MM-DD--YYYY-MM-DD (default from .env or %(default)s)"
+        help="Date range in format YYYY-MM-DD--YYYY-MM-DD (default: current month or from .env)",
    )
    parser.add_argument(
        "--compact",
        action="store_true",
-        help="Use compact plain-text output instead of table"
+        help="Use compact plain-text output instead of table",
    )
    parser.add_argument(
        "--output",
-        help="Path to output .odt file (e.g., report.odt). If omitted, prints to stdout."
+        help="Path to output file (.odt, .csv, .md, .html, .json, .xlsx). If omitted, prints to stdout.",
    )
    parser.add_argument(
-        "--author",
-        default="",
-        help="Override author name from .env (REDMINE_AUTHOR)"
+        "--author", default="", help="Override author name from .env (REDMINE_AUTHOR)"
    )
    parser.add_argument(
-        "--no-time",
+        "--no-time", action="store_true", help="Do not include spent time into table"
+    )
+    parser.add_argument("--url", help="Override Redmine URL from .env (REDMINE_URL)")
+    parser.add_argument("--api-key", help="Override Redmine API key from .env (REDMINE_API_KEY)")
+    parser.add_argument("--config", help="Path to .env config file")
+    parser.add_argument("--verbose", action="store_true", help="Enable verbose output")
+    parser.add_argument("--debug", action="store_true", help="Enable debug output")
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+        help="Show version and exit",
+    )
+    parser.add_argument(
+        "--summary",
        action="store_true",
-        help="Do not include spent time into table"
+        help="Print summary (total hours by project/version) to stderr",
    )
    args = parser.parse_args(argv)

+    # CLI-переопределения имеют приоритет над .env/env.
+    if args.config:
+        Config.load_config(args.config)
+    Config.set_redmine_url(args.url)
+    Config.set_redmine_api_key(args.api_key)
+
+    # Настройка уровня логирования
+    if args.debug:
+        logging.basicConfig(level=logging.DEBUG, format="%(levelname)s: %(message)s")
+    elif args.verbose:
+        logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s")
+    else:
+        logging.basicConfig(level=logging.WARNING, format="%(levelname)s: %(message)s")
+
    try:
        Config.validate()
    except ValueError as e:
@@ -73,34 +114,60 @@ def main(argv: Optional[List[str]] = None) -> int:
        print("ℹ️  No time entries found in the given period.", file=sys.stderr)
        return 0

-    print(f"✅ Total issues: {len(issue_hours)} [{args.date}]")
+    if not issue_hours:
+        print("ℹ️  No time entries found in the given period.", file=sys.stderr)
+        return 0
+
+    print(f"✅ Total issues: {len(issue_hours)} [{args.date}]", file=sys.stderr)

    rows = build_grouped_report(issue_hours, fill_time=not args.no_time)

+    if args.summary:
+        summary = calculate_summary(rows)
+        print(f"⏱️  Total time: {summary['total']}h", file=sys.stderr)
+        for key, value in summary.items():
+            if key.startswith("project:"):
+                project = key.split(":", 1)[1]
+                print(f"   {project}: {value}h", file=sys.stderr)
+
    if args.output:
        output_ext = os.path.splitext(args.output)[1].lower()

-        formatter = get_formatter_by_extension(output_ext,
+        if not output_ext:
+            print(
+                "❌ Файл без расширения. Укажите расширение: .odt, .csv, .md, .html, .json или .xlsx",
+                file=sys.stderr,
+            )
+            return 1
+
+        formatter = get_formatter_by_extension(
+            output_ext,
            author=Config.get_author(args.author),
            from_date=from_date,
-            to_date=to_date
+            to_date=to_date,
+            no_time=args.no_time,
        )

        if not formatter:
-            print(f"❌ Неизвестный формат файла: {output_ext}", file=sys.stderr)
+            if output_ext == ".odt":
+                print(
+                    "❌ odfpy is not installed. Install with: pip install odfpy",
+                    file=sys.stderr,
+                )
+            else:
+                known_exts = ", ".join([".odt", ".csv", ".md", ".html", ".json", ".xlsx"])
+                print(
+                    f"❌ Неизвестный формат файла: {output_ext!r}. "
+                    f"Поддерживаются: {known_exts}",
+                    file=sys.stderr,
+                )
            return 1

        try:
            formatter.save(rows, args.output)
            print(f"✅ Report saved to {args.output}")
-        except ImportError as e:
-            if output_ext == ".odt":
-                print("❌ odfpy is not installed. Install with: pip install odfpy", file=sys.stderr)
-            else:
-                print(f"❌ Import error: {e}", file=sys.stderr)
-            return 1
        except Exception as e:
-            fmt = "ODT" if output_ext == ".odt" else ("CSV" if output_ext == ".csv" else "Markdown")
+            fmt = output_ext.lstrip(".").upper()
            print(f"❌ {fmt} export error: {e}", file=sys.stderr)
            return 1

--- a/redmine_reporter/client.py
+++ b/redmine_reporter/client.py
@@ -1,36 +1,93 @@
-from typing import List, Optional, Dict, Tuple
+from typing import Any, Dict, List, Optional, Tuple
+
+import requests
 from redminelib import Redmine
 from redminelib.resources import Issue
+from urllib3.util.retry import Retry
+
 from .config import Config
-from .utils import get_version
+
+# Таймаут на один HTTP-запрос к Redmine (секунды).
+REQUEST_TIMEOUT = 30
+
+# Размер чанка для запроса задач по issue_id, чтобы не превышать лимит длины URL (#21).
+ISSUE_ID_CHUNK_SIZE = 100


-def fetch_issues_with_spent_time(from_date: str, to_date: str) -> Optional[List[Tuple[Issue, float]]]:
+def _get_redmine_auth_kwargs() -> Dict[str, Any]:
+    """Return Redmine auth kwargs. API key has priority over legacy password auth."""
+    api_key = Config.get_redmine_api_key()
+    if api_key:
+        return {"key": api_key}
+    return {
+        "username": Config.get_redmine_user(),
+        "password": Config.get_redmine_password(),
+    }
+
+
+def _make_retry_adapter() -> requests.adapters.HTTPAdapter:
+    """Создаёт HTTPAdapter с retry для временных ошибок (#24)."""
+    retry = Retry(
+        total=3,
+        backoff_factor=0.5,
+        status_forcelist=[429, 500, 502, 503, 504],
+        allowed_methods=["GET", "HEAD", "OPTIONS"],
+    )
+    return requests.adapters.HTTPAdapter(max_retries=retry)
+
+
+def _create_redmine() -> Redmine:
+    """Создаёт Redmine-клиент с таймаутом и retry-адаптером (#24)."""
+    redmine = Redmine(
+        Config.get_redmine_url(),
+        **_get_redmine_auth_kwargs(),
+        requests={
+            "verify": Config.get_redmine_verify(),
+            "timeout": REQUEST_TIMEOUT,
+        },
+    )
+
+    # Монтируем retry-адаптер на сессию для автоматических повторов.
+    # В python-redmine сессия живёт в engine, а redmine.session — контекстный менеджер.
+    retry_adapter = _make_retry_adapter()
+    redmine.engine.session.mount("https://", retry_adapter)
+    redmine.engine.session.mount("http://", retry_adapter)
+
+    return redmine
+
+
+def _fetch_issues_chunked(redmine: Redmine, issue_ids: List[int]) -> List[Issue]:
+    """Загружает задачи чанками, чтобы не превышать лимит длины URL (#21)."""
+    all_issues: List[Issue] = []
+    for i in range(0, len(issue_ids), ISSUE_ID_CHUNK_SIZE):
+        chunk = issue_ids[i : i + ISSUE_ID_CHUNK_SIZE]
+        issue_list_str = ",".join(str(x) for x in chunk)
+        issues = redmine.issue.filter(issue_id=issue_list_str, status_id="*", sort="project:asc")
+        all_issues.extend(issues)
+    return all_issues
+
+
+def fetch_issues_with_spent_time(
+    from_date: str, to_date: str
+) -> Optional[List[Tuple[Issue, float]]]:
    """
    Fetch unique issues linked to time entries of the current user in given date range,
    along with total spent hours per issue.
    Returns list of (issue, total_hours) tuples.
    """

-    redmine = Redmine(
-        Config.REDMINE_URL,
-        username=Config.REDMINE_USER,
-        password=Config.REDMINE_PASSWORD,
-        requests={'verify': '/etc/ssl/certs/ca-certificates.crt'}
-    )
+    redmine = _create_redmine()

-    current_user = redmine.user.get('current')
+    current_user = redmine.user.get("current")
    time_entries = redmine.time_entry.filter(
-        user_id=current_user.id,
-        from_date=from_date,
-        to_date=to_date
+        user_id=current_user.id, from_date=from_date, to_date=to_date
    )

    # Агрегируем часы по issue.id
    spent_time: Dict[int, float] = {}
    issue_ids = set()
    for entry in time_entries:
-        if hasattr(entry, 'issue') and entry.issue and hasattr(entry, 'hours'):
+        if hasattr(entry, "issue") and entry.issue and hasattr(entry, "hours"):
            iid = entry.issue.id
            issue_ids.add(iid)
            spent_time[iid] = spent_time.get(iid, 0.0) + float(entry.hours)
@@ -38,21 +95,16 @@ def fetch_issues_with_spent_time(from_date: str, to_date: str) -> Optional[List[
    if not issue_ids:
        return None

-    # Загружаем полные объекты задач
-    issue_list_str = ','.join(str(i) for i in issue_ids)
-    issues = redmine.issue.filter(
-        issue_id=issue_list_str,
-        status_id='*',
-        sort='project:asc'
-    )
+    # Загружаем полные объекты задач чанками (#21)
+    sorted_ids = sorted(issue_ids)
+    issues = _fetch_issues_chunked(redmine, sorted_ids)

-    # Сопоставляем задачи с суммарным временем
+    # Сопоставляем задачи с суммарным временем.
+    # Сортировка выполняется в report_builder.build_grouped_report,
+    # здесь оставляем порядок API как есть.
    result = []
    for issue in issues:
        total_hours = spent_time.get(issue.id, 0.0)
        result.append((issue, total_hours))

-    # Сортируем по (проект, версия)
-    result.sort(key=lambda x: (str(x[0].project), get_version(x[0])))
-
    return result
--- a/redmine_reporter/config.py
+++ b/redmine_reporter/config.py
@@ -1,39 +1,98 @@
 import os
+from datetime import date, timedelta
+from typing import Union
+
 from dotenv import load_dotenv

+load_dotenv(override=False)

-load_dotenv()
+DEFAULT_REDMINE_VERIFY = "/etc/ssl/certs/ca-certificates.crt"
+FALSE_VALUES = {"0", "false", "no", "off"}
+TRUE_VALUES = {"1", "true", "yes", "on"}


 class Config:
-    REDMINE_URL = os.getenv("REDMINE_URL", "").strip().rstrip("/")
-    REDMINE_USER = os.getenv("REDMINE_USER")
-    REDMINE_PASSWORD = os.getenv("REDMINE_PASSWORD")
-    REDMINE_AUTHOR = os.getenv("REDMINE_AUTHOR")
-    DEFAULT_FROM_DATE = os.getenv("DEFAULT_FROM_DATE")
-    DEFAULT_TO_DATE = os.getenv("DEFAULT_TO_DATE")
+    _cli_url: str | None = None
+    _cli_api_key: str | None = None
+
+    @classmethod
+    def load_config(cls, path: str) -> None:
+        """Загружает переменные из указанного .env-файла с override."""
+        load_dotenv(path, override=True)
+
+    @classmethod
+    def set_redmine_url(cls, url: str) -> None:
+        cls._cli_url = url.strip().rstrip("/") if url else None
+
+    @classmethod
+    def set_redmine_api_key(cls, key: str) -> None:
+        cls._cli_api_key = key.strip() if key else None
+
+    @classmethod
+    def get_redmine_url(cls) -> str:
+        if cls._cli_url is not None:
+            return cls._cli_url
+        return os.getenv("REDMINE_URL", "").strip().rstrip("/")
+
+    @classmethod
+    def get_redmine_api_key(cls) -> str:
+        if cls._cli_api_key is not None:
+            return cls._cli_api_key
+        return os.getenv("REDMINE_API_KEY", "").strip()
+
+    @classmethod
+    def get_redmine_user(cls) -> str:
+        return os.getenv("REDMINE_USER", "").strip()
+
+    @classmethod
+    def get_redmine_password(cls) -> str:
+        return os.getenv("REDMINE_PASSWORD", "").strip()
+
+    @classmethod
+    def get_redmine_verify(cls) -> Union[bool, str]:
+        value = os.getenv("REDMINE_VERIFY", "").strip()
+        if not value:
+            return DEFAULT_REDMINE_VERIFY
+
+        normalized = value.lower()
+        if normalized in FALSE_VALUES:
+            return False
+        if normalized in TRUE_VALUES:
+            return True
+        return value

    @classmethod
    def get_author(cls, cli_author: str = "") -> str:
        """Возвращает автора: из CLI если задан, иначе из .env, иначе — заглушку."""
        if cli_author:
            return cli_author
-        if cls.REDMINE_AUTHOR:
-            return cls.REDMINE_AUTHOR
-        return ""
+        return os.getenv("REDMINE_AUTHOR", "").strip()

    @classmethod
    def get_default_date_range(cls) -> str:
-        if cls.DEFAULT_FROM_DATE and cls.DEFAULT_TO_DATE:
-            return f"{cls.DEFAULT_FROM_DATE}--{cls.DEFAULT_TO_DATE}"
-        # fallback hardcoded
-        return "2025-12-19--2026-01-31"
+        default_from_date = os.getenv("DEFAULT_FROM_DATE", "").strip()
+        default_to_date = os.getenv("DEFAULT_TO_DATE", "").strip()
+        if default_from_date and default_to_date:
+            return f"{default_from_date}--{default_to_date}"
+
+        # fallback: текущий месяц
+        today = date.today()
+        start = today.replace(day=1)
+        # последний день месяца: берём первое число следующего месяца и вычитаем день
+        if today.month == 12:
+            next_month = today.replace(year=today.year + 1, month=1, day=1)
+        else:
+            next_month = today.replace(month=today.month + 1, day=1)
+        end = next_month - timedelta(days=1)
+        return f"{start.isoformat()}--{end.isoformat()}"

    @classmethod
    def validate(cls) -> None:
-        if not cls.REDMINE_URL:
+        if not cls.get_redmine_url():
            raise ValueError("REDMINE_URL is required (set via env or .env)")
-        if not cls.REDMINE_USER:
-            raise ValueError("REDMINE_USER is required")
-        if not cls.REDMINE_PASSWORD:
-            raise ValueError("REDMINE_PASSWORD is required")
+        if cls.get_redmine_api_key():
+            return
+        if not (cls.get_redmine_user() and cls.get_redmine_password()):
+            raise ValueError(
+                "REDMINE_API_KEY is required, or set both REDMINE_USER and REDMINE_PASSWORD"
+            )
--- a/redmine_reporter/formatters/init.py
+++ b/redmine_reporter/formatters/init.py
--- a/redmine_reporter/formatters/base.py
+++ b/redmine_reporter/formatters/base.py
@@ -1,5 +1,6 @@
 from abc import ABC, abstractmethod
-from typing import List
+from typing import Any, List
+
 from ..types import ReportRow


@@ -7,13 +8,19 @@ class Formatter(ABC):
    """
    Абстрактный базовый класс для всех форматтеров.
    Определяет общий интерфейс для форматирования отчета.
+
+    Контракт:
+      - format() возвращает строку для текстовых форматтеров (CSV, HTML, Markdown, console)
+        и объект OpenDocument для ODTFormatter.
+      - save() сохраняет результат в файл; консольные форматтеры бросают NotImplementedError.
    """

    @abstractmethod
-    def format(self, rows: List[ReportRow]) -> str:
+    def format(self, rows: List[ReportRow]) -> Any:
        """
        Форматирует список строк отчета в нужный формат.
-        Возвращает строковое представление отчета.
+        Для текстовых форматтеров возвращает str.
+        Для ODTFormatter возвращает объект OpenDocument.
        """
        pass

@@ -22,6 +29,6 @@ class Formatter(ABC):
        """
        Сохраняет отформатированный отчет в файл по указанному пути.
        Для форматтеров, которые не поддерживают сохранение (например, консольные),
-        можно вызывать `format` и записывать результат вручную.
+        бросает NotImplementedError.
        """
        pass
--- a/redmine_reporter/formatters/console.py
+++ b/redmine_reporter/formatters/console.py
@@ -1,22 +1,26 @@
 from typing import List
+
 from tabulate import tabulate
-from .base import Formatter
+
 from ..types import ReportRow
+from .base import Formatter


 class TableFormatter(Formatter):
    """Форматтер для вывода красивой таблицы в консоль."""

    def format(self, rows: List[ReportRow]) -> str:
-        table_rows = [['Проект', 'Версия', 'Задача', 'Статус', 'Затрачено']]
+        table_rows = [["Проект", "Версия", "Задача", "Статус", "Затрачено"]]
        for r in rows:
-            table_rows.append([
-                r['display_project'],
-                r['display_version'],
-                f"{r['issue_id']}. {r['subject']}",
-                r['status_ru'],
-                r['time_text']
-            ])
+            table_rows.append(
+                [
+                    r["display_project"],
+                    r["display_version"],
+                    f"{r['issue_id']}. {r['subject']}",
+                    r["status_ru"],
+                    r["time_text"],
+                ]
+            )
        return tabulate(table_rows, headers="firstrow", tablefmt="fancy_grid")

    def save(self, rows: List[ReportRow], output_path: str) -> None:
@@ -24,6 +28,7 @@ class TableFormatter(Formatter):
        # Это делается в CLI.
        raise NotImplementedError("TableFormatter не поддерживает сохранение в файл.")

+
 class CompactFormatter(Formatter):
    """Форматтер для компактного вывода в консоль."""

--- a/redmine_reporter/formatters/csv.py
+++ b/redmine_reporter/formatters/csv.py
@@ -1,32 +1,45 @@
 import csv
 import io
 from typing import List
-from .base import Formatter
+
 from ..types import ReportRow
+from .base import Formatter


 class CSVFormatter(Formatter):
-    """Форматтер для экспорта в CSV."""
+    """Форматтер для экспорта в CSV.

-    def __init__(self, **kwargs):
+    Использует полные значения project/version (а не display-значения с пустыми
+    ячейками для групп). Каждая строка CSV самодостаточна — это корректно для
+    табличного формата (#31). Файл сохраняется в UTF-8 с BOM (utf-8-sig) для
+    корректного отображения кириллицы в Microsoft Excel (#26).
+    """
+
+    def __init__(self, no_time: bool = False, **_kwargs):
        super().__init__()
+        self.no_time = no_time

    def format(self, rows: List[ReportRow]) -> str:
        output = io.StringIO()
        writer = csv.writer(output, dialect="excel")
-        writer.writerow(["Project", "Version", "Issue ID", "Subject", "Status", "Spent Time"])
+        headers = ["Project", "Version", "Issue ID", "Subject", "Status"]
+        if not self.no_time:
+            headers.append("Spent Time")
+        writer.writerow(headers)
        for r in rows:
-            writer.writerow([
+            data = [
                r["project"],
                r["version"],
                r["issue_id"],
                r["subject"],
                r["status_ru"],
-                r["time_text"]
-            ])
+            ]
+            if not self.no_time:
+                data.append(r["time_text"])
+            writer.writerow(data)
        return output.getvalue()

    def save(self, rows: List[ReportRow], output_path: str) -> None:
        content = self.format(rows)
-        with open(output_path, "w", encoding="utf-8", newline="") as f:
+        with open(output_path, "w", encoding="utf-8-sig", newline="") as f:
            f.write(content)
--- a/redmine_reporter/formatters/factory.py
+++ b/redmine_reporter/formatters/factory.py
@@ -1,18 +1,22 @@
-from typing import Dict, Type, Optional
+from typing import Dict, Optional, Type
+
 from .base import Formatter
-from .console import TableFormatter, CompactFormatter
+from .console import CompactFormatter, TableFormatter
 from .csv import CSVFormatter
-from .markdown import MarkdownFormatter
-from .odt import ODTFormatter
 from .html import HTMLFormatter
+from .json import JSONFormatter
+from .markdown import MarkdownFormatter
+from .xlsx import XLSXFormatter

-
-# Словарь для сопоставления расширений файлов с классами форматтеров
+# Словарь для сопоставления расширений файлов с классами форматтеров.
+# ODT и XLSX намеренно отсутствуют — их импорт отложен (ленивый), так как
+# odfpy/openpyxl может быть не установлен. См. get_formatter_by_extension.
 FORMATTER_MAP: Dict[str, Type[Formatter]] = {
-    ".odt": ODTFormatter,
    ".csv": CSVFormatter,
+    ".json": JSONFormatter,
    ".md": MarkdownFormatter,
    ".html": HTMLFormatter,
+    ".xlsx": XLSXFormatter,
 }


@@ -27,10 +31,23 @@ def get_formatter_by_extension(extension: str, **kwargs) -> Optional[Formatter]:
    """
    Возвращает экземпляр форматтера по расширению файла.
    Ключевые аргументы (**kwargs) передаются в конструктор форматтера.
+    Возвращает None для .odt, если odfpy не установлен.
    """
-    formatter_class = FORMATTER_MAP.get(extension.lower())
+    ext = extension.lower()
+
+    formatter_class = FORMATTER_MAP.get(ext)
    if formatter_class:
        return formatter_class(**kwargs)
+
+    # ODT требует odfpy — ленивый импорт, чтобы отсутствие зависимости
+    # не ломало загрузку модуля и другие форматтеры.
+    if ext == ".odt":
+        try:
+            from .odt import ODTFormatter
+        except ImportError:
+            return None
+        return ODTFormatter(**kwargs)
+
    return None


--- a/redmine_reporter/formatters/html.py
+++ b/redmine_reporter/formatters/html.py
@@ -1,27 +1,27 @@
-from typing import List, Dict, Any
-from .base import Formatter
+from html import escape
+from typing import List
+
+from ..report_builder import group_rows_by_project_and_version
 from ..types import ReportRow
+from .base import Formatter


 class HTMLFormatter(Formatter):
    """Форматтер для экспорта отчёта в HTML."""

-    def __init__(self, **kwargs):
+    def __init__(self, **_kwargs):
        super().__init__()

    def format(self, rows: List[ReportRow]) -> str:
-        # Сгруппируем данные
-        projects: Dict[str, Dict[str, List[ReportRow]]] = {}
-        for r in rows:
-            proj = r["project"]
-            ver = r["version"]
-            if proj not in projects:
-                projects[proj] = {}
-            if ver not in projects[proj]:
-                projects[proj][ver] = []
-            projects[proj][ver].append(r)
+        projects = group_rows_by_project_and_version(rows)

        lines = [
+            "<!DOCTYPE html>",
+            '<html lang="ru">',
+            "<head>",
+            '  <meta charset="utf-8">',
+            "</head>",
+            "<body>",
            '<table border="1" cellpadding="6" cellspacing="0" style="border-collapse: collapse; font-family: Arial, sans-serif;">',
            "  <thead>",
            "    <tr>",
@@ -36,34 +36,38 @@ class HTMLFormatter(Formatter):
        ]

        for project, versions in projects.items():
+            project_text = escape(project)
            total_project_rows = sum(len(tasks) for tasks in versions.values())
            first_version_in_project = True

            for version, task_rows in versions.items():
+                version_text = escape(version)
                row_span_version = len(task_rows)
                first_row_in_version = True

                for r in task_rows:
+                    task_cell = escape(f"{r['issue_id']}. {r['subject']}")
+                    status_text = escape(r["status_ru"])
+                    time_text = escape(r["time_text"])
                    lines.append("    <tr>")

                    # Ячейка "Проект" - только в первой строке проекта
                    if first_version_in_project and first_row_in_version:
                        lines.append(
-                            f'      <td rowspan="{total_project_rows}" style="vertical-align: top;">{project}</td>'
+                            f'      <td rowspan="{total_project_rows}" style="vertical-align: top;">{project_text}</td>'
                        )

                    # Ячейка "Версия" - только в первой строке версии
                    if first_row_in_version:
                        lines.append(
-                            f'      <td rowspan="{row_span_version}" style="vertical-align: top;">{version}</td>'
+                            f'      <td rowspan="{row_span_version}" style="vertical-align: top;">{version_text}</td>'
                        )
                        first_row_in_version = False

                    # Остальные колонки
-                    task_cell = f"{r['issue_id']}. {r['subject']}"
                    lines.append(f"      <td>{task_cell}</td>")
-                    lines.append(f"      <td>{r['status_ru']}</td>")
-                    lines.append(f"      <td>{r['time_text']}</td>")
+                    lines.append(f"      <td>{status_text}</td>")
+                    lines.append(f"      <td>{time_text}</td>")

                    lines.append("    </tr>")

@@ -71,6 +75,8 @@ class HTMLFormatter(Formatter):

        lines.append("  </tbody>")
        lines.append("</table>")
+        lines.append("</body>")
+        lines.append("</html>")
        return "\n".join(lines)

    def save(self, rows: List[ReportRow], output_path: str) -> None:
--- a/redmine_reporter/formatters/json.py
+++ b/redmine_reporter/formatters/json.py
@@ -0,0 +1,31 @@
+import json
+from typing import List
+
+from ..types import ReportRow
+from .base import Formatter
+
+
+class JSONFormatter(Formatter):
+    """Форматтер для экспорта отчёта в JSON."""
+
+    def __init__(self, **_kwargs):
+        super().__init__()
+
+    def format(self, rows: List[ReportRow]) -> str:
+        data = [
+            {
+                "project": r["project"],
+                "version": r["version"],
+                "issue_id": r["issue_id"],
+                "subject": r["subject"],
+                "status": r["status_ru"],
+                "time": r["time_text"],
+            }
+            for r in rows
+        ]
+        return json.dumps(data, ensure_ascii=False, indent=2)
+
+    def save(self, rows: List[ReportRow], output_path: str) -> None:
+        content = self.format(rows)
+        with open(output_path, "w", encoding="utf-8") as f:
+            f.write(content)
--- a/redmine_reporter/formatters/markdown.py
+++ b/redmine_reporter/formatters/markdown.py
@@ -1,24 +1,32 @@
 from typing import List
-from .base import Formatter
+
 from ..types import ReportRow
+from .base import Formatter
+
+
+def _escape_markdown_table_cell(value: object) -> str:
+    return str(value).replace("\\", "\\\\").replace("|", "\\|").replace("\n", "<br>")


 class MarkdownFormatter(Formatter):
    """Форматтер для экспорта в Markdown."""

-    def __init__(self, **kwargs):
+    def __init__(self, **_kwargs):
        super().__init__()

    def format(self, rows: List[ReportRow]) -> str:
        lines = [
            "| Проект | Версия | Задача | Статус | Затрачено |",
-            "|--------|--------|--------|--------|-----------|"
+            "|--------|--------|--------|--------|-----------|",
        ]
        for r in rows:
-            task_cell = f"{r['issue_id']}. {r['subject']}"
+            task_cell = _escape_markdown_table_cell(f"{r['issue_id']}. {r['subject']}")
            lines.append(
-                f"| {r['display_project']} | {r['display_version']} "
-                f"| {task_cell} | {r['status_ru']} | {r['time_text']} |"
+                f"| {_escape_markdown_table_cell(r['display_project'])} "
+                f"| {_escape_markdown_table_cell(r['display_version'])} "
+                f"| {task_cell} "
+                f"| {_escape_markdown_table_cell(r['status_ru'])} "
+                f"| {_escape_markdown_table_cell(r['time_text'])} |"
            )
        return "\n".join(lines)

--- a/redmine_reporter/formatters/odt.py
+++ b/redmine_reporter/formatters/odt.py
@@ -1,19 +1,21 @@
-import os
 from importlib import resources
 from typing import List
-from odf.opendocument import load
+
+from odf.opendocument import OpenDocument, load
+from odf.style import Style, TableCellProperties, TableColumnProperties
+from odf.table import CoveredTableCell, Table, TableCell, TableColumn, TableRow
 from odf.text import P
-from odf.table import Table, TableColumn, TableRow, TableCell
-from odf.style import Style, TableColumnProperties, TableCellProperties
-from .base import Formatter
+
+from ..report_builder import group_rows_by_project_and_version
 from ..types import ReportRow
 from ..utils import get_month_name_from_range
+from .base import Formatter


 class ODTFormatter(Formatter):
    """Форматтер для экспорта в ODT."""

-    def __init__(self, author: str = "", from_date: str = "", to_date: str = ""):
+    def __init__(self, author: str = "", from_date: str = "", to_date: str = "", **_kwargs):
        """
        Инициализирует форматтер с параметрами для шапки отчета.
        """
@@ -21,19 +23,22 @@ class ODTFormatter(Formatter):
        self.from_date = from_date
        self.to_date = to_date

-    def format(self, rows: List[ReportRow]) -> "OpenDocument":
+    def format(self, rows: List[ReportRow]) -> OpenDocument:
        """
        Форматирует данные в объект OpenDocument.
        """

-        with resources.files("redmine_reporter").joinpath("templates", "template.odt").open("rb") as f:
+        with resources.files("redmine_reporter").joinpath("templates/template.odt").open("rb") as f:
            doc = load(f)

        para_style_name = "Standard"

        # Заголовок
        month_name = get_month_name_from_range(self.from_date, self.to_date)
-        header_text = f"{self.author}. Отчет за месяц {month_name}."
+        if self.author:
+            header_text = f"{self.author}. Отчет за месяц {month_name}."
+        else:
+            header_text = f"Отчет за месяц {month_name}."
        doc.text.addElement(P(stylename=para_style_name, text=header_text))
        doc.text.addElement(P(stylename=para_style_name, text=""))

@@ -56,28 +61,25 @@ class ODTFormatter(Formatter):

        # Заголовки
        header_row = TableRow()
-        for text in ["Наименование Проекта", "Номер версии*", "Задача", "Статус Готовность*", "Затрачено за отчетный период"]:
+        for text in [
+            "Наименование Проекта",
+            "Номер версии*",
+            "Задача",
+            "Статус Готовность*",
+            "Затрачено за отчетный период",
+        ]:
            cell = TableCell(stylename=cell_style_name)
            cell.addElement(P(stylename=para_style_name, text=text))
            header_row.addElement(cell)
        table.addElement(header_row)

-        projects = {}
-        for r in rows:
-            project = r["project"]
-            version = r["version"]
-
-            if project not in projects:
-                projects[project] = {}
-
-            if version not in projects[project]:
-                projects[project][version] = []
-
-            projects[project][version].append(r)
+        projects = group_rows_by_project_and_version(rows)

        # Данные с двухуровневой группировкой и объединением ячеек
        for project, versions in projects.items():
-            total_project_rows = sum(len(rows_for_version) for rows_for_version in versions.values())
+            total_project_rows = sum(
+                len(rows_for_version) for rows_for_version in versions.values()
+            )
            first_version_in_project = True

            for version, rows_for_version in versions.items():
@@ -87,15 +89,19 @@ class ODTFormatter(Formatter):
                for r in rows_for_version:
                    row = TableRow()

-                    # Ячейка "Проект" - только в первой строке всего проекта
+                    # Ячейка "Проект" - только в первой строке всего проекта,
+                    # в остальных — covered-cell для валидности ODF (#13)
                    if first_version_in_project and first_row_in_version:
                        cell_project = TableCell(stylename=cell_style_name)
                        cell_project.setAttribute("numberrowsspanned", str(total_project_rows))
-                        p = P(stylename=para_style_name, text=project)  # Полное название проекта
+                        p = P(stylename=para_style_name, text=project)
                        cell_project.addElement(p)
                        row.addElement(cell_project)
+                    else:
+                        row.addElement(CoveredTableCell())

-                    # Ячейка "Версия" - только в первой строке каждой версии
+                    # Ячейка "Версия" - только в первой строке каждой версии,
+                    # в остальных — covered-cell для валидности ODF (#13)
                    if first_row_in_version:
                        cell_version = TableCell(stylename=cell_style_name)
                        cell_version.setAttribute("numberrowsspanned", str(row_span_version))
@@ -104,8 +110,7 @@ class ODTFormatter(Formatter):
                        row.addElement(cell_version)
                        first_row_in_version = False
                    else:
-                        # Пропускаем - уже объединена
-                        pass
+                        row.addElement(CoveredTableCell())

                    # Остальные колонки
                    task_cell = TableCell(stylename=cell_style_name)
@@ -125,7 +130,8 @@ class ODTFormatter(Formatter):
                    row.addElement(time_cell)

                    table.addElement(row)
-                    first_version_in_project = False
+
+                first_version_in_project = False

        doc.text.addElement(table)
        doc.text.addElement(P(stylename=para_style_name, text=""))
@@ -137,7 +143,7 @@ class ODTFormatter(Formatter):
            "«Задача» -  Номер по Redmine и формулировка.",
            "«Статус» -  Актуальное состояние задачи на момент отчета. Статусы: закрыто, в работе, ожидание, решена.",
            "«Готовность» – Опциональное поле в процентах.",
-            "«Затрачено за отчетный период»  - в днях или часах."
+            "«Затрачено за отчетный период»  - в днях или часах.",
        ]:
            doc.text.addElement(P(stylename=para_style_name, text=line))

--- a/redmine_reporter/formatters/xlsx.py
+++ b/redmine_reporter/formatters/xlsx.py
@@ -0,0 +1,214 @@
+from typing import Dict, List, Tuple
+
+from openpyxl import Workbook
+from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
+from openpyxl.utils import get_column_letter
+from openpyxl.worksheet.worksheet import Worksheet
+
+from ..report_builder import group_rows_by_project_and_version
+from ..types import ReportRow
+from ..utils import hours_to_human
+from .base import Formatter
+
+
+class XLSXFormatter(Formatter):
+    """Форматтер для экспорта отчёта в Excel (.xlsx).
+
+    Использует группировку по проекту и версии: объединяет ячейки,
+    добавляет итоги по группам, закрепляет заголовок, включает автофильтр
+    и числовой столбец с часами для удобного суммирования.
+    """
+
+    _HEADER_FILL = PatternFill(start_color="D9E1F2", end_color="D9E1F2", fill_type="solid")
+    _TOTAL_FILL = PatternFill(start_color="FFF2CC", end_color="FFF2CC", fill_type="solid")
+    _BORDER = Border(
+        left=Side(style="thin"),
+        right=Side(style="thin"),
+        top=Side(style="thin"),
+        bottom=Side(style="thin"),
+    )
+
+    def __init__(self, no_time: bool = False, **_kwargs):
+        super().__init__()
+        self.no_time = no_time
+
+    def format(self, rows: List[ReportRow]) -> Workbook:
+        wb = Workbook()
+        ws = wb.active
+        if ws is None:
+            ws = wb.create_sheet("Report")
+        else:
+            ws.title = "Report"
+
+        headers = ["Project", "Version", "Issue ID", "Subject", "Status", "Hours", "Spent Time"]
+        ws.append(headers)
+        self._style_header_row(ws, headers)
+
+        grouped = group_rows_by_project_and_version(rows)
+
+        current_row = 2
+        project_ranges: List[Tuple[int, int]] = []
+        version_ranges: List[Tuple[int, int]] = []
+        project_totals: Dict[str, float] = {}
+
+        for project, versions in grouped.items():
+            project_start_row = current_row
+
+            for version, task_rows in versions.items():
+                version_start_row = current_row
+
+                for r in task_rows:
+                    hours = "" if self.no_time else r.get("hours", 0.0)
+                    time_text = "" if self.no_time else r["time_text"]
+                    ws.append(
+                        [
+                            project,
+                            version,
+                            r["issue_id"],
+                            r["subject"],
+                            r["status_ru"],
+                            hours,
+                            time_text,
+                        ]
+                    )
+                    self._style_data_row(ws, current_row)
+                    current_row += 1
+
+                if not self.no_time:
+                    version_hours = sum(r.get("hours", 0.0) for r in task_rows)
+                    ws.append(
+                        [
+                            "",
+                            f"Total {version}",
+                            "",
+                            "",
+                            "",
+                            version_hours,
+                            hours_to_human(version_hours),
+                        ]
+                    )
+                    self._style_total_row(ws, current_row, bold=False)
+                    ws.merge_cells(
+                        start_row=current_row, start_column=2, end_row=current_row, end_column=5
+                    )
+                    current_row += 1
+
+                version_end_row = current_row - 1
+                if version_end_row > version_start_row:
+                    version_ranges.append((version_start_row, version_end_row))
+
+            if not self.no_time:
+                project_hours = sum(
+                    sum(r.get("hours", 0.0) for r in task_rows) for task_rows in versions.values()
+                )
+                ws.append(
+                    [
+                        f"Total {project}",
+                        "",
+                        "",
+                        "",
+                        "",
+                        project_hours,
+                        hours_to_human(project_hours),
+                    ]
+                )
+                self._style_total_row(ws, current_row, bold=True)
+                ws.merge_cells(
+                    start_row=current_row, start_column=1, end_row=current_row, end_column=5
+                )
+                current_row += 1
+                project_totals[project] = project_hours
+
+            project_end_row = current_row - 1
+            if project_end_row > project_start_row:
+                project_ranges.append((project_start_row, project_end_row))
+
+        if not self.no_time and project_totals:
+            total_hours = sum(project_totals.values())
+            ws.append(
+                [
+                    "Total",
+                    "",
+                    "",
+                    "",
+                    "",
+                    total_hours,
+                    hours_to_human(total_hours),
+                ]
+            )
+            self._style_total_row(ws, current_row, bold=True)
+            ws.merge_cells(start_row=current_row, start_column=1, end_row=current_row, end_column=5)
+
+        for start, end in project_ranges:
+            ws.merge_cells(start_row=start, start_column=1, end_row=end, end_column=1)
+            cell = ws.cell(row=start, column=1)
+            cell.alignment = Alignment(vertical="top", wrap_text=True)
+
+        for start, end in version_ranges:
+            ws.merge_cells(start_row=start, start_column=2, end_row=end, end_column=2)
+            cell = ws.cell(row=start, column=2)
+            cell.alignment = Alignment(vertical="top", wrap_text=True)
+
+        self._apply_column_widths(ws)
+        if not self.no_time:
+            self._apply_number_format(ws)
+        self._apply_auto_filter(ws, ws.max_row)
+        ws.freeze_panes = "A2"
+
+        return wb
+
+    def save(self, rows: List[ReportRow], output_path: str) -> None:
+        wb = self.format(rows)
+        wb.save(output_path)
+
+    def _style_header_row(self, ws: Worksheet, headers: List[str]) -> None:
+        for col_idx, _ in enumerate(headers, start=1):
+            cell = ws.cell(row=1, column=col_idx)
+            cell.font = Font(bold=True)
+            cell.fill = self._HEADER_FILL
+            cell.border = self._BORDER
+            cell.alignment = Alignment(horizontal="center", vertical="center", wrap_text=True)
+
+    def _style_data_row(self, ws: Worksheet, row: int) -> None:
+        for col_idx in range(1, 8):
+            cell = ws.cell(row=row, column=col_idx)
+            cell.border = self._BORDER
+            if col_idx in (1, 2):
+                cell.alignment = Alignment(vertical="top", wrap_text=True)
+            elif col_idx == 4:
+                cell.alignment = Alignment(vertical="top", wrap_text=True)
+            else:
+                cell.alignment = Alignment(vertical="top")
+
+    def _style_total_row(self, ws: Worksheet, row: int, bold: bool) -> None:
+        for col_idx in range(1, 8):
+            cell = ws.cell(row=row, column=col_idx)
+            cell.border = self._BORDER
+            cell.fill = self._TOTAL_FILL
+            cell.font = Font(bold=bold)
+            cell.alignment = Alignment(vertical="center")
+
+    def _apply_column_widths(self, ws: Worksheet) -> None:
+        # Минимальные ширины по умолчанию
+        widths: Dict[int, float] = {1: 18.0, 2: 16.0, 3: 12.0, 4: 45.0, 5: 14.0, 6: 10.0, 7: 14.0}
+
+        for row in ws.iter_rows(min_row=2, max_row=ws.max_row):
+            for col_idx, cell in enumerate(row, start=1):
+                if cell.value is None:
+                    continue
+                text = str(cell.value)
+                # Оценочная ширина: примерно 1.1 символа на единицу ширины Excel
+                estimated = len(text) * 1.1 + 2
+                widths[col_idx] = max(widths[col_idx], min(estimated, 80))
+
+        for col_idx, width in widths.items():
+            ws.column_dimensions[get_column_letter(col_idx)].width = width
+
+    def _apply_number_format(self, ws: Worksheet) -> None:
+        for row in ws.iter_rows(min_row=2, max_row=ws.max_row, min_col=6, max_col=6):
+            for cell in row:
+                if isinstance(cell.value, (int, float)):
+                    cell.number_format = "0.00"
+
+    def _apply_auto_filter(self, ws: Worksheet, max_row: int) -> None:
+        ws.auto_filter.ref = f"A1:G{max_row}"
--- a/redmine_reporter/report_builder.py
+++ b/redmine_reporter/report_builder.py
@@ -1,19 +1,24 @@
-from typing import List, Tuple, cast
+from typing import Dict, List, Tuple, cast
+
 from redminelib.resources import Issue
+
 from .types import ReportRow
 from .utils import get_version, hours_to_human

-
 STATUS_TRANSLATION = {
-    'Closed': 'Закрыто',
-    'Re-opened': 'В работе',
-    'New': 'В работе',
-    'Resolved': 'Решена',
-    'Pending': 'Ожидание',
-    'Feedback': 'В работе',
-    'In Progress': 'В работе',
-    'Rejected': 'Закрыто',
-    'Confirming': 'Ожидание',
+    "New": "В работе",
+    "In Progress": "В работе",
+    "Feedback": "В работе",
+    "Re-opened": "В работе",
+    "Code Review": "Решена",
+    "Wait Release": "Закрыто",
+    "Pending": "Ожидание",
+    "Resolved": "Решена",
+    "Testing": "Решена",
+    "Confirming": "Ожидание",
+    "Closed": "Закрыто",
+    "Rejected": "Закрыто",
+    "Frozen": "Ожидание",
 }


@@ -24,8 +29,14 @@ def build_grouped_report(
    """
    Преобразует список задач с затраченным временем в плоский список строк отчёта,
    с учётом группировки по проекту и версии (пустые ячейки для повторяющихся значений).
+
+    Предусловие: issue_hours должен быть отсортирован по (project, version).
+    Функция выполняет сортировку самостоятельно для защиты от несортированного ввода.
    """

+    # Защитная сортировка -- гарантирует корректную группировку независимо от порядка на входе
+    issue_hours = sorted(issue_hours, key=lambda x: (str(x[0].project), get_version(x[0]), x[0].id))
+
    rows: List[ReportRow] = []
    prev_project: str = ""
    prev_version: str = ""
@@ -52,6 +63,7 @@ def build_grouped_report(
                    "subject": issue.subject,
                    "status_ru": status_ru,
                    "time_text": time_text,
+                    "hours": round(hours, 2),
                },
            )
        )
@@ -60,3 +72,48 @@ def build_grouped_report(
        prev_version = version

    return rows
+
+
+def calculate_summary(rows: List[ReportRow]) -> Dict[str, float]:
+    """Возвращает сводку: общее время, время по проектам и версиям."""
+    total = 0.0
+    by_project: Dict[str, float] = {}
+    by_project_version: Dict[str, float] = {}
+
+    for r in rows:
+        hours = r.get("hours", 0.0)
+        total += hours
+        by_project[r["project"]] = by_project.get(r["project"], 0.0) + hours
+        key = f"{r['project']}::{r['version']}"
+        by_project_version[key] = by_project_version.get(key, 0.0) + hours
+
+    return {
+        "total": round(total, 2),
+        **{f"project:{k}": round(v, 2) for k, v in by_project.items()},
+        **{f"version:{k}": round(v, 2) for k, v in by_project_version.items()},
+    }
+
+
+def group_rows_by_project_and_version(
+    rows: List[ReportRow],
+) -> Dict[str, Dict[str, List[ReportRow]]]:
+    """
+    Группирует плоский список строк отчёта в иерархию project → version → [rows].
+
+    Предполагается, что rows уже отсортирован (build_grouped_report это гарантирует).
+    Возвращает обычный dict, сохраняющий порядок вставки (Python 3.7+).
+    Используется форматтерами HTML и ODT для объединения ячеек.
+    """
+    projects: Dict[str, Dict[str, List[ReportRow]]] = {}
+    for r in rows:
+        project = r["project"]
+        version = r["version"]
+
+        if project not in projects:
+            projects[project] = {}
+        if version not in projects[project]:
+            projects[project][version] = []
+
+        projects[project][version].append(r)
+
+    return projects
--- a/redmine_reporter/types.py
+++ b/redmine_reporter/types.py
@@ -12,3 +12,4 @@ class ReportRow(TypedDict):
    subject: str
    status_ru: str
    time_text: str
+    hours: float
--- a/redmine_reporter/utils.py
+++ b/redmine_reporter/utils.py
@@ -10,8 +10,19 @@ def get_month_name_from_range(from_date: str, to_date: str) -> str:
        return "Январь"

    months = [
-        "", "Январь", "Февраль", "Март", "Апрель", "Май", "Июнь",
-        "Июль", "Август", "Сентябрь", "Октябрь", "Ноябрь", "Декабрь"
+        "",
+        "Январь",
+        "Февраль",
+        "Март",
+        "Апрель",
+        "Май",
+        "Июнь",
+        "Июль",
+        "Август",
+        "Сентябрь",
+        "Октябрь",
+        "Ноябрь",
+        "Декабрь",
    ]

    return months[end.month]
@@ -19,7 +30,11 @@ def get_month_name_from_range(from_date: str, to_date: str) -> str:

 def get_version(issue) -> str:
    """Возвращает версию задачи или '<N/A>', если не задана."""
-    return str(getattr(issue, 'fixed_version', '<N/A>'))
+    version = getattr(issue, "fixed_version", None)
+    if version is None:
+        return "<N/A>"
+    name = getattr(version, "name", None)
+    return str(name) if name else str(version)


 def hours_to_human(hours: float) -> str:
--- a/tests/test_cli.py
+++ b/tests/test_cli.py
@@ -1,23 +1,227 @@
-import sys
-from io import StringIO
+import os
 from unittest import mock
-from redmine_reporter.cli import main
+
+import pytest
+
+from redmine_reporter.cli import main, parse_date_range
+
+VALID_ENV = {
+    "REDMINE_URL": "https://red.eltex.loc",
+    "REDMINE_API_KEY": "token",
+}


-@mock.patch.dict("os.environ", {
-    "REDMINE_URL": "https://red.eltex.loc/",
-    "REDMINE_USER": "x",
-    "REDMINE_PASSWORD": "y"
-})
-@mock.patch("redmine_reporter.client.fetch_issues_with_spent_time")
-def test_cli_smoke(mock_fetch):
-    mock_fetch.return_value = []
-    old_stdout = sys.stdout
-    sys.stdout = captured = StringIO()
-    try:
-        code = main(["--date", "2026-01-01--2026-01-31"])
-        assert code == 0
-        output = captured.getvalue()
-        assert "Total issues: 0" in output
-    finally:
-        sys.stdout = old_stdout
+@pytest.fixture(autouse=True)
+def _reset_config_overrides():
+    """Сбрасывает CLI-переопределения Config перед каждым тестом."""
+    from redmine_reporter.config import Config
+
+    Config.set_redmine_url("")
+    Config.set_redmine_api_key("")
+    yield
+    Config.set_redmine_url("")
+    Config.set_redmine_api_key("")
+
+
+@pytest.mark.parametrize(
+    "date_arg, expected",
+    [
+        ("2026-01-01--2026-01-31", ("2026-01-01", "2026-01-31")),
+        (" 2026-01-01 -- 2026-01-31 ", ("2026-01-01", "2026-01-31")),
+    ],
+)
+def test_parse_date_range_valid(date_arg, expected):
+    assert parse_date_range(date_arg) == expected
+
+
+@pytest.mark.parametrize(
+    "date_arg",
+    [
+        "20260101-20260131",
+        "2026-1-01--2026-01-31",
+        "2026-02-30--2026-03-01",
+        "2026-02-01--2026-01-31",
+    ],
+)
+def test_parse_date_range_invalid(date_arg):
+    with pytest.raises(ValueError):
+        parse_date_range(date_arg)
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_returns_zero_on_no_entries(mock_fetch):
+    """None от fetch (нет time entries) -- выход 0."""
+    mock_fetch.return_value = None
+    code = main(["--date", "2026-01-01--2026-01-31"])
+    assert code == 0
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+def test_cli_config_error():
+    """Невалидный конфиг -- выход 1."""
+    code = main(["--date", "2026-01-01--2026-01-31"])
+    assert code == 1
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+def test_cli_invalid_date_format():
+    """Неверный формат даты -- выход 1."""
+    code = main(["--date", "20260101-20260131"])
+    assert code == 1
+
+
+class _MockIssue:
+    """Простой mock Redmine Issue для CLI-тестов."""
+
+    def __init__(self, issue_id=1, subject="Task", project="Project", status="New"):
+        self.id = issue_id
+        self.subject = subject
+        self.project = project
+        self.status = status
+        self.fixed_version = None
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_unknown_output_extension(mock_fetch, tmp_path):
+    """Неизвестное расширение файла -- выход 1."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+    output = str(tmp_path / "report.xyz")
+    code = main(["--date", "2026-01-01--2026-01-31", "--output", output])
+    assert code == 1
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_output_without_extension(mock_fetch, tmp_path):
+    """Файл без расширения -- выход 1 с подсказкой."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+    output = str(tmp_path / "report")
+    code = main(["--date", "2026-01-01--2026-01-31", "--output", output])
+    assert code == 1
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+@mock.patch("redmine_reporter.cli.get_formatter_by_extension")
+def test_cli_odt_missing_odfpy_message(mock_gf, mock_fetch, tmp_path, capsys):
+    """При запросе .odt без odfpy — выход 1, понятное сообщение про odfpy."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+    mock_gf.return_value = None
+    output = str(tmp_path / "report.odt")
+    code = main(["--date", "2026-01-01--2026-01-31", "--output", output])
+    assert code == 1
+    captured = capsys.readouterr()
+    assert "odfpy" in captured.err
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+def test_cli_version_flag(capsys):
+    """--version выводит версию и завершается с 0."""
+    with pytest.raises(SystemExit) as exc_info:
+        main(["--version"])
+    assert exc_info.value.code == 0
+    captured = capsys.readouterr()
+    assert "redmine-reporter" in captured.out
+    from redmine_reporter import __version__
+
+    assert __version__ in captured.out
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_verbose_and_debug_flags_accepted(mock_fetch):
+    """--verbose и --debug не ломают запуск."""
+    mock_fetch.return_value = None
+    code = main(["--date", "2026-01-01--2026-01-31", "--verbose"])
+    assert code == 0
+    code = main(["--date", "2026-01-01--2026-01-31", "--debug"])
+    assert code == 0
+
+
+class _MockIssue:
+    """Простой mock Redmine Issue для CLI-тестов."""
+
+    def __init__(self, issue_id=1, subject="Task", project="Project", status="New"):
+        self.id = issue_id
+        self.subject = subject
+        self.project = project
+        self.status = status
+        self.fixed_version = None
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_url_and_api_key_override_env(mock_fetch):
+    """--url и --api-key переопределяют отсутствующие/другие env-переменные."""
+    mock_fetch.return_value = None
+    code = main(
+        [
+            "--date",
+            "2026-01-01--2026-01-31",
+            "--url",
+            "https://other.redmine.loc",
+            "--api-key",
+            "cli-token",
+        ]
+    )
+    assert code == 0
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_config_file_loading(mock_fetch, tmp_path):
+    """--config загружает переменные из указанного .env-файла."""
+    config_path = tmp_path / "custom.env"
+    config_path.write_text(
+        "REDMINE_URL=https://config.redmine.loc\n" "REDMINE_API_KEY=config-token\n",
+        encoding="utf-8",
+    )
+    mock_fetch.return_value = None
+    code = main(["--date", "2026-01-01--2026-01-31", "--config", str(config_path)])
+    assert code == 0
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_summary_flag_prints_totals(mock_fetch, capsys):
+    """--summary выводит общее время и разбивку по проектам в stderr."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+    main(["--date", "2026-01-01--2026-01-31", "--summary"])
+    captured = capsys.readouterr()
+    assert "Total time" in captured.err
+    assert "Project" in captured.err or "Project" in captured.out
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_total_issues_message_goes_to_stderr(mock_fetch, capsys):
+    """«Total issues» пишется в stderr, не загрязняя stdout при pipe (#28)."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+    main(["--date", "2026-01-01--2026-01-31"])
+    captured = capsys.readouterr()
+    assert "Total issues" not in captured.out
+    assert "Total issues" in captured.err
+
+
+@mock.patch.dict(os.environ, VALID_ENV, clear=True)
+@mock.patch("redmine_reporter.cli.fetch_issues_with_spent_time")
+def test_cli_no_time_passed_to_formatter(mock_fetch, tmp_path):
+    """CLI --no-time передаётся в файловый форматтер."""
+    issue = _MockIssue()
+    mock_fetch.return_value = [(issue, 1.0)]
+
+    output = str(tmp_path / "report.xlsx")
+    with mock.patch("redmine_reporter.cli.get_formatter_by_extension") as mock_get_formatter:
+        mock_formatter = mock.MagicMock()
+        mock_get_formatter.return_value = mock_formatter
+        main(["--date", "2026-01-01--2026-01-31", "--output", output, "--no-time"])
+
+    _, kwargs = mock_get_formatter.call_args
+    assert kwargs.get("no_time") is True
--- a/tests/test_client.py
+++ b/tests/test_client.py
@@ -1,17 +1,29 @@
-import pytest
+import os
 from unittest import mock
+
 from redmine_reporter.client import fetch_issues_with_spent_time
+from redmine_reporter.config import DEFAULT_REDMINE_VERIFY
+
+PASSWORD_ENV = {
+    "REDMINE_URL": "https://red.eltex.loc",
+    "REDMINE_USER": "user",
+    "REDMINE_PASSWORD": "password",
+}


-@mock.patch("redmine_reporter.client.Redmine")
-def test_fetch_issues_with_spent_time(mock_redmine_class):
-    # Подготовка моков
-    mock_redmine = mock_redmine_class.return_value
+def _configure_current_user(mock_redmine, user_id=1):
    mock_user = mock.MagicMock()
-    mock_user.id = 123
+    mock_user.id = user_id
    mock_redmine.user.get.return_value = mock_user

-    # Два time entry на одну задачу
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_aggregates_hours_per_issue(mock_redmine_class):
+    """Два time entry на одну задачу -- часы суммируются."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine, user_id=123)
+
    mock_entry1 = mock.MagicMock()
    mock_entry1.issue.id = 101
    mock_entry1.hours = 2.0
@@ -20,7 +32,6 @@ def test_fetch_issues_with_spent_time(mock_redmine_class):
    mock_entry2.hours = 1.5
    mock_redmine.time_entry.filter.return_value = [mock_entry1, mock_entry2]

-    # Мок задачи
    mock_issue = mock.MagicMock()
    mock_issue.id = 101
    mock_issue.project = "Проект X"
@@ -34,3 +45,206 @@ def test_fetch_issues_with_spent_time(mock_redmine_class):
    assert len(result) == 1
    issue, total_hours = result[0]
    assert total_hours == 3.5
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_returns_none_when_no_entries(mock_redmine_class):
+    """Нет time entries -- возвращается None."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    result = fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+    assert result is None
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_skips_entries_without_issue(mock_redmine_class):
+    """Time entry без привязки к задаче игнорируется."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+
+    # entry без issue атрибута
+    entry_no_issue = mock.MagicMock(spec=["hours"])  # нет .issue
+    entry_no_issue.hours = 1.0
+
+    mock_redmine.time_entry.filter.return_value = [entry_no_issue]
+
+    result = fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+    assert result is None
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_multiple_issues(mock_redmine_class):
+    """Несколько задач -- каждая с правильным суммарным временем."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+
+    def make_entry(issue_id, hours):
+        e = mock.MagicMock()
+        e.issue.id = issue_id
+        e.hours = hours
+        return e
+
+    mock_redmine.time_entry.filter.return_value = [
+        make_entry(1, 1.0),
+        make_entry(2, 2.0),
+        make_entry(1, 0.5),
+    ]
+
+    mock_issue1 = mock.MagicMock()
+    mock_issue1.id = 1
+    mock_issue1.project = "P"
+    mock_issue2 = mock.MagicMock()
+    mock_issue2.id = 2
+    mock_issue2.project = "P"
+    mock_redmine.issue.filter.return_value = [mock_issue1, mock_issue2]
+
+    result = fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+    assert result is not None
+    assert len(result) == 2
+
+    hours_by_id = {issue.id: hours for issue, hours in result}
+    assert hours_by_id[1] == 1.5
+    assert hours_by_id[2] == 2.0
+
+
+@mock.patch.dict(
+    os.environ,
+    {
+        "REDMINE_URL": "https://red.eltex.loc",
+        "REDMINE_API_KEY": "api-token",
+        "REDMINE_USER": "user",
+        "REDMINE_PASSWORD": "password",
+    },
+    clear=True,
+)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_uses_api_key_when_present(mock_redmine_class):
+    """Если задан API key, он используется вместо логина/пароля."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    _, kwargs = mock_redmine_class.call_args
+    assert kwargs["key"] == "api-token"
+    assert kwargs["requests"]["verify"] == DEFAULT_REDMINE_VERIFY
+    assert "username" not in kwargs
+    assert "password" not in kwargs
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_uses_username_password_when_no_api_key(mock_redmine_class):
+    """Если API key не задан, остаётся старая схема логин/пароль."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    _, kwargs = mock_redmine_class.call_args
+    assert kwargs["username"] == "user"
+    assert kwargs["password"] == "password"
+    assert kwargs["requests"]["verify"] == DEFAULT_REDMINE_VERIFY
+    assert "key" not in kwargs
+
+
+@mock.patch.dict(os.environ, {**PASSWORD_ENV, "REDMINE_VERIFY": "/tmp/redmine-ca.pem"}, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_uses_custom_verify_path(mock_redmine_class):
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    _, kwargs = mock_redmine_class.call_args
+    assert kwargs["requests"]["verify"] == "/tmp/redmine-ca.pem"
+
+
+# -- #24: Таймаут и retry --
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_sets_timeout_in_requests(mock_redmine_class):
+    """В requests dict передаётся timeout (#24)."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    _, kwargs = mock_redmine_class.call_args
+    assert "timeout" in kwargs["requests"]
+    assert kwargs["requests"]["timeout"] == 30
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_mounts_retry_adapter(mock_redmine_class):
+    """На сессию монтируется HTTPAdapter с retry для временных ошибок (#24)."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+    mock_redmine.time_entry.filter.return_value = []
+
+    fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    # Проверяем, что engine.session.mount был вызван для http:// и https://
+    mount_calls = mock_redmine.engine.session.mount.call_args_list
+    prefixes = [call.args[0] for call in mount_calls]
+    assert "https://" in prefixes
+    assert "http://" in prefixes
+
+    # Проверяем retry-конфигурацию адаптера
+    https_adapter = next(call.args[1] for call in mount_calls if call.args[0] == "https://")
+    max_retries = https_adapter.max_retries
+    assert max_retries.total == 3
+    assert 429 in max_retries.status_forcelist
+
+
+# -- #21: Чанкирование issue_ids --
+
+
+@mock.patch.dict(os.environ, PASSWORD_ENV, clear=True)
+@mock.patch("redmine_reporter.client.Redmine")
+def test_fetch_chunks_large_issue_count(mock_redmine_class):
+    """При >100 задач запросы разбиваются на чанки (#21)."""
+    mock_redmine = mock_redmine_class.return_value
+    _configure_current_user(mock_redmine)
+
+    # 250 time entries → 250 уникальных issue_id
+    entries = []
+    for i in range(1, 251):
+        e = mock.MagicMock()
+        e.issue.id = i
+        e.hours = 1.0
+        entries.append(e)
+    mock_redmine.time_entry.filter.return_value = entries
+
+    # issue.filter вызывается с чанками по 100 ID
+    call_chunks = []
+
+    def issue_filter_side_effect(**kwargs):
+        ids_str = kwargs.get("issue_id", "")
+        call_chunks.append(ids_str)
+        ids = [int(x) for x in ids_str.split(",")]
+        return [mock.MagicMock(id=i, project="P", subject="T", status="New") for i in ids]
+
+    mock_redmine.issue.filter.side_effect = issue_filter_side_effect
+
+    result = fetch_issues_with_spent_time("2026-01-01", "2026-01-31")
+
+    # Должно быть 3 вызова (100 + 100 + 50)
+    assert len(call_chunks) == 3
+    assert len(call_chunks[0].split(",")) == 100
+    assert len(call_chunks[1].split(",")) == 100
+    assert len(call_chunks[2].split(",")) == 50
+    assert result is not None
+    assert len(result) == 250
--- a/tests/test_config.py
+++ b/tests/test_config.py
@@ -1,25 +1,135 @@
 import os
-import pytest
 from unittest import mock
-from redmine_reporter.config import Config
+
+import pytest
+
+from redmine_reporter.config import DEFAULT_REDMINE_VERIFY, Config


-@mock.patch.dict(os.environ, {
-    "REDMINE_URL": "https://red.eltex.loc/",
-    "REDMINE_USER": "test",
-    "REDMINE_PASSWORD": "secret"
-})
-def test_config_valid():
+@mock.patch.dict(
+    os.environ,
+    {
+        "REDMINE_URL": "https://red.eltex.loc/",
+        "REDMINE_USER": "test",
+        "REDMINE_PASSWORD": "secret",
+    },
+    clear=True,
+)
+def test_config_valid_with_password_fallback():
+    Config.validate()  # не должно быть исключения
+
+
+@mock.patch.dict(
+    os.environ,
+    {
+        "REDMINE_URL": "https://red.eltex.loc/",
+        "REDMINE_API_KEY": "token",
+    },
+    clear=True,
+)
+def test_config_valid_with_api_key():
    Config.validate()  # не должно быть исключения


@mock.patch.dict(os.environ, {}, clear=True)
-def test_config_missing():
+def test_config_missing_url():
    with pytest.raises(ValueError, match="REDMINE_URL"):
        Config.validate()


-@mock.patch.dict(os.environ, {"REDMINE_AUTHOR": "Иванов И.И."})
+@mock.patch.dict(os.environ, {"REDMINE_URL": "https://red.eltex.loc/"}, clear=True)
+def test_config_missing_auth():
+    with pytest.raises(ValueError, match="REDMINE_API_KEY"):
+        Config.validate()
+
+
+@mock.patch.dict(os.environ, {"REDMINE_URL": " https://red.eltex.loc/ "}, clear=True)
+def test_get_redmine_url_strips_spaces_and_trailing_slash():
+    assert Config.get_redmine_url() == "https://red.eltex.loc"
+
+
+@mock.patch.dict(os.environ, {"REDMINE_AUTHOR": " Иванов И.И. "}, clear=True)
 def test_get_author():
    assert Config.get_author("") == "Иванов И.И."
    assert Config.get_author("Петров П.П.") == "Петров П.П."
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+def test_get_author_fallback():
+    """Если ни CLI, ни .env не задали автора -- возвращается пустая строка."""
+    assert Config.get_author("") == ""
+
+
+@mock.patch.dict(
+    os.environ,
+    {
+        "DEFAULT_FROM_DATE": "2026-01-01",
+        "DEFAULT_TO_DATE": "2026-01-31",
+    },
+    clear=True,
+)
+def test_get_default_date_range_from_env():
+    assert Config.get_default_date_range() == "2026-01-01--2026-01-31"
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+def test_get_default_date_range_fallback():
+    """Если даты не заданы -- используется текущий месяц."""
+    from datetime import date, timedelta
+
+    today = date.today()
+    start = today.replace(day=1)
+    if today.month == 12:
+        next_month = today.replace(year=today.year + 1, month=1, day=1)
+    else:
+        next_month = today.replace(month=today.month + 1, day=1)
+    end = next_month - timedelta(days=1)
+
+    result = Config.get_default_date_range()
+    assert result == f"{start.isoformat()}--{end.isoformat()}"
+
+
+@mock.patch.dict(os.environ, {}, clear=True)
+def test_get_redmine_verify_default():
+    assert Config.get_redmine_verify() == DEFAULT_REDMINE_VERIFY
+
+
+@pytest.mark.parametrize("value", ["0", "false", "False", "no", "off"])
+def test_get_redmine_verify_false_values(value):
+    with mock.patch.dict(os.environ, {"REDMINE_VERIFY": value}, clear=True):
+        assert Config.get_redmine_verify() is False
+
+
+@pytest.mark.parametrize("value", ["1", "true", "True", "yes", "on"])
+def test_get_redmine_verify_true_values(value):
+    with mock.patch.dict(os.environ, {"REDMINE_VERIFY": value}, clear=True):
+        assert Config.get_redmine_verify() is True
+
+
+@mock.patch.dict(os.environ, {"REDMINE_VERIFY": "/tmp/redmine-ca.pem"}, clear=True)
+def test_get_redmine_verify_custom_path():
+    assert Config.get_redmine_verify() == "/tmp/redmine-ca.pem"
+
+
+# -- #15: .env не должен переопределять переменные окружения --
+
+
+@mock.patch("dotenv.load_dotenv")
+def test_env_var_takes_priority_over_dotenv(mock_load):
+    """load_dotenv вызывается с override=False — env vars не перебиваются .env."""
+    import importlib
+
+    from redmine_reporter import config as cfg_mod
+
+    importlib.reload(cfg_mod)
+
+    mock_load.assert_called_once_with(override=False)
+
+
+# -- #35: get_redmine_password должен делать .strip() --
+
+
+@mock.patch.dict(os.environ, {"REDMINE_PASSWORD": "  secret123  "}, clear=True)
+def test_get_redmine_password_strips_whitespace():
+    """Пароль обрезается от whitespace, как и все остальные геттеры."""
+    assert Config.get_redmine_password() == "secret123"
--- a/tests/test_formatters.py
+++ b/tests/test_formatters.py
@@ -1,12 +1,28 @@
-import pytest
-import os
+import io
+import json
 from typing import List
-from redmine_reporter.types import ReportRow
-from redmine_reporter.formatters.console import TableFormatter, CompactFormatter
+from unittest import mock
+
+import pytest
+from odf.opendocument import OpenDocument, OpenDocumentText
+
+from redmine_reporter.formatters.console import CompactFormatter, TableFormatter
 from redmine_reporter.formatters.csv import CSVFormatter
+from redmine_reporter.formatters.factory import get_formatter_by_extension
+from redmine_reporter.formatters.html import HTMLFormatter
+from redmine_reporter.formatters.json import JSONFormatter
 from redmine_reporter.formatters.markdown import MarkdownFormatter
 from redmine_reporter.formatters.odt import ODTFormatter
-from odf.opendocument import OpenDocument
+from redmine_reporter.formatters.xlsx import XLSXFormatter
+from redmine_reporter.types import ReportRow
+
+
+def _make_empty_odt_bytes() -> bytes:
+    """Создаёт минимальный валидный ODT-документ в памяти."""
+    doc = OpenDocumentText()
+    buf = io.BytesIO()
+    doc.save(buf)
+    return buf.getvalue()


 def make_fake_report_rows() -> List[ReportRow]:
@@ -16,9 +32,7 @@ def make_fake_report_rows() -> List[ReportRow]:
    - Проект B: версия <N/A> (1 задача)
    - Проект C: версия v1.0 (1 задача), версия v1.1 (2 задачи)
    """
-
    return [
-        # Проект A, v1.0
        {
            "project": "Проект A",
            "version": "v1.0",
@@ -27,7 +41,8 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 101,
            "subject": "Реализовать фичу X",
            "status_ru": "В работе",
-            "time_text": "4ч 30м"
+            "time_text": "4ч 30м",
+            "hours": 4.5,
        },
        {
            "project": "Проект A",
@@ -37,9 +52,9 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 102,
            "subject": "Исправить баг Y",
            "status_ru": "Решена",
-            "time_text": "2ч"
+            "time_text": "2ч",
+            "hours": 2.0,
        },
-        # Проект A, v2.0
        {
            "project": "Проект A",
            "version": "v2.0",
@@ -48,9 +63,9 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 103,
            "subject": "Документация Z",
            "status_ru": "Ожидание",
-            "time_text": "1ч"
+            "time_text": "1ч",
+            "hours": 1.0,
        },
-        # Проект B, без версии
        {
            "project": "Проект B",
            "version": "<N/A>",
@@ -59,9 +74,9 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 201,
            "subject": "Обновить README",
            "status_ru": "Закрыто",
-            "time_text": "0ч"
+            "time_text": "0ч",
+            "hours": 0.0,
        },
-        # Проект C, v1.0
        {
            "project": "Проект C",
            "version": "v1.0",
@@ -70,9 +85,9 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 301,
            "subject": "Настроить CI",
            "status_ru": "В работе",
-            "time_text": "3ч 15м"
+            "time_text": "3ч 15м",
+            "hours": 3.25,
        },
-        # Проект C, v1.1
        {
            "project": "Проект C",
            "version": "v1.1",
@@ -81,7 +96,8 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 302,
            "subject": "Добавить тесты",
            "status_ru": "В работе",
-            "time_text": "5ч"
+            "time_text": "5ч",
+            "hours": 5.0,
        },
        {
            "project": "Проект C",
@@ -91,7 +107,8 @@ def make_fake_report_rows() -> List[ReportRow]:
            "issue_id": 303,
            "subject": "Рефакторинг",
            "status_ru": "Решена",
-            "time_text": "6ч 45м"
+            "time_text": "6ч 45м",
+            "hours": 6.75,
        },
    ]

@@ -101,75 +118,429 @@ def fake_rows():
    return make_fake_report_rows()


-def _get_formatter_output_text(result):
-    """Преобразует результат форматтера в строку для проверки содержимого."""
+@pytest.fixture
+def odt_formatter():
+    """ODTFormatter с замоканной загрузкой шаблона."""
+    odt_bytes = _make_empty_odt_bytes()
+    mock_file = mock.MagicMock()
+    mock_file.__enter__ = mock.MagicMock(return_value=io.BytesIO(odt_bytes))
+    mock_file.__exit__ = mock.MagicMock(return_value=False)

-    if isinstance(result, OpenDocument):
-        return ""
-    elif isinstance(result, str):
-        return result
-    else:
-        raise TypeError(f"Unexpected formatter output type: {type(result)}")
+    with mock.patch(
+        "redmine_reporter.formatters.odt.resources.files",
+        return_value=mock.MagicMock(
+            joinpath=mock.MagicMock(
+                return_value=mock.MagicMock(open=mock.MagicMock(return_value=mock_file))
+            )
+        ),
+    ):
+        yield ODTFormatter(author="Тест Автор", from_date="2026-01-01", to_date="2026-01-31")


-FORMATTER_FACTORIES = [
+# -- Тесты упаковки formatters как полноценного пакета --
+
+
+def test_formatters_is_regular_package():
+    """redmine_reporter.formatters — полноценный пакет с __init__.py, не namespace."""
+    import redmine_reporter.formatters
+
+    assert hasattr(redmine_reporter.formatters, "__file__")
+    assert redmine_reporter.formatters.__file__.endswith("__init__.py")
+
+
+def test_formatters_found_by_setuptools():
+    """setuptools.find_packages находит formatters как полноценный пакет."""
+    import os
+
+    from setuptools import find_packages
+
+    project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+    found = find_packages(where=project_root, include=["redmine_reporter*"])
+    assert "redmine_reporter.formatters" in found
+
+
+# -- Тесты ленивого импорта ODT (#25) --
+
+
+def _simulate_missing_odfpy():
+    """Вспомогательная функция: подготавливает очистку кэша модулей odf и odt.
+
+    Возвращает словарь сохранённых модулей для последующего восстановления.
+    """
+    import sys
+
+    saved = {}
+    for key in list(sys.modules.keys()):
+        if key == "odf" or key.startswith("odf.") or key == "redmine_reporter.formatters.odt":
+            saved[key] = sys.modules.pop(key)
+    return saved
+
+
+def _restore_modules(saved):
+    import sys
+
+    sys.modules.update(saved)
+
+
+def test_get_formatter_odt_returns_none_without_odfpy():
+    """Без odfpy — get_formatter_by_extension('.odt') возвращает None, не падает."""
+    import builtins
+
+    from redmine_reporter.formatters.factory import get_formatter_by_extension
+
+    real_import = builtins.__import__
+
+    def blocking_import(name, *args, **kwargs):
+        if name == "odf" or name.startswith("odf."):
+            raise ImportError(f"No module named '{name}'")
+        return real_import(name, *args, **kwargs)
+
+    saved = _simulate_missing_odfpy()
+    try:
+        with mock.patch("builtins.__import__", side_effect=blocking_import):
+            result = get_formatter_by_extension(
+                ".odt", author="test", from_date="2026-01-01", to_date="2026-01-31"
+            )
+            assert result is None
+    finally:
+        _restore_modules(saved)
+
+
+def test_get_formatter_csv_works_without_odfpy():
+    """Без odfpy — get_formatter_by_extension('.csv') работает нормально."""
+    import builtins
+
+    from redmine_reporter.formatters.factory import get_formatter_by_extension
+
+    real_import = builtins.__import__
+
+    def blocking_import(name, *args, **kwargs):
+        if name == "odf" or name.startswith("odf."):
+            raise ImportError(f"No module named '{name}'")
+        return real_import(name, *args, **kwargs)
+
+    saved = _simulate_missing_odfpy()
+    try:
+        with mock.patch("builtins.__import__", side_effect=blocking_import):
+            result = get_formatter_by_extension(".csv")
+            assert result is not None
+    finally:
+        _restore_modules(saved)
+
+
+# -- Параметризованные тесты текстовых форматтеров --
+
+TEXT_FORMATTER_FACTORIES = [
    ("table", lambda: TableFormatter()),
    ("compact", lambda: CompactFormatter()),
    ("csv", lambda: CSVFormatter()),
+    ("json", lambda: JSONFormatter()),
    ("markdown", lambda: MarkdownFormatter()),
-    ("odt", lambda: ODTFormatter(author="Тест Автор", from_date="2026-01-01", to_date="2026-01-31")),
 ]


-@pytest.mark.parametrize("name, formatter_factory", FORMATTER_FACTORIES)
-def test_formatter_does_not_crash(fake_rows, name, formatter_factory):
-    """Проверяем, что форматтер не падает на валидных данных."""
-
-    formatter = formatter_factory()
-    result = formatter.format(fake_rows)
-
-    if name == "odt":
-        assert isinstance(result, OpenDocument)
-    else:
-        assert isinstance(result, str)
-        assert len(result.strip()) > 0
+@pytest.mark.parametrize("name, factory", TEXT_FORMATTER_FACTORIES)
+def test_text_formatter_returns_nonempty_string(fake_rows, name, factory):
+    """Текстовые форматтеры возвращают непустую строку."""
+    result = factory().format(fake_rows)
+    assert isinstance(result, str)
+    assert len(result.strip()) > 0


-@pytest.mark.parametrize("name, formatter_factory", FORMATTER_FACTORIES)
-def test_formatter_contains_key_content(fake_rows, name, formatter_factory):
-    """Проверяем, что вывод содержит ключевые элементы."""
+@pytest.mark.parametrize("name, factory", TEXT_FORMATTER_FACTORIES)
+def test_text_formatter_contains_key_content(fake_rows, name, factory):
+    """Вывод содержит ключевые данные из отчёта."""
+    output = factory().format(fake_rows)

-    formatter = formatter_factory()
-    result = formatter.format(fake_rows)
+    assert "Проект A" in output
+    assert "Проект B" in output
+    assert "В работе" in output
+    assert "<N/A>" in output
+    assert "6ч 45м" in output

-    output_text = _get_formatter_output_text(result)
-    if not output_text:
-        return  # Пропускаем ODT
-
-    # Общие элементы
-    assert "Проект A" in output_text
-    assert "Проект B" in output_text
-    assert "В работе" in output_text
-    assert "<N/A>" in output_text
-    assert "6ч 45м" in output_text
-
-    # Специфика по форматам
    if name == "csv":
-        # В CSV ID и subject — отдельные колонки
-        assert "101" in output_text
-        assert "Реализовать фичу X" in output_text
+        # В CSV issue_id и subject -- отдельные колонки
+        assert "101" in output
+        assert "Реализовать фичу X" in output
+    elif name == "json":
+        # В JSON issue_id -- число, subject -- отдельное поле
+        assert '"issue_id": 101' in output
+        assert "Реализовать фичу X" in output
    else:
-        # В остальных — вместе
-        assert "101. Реализовать фичу X" in output_text
+        assert "101. Реализовать фичу X" in output


-def test_odt_save_creates_valid_file(fake_rows, tmp_path):
-    """Проверяем, что ODT можно сохранить и он открывается как ZIP."""
+@pytest.mark.parametrize("name, factory", TEXT_FORMATTER_FACTORIES)
+def test_text_formatter_empty_rows(name, factory):
+    """Форматтер не падает на пустом списке строк."""
+    result = factory().format([])
+    assert isinstance(result, str)

-    output_file = tmp_path / "report.odt"
-    formatter = ODTFormatter(author="Тест", from_date="2026-01-01", to_date="2026-01-31")
-    formatter.save(fake_rows, str(output_file))
+
+# -- Тесты консольных форматтеров --
+
+
+def test_table_formatter_save_raises(fake_rows):
+    with pytest.raises(NotImplementedError):
+        TableFormatter().save(fake_rows, "/dev/null")
+
+
+def test_compact_formatter_save_raises(fake_rows):
+    with pytest.raises(NotImplementedError):
+        CompactFormatter().save(fake_rows, "/dev/null")
+
+
+def test_csv_save_writes_utf8_bom(fake_rows, tmp_path):
+    """CSV-файл начинается с UTF-8 BOM для корректного открытия в Excel (#26)."""
+    output = tmp_path / "report.csv"
+    CSVFormatter().save(fake_rows, str(output))
+    content = output.read_bytes()
+    assert content[:3] == b"\xef\xbb\xbf"  # UTF-8 BOM
+
+
+def test_csv_uses_full_values_not_display(fake_rows):
+    """CSV экспортирует полные project/version, а не display-значения (#31).
+
+    В отличие от консольных и Markdown форматтеров (display_*), CSV содержит
+    полные значения в каждой строке — это корректно для табличного формата.
+    """
+    output = CSVFormatter().format(fake_rows)
+    lines = output.strip().split("\n")
+    # Header + 7 data rows = 8 lines
+    assert len(lines) == 8
+    # Вторая строка данных (lines[2]) имеет display_project="" и display_version="",
+    # но CSV должен содержать полные значения
+    assert "Проект A" in lines[2]
+    assert "v1.0" in lines[2]
+
+
+def test_json_save_writes_parsable_data(fake_rows, tmp_path):
+    """JSON-файл содержит валидный JSON со всеми строками отчёта."""
+    output = tmp_path / "report.json"
+    JSONFormatter().save(fake_rows, str(output))
+    data = json.loads(output.read_text(encoding="utf-8"))
+    assert len(data) == len(fake_rows)
+    assert data[0]["project"] == "Проект A"
+    assert data[0]["issue_id"] == 101
+
+
+def test_get_formatter_by_extension_json():
+    """get_formatter_by_extension('.json') возвращает JSONFormatter."""
+    formatter = get_formatter_by_extension(".json")
+    assert isinstance(formatter, JSONFormatter)
+
+
+def test_get_formatter_by_extension_xlsx():
+    """get_formatter_by_extension('.xlsx') возвращает XLSXFormatter."""
+    formatter = get_formatter_by_extension(".xlsx")
+    assert isinstance(formatter, XLSXFormatter)
+
+
+def test_xlsx_save_creates_valid_file(fake_rows, tmp_path):
+    """XLSX-файл сохраняется и содержит корректные данные."""
+    from openpyxl import load_workbook
+
+    output = tmp_path / "report.xlsx"
+    XLSXFormatter().save(fake_rows, str(output))
+
+    wb = load_workbook(str(output))
+    ws = wb.active
+    assert ws.title == "Report"
+    assert ws["A1"].value == "Project"
+    assert ws["A2"].value == "Проект A"
+    assert ws["C2"].value == 101
+    assert ws["F2"].value == 4.5
+    assert ws["G2"].value == "4ч 30м"
+    # header + 7 data rows + 5 version totals + 3 project totals + 1 grand total
+    assert ws.max_row == 17
+
+
+def test_xlsx_has_merged_cells(fake_rows, tmp_path):
+    """XLSX содержит объединённые ячейки по проектам и версиям."""
+    from openpyxl import load_workbook
+
+    output = tmp_path / "report.xlsx"
+    XLSXFormatter().save(fake_rows, str(output))
+
+    wb = load_workbook(str(output))
+    ws = wb.active
+    merged_ranges = [str(r) for r in ws.merged_cells.ranges]
+    # Проект A: 3 строки данных + 2 итога по версиям + 1 итог по проекту = строки 2-7
+    assert any("A2:A7" in r for r in merged_ranges)
+    # Версия v1.0 проекта A: 2 строки данных + 1 итог по версии = строки 2-4
+    assert any("B2:B4" in r for r in merged_ranges)
+
+
+def test_xlsx_has_totals(fake_rows, tmp_path):
+    """XLSX содержит итоги по версиям, проектам и общий итог."""
+    from openpyxl import load_workbook
+
+    output = tmp_path / "report.xlsx"
+    XLSXFormatter().save(fake_rows, str(output))
+
+    wb = load_workbook(str(output))
+    ws = wb.active
+
+    total_values = [ws.cell(row=r, column=6).value for r in range(2, ws.max_row + 1)]
+    # Проект A всего: 4.5 + 2 + 1 = 7.5
+    assert 7.5 in total_values
+    # Общий итог: 4.5 + 2 + 1 + 0 + 3.25 + 5 + 6.75 = 22.5
+    assert 22.5 in total_values
+    # Проверим числовой формат
+    assert ws["F2"].number_format == "0.00"
+
+
+def test_xlsx_no_time_keeps_columns_empty_and_skips_totals(fake_rows, tmp_path):
+    """XLSX с no_time: колонки времени пустые, итогов нет."""
+    from openpyxl import load_workbook
+
+    output = tmp_path / "report.xlsx"
+    XLSXFormatter(no_time=True).save(fake_rows, str(output))
+
+    wb = load_workbook(str(output))
+    ws = wb.active
+
+    # header + 7 data rows
+    assert ws.max_row == 8
+
+    # Колонки времени пустые для всех строк данных
+    for row in range(2, ws.max_row + 1):
+        assert ws.cell(row=row, column=6).value in (None, "")
+        assert ws.cell(row=row, column=7).value in (None, "")
+
+    # Итоговых строк нет
+    for row in range(2, ws.max_row + 1):
+        assert not str(ws.cell(row=row, column=1).value or "").startswith("Total")
+        assert not str(ws.cell(row=row, column=2).value or "").startswith("Total")
+
+    # Автофильтр и freeze panes на месте
+    assert ws.freeze_panes == "A2"
+    assert ws.auto_filter.ref == "A1:G8"
+
+
+def test_markdown_formatter_escapes_table_cells():
+    rows = make_fake_report_rows()
+    rows[0]["project"] = "A|B"
+    rows[0]["display_project"] = "A|B"
+    rows[0]["subject"] = "Fix | split\nline"
+
+    output = MarkdownFormatter().format(rows)
+
+    assert "A\\|B" in output
+    assert "101. Fix \\| split<br>line" in output
+
+
+def test_html_formatter_escapes_cells():
+    rows = make_fake_report_rows()
+    rows[0]["project"] = 'A&B "<Project>"'
+    rows[0]["display_project"] = rows[0]["project"]
+    rows[0]["subject"] = "Fix <tag> & attrs"
+
+    output = HTMLFormatter().format(rows)
+
+    assert "A&amp;B &quot;&lt;Project&gt;&quot;" in output
+    assert "101. Fix &lt;tag&gt; &amp; attrs" in output
+    assert "Fix <tag>" not in output
+
+
+def test_html_output_has_doctype_and_charset(fake_rows):
+    """HTML-отчёт содержит DOCTYPE и meta charset для корректной кодировки (#27)."""
+    output = HTMLFormatter().format(fake_rows)
+    assert "<!DOCTYPE html>" in output
+    assert '<meta charset="utf-8">' in output
+
+
+# -- Тесты ODT форматтера --
+
+
+def test_odt_formatter_returns_opendocument(fake_rows, odt_formatter):
+    """ODTFormatter.format() возвращает объект OpenDocument."""
+    result = odt_formatter.format(fake_rows)
+    assert isinstance(result, OpenDocument)
+
+
+def test_odt_empty_author_no_garbage_in_header(fake_rows):
+    """При пустом авторе заголовок не содержит мусорных символов (#30)."""
+    odt_bytes = _make_empty_odt_bytes()
+    mock_file = mock.MagicMock()
+    mock_file.__enter__ = mock.MagicMock(return_value=io.BytesIO(odt_bytes))
+    mock_file.__exit__ = mock.MagicMock(return_value=False)
+
+    with mock.patch(
+        "redmine_reporter.formatters.odt.resources.files",
+        return_value=mock.MagicMock(
+            joinpath=mock.MagicMock(
+                return_value=mock.MagicMock(open=mock.MagicMock(return_value=mock_file))
+            )
+        ),
+    ):
+        formatter = ODTFormatter(author="", from_date="2026-01-01", to_date="2026-01-31")
+        doc = formatter.format(fake_rows)
+
+        from odf.text import P
+
+        paragraphs = doc.text.getElementsByType(P)
+        header_text = paragraphs[0].firstChild.data
+
+        assert not header_text.startswith(".")
+        assert "Отчет за месяц" in header_text
+
+
+def test_odt_formatter_save_creates_valid_file(fake_rows, tmp_path):
+    """ODT можно сохранить -- файл валиден (сигнатура ZIP)."""
+    odt_bytes = _make_empty_odt_bytes()
+    mock_file = mock.MagicMock()
+    mock_file.__enter__ = mock.MagicMock(return_value=io.BytesIO(odt_bytes))
+    mock_file.__exit__ = mock.MagicMock(return_value=False)
+
+    with mock.patch(
+        "redmine_reporter.formatters.odt.resources.files",
+        return_value=mock.MagicMock(
+            joinpath=mock.MagicMock(
+                return_value=mock.MagicMock(open=mock.MagicMock(return_value=mock_file))
+            )
+        ),
+    ):
+        formatter = ODTFormatter(author="Тест", from_date="2026-01-01", to_date="2026-01-31")
+        output_file = tmp_path / "report.odt"
+        formatter.save(fake_rows, str(output_file))

    assert output_file.exists()
-    with open(output_file, "rb") as f:
-        assert f.read(2) == b"PK"  # сигнатура ZIP
+    assert output_file.read_bytes()[:2] == b"PK"  # сигнатура ZIP
+
+
+def test_odt_has_covered_cells_for_spans(fake_rows):
+    """ODT содержит covered-table-cell для замещённых ячеек при объединении (#13).
+
+    Тестовые данные (fake_rows):
+      Проект A: v1.0(2 задачи), v2.0(1) → project span=3
+        row1: project+version (0 covered)
+        row2: covered project + covered version (2)
+        row3: covered project + new version cell (1)
+      Проект B: <N/A>(1) → span=1, нет covered
+      Проект C: v1.0(1), v1.1(2) → project span=3
+        row5: project+version (0 covered)
+        row6: covered project + new version cell (1)
+        row7: covered project + covered version (2)
+      Итого: 6 covered cells
+    """
+    odt_bytes = _make_empty_odt_bytes()
+    mock_file = mock.MagicMock()
+    mock_file.__enter__ = mock.MagicMock(return_value=io.BytesIO(odt_bytes))
+    mock_file.__exit__ = mock.MagicMock(return_value=False)
+
+    with mock.patch(
+        "redmine_reporter.formatters.odt.resources.files",
+        return_value=mock.MagicMock(
+            joinpath=mock.MagicMock(
+                return_value=mock.MagicMock(open=mock.MagicMock(return_value=mock_file))
+            )
+        ),
+    ):
+        formatter = ODTFormatter(author="Тест", from_date="2026-01-01", to_date="2026-01-31")
+        doc = formatter.format(fake_rows)
+
+        from odf.table import CoveredTableCell
+
+        covered_cells = doc.getElementsByType(CoveredTableCell)
+        assert len(covered_cells) == 6
--- a/tests/test_report_builder.py
+++ b/tests/test_report_builder.py
@@ -1,6 +1,9 @@
-import pytest
-from redmine_reporter.report_builder import build_grouped_report, STATUS_TRANSLATION
-from redmine_reporter.utils import get_version
+from redmine_reporter.report_builder import (
+    STATUS_TRANSLATION,
+    build_grouped_report,
+    calculate_summary,
+    group_rows_by_project_and_version,
+)


 class MockIssue:
@@ -9,18 +12,35 @@ class MockIssue:
        self.project = project
        self.subject = subject
        self.status = status
-
        if fixed_version is not None:
            self.fixed_version = fixed_version


+# -- Таблица переводов статусов --
+
+
 def test_status_translation():
    assert STATUS_TRANSLATION["Closed"] == "Закрыто"
    assert STATUS_TRANSLATION["New"] == "В работе"
    assert STATUS_TRANSLATION["Resolved"] == "Решена"
+    assert STATUS_TRANSLATION["Pending"] == "Ожидание"


-def test_build_grouped_report():
+def test_status_translation_unknown_passthrough():
+    """Неизвестный статус возвращается как есть."""
+    from redmine_reporter.report_builder import STATUS_TRANSLATION
+
+    assert "SomeNewStatus" not in STATUS_TRANSLATION
+    # build_grouped_report вернёт оригинальное значение
+    issue = MockIssue("P", "S", "SomeNewStatus", "v1.0", 1)
+    rows = build_grouped_report([(issue, 1.0)])
+    assert rows[0]["status_ru"] == "SomeNewStatus"
+
+
+# -- Основная логика группировки --
+
+
+def test_build_grouped_report_grouping():
    issues = [
        (MockIssue("Камеры", "Фича A", "New", "v2.5.0", 101), 2.0),
        (MockIssue("Камеры", "Баг B", "Resolved", "v2.5.0", 102), 1.5),
@@ -29,17 +49,231 @@ def test_build_grouped_report():
    rows = build_grouped_report(issues)

    assert len(rows) == 3
-    # Первая строка — полное название проекта и версии
+    # Первая строка -- полное название проекта и версии
    assert rows[0]["display_project"] == "Камеры"
    assert rows[0]["display_version"] == "v2.5.0"
-    # Вторая — пустые display_* из-за совпадения
+    # Вторая -- пустые display_* из-за совпадения проекта+версии
    assert rows[1]["display_project"] == ""
    assert rows[1]["display_version"] == ""
-    # Третья — новый проект
+    # Третья -- новый проект
    assert rows[2]["display_project"] == "ПО"
    assert rows[2]["display_version"] == "<N/A>"

-    # Проверка перевода и времени
    assert rows[0]["status_ru"] == "В работе"
    assert rows[0]["time_text"] == "2ч"
+    assert rows[0]["hours"] == 2.0
    assert rows[1]["time_text"] == "1ч 30м"
+    assert rows[1]["hours"] == 1.5
+
+
+# -- #22: Сводка по времени --
+
+
+def test_calculate_summary_totals():
+    """Сводка содержит общее время и разбивку по проектам/версиям."""
+    rows = [
+        {
+            "project": "Камеры",
+            "version": "v2.5.0",
+            "issue_id": 101,
+            "subject": "Фича A",
+            "status_ru": "В работе",
+            "time_text": "2ч",
+            "hours": 2.0,
+        },
+        {
+            "project": "Камеры",
+            "version": "v2.5.0",
+            "issue_id": 102,
+            "subject": "Баг B",
+            "status_ru": "Решена",
+            "time_text": "1ч 30м",
+            "hours": 1.5,
+        },
+        {
+            "project": "ПО",
+            "version": "<N/A>",
+            "issue_id": 201,
+            "subject": "Доки",
+            "status_ru": "Ожидание",
+            "time_text": "4ч",
+            "hours": 4.0,
+        },
+    ]
+    summary = calculate_summary(rows)
+
+    assert summary["total"] == 7.5
+    assert summary["project:Камеры"] == 3.5
+    assert summary["project:ПО"] == 4.0
+    assert summary["version:Камеры::v2.5.0"] == 3.5
+    assert summary["version:ПО::<N/A>"] == 4.0
+
+
+def test_calculate_summary_empty():
+    """Сводка для пустого списка -- только total = 0."""
+    summary = calculate_summary([])
+    assert summary == {"total": 0.0}
+
+
+# -- #19: Общая функция группировки --
+
+
+def test_build_grouped_report_new_version_same_project():
+    """Смена версии внутри одного проекта -- display_project пустой, display_version новая."""
+    issues = [
+        (MockIssue("Камеры", "Задача 1", "New", "v1.0", 1), 1.0),
+        (MockIssue("Камеры", "Задача 2", "New", "v2.0", 2), 1.0),
+    ]
+    rows = build_grouped_report(issues)
+    assert rows[0]["display_project"] == "Камеры"
+    assert rows[0]["display_version"] == "v1.0"
+    assert rows[1]["display_project"] == ""
+    assert rows[1]["display_version"] == "v2.0"
+
+
+def test_build_grouped_report_sorts_input():
+    """Несортированный вход -- результат всё равно корректно сгруппирован."""
+    issues = [
+        (MockIssue("ПО", "Задача B", "New", "v1.0", 2), 1.0),
+        (MockIssue("Камеры", "Задача A", "New", "v1.0", 1), 2.0),
+    ]
+    rows = build_grouped_report(issues)
+    # После сортировки "Камеры" < "ПО" (лексикографически по кириллице)
+    assert rows[0]["project"] == "Камеры"
+    assert rows[1]["project"] == "ПО"
+    # Оба display_project непустые -- разные проекты
+    assert rows[0]["display_project"] == "Камеры"
+    assert rows[1]["display_project"] == "ПО"
+
+
+def test_build_grouped_report_empty():
+    """Пустой вход -- пустой результат, без исключений."""
+    rows = build_grouped_report([])
+    assert rows == []
+
+
+def test_build_grouped_report_no_time():
+    """fill_time=False -- time_text пустой для всех строк."""
+    issues = [(MockIssue("P", "S", "New", "v1.0", 1), 3.5)]
+    rows = build_grouped_report(issues, fill_time=False)
+    assert rows[0]["time_text"] == ""
+
+
+def test_build_grouped_report_preserves_issue_id_and_subject():
+    issues = [(MockIssue("P", "Моя задача", "Closed", "v1.0", 42), 0.5)]
+    rows = build_grouped_report(issues)
+    assert rows[0]["issue_id"] == 42
+    assert rows[0]["subject"] == "Моя задача"
+
+
+def test_build_grouped_report_deterministic_order_within_group():
+    """Задачи в одной группе проект+версия упорядочены по issue.id
+    независимо от порядка на входе (#33)."""
+    issues = [
+        (MockIssue("P", "Task C", "New", "v1.0", 103), 1.0),
+        (MockIssue("P", "Task A", "New", "v1.0", 101), 1.0),
+        (MockIssue("P", "Task B", "New", "v1.0", 102), 1.0),
+    ]
+    rows = build_grouped_report(issues)
+    assert [r["issue_id"] for r in rows] == [101, 102, 103]
+
+
+# -- #19: Общая функция группировки --
+
+
+def test_group_rows_basic():
+    """Два проекта, в одном две версии — структура корректна."""
+    rows = [
+        {
+            "project": "A",
+            "version": "v1",
+            "issue_id": 1,
+            "subject": "T1",
+            "status_ru": "S",
+            "time_text": "1ч",
+        },
+        {
+            "project": "A",
+            "version": "v2",
+            "issue_id": 2,
+            "subject": "T2",
+            "status_ru": "S",
+            "time_text": "2ч",
+        },
+        {
+            "project": "B",
+            "version": "v1",
+            "issue_id": 3,
+            "subject": "T3",
+            "status_ru": "S",
+            "time_text": "3ч",
+        },
+    ]
+    grouped = group_rows_by_project_and_version(rows)
+
+    assert list(grouped.keys()) == ["A", "B"]
+    assert list(grouped["A"].keys()) == ["v1", "v2"]
+    assert list(grouped["B"].keys()) == ["v1"]
+    assert len(grouped["A"]["v1"]) == 1
+    assert len(grouped["A"]["v2"]) == 1
+    assert len(grouped["B"]["v1"]) == 1
+
+
+def test_group_rows_multiple_tasks_per_version():
+    """Несколько задач в одной версии — все попадают в список."""
+    rows = [
+        {
+            "project": "A",
+            "version": "v1",
+            "issue_id": 1,
+            "subject": "T1",
+            "status_ru": "S",
+            "time_text": "1ч",
+        },
+        {
+            "project": "A",
+            "version": "v1",
+            "issue_id": 2,
+            "subject": "T2",
+            "status_ru": "S",
+            "time_text": "2ч",
+        },
+        {
+            "project": "A",
+            "version": "v1",
+            "issue_id": 3,
+            "subject": "T3",
+            "status_ru": "S",
+            "time_text": "3ч",
+        },
+    ]
+    grouped = group_rows_by_project_and_version(rows)
+
+    assert len(grouped["A"]["v1"]) == 3
+    assert [r["issue_id"] for r in grouped["A"]["v1"]] == [1, 2, 3]
+
+
+def test_group_rows_preserves_row_data():
+    """Строки в группировке — те же объекты, без потери данных."""
+    rows = [
+        {
+            "project": "P",
+            "version": "v1",
+            "issue_id": 42,
+            "subject": "Task",
+            "status_ru": "Готово",
+            "time_text": "5ч",
+        },
+    ]
+    grouped = group_rows_by_project_and_version(rows)
+
+    row = grouped["P"]["v1"][0]
+    assert row["issue_id"] == 42
+    assert row["subject"] == "Task"
+    assert row["status_ru"] == "Готово"
+    assert row["time_text"] == "5ч"
+
+
+def test_group_rows_empty():
+    """Пустой список — пустой словарь."""
+    assert group_rows_by_project_and_version([]) == {}
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -1,27 +1,112 @@
-import pytest
-from redmine_reporter.utils import hours_to_human, get_month_name_from_range, get_version
+from redmine_reporter.utils import (
+    get_month_name_from_range,
+    get_version,
+    hours_to_human,
+)


-def test_hours_to_human():
+def test_hours_to_human_zero():
    assert hours_to_human(0) == "0ч"
+    assert hours_to_human(-1) == "0ч"
+
+
+def test_hours_to_human_whole_hours():
    assert hours_to_human(1.0) == "1ч"
-    assert hours_to_human(2.5) == "2ч 30м"
+    assert hours_to_human(8.0) == "8ч"
+
+
+def test_hours_to_human_minutes_only():
    assert hours_to_human(0.75) == "45м"
-    assert hours_to_human(3.1666) == "3ч 10м"  # ≈ 3ч 10м
+    assert hours_to_human(0.5) == "30м"
+
+
+def test_hours_to_human_mixed():
+    assert hours_to_human(2.5) == "2ч 30м"
+    assert hours_to_human(1.5) == "1ч 30м"
+
+
+def test_hours_to_human_rounding():
+    assert hours_to_human(3.1666) == "3ч 10м"  # 190 минут -> 3ч 10м


 def test_get_month_name_from_range():
    assert get_month_name_from_range("2026-01-01", "2026-01-31") == "Январь"
-    assert get_month_name_from_range("2025-12-01", "2026-02-15") == "Февраль"  # берётся to_date
-    assert get_month_name_from_range("invalid", "also_invalid") == "Январь"  # fallback
+    assert get_month_name_from_range("2025-12-01", "2026-02-15") == "Февраль"


-def test_get_version():
+def test_get_month_name_from_range_all_months():
+    months = [
+        "Январь",
+        "Февраль",
+        "Март",
+        "Апрель",
+        "Май",
+        "Июнь",
+        "Июль",
+        "Август",
+        "Сентябрь",
+        "Октябрь",
+        "Ноябрь",
+        "Декабрь",
+    ]
+    for i, name in enumerate(months, start=1):
+        to_date = f"2026-{i:02d}-01"
+        assert get_month_name_from_range("2026-01-01", to_date) == name
+
+
+def test_get_month_name_from_range_invalid_fallback():
+    """Невалидная дата -- возвращается 'Январь'."""
+    assert get_month_name_from_range("invalid", "also_invalid") == "Январь"
+
+
+def test_get_version_with_attribute():
+    class MockIssue:
+        fixed_version = "v2.5.0"
+
+    assert get_version(MockIssue()) == "v2.5.0"
+
+
+def test_get_version_without_attribute():
    class MockIssue:
        pass
-    issue_with = MockIssue()
-    issue_with.fixed_version = "v2.5.0"
-    assert get_version(issue_with) == "v2.5.0"

-    issue_without = MockIssue()
-    assert get_version(issue_without) == "<N/A>"
+    assert get_version(MockIssue()) == "<N/A>"
+
+
+def test_get_version_none_attribute():
+    class MockIssue:
+        fixed_version = None
+
+    assert get_version(MockIssue()) == "<N/A>"
+
+
+def test_get_version_with_redminelib_version_object():
+    """redminelib Version: str() возвращает ID, .name — человекочитаемое имя."""
+
+    class MockVersion:
+        """Имитирует redminelib.resources.Version — str() даёт ID."""
+
+        def __init__(self, vid, name):
+            self.id = vid
+            self.name = name
+
+        def __str__(self):
+            return str(self.id)
+
+    class MockIssue:
+        fixed_version = MockVersion(42, "v2.5.0")
+
+    assert get_version(MockIssue()) == "v2.5.0"
+
+
+def test_get_version_falls_back_to_str_when_no_name():
+    """Если у объекта версии нет .name — fallback на str()."""
+
+    class MockVersionNoName:
+        def __str__(self):
+            return "fallback-id"
+
+    class MockIssue:
+        fixed_version = MockVersionNoName()
+
+    assert get_version(MockIssue()) == "fallback-id"
Author	SHA1	Message	Date
Кокос Артем Николаевич	222d31730e	feat(xlsx): make Excel export production-grade - Add merge cells for project/version groups. - Add numeric Hours column and human-readable Spent Time. - Add version/project/grand totals. - Apply auto-width, freeze panes, auto-filter and styling. - Respect --no-time: keep columns empty, skip totals. - Pass no_time flag through formatter factory to all file formatters. - Add tests for XLSX features and --no-time behavior. Closes #38	2026-06-29 14:41:37 +07:00
Кокос Артем Николаевич	86f083aa79	chore(release): bump version to 1.6.0 Bump version from 1.5.0 to 1.6.0 in __init__.py and pyproject.toml. Update test_cli_version_flag to assert against the current package version instead of a hardcoded string.	2026-06-29 12:38:54 +07:00
Кокос Артем Николаевич	a82be05b83	fix: handle empty time entries and add missing mypy override for openpyxl - Treat empty list from fetch_issues_with_spent_time as 'no entries' and exit 0 instead of crashing later in the pipeline. - Update CLI output-extension tests to use non-empty mock data so they actually reach the extension validation code path. - Add openpyxl to mypy ignore_missing_imports overrides. Closes #36	2026-06-29 12:21:44 +07:00
Кокос Артем Николаевич	ca89832d74	feat: JSON, Excel export and time summary - #23: add JSONFormatter and XLSXFormatter - add openpyxl dependency for .xlsx export - #22: add --summary flag and calculate_summary() in report_builder - ReportRow now carries raw hours for summary calculations - update CLI help and README with .json/.xlsx formats and --summary - add tests for new formatters and summary computation Closes #22, closes #23	2026-06-29 12:09:58 +07:00
Кокос Артем Николаевич	f6afc4096d	feat(cli): dynamic default range, --version, --verbose, --debug, --url, --api-key, --config - #17: default date range falls back to current month when .env dates are missing - #18: add --version, --verbose, --debug flags - #20: add --url, --api-key, --config CLI overrides - Config supports CLI overrides for URL/API key and explicit config file loading - Update README with new CLI options - Add tests for new flags and config overrides Closes #17, closes #18, closes #20	2026-06-29 12:02:51 +07:00
Кокос Артем Николаевич	738d9d543e	fix: mount retry adapter on Redmine engine session python-redmine exposes as a context manager, while the actual requests.Session lives in . Mounting the retry adapter on the wrong object caused: 'function' object has no attribute 'mount' on startup. Update the related test to mock the real session.	2026-06-29 11:53:09 +07:00
Артём Кокос	58fa5a7ab4	Add retry/backoff, timeout, and issue_id chunking to Redmine client - #24: Mount HTTPAdapter with Retry(total=3, backoff_factor=0.5) for HTTP 429/500/502/503/504 on the Redmine session, set 30s timeout - #21: Split large issue_id lists into chunks of 100 to avoid exceeding URL length limits on reverse proxies Closes #24, #21	2026-06-27 13:06:41 +07:00
Артём Кокос	14219564dd	Fix 9 bugs: ODT covered-cells, CSV BOM, HTML charset, stderr, dead code - #13 (critical): Add CoveredTableCell elements to ODT for valid row spans (ODF 1.2) - #28: Move "Total issues" info message from stdout to stderr (clean pipe output) - #27: Wrap HTML export in full document with DOCTYPE and meta charset utf-8 - #26: Save CSV with utf-8-sig encoding (UTF-8 BOM for Excel compatibility) - #31: Document CSV uses full project/version values (not display_* like console/MD) - #30: Fix ODT header formatting when author is empty (no leading dot/space) - #36: Remove test_cli_smoke_empty testing unreachable code path (return []) - #37: Remove unused mock_path variable in ODT test fixture - #34: Remove unreachable len(parts) != 2 check in parse_date_range Closes #13, #28, #27, #26, #31, #30, #36, #37, #34	2026-06-27 13:01:32 +07:00
Артём Кокос	da069993b9	Extract grouping logic into shared function (#19 ) Add group_rows_by_project_and_version() to report_builder.py and replace the duplicated inline grouping in both html.py and odt.py with a single call to the shared function. This ensures consistent grouping behavior across formatters and removes a maintenance burden — any change to grouping logic now happens in one place. Closes #19	2026-06-26 00:21:58 +07:00
Артём Кокос	dbc4cf960a	Fix version display, deterministic sort, remove duplicate sort get_version() now returns version.name instead of str(version), which returned the numeric ID from redminelib.resources.Version. Falls back to str() when .name is absent (#14). Add issue.id as tertiary sort key in build_grouped_report so tasks within the same project+version group always appear in the same order regardless of API response ordering (#33). Remove redundant sort from client.fetch_issues_with_spent_time — the sort already runs in report_builder.build_grouped_report, so doing it twice wastes CPU. Also remove the now-unused get_version import (#32). Closes #14, closes #32, closes #33	2026-06-25 23:32:14 +07:00
Артём Кокос	3a6d1b7ba7	Fix .env override priority and password whitespace stripping Change load_dotenv() to load_dotenv(override=False) so real environment variables always take priority over stale .env files. This prevents a hardcoded or outdated REDMINE_API_KEY in .env from silently overriding a fresh token exported in the shell (#15). Add .strip() to get_redmine_password() for consistency with all other config getters — trailing whitespace in .env no longer causes silent auth failures (#35). Closes #15, closes #35	2026-06-25 21:06:19 +07:00
Артём Кокос	3956decd4e	Fix package structure and lazy-import ODT formatter Add missing __init__.py to formatters/ so setuptools.find_packages includes the subpackage in wheel/sdist builds (#16). Move ODTFormatter import from top-level to lazy import inside get_formatter_by_extension() so missing odfpy no longer crashes module load before main() runs. Remove dead except ImportError handler in cli.py save() block; surface a clear 'odfpy is not installed' message when the formatter factory returns None for .odt (#25). Closes #16, closes #25	2026-06-25 20:42:13 +07:00
Кокос Артем Николаевич	0e4e0f3ee2	Bump version: v1.5.0	2026-05-22 17:49:18 +07:00
Кокос Артем Николаевич	2db0ab1f0b	Tighten configuration and export handling	2026-05-22 17:41:56 +07:00
Кокос Артем Николаевич	8bc8181ce3	Add Redmine API token authentication	2026-05-22 17:19:00 +07:00
Artem Kokos	7bc6e024c0	Quick fixes & tests	2026-03-28 23:55:46 +07:00
Кокос Артем Николаевич	06cd57e2c4	Blacked	2026-02-05 15:31:31 +07:00
Кокос Артем Николаевич	d7e927e6eb	Bump version: v1.4.1	2026-02-05 15:18:40 +07:00
Кокос Артем Николаевич	000bf37503	Update status map	2026-02-05 15:15:44 +07:00
Артём Кокос	dfb8d474b4	Update README.md	2026-01-26 21:03:24 +07:00