feat(umkm): migrate KategoriProduk to KategoriProdukUmkm for UMKM isolation

- update prisma schema to use KategoriProdukUmkm for Umkm model
- add @@map to KategoriProdukUmkm for lowercase table naming
- update API endpoints and KPI dashboard to use new model
- bump version to 0.1.33
This commit is contained in:
2026-04-28 00:47:22 +08:00
parent 5ab014281a
commit a4c7a97593
13 changed files with 533 additions and 158 deletions

View File

@@ -1,8 +1,8 @@
# deploy-stg
Deploy ke staging environment secara penuh: version bump, cek migrasi, commit, push, trigger GitHub workflow (publish + re-pull), dan verifikasi versi.
Deploy ke staging environment secara penuh menggunakan MCP server `deploy-stg`.
**Repo GitHub:** `bipproductbali/desa-darmasaba`
**Repo GitHub:** `bipprojectbali/desa-darmasaba`
**Branch stg:** `stg`
**STG URL:** `https://desa-darmasaba-stg.wibudev.com`
@@ -10,37 +10,30 @@ Deploy ke staging environment secara penuh: version bump, cek migrasi, commit, p
## Alur Eksekusi
### Langkah 0 — Cek /api/version
Sebelum apapun, pastikan endpoint `/api/version` sudah ada:
### Langkah 0 — Cek /api/version endpoint
Pastikan endpoint `/api/version` sudah ada di API:
```bash
grep -n '"/version"' src/app/api/\[\[...slugs\]\]/route.ts
```
Jika belum ada, tambahkan langsung ke main API group (referensi dari package.json via `fs.readFile`).
Jika belum ada, tambahkan ke main API group yang membaca `version` dari `package.json`.
---
### Langkah 1 — Version Bump
Baca versi saat ini dari `package.json`, bump patch version (+1), lalu tulis ulang:
```bash
# Baca versi saat ini
node -e "const p=require('./package.json'); const [maj,min,pat]=p.version.split('.').map(Number); console.log(maj+'.'+min+'.'+(pat+1))"
```
Update `package.json` dengan versi baru. Simpan versi baru sebagai `$NEW_VERSION`.
Gunakan MCP tool `bump_version` (server: `deploy-stg`).
Tool otomatis baca `package.json`, increment patch (+1), tulis kembali.
Catat `new_version` dari response — akan dipakai di Langkah 5 dan 6.
---
### Langkah 2 — Cek Prisma Migration
### Langkah 2 — Cek & Buat Migration
```bash
bunx prisma migrate status
```
Gunakan MCP tool `check_migrations` (server: `deploy-stg`).
- Jika output mengandung kata `pending` atau `drift` → buat migrasi baru:
```bash
bunx prisma migrate dev --name bump-stg-<new_version>
```
- Jika sudah up-to-date → lanjut ke langkah berikutnya.
- Jika `needs_migration: true` → jalankan `create_migration` dengan `name: bump-stg-<new_version>`
- Jika `is_up_to_date: true` → lanjut ke Langkah 3
---
@@ -50,126 +43,78 @@ bunx prisma migrate status
bun run build
```
Jika build gagal, **stop** dan perbaiki error dulu sebelum melanjutkan deploy.
Jika build gagal **stop**, perbaiki error sebelum melanjutkan.
---
### Langkah 4 — Commit
### Langkah 4 — Commit & Push ke stg
Stage semua perubahan dan commit:
```bash
git add package.json
git add prisma/migrations/ # jika ada migrasi baru
git commit -m "chore: bump version to $NEW_VERSION for stg deploy"
```
Gunakan MCP tool `commit_and_push_stg` (server: `deploy-stg`).
Tool otomatis stage `package.json` + `prisma/migrations/`, commit dengan message yang menyertakan versi baru, lalu push ke branch `stg` menggunakan `GH_TOKEN`.
---
### Langkah 5 — Push ke origin/stg
### Langkah 5 — Trigger publish.yml
```bash
git push origin HEAD:stg
```
Gunakan MCP tool `trigger_publish` (server: `deploy-stg`):
- `stack_env`: `stg` (default)
- `tag`: nilai `new_version` dari Langkah 1 (sama persis dengan versi di `package.json`)
Tunggu push selesai sebelum trigger workflow.
Tool mengembalikan `run_id`. Poll dengan `watch_workflow_run` setiap 30 detik hingga `status == "completed"`:
- `conclusion == "success"` → lanjut ke Langkah 6
- `conclusion != "success"`**stop**, tampilkan error, jangan lanjut ke re-pull
---
### Langkah 6 — Trigger publish.yml
### Langkah 6 — Trigger re-pull.yml
**Input 1:** `stack_env` = `stg`
**Input 2:** `tag` = versi dari package.json (contoh: `0.1.25`)
Setelah publish berhasil, gunakan MCP tool `trigger_repull` (server: `deploy-stg`):
- `stack_name`: otomatis dari env `STACK_NAME` (tidak perlu diisi manual)
- `stack_env`: `stg`
```bash
gh workflow run publish.yml \
--repo bipprojectbali/desa-darmasaba \
--ref stg \
-f stack_env=stg \
-f tag=$NEW_VERSION
```
Tunggu 5 detik lalu dapatkan run ID:
```bash
sleep 5
RUN_ID=$(gh run list \
--workflow=publish.yml \
--repo bipprojectbali/desa-darmasaba \
--limit 1 \
--json databaseId \
-q '.[0].databaseId')
```
Monitor sampai selesai:
```bash
gh run watch $RUN_ID --repo bipprojectbali/desa-darmasaba
```
Jika publish **gagal** → **stop**, jangan lanjut ke re-pull.
Stack yang di-deploy: `<STACK_NAME>-stg`. Poll dengan `watch_workflow_run` setiap 30 detik hingga `status == "completed"`.
---
### Langkah 7 — Trigger re-pull.yml
### Langkah 7 — Verifikasi Versi
Setelah publish berhasil, trigger re-pull:
Gunakan MCP tool `check_stg_version` (server: `deploy-stg`):
- `wait_seconds`: `30` (tunggu container siap)
**Input 1:** `stack_env` = `stg`
**Input 2:** `stack_name` = `desa-darmasaba` → stack yang di-deploy: `desa-darmasaba-stg`
```bash
gh workflow run re-pull.yml \
--repo bipprojectbali/desa-darmasaba \
--ref main \
-f stack_name=desa-darmasaba \
-f stack_env=stg
```
Tunggu 5 detik lalu monitor:
```bash
sleep 5
REPULL_ID=$(gh run list \
--workflow=re-pull.yml \
--repo bipprojectbali/desa-darmasaba \
--limit 1 \
--json databaseId \
-q '.[0].databaseId')
gh run watch $REPULL_ID --repo bipprojectbali/desa-darmasaba
```
Tool otomatis fetch `BASE_URL/api/version` dan bandingkan dengan versi lokal.
- `match: true`**Deploy berhasil!**
- `match: false` → cek container logs di Portainer atau jalankan `gh run view <run_id> --repo bipprojectbali/desa-darmasaba --log`
---
### Langkah 8 — Verifikasi Versi
## Ringkasan MCP Tools
Bandingkan versi di stg dengan versi lokal:
```bash
# Versi lokal
LOCAL_VER=$(node -e "console.log(require('./package.json').version)")
# Versi di STG (tunggu container siap ~30 detik)
sleep 30
STG_VER=$(curl -s https://desa-darmasaba-stg.wibudev.com/api/version | node -e "process.stdin.resume();let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.parse(d).version))")
echo "Local : $LOCAL_VER"
echo "STG : $STG_VER"
```
- Jika `LOCAL_VER == STG_VER` → **Deploy berhasil!**
- Jika berbeda → cek logs container di Portainer atau jalankan `gh run view $REPULL_ID --repo bipprojectbali/desa-darmasaba --log`
---
| Tool | Server | Tujuan |
|------|--------|--------|
| `bump_version` | `deploy-stg` | Increment patch version di package.json |
| `check_migrations` | `deploy-stg` | Cek status Prisma migrations |
| `create_migration` | `deploy-stg` | Buat migration baru jika diperlukan |
| `commit_and_push_stg` | `deploy-stg` | Commit + push ke branch stg |
| `trigger_publish` | `deploy-stg` | Trigger publish.yml (build Docker image) |
| `watch_workflow_run` | `deploy-stg` | Poll status workflow run |
| `trigger_repull` | `deploy-stg` | Trigger re-pull.yml (redeploy di Portainer) |
| `check_stg_version` | `deploy-stg` | Bandingkan versi lokal vs STG |
## Ringkasan Workflow Inputs
| Workflow | Input | Value |
|----------|-------|-------|
| `publish.yml` | `stack_env` | `stg` |
| `publish.yml` | `tag` | versi dari `package.json` (e.g. `0.1.25`) |
| `re-pull.yml` | `stack_name` | `desa-darmasaba` |
| `publish.yml` | `tag` | versi dari `package.json` (e.g. `0.1.26`) |
| `publish.yml` | `stack_name` | dari env `STACK_NAME` (opsional) |
| `re-pull.yml` | `stack_name` | dari env `STACK_NAME` (otomatis) |
| `re-pull.yml` | `stack_env` | `stg` |
## Catatan
- Jangan jalankan `re-pull.yml` jika `publish.yml` belum selesai/berhasil.
- Verifikasi versi dilakukan via `/api/version` (bukan `/api/utils/version`).
- Jika `gh` belum login: `gh auth login`.
- Untuk cek status workflow manual: `gh run list --repo bipprojectbali/desa-darmasaba`.
- Isi `GH_TOKEN` di `.env` sebelum menjalankan deploy (bisa sama dengan `GH_TOKEN`).
- `BASE_URL` di `.env` sudah diset ke `https://desa-darmasaba-stg.wibudev.com`.
- `STACK_NAME` di `.env` diset ke nama stack (e.g. `desa-darmasaba`) — dipakai otomatis oleh `trigger_publish` dan `trigger_repull`.
- Verifikasi versi via `/api/version` (bukan `/api/utils/version`).

View File

@@ -1,12 +1,16 @@
#!/usr/bin/env node
/**
* MCP Server: GitHub Actions Workflow Tools
* Tools: trigger_publish, trigger_repull, get_workflow_runs, watch_workflow_run
* MCP Server: GitHub Actions Workflow Tools + Deploy-STG Pre/Post Steps
* Tools: trigger_publish, trigger_repull, get_workflow_runs, watch_workflow_run,
* check_migrations, create_migration, bump_version, commit_and_push_stg, check_stg_version
*/
import { execSync, spawnSync } from "child_process";
import { spawnSync } from "child_process";
import { readFileSync, writeFileSync } from "fs";
import { join } from "path";
const REPO = "bipprojectbali/desa-darmasaba";
const CWD = process.cwd();
// --- MCP Protocol Helpers ---
@@ -24,8 +28,12 @@ function respondError(id, code, message) {
// --- Shell Helper ---
function runCmd(cmd) {
const r = spawnSync("sh", ["-c", cmd], { encoding: "utf-8" });
function runCmd(cmd, opts = {}) {
const r = spawnSync("sh", ["-c", cmd], {
encoding: "utf-8",
cwd: CWD,
...opts,
});
if (r.error) return { ok: false, out: r.error.message };
if (r.status !== 0) return { ok: false, out: (r.stderr || r.stdout || "").trim() };
return { ok: true, out: (r.stdout || "").trim() };
@@ -41,21 +49,75 @@ function getLatestRunId(workflow, delaySecs = 3) {
// --- Tool Definitions ---
const TOOLS = [
{
name: "check_migrations",
description: "Cek status Prisma migrations. Returns apakah ada pending migrations.",
inputSchema: { type: "object", properties: {} },
},
{
name: "create_migration",
description: "Buat Prisma migration baru (prisma migrate dev). Jalankan hanya jika check_migrations mendeteksi pending/drift.",
inputSchema: {
type: "object",
properties: {
name: {
type: "string",
description: "Nama migration (e.g. bump-stg-0.1.26)",
},
},
required: ["name"],
},
},
{
name: "bump_version",
description: "Baca versi dari package.json, increment patch (+1), tulis kembali. Returns old_version dan new_version.",
inputSchema: { type: "object", properties: {} },
},
{
name: "commit_and_push_stg",
description: "Stage package.json + prisma/migrations, commit, lalu push ke branch stg menggunakan GH_TOKEN.",
inputSchema: {
type: "object",
properties: {
message: {
type: "string",
description: "Commit message. Jika tidak diisi, auto-generate dari versi package.json.",
},
},
},
},
{
name: "check_stg_version",
description: "Bandingkan versi lokal (package.json) dengan versi di STG (/api/version). Tunggu container siap jika perlu.",
inputSchema: {
type: "object",
properties: {
wait_seconds: {
type: "number",
description: "Detik tunggu sebelum fetch STG (default: 30, untuk memberi waktu container siap).",
},
},
},
},
{
name: "trigger_publish",
description:
"Trigger publish.yml workflow: build & push Docker image to GHCR. Returns run ID.",
"Trigger publish.yml workflow: build & push Docker image ke GHCR. Returns run ID.",
inputSchema: {
type: "object",
properties: {
stack_env: {
type: "string",
enum: ["dev", "stg", "prod"],
description: "Target environment (branch dengan nama ini akan di-checkout)",
description: "Target environment. Default: stg.",
},
tag: {
type: "string",
description: "Image tag, biasanya versi dari package.json (e.g. 0.1.25)",
description: "Image tag — harus sama persis dengan versi di package.json (e.g. 0.1.25).",
},
stack_name: {
type: "string",
description: `Nama stack. Default: nilai env STACK_NAME (${process.env.STACK_NAME || "belum diset"}).`,
},
},
required: ["stack_env", "tag"],
@@ -64,21 +126,21 @@ const TOOLS = [
{
name: "trigger_repull",
description:
"Trigger re-pull.yml workflow: redeploy stack di Portainer. Hanya jalankan setelah publish berhasil.",
"Trigger re-pull.yml workflow: redeploy stack di Portainer. Jalankan HANYA setelah publish berhasil.",
inputSchema: {
type: "object",
properties: {
stack_name: {
type: "string",
description: "Nama stack (e.g. desa-darmasaba). Stack yang di-deploy: <stack_name>-<stack_env>",
description: `Nama stack (e.g. desa-darmasaba). Stack yang di-deploy: <stack_name>-<stack_env>. Default: nilai env STACK_NAME (${process.env.STACK_NAME || "belum diset"}).`,
},
stack_env: {
type: "string",
enum: ["dev", "stg", "prod"],
description: "Target environment",
description: "Target environment.",
},
},
required: ["stack_name", "stack_env"],
required: ["stack_env"],
},
},
{
@@ -108,7 +170,7 @@ const TOOLS = [
properties: {
run_id: {
type: "number",
description: "ID workflow run (dapat dari get_workflow_runs)",
description: "ID workflow run (dapat dari trigger_publish / trigger_repull / get_workflow_runs)",
},
},
required: ["run_id"],
@@ -118,16 +180,164 @@ const TOOLS = [
// --- Tool Handlers ---
function handleCheckMigrations() {
const r = runCmd("bunx prisma migrate status 2>&1", { timeout: 30000 });
const out = r.out || "";
const hasPending =
out.includes("following migration(s) have not yet been applied") ||
out.includes("drift") ||
out.includes("pending");
const isUpToDate =
out.includes("Database schema is up to date") ||
out.includes("up to date");
return {
ok: true,
needs_migration: hasPending && !isUpToDate,
is_up_to_date: isUpToDate,
output: out,
};
}
function handleCreateMigration(args) {
const { name } = args;
const r = runCmd(
`echo "" | bunx prisma migrate dev --name ${name} --skip-generate 2>&1`,
{ timeout: 120000 }
);
return {
ok: r.ok,
output: r.out,
error: r.ok ? undefined : r.out,
};
}
function handleBumpVersion() {
const pkgPath = join(CWD, "package.json");
let pkg;
try {
pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
} catch (e) {
return { ok: false, error: `Gagal baca package.json: ${e.message}` };
}
const oldVersion = pkg.version;
const [maj, min, pat] = oldVersion.split(".").map(Number);
const newVersion = `${maj}.${min}.${pat + 1}`;
pkg.version = newVersion;
try {
writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
} catch (e) {
return { ok: false, error: `Gagal tulis package.json: ${e.message}` };
}
return { ok: true, old_version: oldVersion, new_version: newVersion };
}
function handleCommitAndPushStg(args) {
const { message } = args || {};
// Baca versi untuk auto commit message
let version = "unknown";
try {
const pkg = JSON.parse(readFileSync(join(CWD, "package.json"), "utf-8"));
version = pkg.version;
} catch {}
const commitMsg = message || `chore: bump version to ${version} for stg deploy`;
// Stage file
runCmd("git add package.json 2>&1");
runCmd("git add prisma/migrations/ 2>&1");
// Cek apakah ada yang di-stage
const statusR = runCmd("git diff --cached --name-only 2>&1");
if (!statusR.out.trim()) {
return { ok: false, error: "Tidak ada perubahan yang di-stage untuk di-commit." };
}
// Commit
const commitR = runCmd(`git commit -m "${commitMsg}" 2>&1`);
if (!commitR.ok) return { ok: false, step: "commit", error: commitR.out };
// Push ke stg menggunakan GH_TOKEN jika tersedia
const token = process.env.GH_TOKEN;
const pushCmd = token
? `git push https://x-access-token:${token}@github.com/${REPO}.git HEAD:stg 2>&1`
: `git push origin HEAD:stg 2>&1`;
const pushR = runCmd(pushCmd, { timeout: 60000 });
if (!pushR.ok) return { ok: false, step: "push", error: pushR.out };
return {
ok: true,
message: `Berhasil commit "${commitMsg}" dan push ke stg`,
version,
};
}
function handleCheckStgVersion(args) {
const waitSecs = (args && args.wait_seconds) || 30;
const baseUrl = process.env.BASE_URL;
if (!baseUrl) {
return { ok: false, error: "BASE_URL tidak ada di environment — isi di .env" };
}
// Baca versi lokal
let localVersion;
try {
const pkg = JSON.parse(readFileSync(join(CWD, "package.json"), "utf-8"));
localVersion = pkg.version;
} catch (e) {
return { ok: false, error: `Gagal baca package.json: ${e.message}` };
}
// Tunggu container siap
if (waitSecs > 0) {
runCmd(`sleep ${waitSecs}`);
}
// Fetch versi dari STG
const r = runCmd(`curl -sf --max-time 10 "${baseUrl}/api/version" 2>&1`);
if (!r.ok) {
return {
ok: false,
error: `Gagal fetch ${baseUrl}/api/version: ${r.out}`,
local_version: localVersion,
};
}
let stgVersion;
try {
stgVersion = JSON.parse(r.out).version;
} catch {
return {
ok: false,
error: `Gagal parse response: ${r.out}`,
local_version: localVersion,
};
}
const match = localVersion === stgVersion;
return {
ok: true,
local_version: localVersion,
stg_version: stgVersion,
match,
status: match
? "✓ DEPLOY BERHASIL — versi STG sudah sesuai"
: "✗ VERSI BERBEDA — cek container logs di Portainer",
};
}
function handleTriggerPublish(args) {
const { stack_env, tag } = args;
const triggerCmd = `gh workflow run publish.yml --repo ${REPO} --ref ${stack_env} -f stack_env=${stack_env} -f tag=${tag}`;
const { stack_env = "stg", tag, stack_name } = args;
const resolvedStackName = stack_name || process.env.STACK_NAME;
let triggerCmd = `gh workflow run publish.yml --repo ${REPO} --ref ${stack_env} -f stack_env=${stack_env} -f tag=${tag}`;
if (resolvedStackName) triggerCmd += ` -f stack_name=${resolvedStackName}`;
const r = runCmd(triggerCmd);
if (!r.ok) return { ok: false, error: r.out };
const runId = getLatestRunId("publish.yml");
return {
ok: true,
message: `Workflow publish.yml berhasil di-trigger (env=${stack_env}, tag=${tag})`,
message: `Workflow publish.yml di-trigger (env=${stack_env}, tag=${tag}${resolvedStackName ? `, stack=${resolvedStackName}` : ""})`,
run_id: runId ? Number(runId) : null,
monitor_hint: runId
? `Gunakan watch_workflow_run dengan run_id: ${runId}`
@@ -136,7 +346,12 @@ function handleTriggerPublish(args) {
}
function handleTriggerRepull(args) {
const { stack_name, stack_env } = args;
const resolvedStackName = args.stack_name || process.env.STACK_NAME;
const { stack_env } = args;
if (!resolvedStackName) {
return { ok: false, error: "stack_name wajib diisi atau set env STACK_NAME di .mcp.json" };
}
const stack_name = resolvedStackName;
const triggerCmd = `gh workflow run re-pull.yml --repo ${REPO} --ref main -f stack_name=${stack_name} -f stack_env=${stack_env}`;
const r = runCmd(triggerCmd);
if (!r.ok) return { ok: false, error: r.out };
@@ -144,7 +359,7 @@ function handleTriggerRepull(args) {
const runId = getLatestRunId("re-pull.yml");
return {
ok: true,
message: `Workflow re-pull.yml berhasil di-trigger (stack=${stack_name}-${stack_env})`,
message: `Workflow re-pull.yml di-trigger (stack=${stack_name}-${stack_env})`,
run_id: runId ? Number(runId) : null,
monitor_hint: runId
? `Gunakan watch_workflow_run dengan run_id: ${runId}`
@@ -199,7 +414,7 @@ function handleMessage(msg) {
respond(id, {
protocolVersion: "2024-11-05",
capabilities: { tools: {} },
serverInfo: { name: "github-actions", version: "1.0.0" },
serverInfo: { name: "deploy-stg", version: "2.0.0" },
});
return;
}
@@ -220,8 +435,13 @@ function handleMessage(msg) {
const { name, arguments: args = {} } = params;
let result;
if (name === "trigger_publish") result = handleTriggerPublish(args);
else if (name === "trigger_repull") result = handleTriggerRepull(args);
if (name === "check_migrations") result = handleCheckMigrations();
else if (name === "create_migration") result = handleCreateMigration(args);
else if (name === "bump_version") result = handleBumpVersion();
else if (name === "commit_and_push_stg") result = handleCommitAndPushStg(args);
else if (name === "check_stg_version") result = handleCheckStgVersion(args);
else if (name === "trigger_publish") result = handleTriggerPublish(args);
else if (name === "trigger_repull") result = handleTriggerRepull(args);
else if (name === "get_workflow_runs") result = handleGetWorkflowRuns(args);
else if (name === "watch_workflow_run") result = handleWatchWorkflowRun(args);
else {