◆ iSeeMore Platform

Hub + Microservices · portal.iseemore.ru · Сотрудник = центральная точка
Готово
Прототип
Следующий
Планируется
Hub
Сервис
Внешний
v2.1 · 18 февраля 2026

Портал-Хаб + Микросервисы

Портал — тонкая оболочка: авторизация, оргструктура, навигация, дашборд. Каждый функциональный блок — отдельный сервис со своим API. Стержень — оргструктура. Конечная точка — сотрудник.

👤

Сотрудник = точка сборки

Все данные привязаны к человеку. Открываешь карточку — видишь всё, что к нему относится из доступных тебе сервисов.

🌳

Оргструктура = общий ресурс

Дерево сотрудников одно на всех. Каждый сервис добавляет свой слой данных поверх одной и той же иерархии.

🔒

Видимость = по роли + отделу

Каждый отдел видит структуру через свою линзу. РМ видит KPI, отдел обучения видит тренинги, логистика видит маршруты.

🧩

Независимые сервисы

Сломался KPI — отчёты работают. Обновляешь чек-листы — тикеты не затронуты. Каждый модуль живёт своей жизнью.

Portal Hub
Auth · JWT · Оргструктура
Уведомления · Дашборд
📊
Отчёты
Excel → визуализация
🎯
KPI Planner
Планы · Бонусы · Прогноз
🏷
Trade Marketing
Промо · Акции
📨
Тикеты
Обращения · SLA
✅
Чек-листы
Маршруты · Фото
🎓
Обучение
Прототип · 7 экранов
🛟
support.
Уже работает
💰
price.
Уже работает
Карточка сотрудника — данные из разных сервисов
ИП

Иванов Пётр Сергеевич

Торговый менеджер · Москва-Центр · Таб. №4521

