Repository reconnaissance Scola¶
Snapshot reconnaissance statis untuk perancangan dokumentasi pengguna berbasis role dan contextual help.
Last verified: 2026-08-05
Mode: server development
Workspace root: /home/scola/odoo
Scope: indeks hasil reconnaissance; tidak mengubah kode aplikasi
Runtime limitation: Missing or unclear — audit ini tidak memeriksa database tenant, modul yang terpasang, group efektif per user, atau perilaku bundle production
Status bukti yang dipakai secara eksklusif: Confirmed from code, Inferred from code, Requires business confirmation, dan Missing or unclear.
Cara membaca¶
Inventaris ini adalah bukti desain saat ini, bukan pernyataan bahwa seluruh akses atau business rule yang ditemukan sudah benar. Kolom Confidence level pada inventaris halaman berlaku untuk satu baris penuh; detail yang bersifat inferensi atau belum jelas tetap diberi label pada sel terkait.
| Output | Artefak | File | Isi | Status |
|---|---|---|---|---|
| A | Application module map | application-map.md | Aplikasi frontend, section/menu leaf, seluruh manifest backend, dan coverage dokumentasi | Confirmed from code |
| B | Route and page inventory | route-inventory.md | Seluruh component route, redirect/alias, UI statis, API, prasyarat, dan dampak | Confirmed from code |
| C | Role-permission matrix | role-permission-matrix.md | Role-app, capability, route guard, feature/module gate, dan drift menu-route | Confirmed from code |
| D + F | Page relationships and contextual help | page-relationships.md | Relasi route/component/API serta halaman prioritas contextual help | Confirmed from code |
| E | Candidate end-to-end workflows | workflow-candidates.md | Urutan proses yang dapat dibuktikan atau diinferensikan dari kode | Inferred from code |
| H | Open questions | open-questions.md | Inkonsistensi, risiko, dan pertanyaan untuk product owner/SME | Requires business confirmation |
| G | Documentation coverage matrix | application-map.md#G-documentation-coverage-matrix | Cakupan existing user guide dan prioritas per modul | Inferred from code |
Baseline snapshot¶
| Metrik | Jumlah | Status |
|---|---|---|
| Frontend effective routes | 1003 | Confirmed from code |
| Frontend component pages | 884 | Confirmed from code |
| Frontend redirects/aliases | 119 | Confirmed from code |
| Unique routed component files | 581 | Confirmed from code |
| Frontend apps / menu leaves | 36 / 529 | Confirmed from code |
| Frontend role catalogs / flags | 33 / 27 | Confirmed from code |
| Backend addon manifests | 67 | Confirmed from code |
| Backend module-like directories without manifest | 4 | Confirmed from code |
| Backend application=True addons | 15 | Confirmed from code |
| Backend controller route instances | 1734 | Confirmed from code |
| Backend unique decorated paths | 1679 | Confirmed from code |
| Backend canonical roles | 32 | Confirmed from code |
| Backend ACL rows / record rules | 1037 / 290 | Confirmed from code |
| Backend model classes / fields | 400 / 3909 | Confirmed from code |
| Backend Python / SQL constraints | 139 / 108 | Confirmed from code |
| Systematic backend model-rule rows | 342 | Confirmed from code |
| Parsed required fields / Python constraints / SQL constraints | 934 / 139 / 108 | Confirmed from code |
| Pages with forms | 237 | Confirmed from code |
| Pages with tables/columns | 328 | Confirmed from code |
| Pages with filters/search | 552 | Confirmed from code |
| Pages with validation signals | 634 | Confirmed from code |
| Pages with resolved endpoint literals | 627 | Confirmed from code |
| Placeholder/stub component routes | 7 | Confirmed from code |
| Existing user-guide markdown files scanned | 88 | Confirmed from code |
Metode dan batas audit¶
- Confirmed from code — route diambil dari katalog router rekursif, termasuk redirect dan alias; component file diselesaikan terhadap alias
@/. - Confirmed from code — menu, app, role, capability, feature flag, dan module key diambil dari registry frontend aktif.
- Confirmed from code — form, field, kolom, filter, tombol, validasi, link, service method, dan endpoint diekstrak dari component closure statis.
- Confirmed from code — atribusi endpoint hanya menerima call literal pada component atau method service yang dipanggil langsung; URL router/navigation tidak dihitung sebagai API dan wrapper composable yang tidak ter-resolve ditandai unclear.
- Confirmed from code — modul, controller, model, constraint, ACL, record rule, dan workflow backend dibaca dari repository
custom_addons_scola/gcgscola. - Missing or unclear — dynamic component, label i18n, endpoint yang dirakit saat runtime, Odoo data XML yang bergantung instalasi, dan group user tenant dapat memerlukan verifikasi runtime.
- Requires business confirmation — intensi kebijakan role, pemilik proses, terminologi sekolah, dan urutan kerja operasional harus disahkan product owner/SME.
Template record halaman kanonis¶
D0 documentation program (2026-09-04): Gunakan satu record ini untuk setiap halaman/task kanonis sebelum menulis operation manual atau user guide. Inventaris statis di folder ini adalah titik awal, bukan pengganti verifikasi runtime atau persetujuan aturan bisnis.
| Field | Isi yang wajib direkam | Status bukti yang diizinkan |
|---|---|---|
| Identity | Domain, package, app, menu, canonical route, route name, component, dan disposition (canonical, detail-only, internal, duplicate, obsolete, atau blocked) |
CONFIRMED_FROM_CODE |
| Audience and authority | Persona/role, capability, entitlement, assignment, company/record/self/child scope, dan direct API result | Code + runtime bila dipakai sebagai instruksi akses |
| User purpose | Tugas pengguna, trigger, output, dan batas tanggung jawab | CONFIRMED_BUSINESS_RULE; jika belum, REQUIRES_BUSINESS_CONFIRMATION |
| Controls | Form, field, filter, action, destructive/irreversible action, validation, dan state visibility | CONFIRMED_FROM_CODE |
| Data path | Service/composable, endpoint, controller, model, state machine, audit/elevation boundary | CONFIRMED_FROM_CODE |
| Prerequisites | Master data, konfigurasi, feature flag, period/state, device, role, dan dependency lintas domain | Code + business decision |
| Outcome | State transition, side effect, notification, report, dan downstream consumer | Code + runtime/business confirmation menurut risiko |
| Failure and recovery | Error class, safe retry, idempotency, correction/reversal, evidence yang aman dikumpulkan, dan escalation owner | Code + business decision + runtime untuk alur kritis |
| Documentation mapping | Domain SSOT, operation manual, role guide, task guide, troubleshooting, API reference, dan QA case | Documentation Owner |
| Evidence and freshness | Source reference, runtime identity/run/profile, decision/approver, last verified, expiry/review date, confidence | Semua sumber diberi label eksplisit |
Aturan disposition¶
canonical: satu-satunya entry dokumentasi aktif untuk tugas tersebut.detail-only: halaman pendukung; didokumentasikan dari artikel kanonis, bukan menjadi entry tugas mandiri.internal: tidak masuk user guide; dapat masuk operation manual terbatas bila ada owner dan kontrol akses.duplicate: tidak mendapat artikel baru; arahkan pembaca ke canonical article.obsolete: diberi banner superseded, inbound link dipindahkan, lalu diarsipkan.blocked: jangan membuat langkah operasional; tulis limitation/troubleshooting yang aman dan tautkan blocker/owner.
Tidak ada field yang belum diketahui boleh diisi dengan dugaan. Gunakan
INFERRED_FROM_CODE, REQUIRES_BUSINESS_CONFIRMATION, atau
MISSING_OR_UNCLEAR sampai evidence tersedia.
Dokumen aturan yang dibaca¶
AGENTS.mddanscola-fe-v2/AGENTS.mddocs/ai-guidelines/AI_AGENT_MASTER_GUIDE.mddocs/ai-guidelines/development-guide.mddocs/ai-guidelines/workspace-governance.mddocs/ai-guidelines/architecture-api.mddocs/ai-guidelines/DOCUMENTATION_GOVERNANCE.mddocs/ai-guidelines/menu-architecture.md.
Dokumen QA tidak digunakan karena tahap ini tidak membuat atau menjalankan test baru.