Kenapa namanya Kanesh

Nama Kanesh diambil dari kota dagang Zaman Perunggu yang para pedagangnya menyimpan catatan sendiri di lempeng tanah liat. Nama itu menghubungkan kebiasaan menjaga arsip mandiri dengan platform data self-hosted tempat kamu mengelola koleksi, record, dan akses workspace sendiri.

Dari mana asal nama Kanesh?

Kanesh, juga ditulis Kaniš, adalah kota di Anatolia tengah, dekat Kayseri di Turki sekarang. Sekitar abad ke-20 sampai ke-18 SM, pedagang dari Assur menjalankan kawasan dagang di sana yang disebut kārum. Nama perangkat lunak ini merujuk pada kota tersebut dan catatan yang ditinggalkan para pedagangnya.

Arkeolog menemukan puluhan ribu lempeng tanah liat di rumah-rumah pedagang itu. Isinya mencakup surat antar mitra, catatan pengiriman, utang, kontrak, dan catatan pengadilan, ditulis dengan aksara paku. Setiap rumah menyimpan arsipnya sendiri. Hubungan antara kegiatan sehari-hari dan catatan pendukungnya itulah yang menjadi dasar pemilihan nama.

Perbandingan ini adalah analogi, bukan spesifikasi teknis. Lempeng tanah liat tidak menjelaskan cara database menjaga relasi atau memeriksa izin sebuah token. Cerita tersebut membantu menjelaskan tujuan proyek: sistem pencatatan yang kamu host dan kelola sendiri.

Apa hubungan arsip dengan data aplikasi?

Koleksi memberi struktur yang sama pada record sejenis. Field bertipe dan validasi menentukan data apa yang dapat masuk ke struktur tersebut. Relasi menghubungkan record, sedangkan grafik skema membantu memperlihatkan hubungan dalam model data. Fitur-fitur inilah yang menjadi padanan teknis dari gagasan tentang arsip.

Misalnya, sebuah catatan pengiriman mengajak kita memikirkan field yang dibutuhkan dan record lain yang perlu dirujuk. Itu adalah latihan merancang model, bukan pernyataan bahwa Kanesh menyediakan aplikasi pengiriman siap pakai. Kamu tetap menentukan koleksi dan arti setiap field sesuai kebutuhan aplikasimu.

Gagasan dari Kanesh dahulu	Hubungannya dengan Kanesh sekarang
Satu lempeng mencatat satu transaksi	Koleksi menampung record individual
Format berulang untuk utang dan pengiriman	Field bertipe dan validasi menentukan struktur
Lempeng merujuk ke lempeng lain	Relasi dan grafik skema menghubungkan data
Setiap rumah menyimpan arsip	Workspace self-hosted menyimpan catatan yang kamu kelola
Amplop tersegel ditujukan kepada penerima	Peran dan izin koleksi mengatur akses
Surat dikirim antar kota	REST, GraphQL, dan MCP membuka akses bagi klien

Hubungan ini menjelaskan nama tanpa menjanjikan padanan teknis yang persis untuk setiap praktik sejarah. Khususnya, analogi amplop tersegel membicarakan siapa yang boleh mengakses catatan, bukan menyatakan adanya fitur enkripsi tertentu.

Apa arti menyimpan catatan sendiri dalam Kanesh?

Kanesh berjalan sebagai satu image aplikasi yang sudah menyertakan Studio. SQLite menjadi database bawaan dengan data lokal, sedangkan PostgreSQL dan MySQL didukung untuk penggunaan eksternal. Dalam model self-hosted ini, memilih penyimpanan dan mengelola instalasi menjadi bagian dari penggunaan platform.

Satu instalasi mendukung workspace terpisah dengan anggota dan perannya masing-masing. Satu workspace gratis, dan workspace tanpa batas butuh lisensi Pro seharga $9 per bulan per instalasi (lihat harga). Studio menyediakan tempat untuk menentukan koleksi dan mengelola record. REST dan GraphQL menyediakan akses ke koleksi tersebut, sementara ekspor OpenAPI 3.1 mengikuti skema yang sedang dipakai. Arsipmu dapat dibaca oleh klien aplikasi sesuai izin yang diberikan.

Latihan awal yang bisa dilakukan adalah membuat koleksi kecil, menambahkan record, lalu memeriksa referensi API-nya. Panduan memulai menjelaskan build image dan klaim instalasi. Untuk konteks aplikasi, lanjutkan ke use case CRM atau alat internal.

Bagaimana akses pengguna dan agent diatur?

Gagasan arsip juga mencakup batas akses: sebuah catatan perlu tersedia bagi pembaca yang tepat. Kanesh memakai otorisasi workspace yang sama di Studio, REST, GraphQL, dan MCP. Peran serta izin per koleksi menentukan operasi yang dapat dilakukan anggota.

Codex dan Claude Code dapat terhubung melalui MCP read-only. Tool yang tersedia membaca skema dan record sesuai izin pemilik token. Tool tersebut tidak dapat menulis melalui MCP. Pembuatan koleksi atau record harus melalui REST dengan akun yang memiliki izin yang dibutuhkan.

Token pribadi mengikuti izin pemiliknya, bukan memiliki cakupan akses terpisah. Tinjau izin akun sebelum menghubungkan agent. Dokumentasi MCP menjelaskan pengaturan serta tool yang tersedia. Jika kamu mengevaluasi platform lain bersama Kanesh, perbandingan dengan Directus dapat menjadi bacaan berikutnya.

Apa yang tidak bisa disimpulkan dari namanya?

Nama menjelaskan tujuan, sedangkan dokumentasi saat ini menjelaskan kemampuan. Kanesh masih baru, di rilis stabil pertamanya. Realtime, login OAuth, dan workflow ada di roadmap.

Gunakan cerita nama ini sebagai pengingat untuk memikirkan struktur catatan dan siapa yang mengelolanya. Setelah itu, nilai Kanesh berdasarkan operasi koleksi, aturan akses, dan dukungan database yang memang didokumentasikan. Cerita sejarah membantu memperkenalkan proyek, tetapi keputusan penggunaan tetap memerlukan pemeriksaan kemampuan saat ini.

FAQ

Mengapa platform ini dinamai Kanesh?

Namanya merujuk pada kota Zaman Perunggu tempat pedagang menyimpan arsip lempeng tanah liat di rumah masing-masing. Arsip itu mencakup surat, catatan pengiriman, utang, kontrak, dan catatan pengadilan. Perangkat lunak Kanesh memakai kisah tersebut sebagai analogi sistem pencatatan self-hosted.

Apakah Kaniš berbeda dari Kanesh?

Kaniš adalah ejaan lain dari Kanesh dalam kisah yang melatarbelakangi nama proyek. Kota itu berada di Anatolia tengah, dekat Kayseri di Turki sekarang. Nama perangkat lunaknya memakai Kanesh, sedangkan penjelasan sejarahnya menyertakan kedua ejaan tersebut.

Apakah analogi arsip berarti produknya sudah selesai?

Belum sepenuhnya. Kanesh masih baru, di rilis stabil pertamanya. Koleksi, Studio, API, izin workspace, dan MCP read-only adalah kemampuan yang didokumentasikan, sementara realtime, OAuth, dan workflow ada di roadmap. Nilai kemampuan yang tersedia itu secara terpisah dari cerita di balik namanya.