Александр Зимин
13 KiB
13 KiB
Состояние разработки Ordinis (ЦУОД ОДХ)
Версия: v2.14.0 (mega-sprint feature wave: 38 MRs за 2 дня, prod v2.8.0 → v2.14.0) Дата: 2026-05-12 (vespertine update — конец дня 2) Owner: zimin.an@nstart.space Окружения:
- prod (cluster.264, https://ordinis.k8s.264.nstart.cloud, ✅ LIVE v2.14.0, Альтум traffic stable)
- staging (cluster.265, dev environment) Предыдущий snapshot: 2026-05-07-state.md (v1.0.1, post-cutover hardening)
0. Что изменилось с v1.0.1 (2026-05-07 → 2026-05-12)
Mega-sprint feature wave
День 1 (2026-05-11): !108–!140 = 33 MRs merged (28 features + 3 chores + 1 closed zombie + 1 v2.11.x deploy pending). Tags v2.0.0 → v2.11.0. Highlights: backend pending endpoints (5/5 + extras), schema workflow API (8 endpoints) + Phase 1a/b/c UI, History tab wiring, TimeTravelModal fully wired, Monaco editor, friendly error UI, webhook stats dashboard.
День 2 (2026-05-12): !141–!147 = 7 MRs (5 merged + 2 design-only open). Tags v2.12.0 → v2.14.0. Focus shifted: feature shipping → polish + design proposals.
День 2 detail (focus этого state.md)
Polish features shipped:
- !141 → v2.12.0 RecordDrawer chip strip scroll-spy (IntersectionObserver active section highlight)
- !142 → v2.13.0 Searchable MultiSelect через cmdk + DateRangePicker (react-day-picker, lazy chunk 67kb gz)
- !143 → v2.14.0 Webhook delivery histogram (SVG stacked bar chart, 24h/7d toggle, hover tooltip)
Design proposals (3 docs, не implementation):
- !143 + !144 Redis FK projection design v1 → v2.1 после 2 rounds /plan-eng-review. NEAR-CLEAR. Sprint estimate 8.5d → 4-5d после
LineageIndexServicereuse decision. 15-test plan + 3 critical safety mitigations + 3-tier kill switch + explicit SLO targets. - !145 + !146 AI schema assist design v1 → v2 после /office-hours. Approach C-revised (hybrid template + per-field LLM) chosen over v1 whole-schema LLM. 7B model на consumer GPU. P5 measurement step как prerequisite. 3-4d implementation.
- !145 + !147 Dictionary marketplace design v1 → v2 после /office-hours + cross-model challenge. Approach C-revised (bundle hygiene 2-3d hard cap) chosen over v1 full marketplace (10-14d). Java handoff readiness + sales artifact angle. Anti-creep enforcement language.
Prod deploy v2.14.0:
- Pipeline 6700 (manual API trigger on tag)
- Bridge
trigger-deploy-prod(id=30851) — played - Downstream pipeline 6708 в ordinis-infra (project 368)
- Manual gate
deploy-prod(id=30893) — played - Helm rollout ~70s, no rollback
- Verified:
curl https://ordinis.k8s.264.nstart.cloud/api/v1/version→{tag: "v2.14.0", commit: "08c92627"}
0.1. New design proposals (decision artifacts)
Все три ждут measurement / customer event / GPU availability перед implement:
| Design doc | Status | Effort | Prerequisite | Defer rationale |
|---|---|---|---|---|
docs-internal/design/redis-fk-projection.md v2.1 |
CLEAR | 4-5d | Dict упрётся в latency SLA | Premature optimization, текущий read path handles RPS |
docs-internal/design/ai-schema-assist.md v2 |
CHOSEN (Approach C) | 3-4d | Baseline measurement 2 weeks + GPU verification | Demand evidence пока ZERO — founder-driven feature |
docs-internal/design/dictionary-marketplace.md v2 |
CHOSEN (Bundle hygiene C-revised) | 2-3d hard cap | Customer #2 ETA + signing key infra decision | Bundle hygiene proceeds Q3, full marketplace ждёт N=2 customers |
Design docs moved из docs/design/ → docs-internal/design/ per /docs/ scope discipline (public docs = integrator + operator + reviewer only, no engineering internals).
/office-hours formal docs:
~/.gstack/projects/claude/zimin-main-design-ai-schema-assist-20260512.md~/.gstack/projects/claude/zimin-main-design-bundle-hygiene-20260512.md
1. Стек / архитектура (без изменений с 2026-05-07)
Backend: Java 21 + Spring Boot 3.4.2 + JPA + Liquibase + PostgreSQL 18 + PostGIS + Kafka + Caffeine + Redis. Микросервисы: ordinis-app (writer), ordinis-read-api, ordinis-projection-writer, config-server. Outbox + Kafka publisher pattern, idempotency keys, audit log, valid_from/valid_to + EXCLUSION CONSTRAINT, data_scope filtering.
Frontend: React 19 + Vite 7 + TanStack Router + TanStack Query + Tailwind v4 + Radix primitives + cmdk + sonner toaster + @phosphor-icons/react + Monaco editor (lazy) + react-day-picker (lazy). Custom UI primitives только. @nstart/ui dropped (Stage 3.9).
Auth: Keycloak OIDC + JWT scope-based RBAC. realm_access.roles → DataScope (PUBLIC/INTERNAL/RESTRICTED). audience optional.
Infra: cluster.264 prod / cluster.265 staging. CNPG для PostgreSQL (single-instance, daily backups к S3 через geoportal-minio). Strimzi Kafka KRaft single broker. Vault (k8s auth). Redis для projection (per-dict opt-in feature flag).
2. Functional coverage matrix (updated)
2.1. UI features ✅ live на v2.14.0
| Feature | First shipped | Polish | Status |
|---|---|---|---|
| Schema workflow (draft → review → publish) UI | v2.5.0-v2.8.0 (Phase 1a/b/c) | — | ✅ live |
| TimeTravel modal (changes / records / schema tabs) | v2.10.0-v2.11.0 | — | ✅ live |
| History tab + Compare modal | v2.5.0 | — | ✅ live |
| Monaco editor для schema authoring | v2.8.0 | — | ✅ live |
| /reviews tabs (Записи / Схемы) | v2.8.0 | — | ✅ live |
| Friendly error UI (QueryErrorState, 10 sites) | v2.10.0 | — | ✅ live |
| Webhook stats cards (Pending/Retry/Delivered/DLQ + success rate) | v2.9.0 | — | ✅ live |
| Webhook stats histogram (SVG, 24h/7d) | v2.14.0 | — | ✅ live |
| RecordDrawer toolbar (search полей + только заполненные + scroll-spy chip strip) | v2.5.0-v2.12.0 | active section highlight | ✅ live |
| cmdk searchable MultiSelect (webhook events) | v2.13.0 | — | ✅ live |
| DateRangePicker (audit page) | v2.13.0 | — | ✅ live |
| Dark theme sweep (bg-white → bg-surface) | v2.6.0 | — | ✅ live |
| Mobile responsive (Sheet sidebar) | previously done | — | ✅ live |
2.2. Backend APIs ✅ live на v2.14.0
| Endpoint group | First shipped | Status |
|---|---|---|
| Dictionary CRUD + bitemporal records | v0.x | ✅ live |
| Schema workflow API (8 endpoints + audit) | v2.2.0 | ✅ live |
Full timeline /changelog с kind discrimination |
v2.3.x | ✅ live |
Diff endpoint /changelog/{entryId}/diff |
v2.4.0 | ✅ live |
PATCH /drafts/{id} (edit без recreate) |
v2.7.0 | ✅ live |
| Webhook subscriptions CRUD + DLQ + replay | v1.x | ✅ live |
Webhook stats /subscriptions/{id}/stats?bucketBy=hour|day |
v2.14.0 | ✅ live (NEW) |
2.3. Что НЕ shipped (design only)
| Feature | Doc | Status | Blocker |
|---|---|---|---|
| Redis FK projection cascade invalidation | docs/design/redis-fk-projection.md v2.1 |
CLEAR after 2 reviews | Dict latency SLA |
| AI schema assist (template + per-field LLM) | docs/design/ai-schema-assist.md v2 |
Approach C chosen | P5 measurement + GPU |
| Bundle hygiene (manifest + publisher CLI, NO UI) | docs/design/dictionary-marketplace.md v2 |
Approach C-revised chosen | Customer #2 ETA + signing key infra decision |
3. Backlog state (post-mega-sprint)
3.1. Active assignments (этой недели / следующих 2 weeks)
- P0 metric для AI schema baseline — add
admin.schema_authoring.secondsвDictionaryDefinitionService.createDraft(). Ship в v2.15.0 (~1h work). Critical: без этого нельзя decide P50 demand evidence для AI feature. - 2-weeks baseline collection на v2.14.0 prod. После — decision: P50 > 20 min → implement AI schema assist Phase 1 (3-4d), P50 < 10 min → defer AI, ship bundle hygiene (2-3d).
- GPU verification в k8s prod cluster (parallel с baseline collection). Talk to ops, confirm vLLM availability.
- Bundle signing key infrastructure decision с corp ops (GitLab CI variables protected vs Vault vs HSM). Document choice.
- Customer #2 ETA confirm — Альтум integration milestone, гидрометео preliminary discussion status. Informs marketplace urgency (не gates implementation though — bundle hygiene proceeds regardless).
3.2. Deferred (low priority)
| # | Item | Effort | Блокер |
|---|---|---|---|
| 1 | Phase 1d Keycloak roles в useCanReviewSchema/Publish |
~30 мин | infra не пробросила realm_access.roles в JWT |
| 2 | GitHub mirror sync (git subtree split --prefix=ordinis-admin-ui) |
1 мин | 2 weeks v2.14.0 stability observation |
| 3 | nsi-hot.md update v2.8.0 → v2.14.0 | 10 мин | low priority maintenance |
3.3. Roadmap (governance / data quality / federation, 2-3 quartals)
Без изменений с 2026-05-05-state.md:
- Approval workflow v2 (multi-step approval chain, BPM Camunda integration)
- Lineage / dependency graph
- Geo first-class (bbox/polygon query)
- Cross-dictionary FK cascade rules
- Data quality rules engine (cross-field constraints, ML-anomaly detection)
- Federation MDM-кластеров (master/replica)
- Schema registry (Apicurio/Confluent) для Kafka
- Webhooks для не-Kafka consumer'ов
4. Open risks (updated)
- Customer #2 acquisition velocity — marketplace + AI assist designs assume timeline. Если customer #2 не появляется в Q3 — design docs sit, no rework needed но opportunity cost real.
- P5 measurement may invalidate AI assist hypothesis. Baseline P50 < 10 min → 30мин «admin pain» субъективна, feature defer'нется. Cost = ~1h metric work, low risk.
- GPU availability в prod cluster uncertain. Если нет — AI schema assist requires either: external API за feature flag (compromise data perimeter для non-classified), procurement new GPU node (delay weeks-months), or skip feature entirely.
- Bundle hygiene scope creep risk. Hard cap 2-3 days с anti-creep enforcement language — but founder discipline ultimate enforcement. PR review rule: reject additions outside «what ships» list.
- CHANGELOG.md bundling в frontend (v2.14.0 «Что нового» feature) — main bundle вырос 394kb → 427kb (+33kb / +13kb gz). CHANGELOG растёт ~500 bytes per release. Через 100 releases это ~50kb extra. Acceptable now, может потребовать lazy-load или backend endpoint в будущем.
5. Naming / branding state
- Repo:
ordinis(wasnsi) - Product display: «Ordinis» английский / «Ордин» русский (rare)
- Customer #1: ЦУОД ОДХ (anchor)
- Bundle ID convention:
<domain>.<vertical>.<bundle-name>(e.g.ru.cuod.dzz-ground-segment) - Tag scheme: semver
vMAJOR.MINOR.PATCH, auto-bumped via semantic-release - Prod URL: https://ordinis.k8s.264.nstart.cloud
- Swagger: https://ordinis.k8s.264.nstart.cloud/swagger-ui.html
- Docs: https://ordinis.k8s.264.nstart.cloud/docs/ (mkdocs)
6. Workflow patterns (operational learnings, this session)
- GitLab deploy gate sequence: trigger pipeline → play
trigger-deploy-prodbridge → play downstreamdeploy-prodjob. Three separate explicit confirmations. GITLAB_HOST=git.nstart.cloudenv var нужен дляglab apicalls (default goes к gitlab.com).glab mr viewworks without (uses git remote).- Manual API pipeline trigger для prod deploy (semantic-release bot pipelines skip CI).
glab api -X POST projects/367/pipeline?ref=v{TAG}. - Cross-model challenge in /office-hours Phase 3.5 critical — каждый раз когда engaged surface'нул substantial issues missed by single-model reasoning. Marketplace session was strongest example: my pure-defer recommendation overcorrected, subagent caught 4 misses, final synthesis better than either pure position.
Резюме
- Prod v2.14.0 live на cluster.264. 6 minor versions shipped в один день (v2.8.0 → v2.14.0). 38 MRs total за 2 дня.
- Three design proposals documented с explicit prerequisites + measurement steps + hard caps. None implementation. Defer recommendations stand.
- Главный риск для дальнейшего product development — не technical, а demand signal. AI assist / marketplace требуют customer pull или measurement evidence перед dev investment.
- Next concrete action: ship metric
admin.schema_authoring.secondsв v2.15.0 (~1h work), затем 2 weeks observation.
Прогноз до next major release decision (v3 vs v2.x): ~2-4 weeks pending baseline measurement results + customer #2 conversation outcomes.