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.

Peta akar, dari segi bentuk

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