Overview

Document Purpose

This documentation was prepared for 2 main purposes:

1. Onboarding new engineers to understand the end-to-end Adi Jaya system.
2. Team operational reference (dev, QA, ops, internal PM) for maintenance and troubleshooting.

System Summary

Adi Jaya is a procurement & payment workflow application based on Laravel 8 with 3 main surfaces:

• Web Admin (/admin/*) for internal operations (Head Admin, Logistics, Accounting, SPK, Project/SPV).
• Mobile/API v1 (/api/v1/*) for project/SPV/head admin workflows via JSON API + Sanctum.
• Membership API (/membership/*, via separate route) for register/login/OTP/FCM.

Domain Scope

The system includes the following business flows:

• SPB (Goods Request Letter)
• PO (Purchase Order)
• PO Payment (including split payment + price changes)
• PO Payment Receipt
• SPK module (contract, revision, payment, accounting, receipt)
• Master data: Project, Supplier, Employee, Role Access

Key Technologies

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

Entry Points

Surfaces	Prefix	Description
Web Admin	/admin	Main web operational route
API v1	/api/v1	Mobile API/project flow
Legacy APIs	/api	Minimum default (/user)
Membership	routes/membership.php	Register/Login/OTP/Fcm

Main Role

Role defined in App\\Models\\User + Gate in AuthServiceProvider:

• head_admin
• project
• spv
• logistics
• logistics_admin
• accounting
• accounting_admin
• spk
• pm (available on model/gate, specific route usage requires verification)

Critical Status per Domain

Domains	Critical Status
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 Navigation

• Read: architecture
• Next: role-access-matrix
• Next: module-map, business-flows
• API: api-reference, api-cookbook
• Operational: setup-local, deployment-runbook, observability-ops

Verification Notes

• Status: Partial
• Scope: Endpoint runtime verification via php artisan route:list cannot be run in the audit environment (PHP binary is not available).
• Action: Run route list verification on the primary application host and then sync endpoint changes.