Veri Akışı

Başlangıç

1. Operatör serve veya worker başlatır.
2. Yapılandırma yüklenir: işletim sistemi ortamı, sonra .env / --env-file, sonra varsayılanlar.
3. MongoDB bağlantısı kurulur. MongoDB yoksa serve ve worker fail-fast olur.
4. serve için HTTP rotaları açılır.
5. worker kapanış sinyallerini bekler ve outbound iş çalıştırmaz.

Inbound iş emri istek akışı

flowchart TD
  req[HTTP istek JSON veya XML] --> dec[Decoder]
  dec --> norm[Normalize]
  norm --> val[Sözleşme doğrulama]
  val --> actor[Integration actor]
  actor --> svc[Kalıcılık servisi]
  svc --> mongo[(MongoDB)]
  svc --> resp[Standart yanıt zarfı]

Adım	Davranış
İstek	POST /api/v1/inbound/work-orders (canlı) veya /test (yalnız format)
Decoder	JSON DisallowUnknownFields veya katı XML; DOCTYPE reddedilir
Normalize	stage_type Türkçe büyük/küçük harf; UTC Z tarihleri
Validate	Zorunlu alanlar, StrictInt64, enum, tarih sırası, tekrarlar
Actor	Var, aktif, tenant eşleşmesi — veya tipli 409 / beklenmeyen 500
Service	Ürün upsert, proje/üretim/aşama birleştirme, makine/çalışan çözümleme
MongoDB	Müşteri veritabanı; çok belgelik transaction gerekmez
Yanıt	{ success, request_id, data, error } özet ve uyarılarla

Canlı POST, özellikler açıksa Idempotency-Key ve istek arşivini de uygular.

Planlanan outbound akış

Worker’ın uygun MongoDB kayıtlarını okuyup harici API’lere göndermesi planlanır. Uygulanmamıştır.