GenAudioBookInfo/wiki/Architecture.md

Архитектура

GenAudioBookInfo построен по принципам Чистой архитектуры (Clean Architecture / Hexagonal Architecture).
Бизнес-логика не зависит от внешних библиотек, баз данных или UI-фреймворков.

---

Слои

┌──────────────────────────────────────────────────────────┐
│  cmd/genaudiobookinfo/main.go   (Composition Root / DI)  │
├──────────────────────────────────────────────────────────┤
│  presentation/          TUI, ConsoleLogger, Presenter    │
├──────────────────────────────────────────────────────────┤
│  usecase/               Бизнес-логика. Нет зависимостей  │
│                         от infra, только интерфейсы      │
├──────────────────────────────────────────────────────────┤
│  domain/                Сущности + интерфейсы (порты)    │
├──────────────────────────────────────────────────────────┤
│  infrastructure/        Адаптеры: FS, HTTP, теги, YAML   │
└──────────────────────────────────────────────────────────┘

Зависимости направлены внутрь: main → usecase → domain ← infrastructure.

---

Структура папок

genaudiobookinfo/
├── cmd/
│   └── genaudiobookinfo/
│       └── main.go            # Точка входа, DI, TUI запуск
├── internal/
│   ├── domain/
│   │   ├── audiobook.go       # Агрегат AudioBookInfo, EnrichedBookInfo
│   │   ├── llm.go             # Интерфейс LLMClient
│   │   ├── ports.go           # Все порты: FolderLister, MetadataExtractor,
│   │   │                      #   TorrentSearcher, ResultWriter, CoverDownloader,
│   │   │                      #   ProcessLogger, ProcessResult
│   │   └── torrent.go         # Сущности TorrentInfo, TorrentDetail
│   ├── usecase/
│   │   └── scan_audiobooks.go # Конвейер (Pipeline + Fan-Out/Fan-In)
│   ├── infrastructure/        # Адаптеры (реализации портов)
│   │   ├── folder_lister.go       # FSFolderLister
│   │   ├── metadata_extractor.go  # TagMetadataExtractor (dhowden/tag)
│   │   ├── torrapi_client.go      # TorrAPIClient (HTTP)
│   │   ├── result_writer.go       # FSResultWriter (создание папок, JSON, копирование)
│   │   ├── cover_downloader.go    # HTTPCoverDownloader
│   │   ├── openrouter_client.go   # OpenRouterClient (LLM через REST)
│   │   ├── audio_utils.go         # Утилиты: длительность, формат, список файлов
│   │   ├── console_windows.go     # SetConsoleUTF8 для Windows
│   │   └── console_other.go       # Заглушка для non-Windows
│   ├── nameparser/
│   │   └── parser.go          # Разбор "Автор - Название" из имени папки
│   └── presentation/
│       ├── tui_logger.go      # TUILogger (Bubbletea, Dracula)
│       ├── console_logger.go  # ConsoleLogger (fallback без TUI)
│       └── console_presenter.go # Финальная сводка в stdout
├── config.yaml
├── go.mod
├── go.sum
├── Makefile
└── README.md

---

Интерфейсы (порты)

Определены в internal/domain/ports.go:

Интерфейс	Назначение	Адаптер
FolderLister	Перечислить подпапки	FSFolderLister
MetadataExtractor	Извлечь теги из аудиофайла	TagMetadataExtractor
TorrentSearcher	Поиск + детали раздачи	TorrAPIClient
ResultWriter	Записать результат на диск	FSResultWriter
CoverDownloader	Скачать обложку	HTTPCoverDownloader
LLMClient	Нормализовать автора/название	OpenRouterClient
ProcessLogger	Отчитываться о прогрессе	TUILogger / ConsoleLogger

---

Паттерны

Паттерн	Где применён
Pipeline	ExecuteForFolders → processOneBook → writer
Fan-Out / Fan-In	Worker Pool в ExecuteForFolders
Semaphore	searchSem — ограничение параллелизма к TorrAPI
Dependency Injection	main.go — Composition Root без фреймворка
Repository / Port-Adapter	Все infrastructure/ адаптеры
Strategy	ProcessLogger — TUI или Console выбирается в main.go
Graceful Shutdown	context.WithTimeout + signal.Notify (SIGINT, SIGTERM)

---

TUI (Bubbletea)

presentation/tui_logger.go реализует полноэкранный интерфейс:

• Верхняя панель: текущая книга, статус, прогресс-бар N / Total, спиннер, последние 5 событий
• Нижняя панель: полный лог с цветами (Dracula palette)

Цветовая схема:

Тип	Цвет
INFO	#00FFFF cyan
WARN	#FFFF00 yellow
ERROR	#FF5555 red
OK	#50FA7B green
DEBUG	#6272A4 gray