# Hermes Hub — Brand Guidelines (Официальный брендбук)

## 1. Назначение и миссия

**Hermes Hub** — единый центр управления (Control Hub) мульти-агентной и мульти-провайдерной экосистемой Hermes.
Приложение обеспечивает координацию автономных агентов (оркестраторы, кодеры, ревьюеры, исследователи), маршрутизацию запросов к языковым моделям через адаптеры (Google Antigravity, OpenAI Codex, OpenCode Go), контроль квот, отказоустойчивость (failover) и управление безопасностью учетных записей.

---

## 2. Философия и символика логотипа

Официальный знак Hermes Hub представляет собой гармоничную органическо-технологическую эмблему в золотом исполнении на благородном тёмно-зелёном фоне.

- **Центральная литера «H»** — ядро системы: Hermes Hub как центральный координирующий узел.
- **Корневая система (нижняя часть)** — фундаментальная инфраструктура Hermes, надежность, стабильность и локальное хранилище данных.
- **Ветви и плетения (верхняя часть)** — органический рост экосистемы, масштабируемость и взаимодействие мульти-агентных команд.
- **Функциональные узлы (сферы/точки на ветвях)** — специализированные субагенты, адаптеры провайдеров и сервисы.
- **Взаимосвязанная сеть линий** — динамическая маршрутизация запросов, session affinity, failover и потоки данных.
- **Внешний замкнутый круг** — целостность, безопасность, суверенность локального окружения пользователя и fail-closed защита.

---

## 3. Фирменная палитра (Brand Color Palette)

Интерфейс Hermes Hub строится по принципу **Dark-First** с глубокими природно-технологическими оттенками хвои, мха и благородного золота.

### 3.1. Основные цвета (Core Brand Colors)

| Токен | HEX | Название | Назначение |
|---|---|---|---|
| `PRIMARY` | `#0F1510` | Obsidian Forest | Глубокий базовый фон приложения (Window Background) |
| `DARK` | `#1A2A1F` | Deep Pine | Фон панелей, бокового меню (Sidebar), модальных окон |
| `SECONDARY` | `#2F4A36` | Moss Slate | Карточки (Cards), поверхности элементов, разделители |
| `LIGHT` | `#F7F1E3` | Warm Ivory | Основной цвет текста, контрастные заголовки, светлые акценты |
| `ACCENT` | `#CDAA64` | Ancient Gold | Акцентные кнопки, маркеры MAIN/Orchestrator, фокусы |

### 3.2. Семантические цвета состояний (Semantic & Operational Tokens)

Operational-цвета оптимизированы для мгновенного считывания статуса оператором, сохраняя гармонию с бренд-палитрой:

| Статус | HEX | Индикатор | Значение |
|---|---|---|---|
| `STATUS_HEALTHY` | `#2E7D32` | 🟢 Здоровый | Профиль/адаптер в строю, проверки пройдены |
| `STATUS_WARNING` | `#D97706` | 🟡 Внимание | Заканчивается квота, rate limit, деградация |
| `STATUS_ERROR` | `#DC2626` | 🔴 Ошибка | Сбой авторизации, недоступность сервиса, ошибка сети |
| `STATUS_AUTH_REQ` | `#E67E22` | 🔑 Требуется вход | Учетные данные отсутствуют или устарели |
| `STATUS_DISABLED` | `#5A6B5D` | ⚪ Отключен | Профиль деактивирован пользователем |
| `STATUS_FAILOVER` | `#3B82F6` | 🔄 Failover | Активный переход на резервный профиль |
| `STATUS_MAIN` | `#CDAA64` | ⭐ Основной | Главный аккаунт провайдера |
| `STATUS_ORCH` | `#E5C158` | 👑 Оркестратор | Главный координатор команды агентов |

---

## 4. Типографика (Typography)

### 4.1. Шрифтовые гарнитуры

- **Display / Акцидентный заголовок**: `Cinzel` / `Cinzel Decorative` (fallback: `Georgia`, `Cambria`, `Times New Roman`).
  - Используется строго для: логотипа, Splash Screen, диалога «О программе», главных заголовков экранов верхнего уровня.
- **UI / Основной интерфейс**: `Inter` (fallback: `Segoe UI`, `SF Pro Display`, `Arial`, `system-ui`).
  - Используется для всего рабочего интерфейса: навигация, кнопки, списки аккаунтов, карточки ролей, таблицы маршрутизации, метки состояний и журналы.
- **Моноширинный**: `JetBrains Mono` / `Consolas` / `Cascadia Code`.
  - Используется для: model identifiers, profile IDs, JSON, логов и маскированных email/ключей.

### 4.2. Иерархия размеров

- **Title Hero**: 22–26pt, Bold, `Cinzel` / `Segoe UI` (Accent Gold / Warm Ivory)
- **Section Heading (H1)**: 18–20pt, SemiBold (Warm Ivory)
- **Subheading (H2)**: 14–16pt, SemiBold (Warm Ivory / Gold)
- **Body Regular**: 12–13pt, Regular (Warm Ivory)
- **Body Secondary / Caption**: 10–11pt, Regular (`#889988` / Text Muted)
- **Badges & Micro**: 9–10pt, Bold (Text on Accent / Status)

---

## 5. Правила использования логотипа (Logo Usage Rules)

### 5.1. Допустимое использование
- Использование утверждённого символа `Hermes Hub.png` в высоком разрешении.
- Пропорциональное масштабирование с сохранением прозрачности или на фирменном фоне (`#0F1510` / `#1A2A1F`).
- Размещение на Splash Screen, в шапке окна «О программе», инсталляторе и официальной документации.
- Использование упрощённого контура для мелких иконок (16x16–48x48) с высокой читаемостью буквы «H».

### 5.2. Строго запрещено (Prohibited)
- ❌ Заменять центральную литеру «H» на другой символ или шрифт.
- ❌ Добавлять посторонние элементы (луну, солнце, шестерёнки, облака, не утверждённые брендбуком).
- ❌ Искажать пропорции (растягивать по горизонтали/вертикали).
- ❌ Перекрашивать золото в синие, фиолетовые или неоновые оттенки generic SaaS.
- ❌ Использовать мелкий детализированный логотип в местах, где он превращается в нечитаемый шум.

---

## 6. Windows-интеграция и ассеты иконок

Для нативного приложения сгенерирован единый контейнер `HermesHub.ico`, содержащий слои:
- `16x16` (Taskbar small, Tray, File details)
- `24x24` (Taskbar standard 125% DPI)
- `32x32` (Taskbar 100% DPI, Window title icon)
- `48x48` (Alt+Tab, Explorer medium tiles)
- `64x64` (Explorer large tiles, Start menu)
- `128x128` (High-DPI display, Start Menu large)
- `256x256` (Extra Large Icons, Master Windows layer)

Master PNG: `assets/branding/logo/logo_master.png` (1024x1024).
