Skip to main content
Panduan singkat untuk developer yang ingin mengubah tone, panjang narasi, atau struktur output AI.

​
Peta file

​
Versi prompt

Enricher menyimpan provenance:
Naikkan versi saat mengubah system prompt agar bisa audit job lama di DB/logs.

​
Parameter model

Ganti model ke deepseek-v4-pro untuk kualitas lebih tinggi (biaya lebih).

​
Checklist setelah edit prompt

1

Tes lokal

Generate satu dokumen yang terdampak (master bukti-1, trainer full set, atau branding LinkedIn).
2

Unit test terkait

3

Validasi payload

Pastikan output masih lolos Zod schema — enricher fallback jika parse gagal.
4

Deploy

​
Menambah dokumen baru

  1. Buat composer + schema Zod
  2. registerDocument() di master-definitions.ts / trainer-definitions.ts / branding-definitions.ts
  3. Tambah route renderer di apps/renderer
  4. Jika aiMode: assist — definisikan enrichableFieldPaths + enrichmentGroups
  5. Update frontend catalog jika perlu (biasanya auto dari API)

​
Anti-patterns

Taruh di exactFieldPaths. AI hanya narasi.
Pakai enrichmentGroups seperti bukti-1 dan bukti-6.
Semua prompt server-side di apps/api.

​
Debug job gagal

  1. Cek status job di DB / UI sidebar “Generate Gagal”
  2. Log worker: generation-worker.service.ts
  3. Jika PAYLOAD_VALIDATION_FAILED — bandingkan output AI vs schema Zod
  4. Retry di UI memanggil handleGenerate() fresh (bukan reuse job input lama)