Konsol + situs publik

Dua tempat di mana Letaido menempatkan apa yang dibangunnya: satu untuk tim Anda, satu untuk orang lain.

1. Konsol (internal)

Console adalah aplikasi web khusus anggota tempat Letaido menyediakan alat internal. Anggap saja sebagai permukaan dasbor pribadi tim Anda.

Hanya dapat diakses oleh anggota workspace. Pengunjung anonim akan mendapatkan halaman login.
Aplikasi membaca identitas dari header autentikasi, sehingga setiap halaman mengetahui siapa yang melihatnya (pemilik, admin, anggota, viewer).
Akses database: baca/tulis penuh ke console_db dan console_site_db. Tidak dapat mengakses site_db.

Membuat halaman Console saat:

Output hanya untuk tim Anda.
Perlu melakukan kueri data internal, memanggil konektor, atau menampilkan kontrol.
Pelanggan tidak boleh melihatnya.

Laporan, Aplikasi, Artefak

Semua yang dibangun Letaido di Console termasuk dalam salah satu dari tiga kategori. Halaman beranda Console memiliki tab untuk masing-masing (Reports, Applications, Artifacts) ditambah tab Home yang mencantumkan semuanya bersama-sama, yang terbaru terlebih dahulu, dengan kategori sebagai tag di samping judul.

Bucket	Apa itu	Apa yang dilakukan tim Anda dengannya	Contoh
Reports	Grafik, tabel, dan tampilan data yang difilter	Membukanya, membaca angka, memfilter, meninggalkannya	Ahrefs Brand Authority, AI Visibility, Rank Monitor
Applications	Alat multi-halaman dan alur kerja yang kompleks	Menempelkan input, menjalankan pipeline, mendapatkan output, kembali ke hasil sebelumnya	Battlecard Generator, AI Visibility Dashboard, Paid Ads Campaign Builder
Artifacts	Item sekali pakai: grafik, tabel, potongan teks	Melihat sekilas, menyalinnya, membagikannya, melanjutkan	Email preview, homepage block, AEO 101 section, Ahrefs Feature Library

Laporan

Laporan adalah sesuatu yang Anda buka untuk melihat kondisi sesuatu. Nilainya terletak pada data yang ditampilkan; interaksi utamanya adalah membaca atau memfilter. Laporan diperbarui dari sumber datanya sesuai jadwal atau sesuai permintaan. Laporan berada di /reports/<slug>/.

Minta Report ketika jawaban untuk "mengapa ini ada" adalah "agar kita bisa melihat X secara sekilas" (status peringkat kita, pangsa suara minggu ini, delta otoritas merek bulan ini).

Aplikasi

Aplikasi adalah sesuatu yang Anda gunakan untuk menyelesaikan pekerjaan. Nilainya terletak pada alur kerja; interaksi utamanya adalah membuat, mengedit, atau memproduksi. Aplikasi menerima input, menjalankan pipeline multi-langkah, menyimpan hasil, dan memungkinkan tim Anda kembali ke eksekusi sebelumnya. Aplikasi berada di /applications/<slug>/.

Minta Application ketika jawaban untuk "mengapa ini ada" adalah "agar kami dapat melakukan X berulang kali tanpa perlu membangun ulang alur kerja setiap kali" (menghasilkan battlecard, menjalankan brief kampanye, membuat salinan konten).

Artefak

Artefak adalah satu bagian output yang Anda masukkan sekali dan rujuk nanti. Artefak bersifat kecil, mandiri, dan tidak perlu dibungkus dalam aplikasi atau laporan lengkap. Artefak berada di /artifacts/<slug>/.

Minta Artifact ketika jawaban untuk "mengapa ini ada" adalah "agar tim memiliki tempat untuk melihatnya" (pratinjau blok beranda, email minggu ini, pustaka fitur, lembar satu halaman untuk penjualan).

Tidak yakin mana yang Anda inginkan?

Jelaskan hasilnya dan agen memilih bucket yang tepat.

"Tunjukkan saya otoritas merek mingguan berdasarkan pesaing." → Laporan.
"Buatkan saya alat di mana saya menempelkan URL pesaing dan mendapatkan battlecard kembali." → Aplikasi.
"Hasilkan pratinjau buletin minggu depan." → Artefak.

2. Situs publik (eksternal)

Situs publik adalah bagian dari ruang kerja Anda yang dapat diakses oleh internet terbuka, sepenuhnya terpisah dari Console yang digunakan tim Anda. Situs ini ada untuk menyajikan konten kepada orang-orang di luar ruang kerja Anda.

Pola URL: /<route> untuk semuanya. Pola konvensional: /u/<token> untuk laporan bersama satu kali, /r2s/<token> untuk run yang ditinjau, /docs/<slug> untuk dokumen ini.
Visibilitas dikontrol oleh toggle tingkat workspace (lihat Mode di bawah).
Akses database: baca/tulis site_db (memilikinya). Baca/tulis console_site_db. Tidak dapat mengakses console_db.

Buat halaman situs publik ketika: - Pelanggan, prospek, atau pengunjung anonim perlu melihat sesuatu. - Anda menginginkan URL yang dapat dibagikan di luar email atau Slack. - Data sudah dibuat (di Console atau oleh job) dan Anda hanya menyajikannya.

Tiga mode untuk situs publik

Situs publik memiliki tiga status, yang dapat diubah oleh pemilik atau admin dari UI Ruang kerja. Agen itu sendiri tidak dapat mengubah status ini.

off: nginx mengembalikan 403 kepada semua orang. Proses Flask masih berjalan; tidak ada traffic yang mencapainya.
authorized: anggota Workspace dan tamu yang diundang secara eksplisit dapat melihatnya. Baik untuk tinjauan sebelum peluncuran.
open: siapa pun dengan URL dapat melihatnya. Perlakukan setiap pengunjung sebagai tidak tepercaya.

Ketika mode adalah open, agen menerapkan default tambahan: validasi Pydantic pada setiap input pengunjung, tidak ada panggilan konektor per pengunjung (cache ke site_db sebagai gantinya), persetujuan konektor terpisah untuk permukaan situs, dan output yang terlihat disanitasi sebelum persistensi.

Komunikasi lintas permukaan

Konsol dan situs publik berjalan dalam proses yang berbeda. Keduanya masih dapat bekerja sama, tetapi hanya melalui satu saluran eksplisit: database console_site_db.

Console menulis data (laporan, ringkasan, artefak) ke dalam tabel.
Situs publik membaca tabel tersebut dan merendernya di URL yang dilindungi token.
Situs dapat menulis kembali sinyal interaksi (misalnya "pengunjung mengklik") yang dibaca oleh Console.

Agen TIDAK mencoba mem-proxy kueri Console melalui rute publik. REVOKE berada di lapisan database; ini akan gagal, dan juga merupakan desain yang salah.