# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ОБРАБОТЧИК ВРЕМЕНИ
----------------------------------------------------------------------------

ОПИСАНИЕ
----------------------------------------------------------------------------

Обработчик времени управляет системой управления временем в BACH. Он предлагает
Функциональные возможности для отображения времени, таймеров, обратного отсчета и времени.
Управление профилями (Между). Все модули используют центральный TimeManager
для скоординированных операций.

Базовый каталог: data/ (файлы состояния)
Модули: инструменты/time_system.py


ОПЕРАЦИИ
----------------------------------------------------------------------------

ЧАСЫ
-----
  bach clock on              - Активировать отображение времени
  bach clock off             - Деактивировать отображение времени
  bach clock status          - Проверить состояние отображения времени
  bach clock interval <sek>  - Установить интервал отображения в секундах

ТАЙМЕР
-----
  bach timer start [name]    - Запустить таймер (по умолчанию: «по умолчанию»)
  bach timer stop [name]     - Остановить таймер
  bach timer list            - Показать все активные таймеры
  bach timer clear           - Все таймеры удалить

ОБРАТНЫЙ СЧЕТ
---------
  bach countdown start <name> <HH:MM:SS> [--after 'befehl']
                             - Начать обратный отсчет с помощью дополнительной команды
                               (Краткая форма: только <ЧЧ:ММ:СС> -> name="timer")
  bach countdown stop <name> - Countdown abbrechen
  bach countdown pause <name> - Countdown pausieren
  bach countdown resume <name> - Countdown fortsetzen
  bach countdown list        - Показать все обратные отсчеты

МЕЖДУ
-------
  bach between on            - Активировать между проверками
  bach between off           - Деактивировать между проверками
  bach between status        - Показать статус
  bach between use <name>    - Активировать профиль
  bach between profile list  - Список профилей
  bach between profile show <name> - Profil Details anzeigen

BEAT
----
  bach beat                  - Показать всю информацию о времени
  bach beat on               - Активировать все отображения времени
  bach beat off              - Деактивировать все отображения времени
  bach beat interval <sek>   - Глобальный набор интервал


ПРИМЕРЫ
----------------------------------------------------------------------------

# Запустить измерение таймера и запрос через 30 секунд
bach timer start work
# ... работа ...
bach timer stop work

# Обратный отсчет с сигналом тревоги: 5-минутный перерыв
bach countdown start pause 00:05:00 --after "echo Pause vorbei!"

# Загрузка между профилями (например, рабочие часы)
bach between status
bach between use office-hours

# Проверить статус глобального времени
bach beat
bach beat on           # Активировать все модули времени
bach beat interval 60  # Обновление каждые 60 секунд


ФАЙЛЫ
----------------------------------------------------------------------------

Состояние файлов (относительно системы/):

  data/.clock_state — настройки отображения времени
  data/.timer_state — Управление состоянием таймера
  data/.countdown_state — Управление состоянием обратного отсчета
  data/.between_state — между менеджером профилей

Модуль:

  hub/time.py — реализация обработчика
  инструменты/time_system.py — TimeManager, ClockModule, TimerModule,
                           CountdownModule, BetweenManager


СМОТРИТЕ ТАКЖЕ
----------------------------------------------------------------------------

  API базового обработчика: docs/help/base.txt
  Конфигурация: config/time_config.json
  Спецификация системы времени: docs/TIME-SYSTEM.md
  Управление профилями: docs/BETWEEN-PROFILES.md
