Katmanlar

Katman	Yol	Sorumluluk
Domain	`internal/domain/*`	Entity, value object, domain event, repository port
Application	`internal/application/*`	Use-case, DTO, orchestration, CQRS komut/sorgu
Adapters	`internal/adapters/{http,goui,persistence,shared}`	Fiber handler, GoUI, sqlc repo, ortak adapter yardımcıları
Infrastructure	`internal/infrastructure/*`	Config, DB, JWT/Argon2/TOTP, SMTP, SMS, ödeme gateway, outbox, cache
Bootstrap	`internal/bootstrap` (`Build` + `wire_*.go`)	Manuel DI; composition root parçalı wiring

Domain, application dışına bağımlı olmaz. Application yalnızca domain portlarına ve kendi DTO’larına bakar.

Bounded context’ler

Context	Domain	Application	Not
User	`domain/user`	`application/user`	CRUD, profil, soft-delete
Auth	`domain/auth`	`application/auth`	Token, MFA, OAuth olayları
Authz / RBAC	`domain/rbac`	`application/authz`	Rol/izin aggregate; çözümleme authz’de
Notification	`domain/notification`	`application/notification`	Dispatcher, inbox, bulk
Settings	`domain/settings`	`application/settings`	Aktif SMS/ödeme sağlayıcı
Payment	`domain/payment`	`application/payment`	3DS, transaction
Contact	`domain/contact`	`application/contact`	Public form + admin kutu
Upload	`domain/upload`	`application/upload`	Güvenli dosya yükleme
Audit	—	`application/audit`	Domain aggregate yok; uygulama servisi
Idempotency / Outbox	—	`application/{idempotency,outbox}`	Altyapı destekli

Paylaşılan domain tipleri: domain/shared.

Bunlar domain değildir; çapraz yardımcı paketlerdir.

Paket	Kullanım
`pkg/rbac`	`Perm*` sabitleri, `Catalog`, `Checker` — aggregate `domain/rbac`, use-case `application/authz`
`pkg/recipients`	CSV/XLSX alıcı içe aktarma (bildirim bulk) — iletişim formu `domain/contact`
`pkg/tabular`	Liste dışa aktarma (CSV/XLSX)
`pkg/i18n`	Locale dosyaları (`locales/tr.json`, `en.json`)
`pkg/validation`	go-playground tag kayıtları + alan mesajları
`pkg/pagination`	Offset/limit yardımcıları
`pkg/fieldenc`	Hassas alan şifreleme (ödeme kartı vb.)

pkg/user yoktur; kullanıcı yalnızca internal/domain/user altındadır.

Özet gruplar:

Public: health, OpenAPI, contact submit, auth login/refresh/oauth, payment callback/webhook
Protected: /me, users, notifications send/bulk, rbac, settings, payments, audit, contacts, uploads

Web oturumu HttpOnly cookie; API Bearer JWT. İkisi aynı application use-case’lerini çağırır.

Örnek panel yolları: /dashboard, /dashboard/users, /dashboard/notifications/bulk, /dashboard/payments/checkout, /dashboard/audit/logs.

Parça	Yol
Migration	`migrations/000001_schema.`, `000002_seed.` (embed: `migrations.go`)
sqlc kaynak	`db/queries/*.sql`
sqlc çıktı	`internal/adapters/persistence/postgres/db/`

Geliştirmede şema tek dosyada tutulur (000001). Canlıya çıktıktan sonra incremental migration eklenir.