Reference
Modullar reference’i
Backend commandlari, internal paketlar va frontend funksional chegaralari.
Backend commandlari
| Path | Vazifa |
|---|---|
backend/cmd/api | HTTP API process, middleware va route wiring |
backend/cmd/worker | Job engine, health/ready/metrics va graceful shutdown |
backend/cmd/migrate | SQL migratsiyalarni tartibda qo‘llash |
backend/cmd/seed | Initial administratorni idempotent yaratish |
Backend internal modullari
| Modul | Javobgarlik |
|---|---|
internal/httpapi | Router, middleware, handlers, chat persistence, limits, idempotency, admin, OpenAI compatibility |
internal/auth | Argon2id, session/token va security primitives |
internal/providers | Yagona provider contract, registry va normalizatsiya |
internal/providers/openai | Azure OpenAI/OpenAI-compatible adapter |
internal/storage/s3 | Private object, presign, checksum, multipart va download |
internal/jobs | Lease/fencing engine, retry/backoff, file processing va cleanup |
internal/config | Environment parsing, defaults va production invariantlari |
| Observability paketlari | Structured logging, Prometheus metrics va request IDs |
Frontend domenlari
Chat
Streaming composer, model/reasoning selector, message parts va attachments.
Workspace
Conversation history, search, project, share va cursor pagination.
Settings
Profile, password, sessions, API keys va connections.
Admin
Users, providers, models, usage, audit va statistics.
Yangi provider qo‘shish
- Provider interfeysining barcha metodlarini implement qiling.
- Request capability va token estimate’ni aniq normalizatsiya qiling.
- Streaming event va terminal errorlarni unified formatga aylantiring.
- Credential schema/encryption va connection testni qo‘shing.
- Registry wiring, admin type validation va contract testlarni yangilang.
- Usage/pricing semantikasi noma’lum bo‘lsa fail closed qiling.