Blueprint Backend & AI API

id uuid pk default gen_random_uuid()
created_at timestamptz default now()
updated_at timestamptz default now()
status text not null
deleted_at timestamptz null

• users

  Identitas pengguna, role, kuota, dan preferensi.

  identity

  kolom: email citext unique · display_name text · avatar_url text · plan text · locale text

  relasi: 1-N projects · 1-N api_keys · 1-N notifications · 1-N audit_logs

  index: unique(email) · idx(plan, status)

• user_roles

  RBAC terpisah dari profil untuk mencegah privilege escalation.

  identity

  kolom: user_id uuid fk→users · role app_role

  relasi: N-1 users

  index: unique(user_id, role)

• projects

  Proyek video: narasi, metadata, bahasa, gaya visual, progress.

  project

  kolom: owner_id uuid fk→users · title text · narration text · language text · style text · progress int

  relasi: 1-1 storyboards · 1-N render_jobs · 1-1 seo_packages

  index: idx(owner_id, status) · idx(updated_at desc)

• storyboards

  Hasil Storyboard AI dan naskah teroptimasi.

  creative

  kolom: project_id uuid fk→projects · optimized_script text · hook text · cta text · analysis jsonb

  relasi: 1-N scenes

  index: unique(project_id)

• scenes

  10 scene × 2 detik beserta kamera, emosi, transisi, prompt.

  creative

  kolom: storyboard_id uuid fk→storyboards · index int · narration text · camera text · image_prompt text · video_prompt text

  relasi: 1-1 image_assets · 1-1 video_assets · 1-N subtitle_assets

  index: unique(storyboard_id, index)

• characters

  Character Bible terkunci untuk konsistensi visual.

  creative

  kolom: project_id uuid fk→projects · name text · locked_prompt text · attributes jsonb

  relasi: N-1 projects

  index: idx(project_id)

• environments

  Environment Library: lokasi, cuaca, waktu, pencahayaan.

  creative

  kolom: project_id uuid fk→projects · name text · attributes jsonb

  relasi: N-1 projects

  index: idx(project_id)

• image_assets

  Render gambar 9:16 per scene beserta versi regenerasi.

  asset

  kolom: scene_id uuid fk→scenes · storage_path text · provider_id text · version int · checksum text

  relasi: N-1 scenes

  index: idx(scene_id, version desc) · idx(checksum)

• video_assets

  Klip video 2 detik hasil Video Director AI.

  asset

  kolom: scene_id uuid fk→scenes · storage_path text · duration_ms int · provider_id text · version int

  relasi: N-1 scenes

  index: idx(scene_id, version desc)

• voice_assets

  Voice over: gender, emosi, pitch, speed.

  asset

  kolom: project_id uuid fk→projects · storage_path text · voice_config jsonb · duration_ms int

  relasi: N-1 projects

  index: idx(project_id)

• music_assets

  Trek musik latar dan level ducking terhadap narasi.

  asset

  kolom: project_id uuid fk→projects · storage_path text · mood text · gain_db numeric

  relasi: N-1 projects

  index: idx(project_id)

• subtitle_assets

  Subtitle sinkron (SRT/VTT) termasuk terjemahan.

  asset

  kolom: project_id uuid fk→projects · locale text · format text · storage_path text · cues jsonb

  relasi: N-1 projects

  index: unique(project_id, locale, format)

• thumbnail_assets

  Variasi thumbnail high-CTR beserta skor prediksi.

  delivery

  kolom: project_id uuid fk→projects · storage_path text · concept text · ctr_score numeric

  relasi: N-1 projects

  index: idx(project_id, ctr_score desc)

• seo_packages

  Judul, deskripsi, tag, hashtag, keyword, hook komentar.

  delivery

  kolom: project_id uuid fk→projects · title text · description text · tags text[] · hashtags text[]

  relasi: 1-1 projects

  index: unique(project_id)

• render_jobs

  Job antrean render/export beserta progres dan hasil.

  delivery

  kolom: project_id uuid fk→projects · queue text · stage text · attempts int · format text · resolution text · output_path text

  relasi: N-1 projects · 1-N logs

  index: idx(status, queue) · idx(project_id, created_at desc)

• notifications

  Notifikasi realtime (render, aset siap, error, export).

  ops

  kolom: user_id uuid fk→users · project_id uuid null · type text · payload jsonb · read_at timestamptz

  relasi: N-1 users

  index: idx(user_id, read_at)

