10 Katmanlı Mimari Kanban — Eğitim Notları

Web tarayıcı ana erişim, offline'a dirençli

• Service Worker — istek cache, offline fallback
• manifest.json — add-to-home + ikon seti
• IndexedDB queue — offline aksiyon buffer
• Background Sync API — bağlantı dönüşte gönder

Flowbite tabanlı, Tailwind utility-first

• Flowbite 2.5 — modal, drawer, dropdown, table
• Phosphor — ikonografi (CDN)
• Custom tokens — CSS variables (renk, spacing)
• Roboto 300+ — min 1rem text disiplini

Cihaz spektrumuna uyum

• Container queries — component-level responsive
• Tailwind sm/md/lg/xl — sayfa-level grid
• Touch + hover — input modalite ayrımı

White-label per-tenant brand

• CSS değişken katmanı — --c-brand-{50..900}
• Logo + ikon override — tenant manifest'inden
• Dark mode — opsiyonel toggle
• E-mail şablonu — aynı paletten render

Çok dilli içerik + UI

• Locale catalog — JSON (TR + EN baz)
• Lazy load — locale başına bundle
• Browser locale — auto-detect + fallback

v0.2 — backlog

• Monorepo — paylaşılan UI tokenları
• Native modüller — kamera, biometric, push
• OTA update — Expo update channel

Tek VPS için tek binary çözüm

• TLS auto — Let's Encrypt + ZeroSSL
• HTTP/3 — QUIC native
• Tenant subdomain — *.tenant.framework.io
• Custom domain — CNAME mapping (managed)

Tahtada daire içindeki kritik bant

• JWT/session doğrulama — yazma uçları zorunlu
• CSRF token — double-submit cookie
• tenant_id enjeksiyonu — her sorguya zorlanır
• Idempotency-Key — POST tekrar koruması

Kötüye kullanım + cost guard

• Redis token bucket — sliding window
• Per-tenant + per-endpoint — quota
• Anonim IP-based — baseline
• AI endpoint özel — token / dakika

CSP + clickjacking + HSTS

• CSP — script + img kaynak whitelist
• X-Frame-Options — iframe yasak default
• HSTS — preload
• Permissions-Policy — kamera/mikrofon gate

MinIO origin + Caddy edge cache

• Bucket prefix — tenant başına yol
• Image transform — boyutla on-the-fly
• Signed URL — private asset

Cloudflare frontmost — büyürken

• Bot management — challenge ladder
• OWASP rule set — SQL/XSS guard
• Geo block — gerekirse

Tahtada kırmızı — birincil backend

• uvicorn async worker — N×CPU
• Pydantic v2 — input/output şema
• OpenAPI 3.1 — otomatik üretim
• Dependency injection — port adapter swap

CRUD jeneratörü ile otomatik

• Doctype → REST — entity tanımından üretilir
• Pagination + filter + sort — standart query
• OData-benzeri DSL — ?filter=...&sort=...
• HATEOAS opsiyonel — discovery link

TS SDK paketi (npm registry)

• End-to-end tip güvencesi — schema → TS
• Auto-generated client — build pipeline
• tRPC tarzı imza — Pydantic'tan üretim

Karma/document veri için opsiyonel

• Field-level perm — RBAC entegre
• DataLoader — N+1 koruma
• Persisted query — production safe

Bildirim + agent stream

• Notification channel — toast, alert
• Agent token stream — LLM tool-call SSE
• Live form validation — server-side check
• Connection reverse-proxy — Caddy ws upgrade

Feature başına dilim — AI üretmesi kolay

• Controller + business + view bir arada
• Saf use-case fonksiyonu — framework-free
• Test edilebilirlik — pytest fixture'larıyla

AI agent yürütme motoru

• Tool-calling loop — XML/JSON tool çağrısı
• Planning + reflection — multi-step görev
• Memory — kısa (context) + uzun (vector)
• Human-in-loop — onay döngüsü UI
• Cancellation — kullanıcı durdurabilir

No-code akış kuralları

