Mimari

Mişko; bir Go API’si, bir Vue paneli ve bir PostgreSQL veritabanından oluşur. Video analizi API’nin dışında, iş talep edip sonuçlarını yükleyen worker’larda çalışır.

Teknoloji yığını

Katman	Teknoloji
Backend	Go 1.27 · pgx · sqlc · PostgreSQL 18
Frontend	Vue 3 · Vite · Vue Router · Pinia · vue-i18n
Güvenlik	JWT · bcrypt · rol tabanlı erişim denetimi
Depolama	Google Cloud Storage (özel bucket, imzalı URL’ler)
Worker	Python · PyAV · NumPy · SciPy
Altyapı	Docker · Docker Compose · Nginx · GitHub Actions

Backend katmanları

API modüler bir monolittir. Her alan internal/ altında kendi paketidir ve hepsi aynı biçimde bölünür:

internal/<alan>/
├── domain/       saf iş kuralları, veritabanı ve HTTP yok
├── application/  kullanım senaryoları ve ihtiyaç duydukları portlar
└── adapters/
    ├── http/       rotalar, istek çözümleme, hata eşleme
    ├── postgres/   sqlc ile üretilen sorgular
    ├── catalog/    paradigma kataloğunun salt okunur görünümleri
    └── token/      token üretme ve doğrulama

internal/bootstrap kompozisyon köküdür: somut adaptörleri kullanım senaryolarına bağlar ve tüm rotaları kurar. internal/access/domain ortak izin çekirdeğini tutar; bir kullanım senaryosu bir store’a dokunmadan önce actor.Require(permission) çağırır.

tests/architecture içindeki politika testi bu yapıyı zorunlu kılar: domain ve application paketleri adaptörleri import edemez ve domain kodu standart kütüphanenin küçük bir izin listesiyle sınırlıdır. Katman hatası, incelemeyi beklemeden derlemeyi düşürür.

Liste sorguları

Her liste endpoint’i çıplak bir dizi yerine sayfalanmış bir zarf döndürür:

{ "data": [ ... ], "total": 42, "page": 1, "pageSize": 10 }

page ve pageSize sorgu parametreleridir ve sayfalamayı veritabanı uygular. Panelde tek bir DataTable bileşeni ve useDataTable composable’ı bu zarfı tüketir; böylece arama, sayfalama ve sıralama her ekranda aynı şekilde çalışır.

Analiz nasıl çalışır

Kamera ve görü tarafı, kendi veritabanı olan ikinci bir servis değildir. Bu API’ye kimlik doğrulayan bir worker sürecidir:

Panel ──► Go API ──► PostgreSQL (kayıtlar, metrikler, olaylar)
             │
             │  Authorization: Worker <token>
             ▼
          Worker  ──►  kaydı okur, çıktılarını imzalı URL'lerle
             │         bucket'a yazar
             ▼
   Cloud Storage (orijinal video, analiz videosu, yörünge)

Worker kuyruktaki bir çalıştırmayı üstlenir, sabitlenmiş kaynak videoyu okur ve bir analiz videosu ile bir misko.trajectory.v1 yörüngesi yükler. Metrik göndermez. API yüklenen her nesneyi bildirilen boyut, sağlama ve içerik türüne karşı doğrular, paradigmanın kalite kurallarını uygular; ardından Go metrik motoru metrikleri ve olayları yörüngeden hesaplar. Böylece takibi ne üretirse üretsin, her ölçümün tek bir tanımı API içinde kalır.

Ağır veri bucket’ta kalır: veritabanı kayıtları, metrikleri, olayları ve nesne referanslarını tutar, video baytlarını değil.

Dağıtım

Yığın Docker Compose ile çalışır: PostgreSQL, API, analiz çalıştırmalarını kuyruklayan jobs süreci ve paneli sunan Nginx. Şema ve ilk yönetici, konteyner açılışında değil, açık ve tek seferlik komutlarla kurulur (bootstrap schema ve bootstrap setup); böylece mevcut bir veritabanı kazara migrate edilmez. Backend, frontend ve worker’ın her birinin kendi path-filtreli GitHub Actions pipeline’ı vardır.