Module زیرساخت Platform Backend
platform زیرساخت مشترک اجرای Backend را فراهم میکند و Feature کسبوکاری نیست. Domain Rule، Entity محصول، Permission یا Workflow کسبوکاری نباید برای reuse به این Module منتقل شود.
دامنه
داخل دامنه
- Configuration و Secret Loading؛
- PostgreSQL Pool و اجرای Migration در Startup؛
- HTTP Server، Middlewareهای سراسری و Problem Details مشترک؛
- Liveness، Readiness، OpenAPI و Swagger UI؛
- Container Runtime، CI/CD و اتصال به Reverse Proxy.
خارج از دامنه
- Validation و Authorization هر Feature؛
- Account، OTP، Session و Refresh Token؛
- Query، Migration یا Event اختصاصی Feature؛
- SMS، Push، Object Storage و Payment Provider.
وضعیت
| قابلیت | وضعیت | مالک کد |
|---|---|---|
| Config و Secret | پیادهسازیشده | internal/platform/config |
| PostgreSQL Pool | پیادهسازیشده | internal/platform/database |
| Migration Runner | پیادهسازیشده | internal/platform/migration و cmd/migrate |
| HTTP Server و Middleware | پیادهسازیشده | internal/platform/httpserver و httpx |
| Health Check | پیادهسازیشده | internal/health/adapters/http |
| OpenAPI و Swagger UI | پیادهسازیشده | api/openapi و /docs/ |
| Docker و Deploy Development | پیادهسازیشده | Compose و GitHub Actions |
| Worker و Job عمومی | پیادهسازینشده | فقط هنگام نیاز واقعی |
صفحات این Module
معیار پذیرش
- Featureها فقط از Capabilityهای پایدار Platform استفاده کنند و Business Logic وارد Platform نشود.
- Secret، DSN، Token و PII در Log یا Error عمومی ظاهر نشوند.
- Startup، Shutdown، Health، Migration و Deploy مسیر Test و Failure روشن داشته باشند.
- Dependency جدید فقط برای نیاز مصرفشده و با نسخه Pinشده اضافه شود.