README

Dokumentasi internal Nawasara, hidup di dalam aplikasi di /nawasara-docs.

Isinya dibaca dari kode yang sedang berjalan, bukan dari catatan terpisah — daftar endpoint datang dari tabel route, daftar scope dari registry, katalog komponen dari file blade nawasara/ui, dan panduan dari berkas markdown yang sudah ada di repo. Dokumentasi yang menyalin akan basi tanpa ada yang menyadarinya; yang membaca dari sumbernya tidak bisa.

Isi

Halaman	Sumber
Katalog komponen	memindai `packages/nawasara-ui/resources/views/components/**`
Referensi API	`Route::getRoutes()` + `ScopeRegistry::grouped()`
Autentikasi & token	ditulis manual — menjelaskan alur, bukan mendaftar data
Install agent secscan	`packages/nawasara-secscan/README.md` mulai baris 132
Membuat package baru	`AGENTS.md`

Halaman API juga menandai dua hal yang tidak memunculkan error di mana pun: scope yang dipakai route tapi belum didaftarkan (endpoint terkunci untuk semua token), dan scope terdaftar yang tidak dipakai route mana pun (kemungkinan middleware lupa dipasang).

Akses

Di belakang auth dan permission docs.page.view. Muncul di sidebar pada grup Pengaturan.

php artisan db:seed --class="Nawasara\Docs\Database\Seeders\PermissionSeeder"

Hanya view — tidak ada create/update/delete. Isi dokumentasi dibangun dari berkas dan katalog runtime, bukan dari basis data, jadi tidak ada yang dapat disunting lewat panel; izin tulis hanya akan menggerbang halaman yang tidak ada.

Seeder memberikan izin ini ke semua peran yang ada, bukan hanya developer. Dokumentasi adalah cara memakai sistem, dan menggerbangnya ke developer saja mencabut panduan dari justru orang yang paling membutuhkannya: operator OPD yang baru memakai sistemnya. Yang berubah adalah izin itu kini dapat dicabut per peran.

⚠️ Seed dulu sebelum memasang versi ini. Sebelumnya menu memakai permission => null, jadi semua pemilik akun melihatnya. Tanpa seeder, workspace Dokumentasi hilang dari sidebar semua orang — WorkspaceManager::accessible() menyaring dengan izin yang belum ada.

Penggerbangan dilakukan di dua tempat, dan keduanya perlu: config/menu.php menyembunyikan menunya, routes/web.php menolak URL-nya. Menyembunyikan menu saja tetap menyisakan alamatnya dapat diketik langsung.

Yang perlu diketahui saat mengubah

Katalog di-cache 5 menit. Saat sedang menyunting komponen, panggil POST /nawasara-docs/refresh atau php artisan cache:clear supaya perubahan langsung terlihat.

Dokumentasi komponen tidak seragam. Sebagian punya blok {{-- --}} di awal file dengan bagian Pemakaian:, sebagian hanya komentar per-prop, sebagian tidak ada sama sekali. Halaman katalog menandai yang belum terdokumentasi alih-alih menyembunyikannya, jadi daftarnya sekaligus berfungsi sebagai daftar pekerjaan. Format paling lengkap ada di components/badge.blade.php — tiru itu.

Tailwind butuh dua @source. Di resources/css/app.css package ini terdaftar lewat packages/ dan vendor/. Yang pertama untuk dev lokal, karena vendor/nawasara/docs di Windows berupa junction dan Tailwind tidak menelusurinya; yang kedua untuk build server, di mana packages/ kosong.

Halaman docs adalah view statis, bukan Livewire. Komponen x-nawasara-ui::form.* mengandalkan konteks Livewire dan akan melempar Using $this when not in object context bila dipakai di sini — pakai elemen native untuk kebutuhan sederhana seperti kotak pencarian sisi klien.

Menambah halaman

Buat blade di resources/views/pages/
Daftarkan rute di routes/web.php di dalam grup yang sudah ada — grup itu sudah membawa auth + docs.page.view, jadi halaman baru ikut tergerbang tanpa perlu diingat satu per satu
Tambahkan ke src/Support/DocsNavigation.php — sidebar docs dan halaman indeks membacanya dari sana, jadi cukup satu tempat
Kalau perlu muncul di sidebar aplikasi, tambahkan juga ke config/menu.php

Author

Pringgo J. Saputro <odyinggo@gmail.com>

License

MIT

nawasara / docs

Package info

Security

Statistics