izteamslots 1.1.0

package/.env.example

@@ -0,0 +1 @@
+BOOMLIFY_API_KEY=your_boomlify_api_key_here

package/CONTRIBUTING.md

@@ -0,0 +1,128 @@
+# Участие в разработке izTeamSlots
+
+Спасибо за интерес к проекту! Это руководство поможет начать.
+
+## Подготовка окружения
+
+1. Форкните репозиторий
+2. Клонируйте форк:
+   ```bash
+   git clone https://github.com/<your-username>/izTeamSlots.git
+   cd izTeamSlots
+   ```
+3. Установите зависимости:
+   ```bash
+   npm install
+   ```
+   Скрипт автоматически поставит Python 3.11+, [uv](https://docs.astral.sh/uv/), [Bun](https://bun.sh) и все зависимости.
+
+4. Создайте `.env` и добавьте ключи:
+   ```bash
+   cp .env.example .env
+   ```
+
+5. Создайте ветку:
+   ```bash
+   git checkout -b feat/my-feature
+   ```
+
+## Структура проекта
+
+```text
+izTeamSlots/
+├── backend/           # Python — бизнес-логика, браузерная автоматизация
+│   ├── mail/          # Почтовые провайдеры (плагины)
+│   ├── openai_web_auth.py
+│   ├── slot_orchestrator.py
+│   └── ui_facade.py
+├── ui/                # TypeScript — терминальный интерфейс (OpenTUI)
+│   └── src/
+├── bin/               # CLI entrypoint (npm bin)
+├── scripts/           # Setup-скрипты
+└── .github/workflows/ # CI/CD
+```
+
+## Линтеры
+
+Перед коммитом убедитесь что код проходит проверки:
+
+```bash
+# Python — ruff
+ruff check backend/
+
+# TypeScript — tsc
+npm run typecheck:ui
+```
+
+CI автоматически запускает оба линтера на каждый push и PR.
+
+## Conventional Commits
+
+Проект использует [Conventional Commits](https://www.conventionalcommits.org/):
+
+| Префикс | Назначение |
+|---------|-----------|
+| `feat:` | Новая функциональность |
+| `fix:` | Исправление бага |
+| `docs:` | Только документация |
+| `chore:` | CI, скрипты, зависимости |
+| `refactor:` | Рефакторинг без изменения поведения |
+
+Примеры:
+```
+feat: add IMAP mail provider
+fix: handle Oops error page during OAuth
+chore: update seleniumbase to 4.33
+```
+
+Версия бампается автоматически:
+- `feat:` — minor (1.x.0)
+- `fix:` / `chore:` — patch (1.0.x)
+- `feat!:` / `BREAKING CHANGE` — major (x.0.0)
+
+## Как внести вклад
+
+### Баг-репорты
+
+Откройте issue с:
+- Шаги для воспроизведения
+- Ожидаемое vs фактическое поведение
+- Версия Python, ОС, лог ошибки
+
+### Новая функциональность
+
+Откройте issue с описанием:
+- Какую проблему решает
+- Предлагаемое решение
+- К какому модулю относится
+
+### Pull Requests
+
+1. Один PR — одно логическое изменение.
+2. Следуйте Conventional Commits.
+3. Убедитесь что `ruff check` и `tsc --noEmit` проходят.
+4. Обновите документацию если изменение затрагивает пользовательское поведение.
+
+### Новый почтовый провайдер
+
+Наследуйте `MailProvider` из `backend/mail/base.py`:
+
+```python
+from backend.mail.base import MailProvider, Mailbox, Inbox
+
+class MyProvider(MailProvider):
+    name = "my_provider"
+
+    def generate(self) -> Mailbox:
+        ...
+
+    def inbox(self, mailbox: Mailbox) -> Inbox:
+        ...
+```
+
+Зарегистрируйте в `backend/mail/__init__.py` в фабричных функциях.
+
+## Важно
+
+- **Никогда** не коммитьте `.env`, `accounts/`, `codex/` — они в `.gitignore`.
+- Токены и профили хранятся только локально.

package/README.md

@@ -0,0 +1,249 @@
+<div align="center">
+
+# izTeamSlots
+
+**Менеджер ChatGPT Team слотов с авто-регистрацией через временную почту и обновлением Codex-сессий**
+
+[![CI](https://github.com/izzzzzi/izTeamSlots/actions/workflows/ci.yml/badge.svg)](https://github.com/izzzzzi/izTeamSlots/actions/workflows/ci.yml)
+[![Release](https://github.com/izzzzzi/izTeamSlots/actions/workflows/release.yml/badge.svg)](https://github.com/izzzzzi/izTeamSlots/actions/workflows/release.yml)
+[![npm version](https://img.shields.io/npm/v/izteamslots.svg?style=flat&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/izteamslots)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat&colorA=18181B&colorB=28CF8D)](LICENSE)
+[![Python](https://img.shields.io/badge/Python-3.11+-blue?style=flat&colorA=18181B&colorB=3776AB)](https://python.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?style=flat&colorA=18181B&colorB=3178C6)](https://www.typescriptlang.org/)
+[![Bun](https://img.shields.io/badge/Bun-runtime-orange?style=flat&colorA=18181B&colorB=FBF0DF)](https://bun.sh/)
+
+<br />
+
+<img src="img/demo.gif" alt="izTeamSlots demo" width="600" />
+
+</div>
+
+---
+
+## Обзор
+
+**izTeamSlots** — локальное приложение с архитектурой:
+
+- **Python backend** (бизнес-логика, браузерная автоматизация, storage);
+- **TypeScript OpenTUI frontend** (терминальный интерфейс оператора).
+
+---
+
+## Возможности
+
+- Управление админами: добавить, перелогинить, удалить, открыть браузерный профиль.
+- Пайплайн слотов: `создать почту -> инвайт -> регистрация -> OAuth-логин`.
+- Перелогин слотов: одного выбранного или всех по очереди.
+- Codex-файлы: авто-сохранение `codex-<email>-Team.json` в аккаунт и в `./codex/`.
+- Doctor-проверка: валидация/восстановление файловой структуры аккаунтов при старте.
+- Просмотр почты: входящие письма для админов и слотов.
+
+---
+
+## Структура проекта
+
+```text
+izTeamSlots/
+├── app.py                          # Entrypoint: запускает UI
+├── backend/                        # Весь Python-бэкенд
+│   ├── __init__.py                 # PROJECT_ROOT
+│   ├── __main__.py                 # python -m backend
+│   ├── account_store.py            # CRUD аккаунтов (JSON storage)
+│   ├── mail/                       # Почтовые провайдеры (плагины)
+│   │   ├── __init__.py             # Фабрики: create_provider, create_slot_provider
+│   │   ├── base.py                 # MailProvider ABC, Mailbox, Mail, Inbox
+│   │   ├── boomlify.py             # Boomlify Temp Mail API
+│   │   ├── trickads.py             # trickadsagencyltd.com temp mail
+│   │   └── imap.py                 # Любой IMAP-сервер
+│   ├── openai_web_auth.py          # Браузерная автоматизация (SeleniumBase)
+│   ├── chatgpt_workspace_api.py    # ChatGPT Workspace API через браузер
+│   ├── slot_orchestrator.py        # Оркестратор пайплайна слотов
+│   ├── dto.py                      # DTO для UI
+│   ├── jobs.py                     # Задачи в потоках
+│   ├── rpc_protocol.py             # JSON-RPC протокол
+│   ├── rpc_server.py               # RPC-сервер (stdio)
+│   └── ui_facade.py                # Фасад между RPC и бизнес-логикой
+├── ui/                             # TypeScript TUI (OpenTUI)
+│   ├── package.json
+│   └── src/
+│       ├── main.ts                 # Entrypoint UI
+│       ├── screens/MainScreen.ts   # Главный экран
+│       ├── transport/stdioClient.ts # JSON-RPC клиент
+│       └── menus/                  # Меню, таблицы, форматирование
+├── accounts/                       # Данные аккаунтов (runtime)
+├── codex/                          # Codex-файлы (runtime)
+└── README.md
+```
+
+---
+
+## Установка
+
+### npm (рекомендуется)
+
+```bash
+npm install -g izteamslots
+```
+
+Или запуск без установки:
+
+```bash
+npx izteamslots
+```
+
+### Из исходников
+
+```bash
+git clone https://github.com/izzzzzi/izTeamSlots.git
+cd izTeamSlots
+npm install
+```
+
+`npm install` / `postinstall` автоматически:
+- Проверит Python 3.11+
+- Установит [uv](https://docs.astral.sh/uv/) если его нет (быстрый Python package manager)
+- Установит Python-зависимости через uv (`seleniumbase`, `requests`)
+- Установит [Bun](https://bun.sh) если его нет + UI-зависимости
+- Создаст `.env` из `.env.example` если его нет
+
+> Chrome и chromedriver скачиваются автоматически при первом запуске через SeleniumBase.
+
+Если нужно перезапустить setup вручную:
+
+```bash
+npm run setup
+```
+
+### Настройка .env
+
+```bash
+# Temp mail API (обязательно для создания слотов)
+BOOMLIFY_API_KEY=your_api_key
+```
+
+Опциональные переменные:
+
+| Переменная | По умолчанию | Описание |
+|-----------|:------------:|----------|
+| `BOOMLIFY_DOMAIN` | авто | Домен для временных почт |
+| `BOOMLIFY_TIME` | `permanent` | Время жизни ящика |
+| `SLOT_MAIL_PROVIDER` | `boomlify` | Провайдер почты для слотов |
+| `MAIL_PROVIDER` | `trickads` | Провайдер почты для админов |
+
+## Запуск
+
+```bash
+# Глобальная установка
+izteamslots
+
+# Из исходников
+npm start
+```
+
+Это запустит OpenTUI frontend через **Bun**, который поднимет Python RPC backend (`python -m backend`) по `stdio`.
+
+---
+
+## Архитектура
+
+```mermaid
+flowchart TD
+    A[app.py] -->|spawns| B[bun ui/src/main.ts]
+    B --> C[MainScreen.ts]
+    C -->|stdio JSON-RPC| D[StdioRpcClient]
+    D -->|spawns| E[python -m backend]
+    E --> F[RPCServer]
+    F --> G[UIFacade]
+    G --> H[AccountStore]
+    G --> I[SlotManager]
+    I --> J[openai_web_auth]
+    I --> K[chatgpt_workspace_api]
+    I --> L[Boomlify Mail API]
+```
+
+## Почтовые провайдеры (плагины)
+
+Система почты построена на плагинах — абстрактный класс `MailProvider` и конкретные реализации.
+
+```mermaid
+flowchart TD
+    MP[MailProvider — абстрактный класс]
+    MP --> B[BoomlifyProvider]
+    MP --> T[TrickAdsProvider]
+    MP --> I[IMAPProvider]
+
+    CF[create_provider] -->|MAIL_PROVIDER env| MP
+    CSP[create_slot_provider] -->|SLOT_MAIL_PROVIDER env| MP
+    CPM[create_provider_for_mailbox] -->|по формату password| MP
+
+    style MP fill:#1e3a5f,color:#fff
+    style B fill:#1a4731,color:#fff
+    style T fill:#1a4731,color:#fff
+    style I fill:#1a4731,color:#fff
+```
+
+### Встроенные провайдеры
+
+| Провайдер | Модуль | Описание | Env-переменные |
+|-----------|--------|----------|----------------|
+| `boomlify` | `mail/boomlify.py` | Boomlify Temp Mail API (по умолчанию для слотов) | `BOOMLIFY_API_KEY`, `BOOMLIFY_DOMAIN`, `BOOMLIFY_TIME` |
+| `trickads` | `mail/trickads.py` | trickadsagencyltd.com temp mail (по умолчанию для админов) | — |
+| `imap` | `mail/imap.py` | Любой IMAP-сервер | `IMAP_HOST`, `IMAP_PORT`, `IMAP_SSL`, `IMAP_FOLDER` |
+
+### Фабричные функции
+
+- `create_provider(name)` — создаёт провайдер по имени (или `MAIL_PROVIDER` env, по умолчанию `trickads`)
+- `create_slot_provider(name)` — для слотов (`SLOT_MAIL_PROVIDER` env, по умолчанию `boomlify`)
+- `create_provider_for_mailbox(mailbox)` — автоопределение по формату пароля (если `boomlify:<uuid>` → Boomlify)
+
+### Свой провайдер
+
+Наследуйте `MailProvider` из `backend/mail/base.py` и реализуйте два метода:
+
+```python
+from backend.mail.base import MailProvider, Mailbox, Inbox
+
+class MyProvider(MailProvider):
+    name = "my_provider"
+
+    def generate(self) -> Mailbox:
+        # создать временный ящик, вернуть Mailbox(email, password)
+        ...
+
+    def inbox(self, mailbox: Mailbox) -> Inbox:
+        # получить письма, вернуть Inbox(email, messages=[Mail(...), ...])
+        ...
+```
+
+---
+
+## Пайплайн слотов
+
+```mermaid
+flowchart TD
+    S1[Создать временную почту] --> S2[Отправить инвайт через API]
+    S2 --> S3[Ожидать письмо с инвайт-ссылкой]
+    S3 --> S4[Регистрация по ссылке в браузере]
+    S4 --> S5[Ввод email / пароль / код подтверждения]
+    S5 --> S6[Заполнение имени и даты рождения]
+    S6 --> S7[Закрыть браузер регистрации]
+    S7 --> S8[OAuth PKCE логин]
+    S8 --> S9[Сохранить access_token и codex-файл]
+
+    style S1 fill:#1e3a5f,color:#fff
+    style S9 fill:#1a4731,color:#fff
+```
+
+---
+
+## Важно
+
+- Проект хранит токены и браузерные профили локально на диске.
+- Не публикуйте папки `accounts/` и `codex/` в публичные репозитории.
+- Для стабильной работы перелогина у worker должен быть `openai_password`.
+
+---
+
+## Участие в разработке
+
+См. [CONTRIBUTING.md](CONTRIBUTING.md).

package/app.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+import os
+import subprocess
+from pathlib import Path
+
+
+def main() -> int:
+    root = Path(__file__).resolve().parent
+    ui_dir = root / "ui"
+
+    if not ui_dir.exists():
+        raise RuntimeError("ui/ не найден")
+
+    bun_bin = os.environ.get("BUN_BIN", "bun")
+    env = {
+        **os.environ,
+        "IZTEAMSLOTS_AUTOMIGRATE_PROFILES": os.environ.get("IZTEAMSLOTS_AUTOMIGRATE_PROFILES", "0"),
+    }
+    cmd = [bun_bin, "run", "src/main.ts"]
+    return subprocess.call(cmd, cwd=ui_dir, env=env)
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/backend/__init__.py

@@ -0,0 +1,3 @@
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parent.parent

package/backend/__main__.py

@@ -0,0 +1,3 @@
+from .rpc_server import main
+
+raise SystemExit(main())