Lewati ke isi

Runbook Operasional & Rollback Checklist (Phase 5)

Scope: Guru Penilaian -> E-Raport -> Monitoring Reliability Akademik
Tanggal: 2026-02-27

1) Release Gate

Sebelum deploy, jalankan quality gate berikut:

npm run test:phase5:academic-report
npm run test:phase5:teacher
npm run test:phase4:academic-admin

Untuk smoke E2E flow prioritas tinggi:

npm run test:e2e:flow:p0

Semua command harus exit code 0.

2) KPI SLO Phase 5

Sumber KPI: src/services/observability/academicObservability.service.js
Dashboard: /admin/analytics/academic-reliability atau /principal/analytics/academic-reliability

KPI wajib pantau:

  1. publish_error_rate (%): workflow_ops.publish_failed / workflow_ops.publish_total
  2. workflow_stuck_duration_minutes: durasi maksimum workflow rapor yang belum terselesaikan
  3. access_denied_anomaly_rate (%): proporsi deny event 24 jam terakhir terhadap total deny event

Threshold awal:

  1. publish_error_rate > 3% (warning), > 7% (critical)
  2. workflow_stuck_duration_minutes > 60 (warning), > 180 (critical)
  3. access_denied_anomaly_rate > 20% (warning), > 35% (critical)

3) Monitoring Harian

  1. Buka dashboard reliability akademik dan lakukan Refresh Backend.
  2. Validasi fallback dengan Local Snapshot bila endpoint summary belum tersedia.
  3. Jika antrean sink bertambah, jalankan Sync Now lalu Flush Queue.
  4. Cek tabel Recent Error Events untuk pola workflow_error pada model scola.student.report.
  5. Eskalasi jika KPI melewati threshold critical selama 2 interval monitoring berturut-turut.

4) Incident Handling

  1. Jika publish_error_rate naik:
  2. telusuri event action_publish di audit trail dan workflow_ops.recent.
  3. validasi state raport (kepala_sekolah) sebelum publish.
  4. Jika workflow_stuck_duration_minutes tinggi:
  5. identifikasi report ID yang unresolved,
  6. koordinasikan percepatan approval pada role terkait (wali kelas/kepsek).
  7. Jika access_denied_anomaly_rate naik:
  8. audit perubahan capability/role assignment,
  9. cek route guard event pada role terdampak.

5) Rollback Checklist

  1. Nonaktifkan observability akademik jika menimbulkan noise operasional:
  2. set academic_phase4_observability = false via backend feature flag.
  3. Revert commit terakhir terkait rollout phase 5 menggunakan revert commit (non-destructive).
  4. Jalankan ulang quality gate minimum:
npm run test:phase5:academic-report
npm run test:phase5:teacher
  1. Validasi smoke role kritikal:
  2. Teacher: /faculty/report-card
  3. Homeroom: /faculty/homeroom/report-card
  4. Principal: /principal/academics/reports
  5. Parent: /parent/report-cards

6) Artefak Referensi

  1. Plan utama: docs/implementation/Academic/GURU_PENILAIAN_E2E_DAN_E_RAPORT_AUDIT_UI_UX_IMPLEMENTATION_PLAN_2026-02-27.md
  2. Service observability: src/services/observability/academicObservability.service.js
  3. Workflow orchestration: src/services/reportCard/assessmentWorkflow.service.js
  4. Test gate:
  5. tests/unit/services/assessmentWorkflow.service.spec.js
  6. tests/unit/services/academicObservability.spec.js
  7. tests/menu/foundationAcademicGovernancePhase4.spec.js