Данные из сервисов (видимость зависит от роли зрителя)
🏗 Hub · Оргструктура
Роль: ТМ
Руководитель: Сидоров А. (РМ)
Подчинённые: 4 СВ, 12 ТП
🎯 Сервис KPI
План: 4.2M₽ · Факт: 3.8M₽
Выполнение: 91% · Бонус: 73%
Прогноз на месяц: 96%
📊 Сервис Отчёты
ХБИ: 87% · ХДС: 72%
Матрица: 91% · Полка: 65%
🎓 Сервис Обучение
Тренинги: 3/5 пройдено
Следующий: «Работа с возражениями» 22.02
✅ Сервис Чек-листы
Сегодня: 8/12 визитов
Фото: 6 загружено
📨 Сервис Тикеты
Открытые: 2 обращения
#451 логистика · #467 качество
Принцип видимости: РМ Сидоров видит все 6 слоёв. Отдел обучения видит только «Оргструктура» + «Обучение». Логистика видит «Оргструктура» + «Тикеты (логистика)». Каждый сервис фильтрует данные через JWT и access_grants из Hub.
🏗 Portal Hub (Ядро) Hub Готово
✓ JWT авторизация (телефон + пароль)
✓ 8 ролей: head, rm, tm, sv, tp, coordinator, kam, admin
✓ Матричная оргструктура (user_relations)
✓ Доступ по ролям (access_grants)
✓ Уведомления (агрегатор)
✓ Дашборд с плитками модулей
✓ KPI-бар (чипы в шапке, моки)
✓ Адаптивный UI: телефон → планшет → десктоп
✓ PWA + Service Worker
✓ Шаблон оргструктуры (Excel, 177 сотрудников)
○ Админ-панель: CRUD 400+ сотрудников
○ Импорт из Excel по email (корп. email = ключ)
○ Auth v2: email + пароль
○ API: дерево подчинённых, список, карточка
FastAPI
PostgreSQL 16
Redis 7
Vanilla JS SPA
Docker
:9090
📊 Сервис: Отчёты Сервис Следующий
○ Загрузка Excel-отчётов (API)
○ Парсинг и нормализация данных
○ Визуализация: таблицы, графики
○ Фильтрация по роли через JWT
○ Оргструктуру берёт из Hub API
○ Данные → KPI-бар в Hub (виджеты)
Свой контейнер
Своя БД / схема
JWT из Hub
Потребитель: KPI, Hub-дашборд
🎯 Сервис: KPI Planner Сервис Прототип
✓ Алгоритм v2 (distributePlanV2) — JS прототип
✓ UI прототип (React + Vite)
✓ Бонусная шкала (калькулятор)
✓ Документация (18 стр.)
○ Алгоритм → Python/FastAPI (свой контейнер)
○ Модели: kpi_plans, daily_sales, forecasts
○ Workflow: директор → расчёт → РМ ±20% → утверждение
○ Видимость: каждый видит свой уровень (через Hub API)
○ Интрамесячный прогноз (K_dow)
○ Отдаёт данные для KPI-чипов в Hub
Свой контейнер
Python + FastAPI
Своя БД / схема
Celery (тяжёлые расчёты)
Зависит от: Отчёты
🏷 Сервис: Trade Marketing Сервис Планируется
○ Создание промо-акций
○ Согласование: ТМ → РМ → Директор
○ Календарь акций
○ Привязка к ТТ (данные из KPI-сервиса)
○ Отчёт по эффективности
Свой контейнер
Зависит от: KPI (ТТ)
📨 Сервис: Тикеты Сервис Планируется
○ Обращения: логистика, качество, ИТ, HR
○ Маршрутизация по ответственным
○ Статусы + SLA + уведомления в Hub
○ Замена Telegram-ботов
Свой контейнер
Замена: TG-бот логистики
Замена: TG-бот качества
✅ Сервис: Чек-листы Сервис Планируется
○ Шаблоны для ТП/СВ
○ Ежедневные задачи по маршруту
○ Фото-отчёты с геолокацией
○ Аналитика выполнения → Hub-дашборд
Свой контейнер
Камера + GPS
🎓 Сервис: Обучение Сервис Прототип
✓ UI-прототип интерфейса тренера (7 экранов)
✓ Прототип SCORM-плеера курсов
✓ Прототип PPTX-просмотрщика курсов
✓ Тестовый курс «Работа с возражениями» (PPTX)
○ Оргструктуру берёт из Hub API
○ Назначение тренингов по сотрудникам/группам
○ Календарь + планировщик групп
○ Электронные анкеты (pre/during/post/retention)
○ Матрица обучения сотрудников
○ Данные → профиль сотрудника, бонус KPI
Свой контейнер
Отдел обучения
SCORM / PPTX
Интеграция: KPI (бонус)
🛟 support.iseemore.ru Внешний Работает
✓ Веб-портал поддержки
✓ Telegram miniapp
○ Интеграция с Hub (SSO, виджет)
Отдельный сервер
Будущее: SSO через Hub
💰 price.iseemore.ru Внешний Работает
✓ Price Monitor (веб)
✓ APK (Kotlin, RuStore)
○ Интеграция с Hub (SSO, виджет)
Отдельный сервер
Kotlin APK
Матрица видимости: кто что видит в карточке сотрудника
Кто смотрит Оргструктура KPI / План Отчёты Обучение Чек-листы Тикеты Промо
Директор (head) ✓ ✓ ✓ ✓ ✓ ✓ ✓
РМ ▼ ▼ ▼ ▼ ▼ ▼ ▼
ТМ ▼ ▼ ▼ — ▼ — ▼
СВ ▼ ▼ ▼ — ▼ — —
ТП Я Я Я Я Я Я —
Отдел обучения ✓ — — ✓ — — —
Отдел качества ✓ — — — — ✓ —
Логистика ✓ — — — — ✓ —
Trade Marketing ✓ ▼ ▼ — — — ✓
✓ Полный доступ (все сотрудники)
▼ Свой уровень и вниз
Я Только свои данные
— Нет доступа
Как это работает технически
1️⃣
Пользователь логинится в Hub
Hub выдаёт JWT-токен с: user_id, role, region_id, department. Токен единый для всех сервисов.
2️⃣
Сервис получает запрос + JWT
Валидирует токен (секрет общий). Из JWT знает роль и ID. Запрашивает у Hub API дерево подчинённых если нужно.
3️⃣
Сервис фильтрует данные
Возвращает только те данные, которые относятся к сотрудникам в дереве подчинения пользователя. Офисный отдел видит всех, но только свой слой.
Февраль 2026 · Неделя 1–2
Фаза 0 — Hub: Фундамент
Ядро портала-хаба: авторизация, оргструктура, матричная модель, деплой
FastAPI + PostgreSQL + Redis + Docker Compose
8 ролей, матричные связи, access_grants
SPA: модули, команда, профиль, уведомления
Деплой → portal.iseemore.ru + SSL
Адаптивный UI + KPI-бар с моками
Прототип KPI Planner (React, отдельно)
Февраль 2026 · Неделя 3–4
Фаза 1 — Hub: Админ + API оргструктуры
Админ-панель для управления 400+ сотрудниками, API для сервисов
CRUD сотрудников + Excel-импорт по табельному
API: /api/org/tree/{user_id} — дерево подчинённых
API: /api/org/employees?role=®ion= — фильтрация
Auth v2: табельный номер + код от координатора
Март 2026 · Неделя 1–2
Фаза 2 — Сервис: Отчёты
Первый микросервис: Excel-отчёты → визуализация, фильтрация по ролям
Отдельный контейнер, своя БД/схема
API загрузки + парсинг Excel
Визуализация: таблицы, графики
JWT-фильтрация → каждый видит своё
Виджет для Hub-дашборда + KPI-чипы
Март 2026 · Неделя 3–4
Фаза 3 — Сервис: KPI Planner
Перенос прототипа в продакшн-сервис, workflow согласования
Алгоритм v2 → Python, свой контейнер
Workflow: директор → расчёт → РМ ±20% → утверждение
Бонусная шкала привязана к реальным людям
Видимость через Hub API оргструктуры
Апрель 2026
Фаза 4 — Прогноз + Trade Marketing
Интрамесячный прогноз (K_dow, скользящее среднее)
Алерты и нотификации
Сервис Trade Marketing (промо + акции)
Май–Июнь 2026
Фаза 5 — Тикеты + Чек-листы + Обучение
Сервис Тикеты (замена TG-ботов)
Сервис Чек-листы (маршруты, фото, GPS)
Сервис Обучение (тренинги, тесты)
SSO интеграция: support, price → Hub
1
Hub (ядро)
6
Микросервисов
2
Внешних
400+
Сотрудников
12K
Торговых точек
Инфраструктура (Production)
🖥 TerraMaster
ProxMox
→
🌐 NPM
LXC контейнер
→
🐧 Debian 12
192.168.0.92 · aaPanel
→
🐳 Docker Compose
все контейнеры
→
🔒 portal.iseemore.ru
SSL · NPM proxy
Docker Compose — текущее состояние
Hub: PostgreSQL
16-alpine
Hub: Redis
7-alpine
Hub: FastAPI
Python 3.11
Hub: Nginx
alpine → :9090
Целевая архитектура (добавляются по мере разработки)
Hub API
Auth + Оргструктура
Hub DB
PostgreSQL 16
Redis
Общий кэш + сессии
Nginx Gateway
Роутинг по /api/*
svc-reports
Отчёты API
svc-kpi
KPI Planner API
svc-tickets
Тикеты API
svc-training
Обучение API
svc-checklists
Чек-листы API
svc-promo
Trade Marketing API
Контракт между Hub и сервисами
Hub → Сервис
JWT токен (user_id, role, region)
GET /api/org/tree/{user_id}
GET /api/org/employees?filters
POST /api/notifications (от сервиса)
Сервис → Hub
Виджет для дашборда (JSON)
KPI-чипы (значения для top-bar)
Уведомления (push в Hub)
Бейдж-каунтеры (непрочитанное)
Nginx Gateway
/api/auth/* → Hub
/api/org/* → Hub
/api/reports/* → svc-reports
/api/kpi/* → svc-kpi
/* (фронтенд) → Hub static
Экосистема iSeeMore
portal.
Hub + Сервисы
support.
Поддержка
price.
Price Monitor
APK
Kotlin · RuStore
TG Bot
→ Тикеты
TG Bot
→ Тикеты