Overview

Tujuan Dokumen

Dokumentasi ini disusun untuk 2 tujuan utama:

1. Onboarding engineer baru agar paham sistem Adi Jaya end-to-end.
2. Referensi operasional tim (dev, QA, ops, PM internal) untuk maintenance dan troubleshooting.

Ringkasan Sistem

Adi Jaya adalah aplikasi procurement & payment workflow berbasis Laravel 8 dengan 3 surface utama:

• Admin Web (/admin/*) untuk operasional internal (Head Admin, Logistic, Accounting, SPK, Project/SPV).
• Mobile/API v1 (/api/v1/*) untuk workflow project/SPV/head admin via JSON API + Sanctum.
• Membership API (/membership/*, via route terpisah) untuk register/login/OTP/FCM.

Scope Domain

Sistem mencakup alur bisnis berikut:

• SPB (Surat Permintaan Barang)
• PO (Purchase Order)
• Pembayaran PO (termasuk split payment + perubahan harga)
• PO Payment Receipt
• SPK module (kontrak, revisi, pembayaran, accounting, receipt)
• Master data: Project, Supplier, Employee, Role Access

Teknologi Utama

Area	Stack
Backend	Laravel 8.12, PHP ^8.1 (composer.json)
Auth API	Laravel Sanctum
Realtime/Notif	FCM via package Timedoor membership/Fcmable
PDF Export	barryvdh/laravel-dompdf
Excel Export	maatwebsite/excel
Filtering	timedoor/filter
Frontend Admin	Blade + Laravel Mix + Vue 3 dependency
Documentation	Docusaurus 3.9.2

Entry Points

Surface	Prefix	Keterangan
Admin Web	/admin	Route utama operasional web
API v1	/api/v1	API mobile/project flow
Legacy API	/api	Minimal default (/user)
Membership	routes/membership.php	Register/Login/OTP/Fcm

Role Utama

Role didefinisikan di App\\Models\\User + Gate di AuthServiceProvider:

• head_admin
• project
• spv
• logistic
• logistic_admin
• accounting
• accounting_admin
• spk
• pm (tersedia di model/gate, pemakaian route spesifik perlu verifikasi)

Status Kritis per Domain

Domain	Status Kritis
SPB	waiting_confirmation, revision, approved, reject
PO	waiting_confirmation, approved, complaint, received, cancel, reject, received_by_logistic
Payment	waiting_confirmation, approved, verified
SPK	enum: WAITING_APPROVAL, REVISION, APPROVED, FINISHED, REJECTED
SPK Payment	enum: WAITING_APPROVAL, REVISION, APPROVED, REJECTED

Quick Start Navigasi

• Baca: architecture
• Lanjut: role-access-matrix
• Lanjut: module-map, business-flows
• API: api-reference, api-cookbook
• Operasional: setup-local, deployment-runbook, observability-ops

Catatan Verifikasi

• Status: Partial
• Scope: Verifikasi runtime endpoint via php artisan route:list belum bisa dijalankan pada environment audit (binary PHP tidak tersedia).
• Action: Jalankan verifikasi route list di host aplikasi utama lalu sinkronkan perubahan endpoint.