معماری فناوری، زبان‌ها و روند توسعه

۱نمای کلی معماری

نگاهبان یک سامانهٔ رخدادمحور و میکروسرویسی است که در پنج لایه طراحی شده تا هر بخش مستقل توسعه، تست، مقیاس و جایگزین شود.

۲زبان‌ها و فناوری هر لایه

۳بک‌اند و سرویس‌ها — Go

چرا Go؟ به‌خاطر هم‌روندی بومی (goroutine/channel)، تأخیر پایین، باینریِ تک‌فایل و مصرف منابع کم — دقیقاً مناسب سرویس‌هایی که هزاران رخداد دوربین/حضور را در لحظه پردازش می‌کنند.

قابلیت‌ها و کتابخانه‌ها

• API: REST با Gin/Fiber برای کلاینت‌ها و gRPC برای ارتباط سرویس‌به‌سرویس (کم‌حجم و سریع).
• هم‌روندی: goroutine و channel برای مصرف موازیِ رخدادها از NATS؛ context برای کنترل timeout و لغو.
• داده: pgx برای PostgreSQL، go-redis برای Redis، الگوی Repository.
• احراز هویت: JWT + RBAC، میدلورِ مجوز در سطح هر مسیر.
• پایداری: الگوهای retry، circuit-breaker و idempotency برای رخدادها.

func (s *AttendanceService) Consume(ctx context.Context) {
  sub, _ := s.nats.Subscribe("face.recognized", func(m *nats.Msg) {
    var ev FaceEvent
    json.Unmarshal(m.Data, &ev)
    // تطبیق با زون مجاز و ثبت حضور
    if s.zones.Allowed(ev.PersonID, ev.ZoneID) {
      s.repo.MarkPresence(ctx, ev.PersonID, ev.ZoneID, ev.At)
    } else {
      s.alerts.Raise(ctx, Alert{Type: "unauthorized_zone", Ref: ev})
    }
  })
  <-ctx.Done(); sub.Unsubscribe()
}

۴هوش مصنوعی و بینایی — Python

سرویس‌های هوش مصنوعی با Python نوشته می‌شوند چون اکوسیستم بینایی ماشین در آن بالغ است؛ اما برای استنتاج (inference) مدل‌ها به فرمت بهینه تبدیل و روی GPU اجرا می‌شوند تا تأخیر حداقلی شود.

اجزای اصلی

• تشخیص چهره: آشکارساز RetinaFace/SCRFD + مدل بازنمایی ArcFace که برای هر چهره یک «بردار ویژگی» تولید می‌کند.
• تطبیق هویت: بردار چهره با جست‌وجوی شباهت در pgvector با گالریِ افراد مجاز مقایسه می‌شود.
• اجرای بهینه: مدل‌ها به ONNX صادر و با TensorRT (FP16/INT8) روی GPU اجرا می‌شوند.
• تحلیل رفتار: مدل‌های دنباله‌ای/زمانی برای کشف ناهنجاری و «جایگزینی پنهان» نگهبان.

import onnxruntime as ort, numpy as np

sess = ort.InferenceSession("arcface.onnx",
        providers=["TensorrtExecutionProvider", "CUDAExecutionProvider"])

def embed(face_img):
    emb = sess.run(None, {"input": preprocess(face_img)})[0]
    return emb / np.linalg.norm(emb)   # نرمال‌سازی بردار

# جست‌وجوی نزدیک‌ترین هویت در pgvector
# SELECT person_id FROM gallery ORDER BY embedding <=> $1 LIMIT 1;

۵موبایل و فرانت‌اند

قابلیت‌های کلیدی کلاینت

• به‌روزرسانی بلادرنگ رویدادها و موقعیت بدون رفرش (WebSocket/SSE).
• احراز هویت دوعاملی (تگ + چهره) و نقش‌های تفکیک‌شده (مدیر، راهبر، نگهبان).
• طراحی واکنش‌گرا (Responsive) و پشتیبانی کامل از RTL فارسی.

۶داده، صف و ذخیره‌سازی

۷زیرساخت و DevOps

• کانتینری‌سازی: هر سرویس یک ایمیج Docker با چنددمرحله‌ای (multi-stage) و حجم کم.
• ارکستراسیون: Kubernetes با زمان‌بندی GPU برای سرویس چهره، مقیاس خودکار (HPA) و rollout تدریجی.
• پیکربندی: الگوی GitOps؛ مانیفست‌ها در Git، استقرار خودکار.
• اسرار: Vault برای کلید/توکن؛ هیچ رمزی در کد یا ایمیج نیست.
• مشاهده‌پذیری: متریک (Prometheus)، داشبورد (Grafana)، لاگ (Loki) و ردیابی توزیع‌شده (OpenTelemetry).

۸قابلیت‌های کلیدی برنامه‌نویسی

۹روند توسعهٔ نرم‌افزار

توسعه به‌روش چابک (Agile/Scrum) در اسپرینت‌های ۲ هفته‌ای انجام می‌شود تا کارفرما در پایان هر اسپرینت خروجی قابل‌مشاهده ببیند و بازخورد بدهد.

مدیریت نسخه و کد

• گردش‌کار Git مبتنی بر شاخه‌ی feature و Pull Request با بازبینی اجباری.
• پیام‌های Commit استاندارد (Conventional Commits) و نسخه‌بندی معنایی (SemVer).
• شاخهٔ main محافظت‌شده؛ ادغام فقط پس از سبزشدن CI و تأیید بازبین.

۱۰خط لولهٔ CI/CD

هر تغییر به‌صورت خودکار از این مراحل عبور می‌کند تا فقط کدِ تست‌شده و امن به تولید برسد:

jobs:
  build:
    steps:
      - run: golangci-lint run        # کیفیت کد Go
      - run: go test ./... -race      # تست واحد + رقابت داده
      - run: docker build -t app .    # ساخت ایمیج
      - run: trivy image app          # اسکن آسیب‌پذیری
      - run: kubectl rollout restart deploy/app  # استقرار تدریجی

۱۱استراتژی تست و کیفیت

کیفیت کد با linter و formatter اجباری تضمین می‌شود: golangci-lint/gofmt برای Go، ruff/black + mypy برای Python، eslint/prettier + tsc برای TypeScript.

۱۲چرخهٔ عمر مدل هوش مصنوعی (MLOps)

۱۳جریان دادهٔ زمان اجرا

مسیر یک رخداد، از فریم دوربین تا هشدار روی داشبورد و موبایل:

۱۴امنیت و حاکمیت کد

• رمزنگاری: TLS برای انتقال، رمزنگاری در سکون برای دادهٔ حساس.
• دسترسی: RBAC، اصل کمترین امتیاز، ثبت ممیزی (audit log) همهٔ اقدامات حساس.
• اسرار: مدیریت متمرکز با Vault؛ بدون رمز در مخزن کد.
• زنجیرهٔ تأمین: اسکن وابستگی‌ها و ایمیج‌ها، امضای ایمیج، به‌روزرسانی منظم.
• حریم خصوصی: استقرار On‑Prem و عدم خروج دادهٔ بیومتریک از محیط مشتری.

۱۵ابزارها و محیط توسعه