KS54 Platform — единая цифровая платформа колледжа

Практика

Frontend / platform engineering / архитектура / техническое лидерство

Текущая кульминация цифровой линии КС54: единая внутренняя платформа для образовательных, административных, документных и интеграционных процессов. Репозиторий начат в декабре 2025 как DocFlow и по мере роста вышел далеко за рамки документооборота; в сентябре 2026 продукт получил общее имя KS54 Platform, а DocFlow остался отдельным доменом внутри системы.

Контекст

DocFlow начинался как прикладной контур документооборота, но быстро вобрал образовательные, административные и сервисные процессы колледжа. Задача сместилась от развития отдельного модуля к построению общей платформы с понятными доменными границами.

Решение

Продукт разделён на самостоятельные домены поверх общего платформенного слоя. Frontend получил единые layout- и registry-контракты, backend — модульную маршрутизацию, RBAC, аудит и workers, а данные и файлы — отдельные управляемые контуры. Архитектурные решения фиксируются через ADR и проверяются контрактами CI.

Ограничения

Несколько предметных областей с разными жизненными циклами и ролями
Сосуществование новых модулей с legacy AIS и внешними интеграциями
Файлы, PDF, фоновые задачи и очереди требуют согласованного platform-layer
Миграции и релизы должны сохранять проверяемую историю действующей системы

Что изменилось

DocFlow сохранён как домен, а система получила общее имя KS54 Platform
Документы, образование, контингент, support и электронная очередь развиваются в одной архитектуре
Shared UI-контракты уменьшают расхождения между реестрами и рабочими местами
Новые миграции отделены от замороженной и проверяемой legacy-истории

Схема кейса

Карта доменной платформы

Интерфейсы

Workspaces
Registries
Detail views
Public flows

Домены

DocFlow
Education
Contingent
Support + EQueue

Platform core

RBAC + audit
Workers
FileCore
API contracts

Инфраструктура

PostgreSQL
S3
Integrations
CI + migrations

Обезличенная схема текущих контуров. Она объясняет архитектурный принцип без раскрытия интерфейсов и внутренних данных.

Контур работ

01
Прямое развитие Nuxt 4 / Vue 3 frontend: рабочие места, реестры, detail-экраны, shared layout и UI-контракты
02
Документооборот, справки и сертификаты, приказы/выписки, задачи и связанные document workflows
03
Контингент, посещаемость, электронный журнал, образовательные и воспитательные сценарии
04
Admission, электронная очередь, call/voice, support, публикации и публичные интерфейсы
05
Backend/API на PHP 8.3+ с доменными модулями, RBAC, аудитом, workers и фоновой обработкой
06
PostgreSQL/PgBouncer, Phinx migrations и сохранение проверяемой legacy migration history
07
FileCore и Selectel S3, генерация файлов/PDF, загрузки и документные артефакты
08
Интеграции MOS, Legacy AIS, VK, MAX, Telegram, mail и другие внешние контуры
09
Архитектурные правила, ADR, onboarding, testing/CI contracts и эксплуатационная документация

Технологии периода

Origin / DocFlow

09.12.2025 → 2026

Платформа формируется с декабря 2025 года: сначала как DocFlow, затем с быстрым расширением Nuxt frontend и прикладных контуров — контингента, support, профессиональных сертификатов и других модулей.

Frontend

Nuxt 4.5 / Vue 3.5 / Pinia 3 / TypeScript 5.9

Текущий frontend работает на Nuxt 4 и Vue 3, использует Pinia, Vue Router, Tabler/Iconify и собственные проектные UI-контракты. В репозитории зафиксированы shared registry/layout standards, PWA/mobile проверки и многочисленные frontend contract tests.

Backend & platform

PHP 8.3+ / PostgreSQL / PgBouncer / Phinx 0.16

Backend построен вокруг собственного Router / RouteRegister и доменных модулей, использует PostgreSQL, очереди/workers и постепенно выделенный platform-layer. Новые миграции идут через Phinx, а legacy SQL history заморожена и проверяется перед production migration pipeline.

Domain platform

DocFlow + Education + Contingent + Support + EQueue + FileCore + integrations

Платформа объединяет самостоятельные домены: документооборот, образование и журнал, контингент и посещаемость, задачи, электронную очередь, файлы, support, admission, публикации, сертификаты и внешние интеграции. DocFlow больше не обозначает систему целиком.

Product identity

DocFlow → KS54 Platform / 12.09.2026

ADR-0002 от 12 сентября 2026 фиксирует переименование продукта в KS54 Platform: система выросла за пределы документооборота, поэтому DocFlow сохранён как отдельный домен и legacy technical identifier, а не как название всей платформы.

Версии и даты отражают подтверждённые архивами, Git-историей или релизами состояния и не означают, что каждый компонент использовался во всех развёртываниях.