Di balik layar: mesin kantor v2

Apa yang berubah

Kantor v1 hidup di markdown yang disunting tangan. Graph-nya nol konsisten, role lambat membaca. Kantor v2 memindahkan sumber hukum ke Postgres di VPS. Markdown yang lu baca sekarang adalah hasil render, bukan sumber.

Prasyarat di Mac

Empat hal. Semua sudah terpasang 2 Sep 2026; ini cara memeriksanya. Role menjalankan langkah 3 sendiri di protokol pembuka.

1. Tailscale Mac nyala. API dan DB hanya terbuka di alamat tailnet. Mati = semua tulis gagal, render lokal tetap terbaca.

   tailscale status | head -3
   # kalau mati:
   tailscale up --timeout=20s --accept-routes

2. ~/.kantor/env ada, chmod 600. Isinya API_URL, KANTOR_DIR, RENDER_DIR, dan TOKEN_<ROLE>. Skrip membacanya sendiri. Nol pernah cat.

   ls -l ~/.kantor/env        # -rw------- = benar

3. Render terbaru. Hook prompt menarik otomatis bila tertinggal. Tarik tangan kapan saja:

   cd ~/Downloads/0000-ersapta-office
   bash kantor-v2/mac/tarik-render.sh    # mencetak STEMPEL: sync_seq, node, akar, tiket

4. Pemantau hidup. launchd com.ersapta.kantor.cek-vps memeriksa API tiap 5 menit dan menulis status.

   cat ~/.kantor/status.json
   tail -3 ~/.kantor/cek-vps.log

Membuka sesi role

Selalu dari folder kantor. Satu sesi = satu role. IT Lead dan Desainer satu sesi satu lane (lane-lock); PM satu sesi semua lane, nol lane-lock. Lane kedua = tab IT Lead baru.

cd ~/Downloads/0000-ersapta-office
claude            # atau codex; keduanya membaca aturan yang sama (CLAUDE.md, AGENTS.md)

Lalu panggil kursinya. Tiap role menjalankan protokol pembuka sendiri: tarik render, baca render/akar/<akar>/PAKET.md, klaim tiket bila role produksi.

Lane sah (10): CS, HP, ALX-TCG, ASF, BIP-ERP, WSMPP, CPP, DLPP, YETPP, RAACEPP. Di luar itu ditolak. Lane baru lewat Arsiparis.

Alur satu tiket, ujung ke ujung

Perintah di bawah dijalankan role (PM, IT Lead), bukan Sapta. Jalur ini menutup jebakan 30 persen dan kasus 179 cabang: kriteria selesai sebelum kode, ukuran tugas dibatasi, cabang hilang saat masuk.

1. Lu lempar kebutuhan mentah ke /pm, sebut lane-nya. PM memperkecil scope: SoW, FRD, EPIC, Cerita, Tugas. Kriteria terima milestone ditulis SEBELUM bangun. Kriteria itu yang lu bawa ke klien sampai align.
2. PM menulis di ClickUp. Pakai skill clickup-ops. Tugas wajib memuat Selesai bila: (min 20 karakter) dan Estimasi: <menit> (5 sampai 90). Lebih dari 90 menit = pecah.
3. PM memasukkan ke antrean. Urutan wajib epic, cerita, tugas. Tugas tanpa cerita induk ditolak. Contoh lane CS:

   PM="python3 kantor-v2/antrean/klaim.py --role pm"
   $PM masuk --clickup-id <id epic>   --lane CS --judul "..." --jenis epic
   $PM masuk --clickup-id <id cerita> --lane CS --judul "..." --jenis cerita \
      --induk-clickup <id epic> --selesai-bila "..." \
      --uraian "Sebagai ..., gue bisa ..., sehingga ..."
   $PM masuk --clickup-id <id tugas>  --lane CS --judul "..." --jenis tugas \
      --induk-clickup <id cerita> --selesai-bila "..." --estimasi 45

   clickup_id adalah kunci anti dobel: kirim ulang id yang sama memperbarui, nol menggandakan.
4. Tab baru: /it-lead <LANE>. IT Lead klaim dari repo project (bukan folder kantor). Satu sesi memegang satu tiket.

   cd ~/path/repo-project
   IT="python3 ~/Downloads/0000-ersapta-office/kantor-v2/antrean/klaim.py --role it_lead"
   $IT klaim --lane CS --repo .
   # keluaran: id, sesi, worktree, cabang, selesai_bila, estimasi_menit, langkah
   export KANTOR_SESI=<sesi dari keluaran>
   git worktree add ../CS-working-space-<id> -b tiket/<id>
   echo <id> > ../CS-working-space-<id>/.tiket

5. Bangun sampai selesai_bila terpenuhi, nol lebih. Hal di luar itu = satu baris tanya di catatan review, nol kode. Heartbeat tiap maks 30 menit.

   $IT heartbeat <id>
   # 409 MELAR = kerja lewat 2x estimasi; tiket otomatis ke review; berhenti, tulis catatan

6. IT Lead menyerahkan ke review. Catatan wajib memuat bukti uji. Lalu tulis jurnal it-lead/<tanggal>-<id>.

   $IT review <id> --catatan "apa yang diuji, di mana, hasilnya"

7. PM memeriksa dan memutus. Terima, atau kembalikan dengan alasan.

   $PM tiket <id>                          # detail + riwayat
   $PM selesai <id> --catatan "..."
   $PM buka-ulang <id> --catatan "..."

