Skip to content

moldabayevd/ZhasActivity

Repository files navigation

Zhas Activity

Корпоративная платформа вовлечения и AI-карьерного матчинга для молодых сотрудников (18-35) холдинговой структуры. Внутренний продукт АО «Казахтелеком», разработанный с расчётом на тиражирование по портфельным компаниям АО «Самрук-Қазына».

Status Pilot Audience Stack

О продукте

Zhas Activity объединяет в одной платформе:

  • Управление мероприятиями (волонтёрство, хакатоны, кейс-чемпионаты, talent track активности)
  • Бальную систему и рейтинг с неизменяемым ledger
  • Кадровый резерв с тирами Bronze → Silver → Gold → Diamond
  • Deep Hub: геймификация, достижения, мерч-магазин, чат, обучение
  • AI-карьерный матчинг на собственной LLM-инфраструктуре Самрук
  • Мультиязычность: RU / KK / EN

Продукт ориентирован на сегмент 18-35 лет как наиболее цифрово-зрелую и подверженную риску оттока часть штата холдинга.

Текущий статус

Параметр Значение
Стадия Demo-ready MVP, переход к продакшен-харденингу
Backend модулей 15 (auth, activities, deep, talent_reserve, scoring, leaderboard, moderation и др.)
Mobile Flutter, iOS + Android релиз-сборка
Admin Web React + TypeScript
Готовность к пилоту ~75% (требуется SSO, прод-LLM, security audit, нагрузочное)
Целевой запуск пилота 3 месяца, 5,000 сотрудников КТ
Целевой бюджет пилота ~111M ₸ ($207k)

Бизнес-документация

Документ Что внутри
📄 Бизнес-план пилота на 3 месяца (PDF) Полная заявка для CDO КТ и Samruk Digital: команда, бюджет, риски, тираж
📝 Бизнес-план пилота (Markdown) Тот же документ в редактируемом виде
📊 Обзор продукта (Russian) Полное описание модулей и архитектуры

Архитектура

┌─────────────────────────────────────────────────────────┐
│                    Пользователи                          │
│   Mobile (Flutter)        │     Admin Panel (React)      │
└──────────┬────────────────┴──────────────┬───────────────┘
           │           REST API            │
           └──────────────┬────────────────┘
                          │
              ┌───────────▼───────────┐
              │   FastAPI Backend     │
              │   /api/v1             │
              ├───────────────────────┤
              │ Auth │ Activities     │
              │ Scoring │ Leaderboard │
              │ Moderation │ Deep Hub │
              │ Talent Reserve       │
              │ Analytics │ Audit    │
              └──────────┬───────────┘
                         │
              ┌──────────▼──────────────────┐
              │  PostgreSQL │ S3 │ Redis    │
              │  LLM (Samruk infra: H200)   │
              └─────────────────────────────┘

Стек технологий

Слой Технологии
Mobile Flutter, Riverpod, GoRouter, Dio
Backend Python 3.12, FastAPI, SQLAlchemy 2.0, Alembic, psycopg3
Admin Web React, TypeScript, Vite
Data PostgreSQL, MinIO/S3, Redis (production)
AI/LLM Самрук H200-кластер (open-source LLM), vision моделирование
Infra Docker, Yandex Cloud KZ / собственная инфра Самрук
Auth JWT, корпоративный AD/SSO КТ (production)

Структура репозитория

.
├── mobile/          # Flutter приложение (iOS + Android)
├── backend/         # FastAPI модульный монолит
├── admin-web/       # React админ-панель
├── docs/            # Документация
│   ├── business/    # Бизнес-планы и расчёты
│   ├── architecture/# Системная архитектура
│   ├── api/         # API контракты
│   ├── data/        # ERD, модели данных
│   ├── product/     # Продуктовые требования
│   ├── ops/         # Деплой, демо, релиз
│   └── security/    # RBAC, политики безопасности
├── infra/           # Docker compose для локальной разработки
└── scripts/         # Helper скрипты для разработки

Команда

Проект ведут два Co-Founders:

Co-Founder Роль Профиль
Dauren Moldabayev Co-Founder, Product Lead Senior AI Engineer, АО «Казахтелеком». Архитектор и руководитель разработки.
Abylaikhan Sermakhan Co-Founder, Head of Adoption Председатель Жас Телекома, АО «Казахтелеком». Стратегия принятия и коммуникация с молодёжной аудиторией.

Подробнее в бизнес-документе, раздел 10.

Запуск локально

Требования

  • Docker Desktop
  • Python 3.12+
  • Node.js 20+
  • Flutter 3.24+, Dart 3.5+

1. Инфраструктура (PostgreSQL + MinIO)

docker compose -f infra/docker/docker-compose.yml up -d

2. Backend

cd backend
cp .env.example .env       # Linux/Mac
# copy .env.example .env   # Windows
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# .venv\Scripts\activate   # Windows
pip install -e .[dev]
alembic upgrade head
python -m app.db.seed
uvicorn app.main:app --reload --host 0.0.0.0

API доступен на http://localhost:8000, Swagger на /docs.

3. Admin Web

cd admin-web
cp .env.example .env
npm install
npm run dev

Открывается на http://localhost:5173.

4. Mobile

cd mobile
flutter pub get
flutter gen-l10n
flutter run --dart-define=API_BASE_URL=http://localhost:8000/api/v1

Для Android-эмулятора используй http://10.0.2.2:8000/api/v1 вместо localhost.

Демо-аккаунты

Логин Пароль Роль
admin.central Admin123! Полный администратор
coord.almaty Coord123! Региональный координатор
aruzhan.sadykova Employee123! Сотрудник, Deep Hub разблокирован
dauren.moldabaev Employee123! Senior AI Engineer, Gold тир, AI матчинг
leader.viewer Leader123! Просмотр для руководства
audit.viewer Audit123! Аудит-доступ

Roadmap

  • MVP функционал - мероприятия, баллы, кадровый резерв, Deep Hub
  • Мультиязычность RU/KK/EN
  • Mobile релиз-сборки iOS + Android
  • Бизнес-документация для пилота
  • Production hardening (SSO с AD КТ, реальный LLM, security audit)
  • Пилот на 5,000 сотрудниках КТ (3 месяца)
  • Полное развёртывание КТ (18,000 сотрудников)
  • Multi-tenancy refactor для тиража
  • Тираж по портфелю Самрук-Қазына (5-7 компаний за 18 мес)
  • Модуль менторства для сегмента 35+

Документация (детально)

Лицензия и доступ

Внутренний продукт АО «Казахтелеком». Репозиторий приватный. Доступ выдаётся участникам команды и согласованным стейкхолдерам.

Контакты

Dauren Moldabayev - Product Lead LinkedIn · GitHub · daurenmoldabaev99@gmail.com

About

Корпоративная платформа вовлечения и AI-карьерного матчинга для молодёжи 18-35 в холдинге Самрук-Қазына. FastAPI + Flutter + React + LLM на H200.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors