Ejen anda melukis peta keseluruhan sistem anda. Setiap sesi selepas itu memuatkan peta tersebut.

Tiga peraturan peta

• Topologi dilukis sekali sahaja, di akar. Plat tidak pernah mengulangi sambungan; ia hanya membawa butirannya sendiri dan prosedurnya. Penduaan ialah tempat penyimpangan bermula, jadi ia tidak wujud secara reka bentuk.
• Nilai tidak wujud di mana-mana dalam peta. Tiada port, had, harga atau kiraan — halaman menyatakan di mana nombor itu berada, bukan apa nilainya. Peta yang membawa nilai menjadi salah dalam masa seminggu.
• Sesiapa yang mengubah sambungan mengemas kini peta dalam sesi yang sama. Akar membawa satu baris — disahkan pada <tarikh> terhadap <apa> — dan pembaca mempercayai peta itu setakat itu sahaja.

Apa yang dipegang oleh peta akar, mengikut urutan

• Apa itu projek tersebut, dalam dua ayat, dan baris yang disahkan.
• Diagram tersebut: kotak-kotak dan anak panah; satu anak panah untuk setiap wayar, menunjukkan apa yang mengalir di dalamnya. Arah merupakan faktor yang paling penting dalam diagram ini.
• Wayar-wayar tersebut, disenaraikan: siapa yang memulakan prosesnya, apa yang dihantar, dan apa yang tidak pernah dihantar. Inilah bahagian yang dapat mengesan pembohongan.
• Kedai-kedai: setiap tempat yang menyimpan keadaan, apa yang terdapat di dalamnya, dan apa yang tidak pernah ada di sana.
• Indeks: setiap plat disenaraikan mengikut namanya, setiap prosedur pula disenaraikan mengikut plat dan bahagian masing-masing.

Apa yang terdapat dalam sebuah plat

• Untuk setiap bahagian daripada bidangnya: apa ia itu, apa yang dimilikinya, dengan apa dan ke arah mana ia berkomunikasi, apa yang tidak pernah dilakukannya, dan apa yang berlaku apabila ia dilaksanakan.
• Di mana nilai-nilai berada — penunjuk, bukan nilai itu sendiri.
• Prosedurnya: arahan yang tepat, apa yang perlu dibaca untuk mengetahui sama ada ia berjaya atau tidak, serta apa yang sebenarnya telah gagal semasa pelaksanaannya, bersama tarikhnya.

Pada hari Selasa, ejen anda membuka peta tersebut, melihat kabel yang akan disentuhnya, dan memeriksa tarikh pada garisan yang telah disahkan sebelum membuat sebarang perubahan.

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore

Empat bahagian, dan tiada yang lain.

• Diputuskan — satu baris untuk setiap keputusan yang telah dibuat: tarikh, siapa yang membuat keputusan, dan sebabnya. Sebuah cadangan tidak akan pernah dicatat sebagai telah diputuskan.
• Seterusnya — dipesan, maksimum sepuluh item. Setiap baris menyenaraikan nama barang dan menjelaskan rupa akhirnya. “Dipesan” merupakan satu-satunya status yang dimiliki oleh sesuatu pelan.
• Diparkir — idea-idea yang telah dikemukakan tetapi belum diputuskan, setiap satunya disertai dengan tarikh ia dikemukakan.
• Mulakan dengan manusia — keputusan yang hanya boleh dibuat oleh seseorang, satu baris setiap satu, disertai tarikh.

Undang-undang yang menghalangnya daripada membusuk

• “Selesai” bermaksud sudah dihapuskan. Sesiapa yang menyelesaikan sesuatu tugas akan membuangnya dalam sesi yang sama, dan meletakkan apa yang telah diubah di tempat yang sepatutnya: wayar tersebut diletakkan dalam atlas, keputusan atau pengukuran pula dimasukkan ke dalam rekod, manakala kod pula disimpan dalam komit. Tidak ada bahagian khusus untuk menandakan sesuatu sebagai “Selesai”.
• Entri tersebut dimasukkan ke dalamnya. Baris yang masih penting akan menjadi satu baris dalam kategori “Next” atau “Parked”, dan akan dikeluarkan daripada “Ledger”; yang lain pula akan diabaikan.
• Satu penulis pada satu masa. Baca rancangan tersebut terlebih dahulu sebelum mengubahnya, kemudian tulis semula keseluruhannya.

my-app-plan — walked 2026-09-10 by the Tuesday session

## Decided
2026-08-14 · you · Postgres, not SQLite — two writers, one box
2026-09-02 · you · ship the importer before the dashboard — nobody can try it empty

## Next
1. Importer accepts CSV with a header row. Finished: a real customer file lands.
2. Retry the webhook on 5xx. Finished: one blip stops costing a record.
3. Dashboard: one chart, last 30 days. Finished: it answers "is it working".

## Parked
2026-08-30 · a public status page — nothing to show yet

## Open with your user
2026-09-08 · free tier: how many rows before it asks for money