8. Gabung = hapus. Setelah selesai, PM menggabungkan cabang ke dev (ubah dengan MERGE_TARGET=main). Cabang dan worktree lenyap dalam perintah yang sama.

   bash kantor-v2/antrean/gabung.sh <repo> <id> origin
   bash kantor-v2/antrean/sapu_cabang.sh <repo>            # laporan harian
   bash kantor-v2/antrean/sapu_cabang.sh <repo> --hapus    # eksekusi

9. Tutup cerita dan epic. Semua anak selesai, PM menutup induknya dengan bukti kriteria diperiksa. Epic yang 70 persen ceritanya selesai tapi masih ada masalah terbuka menunggu putusan PM sebelum tugas berikutnya boleh diklaim.

   $PM tutup <id cerita> --catatan "Selesai bila diperiksa: ..."
   $PM epik --lane CS --putuskan
   $PM putus <id epic> --keputusan rilis_sebagian --catatan "Plan B: ..."
   # keputusan: lanjut | rilis_sebagian | potong | nego_waktu

Angka gerbang

Semua hidup di tabel pengaturan. Berubah hanya dengan ketok lu tertulis, satu UPDATE oleh Arsiparis, dicatat di jurnal. Nol ada di kode.

Membaca kantor tanpa sesi

Render adalah markdown biasa. Buka pakai editor apa pun, baca saja.

~/Downloads/0000-ersapta-office/render/
  INDEKS.md                      # daftar semua node per jenis
  STEMPEL                        # sync_seq, node, akar, tiket
  akar/<akar>/PAKET.md           # bacaan wajib tiap role: pm, it-lead, desainer, ceo, sales, arsiparis, arsip
  node/<jenis>/<slug>.md         # jenis: hukum, role, playbook, proyek, state, jurnal, putusan, kamus, templat
  node/<jenis>/<slug>/           # bagian-bagian node panjang (contoh: node/proyek/cs/00-pembuka/01-....md)

grep -rn "kata kunci" ~/Downloads/0000-ersapta-office/render/node/
python3 kantor-v2/mac/node.py --role ceo cari --q gotchas --jenis hukum
python3 kantor-v2/mac/node.py --role ceo baca state/org

• Situs SOP di tailnet (alamat lama yang sudah lu bookmark) kini dibangun dari render.git. Perubahan render tampil paling lama 10 menit kemudian. Hanya terbuka saat Tailscale nyala.
• Markdown v1 utuh di ~/Downloads/0000-ersapta-office/_arsip-v1/. Beku. Kalau ada yang masih lu butuhkan dari sana, minta Arsiparis memindahkannya jadi node.
• Menyunting berkas di render/ percuma: hook menolak, dan render berikutnya menimpanya.

Kalau macet

Cek kesehatan langsung (alamat dibaca dari env, nol ditulis di sini):

set -a; . ~/.kantor/env; set +a
curl -s "$API_URL/sehat"          # ok, postgres, falkordb, kepala, stempel, tertinggal, render_terakhir
ssh portfolio-vps 'cd /home/ubuntu/kantor/prasyarat/vps && docker compose --env-file .env ps'
ssh portfolio-vps 'cd /home/ubuntu/kantor/prasyarat/vps && docker compose --env-file .env up -d'   # hidupkan lagi yang mati

Peta tempat

Mac

VPS (ssh portfolio-vps)

Hukum yang tetap

• Bahasa Indonesia kasual (gue/lu). Dilarang em dash, en dash, arrow chain. Commit bersih tanpa AI attribution.
• Nol push ke GitHub untuk data kantor. Remote hanya bare repo di VPS.
• Rahasia: nol cat .env, nol cat akun-test/*, nol nilai kredensial di node, jurnal, tiket, transkrip, atau halaman ini.
• Fitur Artifact dan layanan publish luar HARAM untuk materi org. Deliverable = berkas lokal.
• Docker lokal di MacBook dilarang. Container hidup di VPS.
• render/ dan _arsip-v1/ baca saja. Hukum berubah hanya lewat Arsiparis dengan ketok lu.
• Angka volatile (cash, pipeline) di Notion dan ClickUp. Pengecualian: state/org dan state/<lane>, maks 8000 karakter, suntikan ke prompt maks 2 KB.
• Klaim pengalaman untuk proposal hanya dari jurnal/proof/lembar-bukti.

Belum hidup (jujur)

Terdaftar sebagai pekerjaan rawat Arsiparis di MULAI-ARSIPARIS.md. Kantor sudah bisa dipakai tanpa semuanya.

• Relay ClickUp ke antrean lewat n8n + HMAC. Sampai hidup, PM memakai klaim.py --role pm masuk. Saat hidup, perintah itu tetap sah.
• login.py: login Playwright ke akun klien tanpa sandi lewat argumen.
• Impor upwork.db lama ke tabel sinyal.
• Halaman render ringkasan sinyal_pemicu untuk CEO tanpa API.
• Digest transkrip dari hook kantor ke DB.
• Empat paket akar di atas 60000 karakter (ceo, sales, it-lead, desainer). Hanya peringatan; dipecah dengan mengubah rujukan panjang jadi merujuk.
• Putar ulang 11 kunci layanan .env kantor v1: tangan lu, lewat dashboard tiap layanan.