• Event listener registry — domain event'lere bağlanır
• Condition evaluator — rule DSL (JsonLogic veya custom)
• Action dispatcher — başka context çağırır
• Audit'li — her tetiklenme log

Uzun süren async görevler

• State machine — pending → running → done
• Retry + backoff — exponential
• Timeout — DLQ'ya düşürme
• Resumable — kaldığı yerden devam

Cron + on-demand iş kuyruğu

• Cron entry points — kayıtlı schedule'lar
• Priority queue — yüksek-düşük
• DLQ — başarısız iş gözü
• Worker pool — VPS'te ayrı process

Auth + kim ne yapabilir

• User, Tenant, Role, Permission — ana varlıklar
• RBAC + ABAC — rol + attribute kombinasyon
• Session, AuthToken — JWT + refresh
• OAuth provider hooks — Google, GitHub, SSO
• SCIM — gelecek enterprise provisioning

Drupal Field / Frappe Custom Field

• Runtime alan tanımı — UI'dan
• Tip sistemi — string, number, ref, json
• Validation — alan başına kural
• Migration runner — JSONB veya ALTER TABLE

Tek kaynak şema — DB + API + TS

• Schema-first — YAML veya code-first
• Code generator — TS tip + Pydantic + Prisma
• Versioning — semver per schema

Entity + revisions + audit

• Doctype tanımları — Frappe modeli
• Revisions — versiyon tut, geri al
• Taxonomy ağacı — hierarchical tag
• Workflow state — draft / review / published

Drupal Layout Builder benzeri

• Region + section + block — hiyerarşi
• Components → Builder — reusable block
• Theme override stack — tenant + brand katmanı
• Conditional visibility — rol + tenant + locale

Hybrid arama policy'si

• Per-entity index policy — alanlar + ağırlık
• Faceted query model — filter agregat
• Reciprocal Rank Fusion — BM25 + vector

Plugin lifecycle yönetimi

• Manifest model — name, version, hooks, perms
• Lifecycle hooks — install, enable, disable, uninstall
• Dependency resolver — topological install
• Plugin API stability — SemVer + deprecation

Managed Cloud edition için

• Subscription + plan — Stripe Billing
• Usage metering — token, agent run, storage
• Quota enforcement — soft + hard limit
• Invoice + dunning — overdue akışı

Hexagonal port — model swap ucuz

• Anthropic Claude — birincil
• OpenAI — alternatif
• Ollama / vLLM — self-host
• Streaming + retry + timeout
• Cost tracking — token sayacı

Tenant-aware kayıtlı agentlar

• System prompt yönetimi — versioned
• Tool registry — agent'a erişim verilen kapılar
• Allowed contexts — whitelist
• Per-tenant prompt override

Doc → chunk → vector

• Chunking — semantic split + overlap
• Embed (provider) — text-embedding
• Upsert — pgvector veya Qdrant
• Reindex cron — değişen entity

BM25 + vector kombinasyonu

• Elastic BM25 — keyword skoru
• pgvector cosine — semantic skoru
• RRF fusion — tek liste döndür
• Re-ranker (ops.) — Cohere/Voyage

Git-backed versiyonlama

• Markdown prompt'lar — repo'da kayıtlı
• A/B test framework — variant skor
• Tenant override — özel istemler

Tüm LLM çağrıları kayıtlı

• Log entry per call — input + output + maliyet
• PII detection — input mask
• Output sanitization — yasaklı içerik kontrol
• Per-tenant cost dashboard

Request → tenant_id

• Subdomain — birinci tercih
• Path-based — //... fallback
• Custom domain — CNAME → tenant
• Header override — admin tooling için

Per-tenant CSS variable seti

• Color tokens — --c-brand-{50..900}
• Logo + favicon — asset key
• Email template — başlık + logo
• Dark mode opt-in

Veri sızıntısı imkansız

• MinIO bucket prefix — tenant key altında
• Signed URL TTL — kısa süre
• Storage quota — plan başına

Self-service signup workflow

