메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when changing the PostgreSQL schema or views for this repo (script/sql/*.sql, tables sppg/dapodik_pd/kecamatan_mapping/kecamatan_coords, views v_sppg/v_sppg_per_kecamatan). Covers ordering, idempotency, and applying against the live sppg-db container.
Use when adding or changing frontend pages/components in this repo (frontend/src, Vue 3 + Vite + Tailwind + Leaflet + Chart.js). Covers routing, API calls, the coverage tier colors, and the build/verify loop.
Use when scraping, cleaning, mapping, or importing the SPPG/DAPODIK data in this repo (script/*.py, script/*.mjs, script/data, script/sql/import_data.sql). Covers the CSV→Postgres flow and known data-quality issues.
| 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. |
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.
v_sppg, bukan tabel sppg. v_sppg sudah difilter ke 38
provinsi valid (ref_provinsi). Tabel sppg mentah punya ~26 baris kotor.try/catch dan balikan res.status(500).json({ error: err.message }).
Pola: console.error('GET /path error:', err).$1, $2, …) untuk semua input user — jangan string-concat
nilai ke SQL.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.COV, V, KC, DAPODIK_AGG, COVERAGE_PCT) sudah ada di atas
file — pakai ulang, jangan duplikat logika kecamatan/coverage.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 })
}
})
req tak terpakai = idiom Express, abaikan).cd backend && node --test (tambah/ubah test di backend/tests/ bila logika berubah).curl -s localhost:3000/api/<path>.Cek dampak perubahan fungsi yang dipakai luas dengan code-review-graph detect-changes.