§01
Umumiy ko'rinish
- Bu nima: "Popper" — supervision/siyosat qatlami: AI dvigatelidan (deutsch) supervision so'rovlarini qabul qiladi, policy pack'larni (YAML DSL) qo'llaydi, HTV chegaralarini hisoblaydi va majburiy audit bilan qarorlar (approve/route/reject) chiqaradi. Karl Popper sharafiga nomlangan (rad etish epistemologiyasi — deutsch/HTV bilan umumiy mavzu). US healthtech platform ekotizimining bir qismi; umumiy protokol —
@regain/hermes. - Turi / holati / roli: api (siyosat/supervision dvigateli + server) · active · lead — foydalanuvchi asosiy muallif (112 kommitdan 72 tasi); US healthtech platform jamoasi: Anton Kim <anton@US healthtech platform> (18), Harsh Manwani (17), aniashev/Anna Shevtsova (8).
- Faollik davri: 2026-01-25 → 2026-02-14 — jadal ~3 haftalik sprint, faol. To'liq OSS skaffolding (LICENSE, VISION, GOVERNANCE, CODE_OF_CONDUCT, CONTRIBUTING, TRADEMARK, CERTIFICATION, PRD.md 51 KB).
§02
Stek
- Tillar: TypeScript (eng qat'iy tsconfig), SQL (TimescaleDB).
- Frameworklar/kutubxonalar: Bun 1.3+; Elysia.js (HTTP, apps/server); TimescaleDB (PostgreSQL 16, hypertable'lar) + Drizzle ORM; Turborepo; Biome 2 (lint/format); lefthook (git hook'lari);
@regain/hermes(kontraktlar uchun npm paket: turlar, AJV validatsiya, builder'lar, HTV utilitalari, fixtura'lar). apps: server, queue, web; packages: core (siyosat dvigateli + DSL parser), db, auth, cache. - Infra/deploy: ko'p-regionli — Helm ikki rejimli sirlar (KSA/Saudiya Arabistoni uchun HashiCorp Vault + US uchun AWS Secrets Manager), GitHub Actions deploy US + SA, AWS ECS (akkaunt migratsiyasi paytida ARN-rewrite bilan task definition'lar), OTEL/LGTM observability (Loki/Grafana/Tempo/Mimir). config/policies (YAML policy pack'lar), docs/specs (PRD + Popper/Hermes spetsifikatsiyalari).
- Ma'lumotlar: TimescaleDB (siqish / 7 yillik saqlash muddati / continuous aggregate'lar bilan time-series audit).
§03
Nima qilindi
Foydalanuvchi tomonidan yozilgan asosiy kommitlar (diff'lar bo'yicha) — asosan platforma/infra/boshqaruv:
- Data residency uchun ikki rejimli sirlar (
187423c, +528): Vault (KSA) va AWS Secrets Manager (US) uchun Helm qo'llab-quvvatlashi — regional data-residency talablariga javob beradi. - Ko'p-regionli CI/CD: AWS US deploy vorkflow (
b4cf6cb+124), Dockerfile yo'l tuzatishlari (56d6d5e), AWS akkaunt migratsiyasi paytida ARN-rewrite (86cb1bd,41714b6), server testlari uchun Turbo orqali DATABASE_URL (2d38ac1). - Observability: OTEL config/logging (
0e44db2,99631f8), SA deploy qo'llanmasidagi LGTM bo'limi (2a1c467). - Runtime: env qo'llab-quvvatlashi uchun bun compile'dan Bun runtime'ga o'tish (
3b7d546). - Siyosat dvigateli + Hermes kontraktlari: core (DSL parser, policy pack'lar),
@regain/hermesintegratsiyasi (supervision turlari, HTV). - Hajm: 3 hafta ichida 112 kommit; foydalanuvchi infra/deploy/boshqaruv bo'yicha lead.
§04
Texnik chellenjlar
Kod/diff'lar bo'yicha (foydalanuvchi mualliligi):
- Data residency bilan ko'p-regionli deploy (
187423c): bitta Helm chart, ikki sir rejimi — Vault (Saudiya Arabistoni, KSA) va AWS Secrets Manager (US) — shunda ma'lumotlar/kalitlar hech qachon regiondan chiqmaydi. → Jiddiy infra/compliance muhandisligi (tibbiy ma'lumotlar, alohida yurisdiktsiyalar). - Audit uchun TimescaleDB hypertable'lari (CLAUDE.md vorkflow): partition ustuni timestamp bilan kompozit PK, segment_by/order_by, 7 kundan keyin siqish, 7 yillik saqlash (audit), continuous aggregate'lar (soatlik dashboardlar / kunlik baseline'lar), real-time agregatsiya o'chiq. →
pg aiguideorqali olib borilgan puxta time-series dizayn. - Siyosat/supervision dvigateli (packages/core): YAML policy pack DSL parser, uni supervision so'rovlariga qo'llash, HTV chegaralari, audit bilan qarorlar. Kontraktlar
@regain/hermesorqali (AJV validatsiya, type guard'lar). → AI'ni nazorat qiluvchi boshqaruv dvigateli (mas'uliyatli AI). - Observability-first: har ikkala regionda OTEL + LGTM stek (Loki/Grafana/Tempo/Mimir). → Taqsimlangan tizim uchun production observability.
- Muhandislik madaniyati: eng qat'iy TS, Biome, lefthook, Turborepo, to'liq OSS boshqaruv to'plami.
§05
AI yordamida ishlab chiqish
- Topilgan sessiyalar: lokal Claude Code sessiyalar katalogida 0 (to'liq yo'lni normalizatsiya qilib tekshirilgan). API orqali testlash popper-cookbook (#51) da bajarilgan — sessiyalar o'sha yerda. CLAUDE.md MCP (
pg aiguide) va skill'lar (pg:setup-timescaledb-hypertables) bilan vorkflowni batafsil tasvirlaydi. - AI bilan nima qilingan: SAL-* tiketlar bo'yicha ishlab chiqish (supervision API va boshqalar), pg-aiguide MCP orqali DB dizayni.
- AI vorkflow patternlari: TimescaleDB sxema dizayni uchun MCP tooling, skill'lar, cookbook-asosli testlash, kontekst sifatida batafsil spetsifikatsiyalar/PRD. Yetuk AI-native jarayon.
§06
Yutuqlar va metrikalar
- Haqiqiy health-AI mahsuloti US healthtech platform uchun boshqaruv dvigateli; data residency bilan ko'p-region (KSA + US); 7 yillik saqlash bilan TimescaleDB audit; OTEL/LGTM observability; to'liq OSS hujjatlar to'plami (PRD 51 KB).
- 5 kishilik jamoa, foydalanuvchi infra/deploy/boshqaruv bo'yicha yetakchi muallif (72/112).