• Signup form — slug + plan seçim
• Migration runner — yeni tenant tabloları
• Welcome email — onboarding link
• Tour — Onboarding plugin tetiklenir

Feature flag + soft/hard limit

• Plan → feature set — JSON/DB tanımı
• Counter — Redis (token, request, storage)
• Soft limit — uyarı + grace
• Hard limit — 429 + upgrade CTA

Pause / archive / delete

• Suspend — okuma açık, yazma kapalı
• Archive — read-only kalır, asset cold
• Delete (GDPR) — 30 gün grace + export
• Backup per tenant — restore plan

Yapısal + JSONB karma

• Master + replica — multi-node ileride
• JSONB GIN index — esnek alan sorgu
• pgvector extension — embedding column
• Row-level Security — tenant_id zorla

Schema-first + tip güvencesi

• Migration history — repo'da
• TS client — backend trigger
• Python prisma-client-py — alternatif

Sync-friendly document store

• Replication — offline-first için
• Mobil sync — RN edisyonu ile
• Decision deferred — ihtiyaç doğunca

Full-text + facet

• Tek node — Sprint başı
• Cluster — K3s migrasyonu sonrası
• Reindex pipeline — domain event'leri tüket

Vector search

• pgvector default — tek DB
• Qdrant alternatif — büyük corpus
• IVFFlat / HNSW index
• Hybrid query — filter + k-NN

Object storage

• Bucket per tenant — izolasyon
• Signed URL — private asset
• Lifecycle policy — eski versiyonları arşivle

Cache + rate limit + pubsub

• Cache layer — hot read
• Rate limit bucket
• Pub/Sub hafif — basit notification fan-out
• NATS — büyürken yerini alır

Komut satırı jeneratör

• mf gen context <ad> — yeni bounded context
• mf gen doctype <ad> — entity + migrasyon
• mf gen view <ad> — liste/dashboard
• mf gen plugin <ad> — plugin iskeleti
• mf dev — hot reload

Tıklayarak entity + alan

• Drag & drop alan ekle — string, ref, json...
• Migration üretici — Prisma diff
• Permission editor — RBAC inline
• Önizleme — örnek kayıt formu

Listing / dashboard no-code

• Tablo + filtre + grafik — drag
• Drupal Views muadili
• SQL preview — power-user için

Schema intellisense

• Route navigation — Cmd+click → handler
• Plugin wizard — yeni plugin sihirbazı
• Snippet picker

AI-generated tip-safe kod

• Use-case başına — auth, CRUD, agent tool
• Inline edit — params doldur
• Toplulukça katkı — repo PR

MDX + live playground

• API reference — OpenAPI'den auto
• Tutorial steps — interactive
• Search (Algolia DocSearch)

JSON Lines, request_id korelasyon

• stdout → Loki — single VPS için Grafana stack
• trace_id + tenant_id — her satıra zorla
• Log retention — 30 gün hot, 1 yıl cold

Değiştirilemez event log

• Postgres tablosu — INSERT only
• Append-only constraint — DB-level
• Forensic query — kim ne zaman ne yaptı

Prometheus-uyumlu

• FastAPI middleware — req duration histogram
• DB query timings
• Agent run + cost — özel metrik
• Per-tenant breakdown

OpenTelemetry SDK

• Trace ID propagation — request başına
• Span enstrümantasyon — auto + manual
• Jaeger / Tempo — collector

/healthz + /readyz

• Dependency check — DB, Redis, ES, MinIO
• Liveness vs readiness — ayrı
• Uptime monitoring — UptimeRobot / Healthchecks.io

pg_dump + MinIO snapshot

• Saatlik WAL — point-in-time recovery
• Günlük tam — ayrı fiziksel disk
• Off-site backup — başka cloud
• DR drill — 3 ayda bir restore testi

GitHub Actions → Hetzner

• Build → test → deploy — ana pipeline
• Docker registry (ghcr) — image kayıt
• Migration adımı — deploy öncesi
• Rollback — bir önceki image hızlıca