| name | node-express-api |
| description | Use when adding or changing backend API endpoints in this repo (backend/api/routes.js, Express + pg). Covers query conventions, the v_sppg clean view, error handling, and the coverage business rule. |
Node/Express API — konvensi repo data-bgn
Backend = Express ESM + pg. Semua endpoint ada di backend/api/routes.js,
koneksi DB di backend/api/db.js, rumus domain di backend/lib/coverage.js.
Aturan wajib
- Selalu query dari
v_sppg, bukan tabel sppg. v_sppg sudah difilter ke 38
provinsi valid (ref_provinsi). Tabel sppg mentah punya ~26 baris kotor.
- Bungkus tiap handler dengan
try/catch dan balikan res.status(500).json({ error: err.message }).
Pola: console.error('GET /path error:', err).
- Parameterized query (
$1, $2, …) untuk semua input user — jangan string-concat
nilai ke SQL.
- Rumus coverage hanya dari
lib/coverage.js. Konstanta PORSI_PER_SPPG_PER_HARI,
TIER_MERAH_MAX, TIER_KUNING_MAX diimpor; SQL menirunya, jangan tulis angka 2000/70/90
secara hardcode di tempat baru.
- Helper SQL bersama (
COV, V, KC, DAPODIK_AGG, COVERAGE_PCT) sudah ada di atas
file — pakai ulang, jangan duplikat logika kecamatan/coverage.
Pola handler
router.get('/contoh', async (req, res) => {
try {
const r = await db.query(`SELECT ... FROM v_sppg ...`, [param])
res.json(r.rows)
} catch (err) {
console.error('GET /contoh error:', err)
res.status(500).json({ error: err.message })
}
})
Setelah mengubah backend (Diagnostic Gate)
- LSP diagnostics file yang diubah (warning
req tak terpakai = idiom Express, abaikan).
cd backend && node --test (tambah/ubah test di backend/tests/ bila logika berubah).- Smoke test endpoint:
curl -s localhost:3000/api/<path>.
- Baru tes browser.
Cek dampak perubahan fungsi yang dipakai luas dengan code-review-graph detect-changes.
