§01
Umumiy ko'rinish
- Bu nima: Astervis — telefoniya / kontakt-markaz sohasidagi startap (build-in-public, pitch dekklari bilan). Self-hosted mahsulot maxsus Go installer orqali mijoz serverlariga (PBX/Asterisk) deploy qilinadi; SaaS dashboard, litsenziyalash, AI funksiyalari (AI Gateway, embeddinglar) va to'liq marketing dvigateli (landing, blog, video, B2B outreach, analitika) mavjud. Bu "hammasi o'zimizniki": mahsulot, yetkazib berish infratuzilmasi, GTM tooling.
- Turi / holati / roli: web-app (SaaS + self-hosted) · faol (oxirgi kommit 2026-05-26) · solo (286 ta kommitdan 248 tasi foydalanuvchiniki; 42 tasi Ilhombek2110).
- Faollik oynasi: 2025-10-24 → 2026-05-26, ~7 oy zich ishlanma, tirik. IZOH: asosiy mahsulot kodi (
astervis/) va sayt (astervis_sale_new/) git submodullarda (alohida repolar) joylashgan, shu sababli 286 ta meta-repo kommiti haqiqiy hajmni JIDDIY ravishda kamaytirib ko'rsatadi — bu yerda asosan Go installer, dizayn hujjatlari, submodul bumplari va pitch ko'rinadi.
§02
Stek
- Tillar: TypeScript (ilovalar uchun asosiy), Go (installer), SQL (Drizzle/Postgres), JS.
- Freymvorklar/kutubxonalar:
- Frontend: Next.js 16 (App Router), React 19, Tailwind CSS 4, shadcn/ui, next-intl (ru/en/uz).
- Backend: Bun ustidagi Elysia.js, PostgreSQL + Drizzle ORM, Redis; API
bun build --compileorqali yagona binarga kompilatsiya qilinadi. - Auth: Better Auth + RBAC (Google/GitHub OAuth).
- AI: Vercel AI SDK (
@ai-sdk/google|anthropic|openai), alohidaai-gatewayilova (Elysia, port 4000),ai-worker,ai-core(Zod sxemalari/promptlar/provayderlar) vaai-evalspaketlari. - Go installer: Cobra CLI, charmbracelet/huh (TUI formalar), pterm, lego/v4 (ACME/Let's Encrypt), go-redis, lib/pq, go-toml.
- Video: Remotion (promo/IG karusellarni dasturiy generatsiyalash).
- Edge: Cloudflare Workers (installer binarlarini R2 orqali CDN tarqatish, wrangler).
- Infra/deploy: Turborepo + Bun v1.3.2 monorepo; Docker Compose (asosiy mahsulot); GitHub Actions (
installer-release.ymlinstaller-v*teglarida → cross-platform binar build → R2 + GitHub Release);curl … | bashorqali bir qatorli o'rnatish; subdomen provizioning uchun DNSimple. Pitch dek generatsiya qilingan PDF sifatida (port 3005). - Ma'lumotlar: PostgreSQL, Redis, TimescaleDB (installerda
timescaledb_databor), CDC connector (change data capture). - E'tiborga molik tooling: repoda kuchli AI tooling —
.claude/,.codex/,.agents/,.mcp.json,skills-lock.json,AGENTS.md; GA4, GSC, Polar (to'lovlar), LinkedIn, Twitter/X, Instagram, Blog, B2B outreach uchun marketing CLI.
§03
Nima qilindi
Xulosalar kod/difflardan (kommit matnidan emas). Meta-repoda foydalanuvchi yozgan kod asosan Go installer + dizayn hujjatlari + release plumbing:
- Go installer (bu yerdagi asosiy yozilgan kod): 2026 aprel–may davomida ~25 ta release (v0.0.57 → v0.0.74).
internal/modullari:docker(compose, health, diskspace, iptables-recovery, compose migration),ssl(Let's Encrypt + remote),license(token, fingerprint, verify, state),cdc/connector,sangoma/firewall_watchdog,wizard(TUI),agent+api(port 9876 dagi REST agent, certificate_renewal, update_manager, license_checker). - Dizayn hujjatlari/rejalar: Open Lines uchun WhatsApp kanali — dizayn spetsifikatsiyasi (
8731f32, +753) + implementatsiya rejasi (536618f, +4049); AI narxlash redizayn rejasi (75bf32a, +209); HA migratsiya runbook. - Release infra: CI workflow_dispatch escape-hatch (
e023868), binar tarqatish uchun Cloudflare Worker. - Katta tooling drop:
ae140f4(177 fayl, +31084) — submodul + hujjatlar + tooling. - Mahsulot submodul bumplari: o'nlab
Update astervis submodule to v1.0.19x…208— mahsulot alohida repoda faol rivojlanmoqda (WhatsApp kanali, ai-gateway embedding tracking va h.k.). - Hajm: 7 oy davomida 286 ta meta-repo kommiti (248 tasi foydalanuvchiniki) + submodullardagi ko'rinmas hajm (mahsulot v1.0.208 ga yetdi — ~200+ release).
§04
Texnik chellenjlar
- Docker iptables ni avtomatik tiklaydigan idempotent self-hosted deploy (
447d789, installer v0.0.74,internal/docker/):iptables: No chain/target/match by that namexatosida (firewalld/nftables qayta yuklanishi Docker demoniningDOCKERNAT zanjirini o'chirib yuborgan), installer buni aniqlaydi (IsDockerIptablesError), demonni qayta ishga tushiradi (RestartDockerDaemon— systemctl → service fallback,context.WithTimeout(90s)bilan), 8s kutadi vaupni bir marta qayta uradi; ishga tushirishdan oldin har doimdocker compose down(-vsiz) bajaradi — bu 5432/6380/9092 portlarni ushlab turgan qotib qolganCreatedkonteynerlarni tozalaydi. Muvaffaqiyatsizlikda — xom stack trace o'rniga inson o'qiy oladigan ko'rsatma. → Ko'rsatadi: Docker networking/iptables ni chuqur tushunish, host darajasidagi barqarorlik, idempotentlik, ehtiyotkorona xato UX. Kuchli DevOps/Go signali. - Installerda networking/infra chekka holatlari (CHANGELOG/difflardan):
host.docker.internalloopback MySQL rezolyutsiyasi (04c3333); backend konteyneri uchun MySQL bind 0.0.0.0 + remote-grant (c8ba8d4); faqat IP rejimi uchun Let's Encrypt (b9b5ed9); docker bo'limiga qarshi disk precheck (d08b4b5); timescaledb_data ning rekursiv chown i (d8b5a81); litsenziya fingerprint uchun pinned-MAC hack o'rniga/etc/machine-idni mount qilish (82765d8); Sangoma firewall watchdog — host darajasidagi NAT tiklash (a1211ea, +206). → Aralash Linux muhitlarida (Ubuntu/Debian/CentOS/RHEL/Sangoma/FreeBSD) real operatsiyalar. - Self-hosted mahsulot litsenziyalash (
internal/license/): token + fingerprint + verify + state —/etc/machine-idorqali apparatga bog'lash bilan anti-piratlik. → Mahsulot fikri (on-prem monetizatsiya). - Uch qatlamli binar tarqatish: CI (teglar bo'yicha GitHub Actions) → Cloudflare Worker (R2 dan CDN) → API (
/api/releasesmetadata +install.shbootstrap). → Self-hosted dasturiy ta'minot uchun to'liq supply chain. - Kompilatsiya qilingan Elysia.js API (
bun build --compileyagona binarga) + Better Auth orqali RBAC +/api/plansda DNSimple orqali subdomen provizioning. → Zamonaviy edge / Bun stack, nostandart production tanlovlar. - AI qatlami alohida ilovalar/paketlar sifatida (
apps/ai-gatewayElysia,packages/ai-coreZod + provayderlar,ai-evals,ai-worker): fazalar bo'yicha strukturalangan AI roadmap (docs/ai-research/roadmap/phase-{0-5}), embedding tracking. → AI funksiyalari uchun yetuk arxitektura, "ChatGPT ni ustidan tiqib qo'ydim" emas.
§05
AI yordamida ishlab chiqish
- Topilgan sessiyalar: loyiha ildizi uchun 21 ta
.jsonl(plyus monorepo submodul yo'llari uchun 6 ta ichma-ich kodlangan katalog:…-astervis,…-astervis-sale-new,…-apps-api,…-packages-db,…-installer,…-scripts-polar— lekin transkriptlar ildizda to'plangan). Jami ~43k transkript qatori — juda yuqori intensivlik. - AI bilan nima qilindi: AI roadmap bo'yicha ishlanma, installer (infra tuzatishlari), dizayn hujjatlari (WhatsApp kanali spec/reja), marketing avtomatlashtirish, pitch.
- AI vorkflow patternlari: yetuk, tizimli AI-yetakchi dev — repo
AGENTS.md,skills-lock.json(skills to'plami lock i),.mcp.json(MCP serverlar), multi-tooling (.claude/+.codex/+.agents/= Claude Code + Codex + boshqalar) ni pin qiladi. CLAUDE.md lug'at, port xaritasi, majburiy skilllar (/ai-sdk,/ai-elements,/vercel-react-best-practices) ni belgilaydi va har qanday vazifadan oldin roadmap ni o'qishni talab qiladi. "AI-native" ishlanma jarayonining namunaviy misoli.
§06
Yutuqlar va metrikalar
- Monorepo miqyosi:
astervis_sale_new/appsda 7 ta ilova (admin, ai-gateway, ai-worker, api, docs, pitch-deck, web) + 14 ta umumiy paket (ai-core, ai-evals, analytics, auth, cache, cli, db, email, entities, ui, intercom…); asosiy mahsulotastervis/(backend, new_admin, queue, replication, nginx) v1.0.208 ga yetdi. - Installer OS qo'llab-quvvatlashi: Ubuntu, Debian, CentOS, RHEL, Sangoma Linux, FreeBSD; cross-compilation + checksumlar.
- Installer relizlari: ~2 oyda ~18+ versiya (v0.0.57→0.0.74).
- GTM infra: GA4, GSC, Polar, LinkedIn, Twitter, Instagram, Intercom, PostHog bilan integratsiyalar.