• api_keys

  Kunci API pengguna dengan rotasi dan scope terbatas.

  ops

  kolom: user_id uuid fk→users · hashed_key text · scopes text[] · last_used_at timestamptz · expires_at timestamptz

  relasi: N-1 users

  index: unique(hashed_key) · idx(user_id, expires_at)

• logs

  Log workflow, request/response AI, retry, dan performa.

  ops

  kolom: project_id uuid null · job_id uuid null · level text · agent text · message text · duration_ms int · meta jsonb

  relasi: N-1 render_jobs

  index: idx(project_id, created_at desc) · idx(level, created_at desc)

• audit_logs

  Jejak audit tak terhapus untuk aksi sensitif & keamanan.

  ops

  kolom: actor_id uuid fk→users · action text · entity text · entity_id uuid · ip inet · diff jsonb

  relasi: N-1 users

  index: idx(actor_id, created_at desc) · idx(entity, entity_id)

• settings

  Preferensi pengguna/workspace: provider default, kualitas, budget.

  ops

  kolom: scope text · owner_id uuid · key text · value jsonb

  relasi: N-1 users

  index: unique(scope, owner_id, key)

Setiap job menyimpan projectId, stage, dan attempts di database — restart server tidak menghilangkan status, dan hanya tahap yang gagal yang dijalankan ulang (bukan seluruh pipeline).

• Chunk upload 5 MB + resume via uploadId dan signed URL.
• Progress event dikirim lewat SSE ke klien.
• Kompresi otomatis: gambar → WebP/AVIF, audio → AAC, video → H.264/H.265.
• Virus scan sebelum aset dipublikasikan; file terinfeksi ditolak 451.
• Auto rename ke `{projectId}/{kind}/{uuid}.{ext}` untuk mencegah tabrakan.
• Versioning per aset (version + checksum) agar regenerasi tidak menimpa.
• Lifecycle rule: aset sementara dihapus otomatis setelah 24 jam.
• Signed URL berumur pendek untuk unduhan; bucket tidak publik.

• JWT akses pendek (15 menit) + refresh token rotasi dengan reuse detection.
• RBAC pada tabel user_roles terpisah + security definer has_role().
• Rate limiting per IP, per pengguna, dan per API key (token bucket di Redis).
• CORS allowlist ketat, CSRF token untuk cookie flow, SameSite=Lax.
• Validasi Zod di setiap boundary request/response.
• Query berparameter/ORM — tidak ada SQL string concatenation.
• Sanitasi output & Content Security Policy tanpa inline script.
• Secret terenkripsi at-rest, rotasi API key terjadwal, tanpa secret di klien.
• Audit trail immutable untuk aksi sensitif (append-only, retensi 1 tahun).
• Virus scan dan validasi MIME/checksum pada seluruh upload.

Analytics menghitung jumlah proyek, video sukses, rata-rata waktu render, provider tercepat & terakurat, penggunaan API, serta biaya per proyek dan per pengguna dari tabel logs + render_jobs.

1. 1.Push ke GitHub memicu GitHub Actions.
2. 2.Lint, typecheck, unit & integration test, contract test OpenAPI.
3. 3.Security scan: dependency audit, SAST, secret scanning, image scan.
4. 4.Build image Docker multi-stage, tag imutabel per commit.
5. 5.Deploy bertahap (canary 10% → 50% → 100%) ke Kubernetes.
6. 6.Health check + smoke test; gagal → rollback otomatis ke revisi sebelumnya.
7. 7.Migrasi database forward-only dengan expand/contract agar zero-downtime.
8. 8.Backup harian (PITR 7 hari) dan mingguan (retensi 90 hari) untuk DB, aset, konfigurasi.

• Aplikasi ini berjalan di TanStack Start: endpoint publik dipetakan ke server route src/routes/api/*, dan logika internal ke server function bertipe aman.
• Aktifkan Lovable Cloud untuk mendapatkan PostgreSQL, Auth (email + Google), Storage, dan RLS tanpa setup — menggantikan kebutuhan Supabase/Prisma/Docker terpisah pada tahap awal.
• Provider AI cukup diakses lewat satu AI Gateway; adapter di src/lib/backend/providers.ts sudah menyiapkan retry, timeout, error mapping, cache key, dan cost optimizer.
• Untuk skala jutaan video, pindahkan worker antrean (BullMQ/Redis) dan rendering FFmpeg ke layanan container terpisah; kontrak REST di halaman ini tetap sama.