API Reference

Quick Summary

Dokumen ini fokus ke endpoint yang paling sering dipakai operasional. Untuk detail payload contoh + label bukti (mock/real/sanitized), lihat API Examples.

Swagger UI: Swagger UI
OpenAPI spec: /openapi/adi-jaya.openapi.yaml
Cakupan lengkap endpoint: API Full Catalog.

Prefix sumber: RouteServiceProvider + route files. Response schema yang belum pasti ditandai perlu verifikasi dan dicatat di Verification Matrix.

Runtime Evidence Status

• Backend runtime hit saat penyusunan dokumen ini: Belum dilakukan (akses environment tidak tersedia di sesi docs).
• Basis validasi saat ini: route file + controller source (adi-jaya-master) dengan sanitization.
• Dampak: endpoint/path relatif kuat, tetapi payload final tetap Partial sampai diuji runtime.

A. Admin Web Endpoints (/admin/*)

Admin web memakai session auth (web + auth) dan middleware access:*.

Area: Projects

Method	Path	Controller@Method	Access
GET	/admin/projects/list	ProjectListController@index	head_admin
GET	/admin/projects/create	ProjectController@index	head_admin
POST	/admin/projects/create	ProjectController@create	head_admin
PUT	/admin/projects/{project}	ProjectController@update	head_admin
DELETE	/admin/projects/{project}	ProjectController@destroy	head_admin

Area: SPB

Method	Path	Controller@Method	Access
POST	/admin/spbs/store	SPBController@store	project
PATCH	/admin/spbs/{spb}/update	SPBController@update	project
PUT	/admin/spbs/{spb}	SPBController@updateStatus	head_admin
GET	/admin/spbs/list/{condition}	SPBListController@index	multi-role

Area: PO

Method	Path	Controller@Method	Access
GET/POST	/admin/po/{spb}/create	PoController@index	head_admin/logistic/logistic_admin
POST	/admin/po/{spb}	PoController@create	head_admin/logistic/logistic_admin
PUT	/admin/po/{po}	PoController@update	head_admin/logistic/logistic_admin
PUT	/admin/po/status/{po}/update	PoController@updateStatus	head_admin/project/spv/logistic/logistic_admin

Area: Pembayaran PO

Method	Path	Controller@Method	Access
GET	/admin/pembayaran/list/{condition}	PembayaranPoListController@index	head_admin/accounting
PUT	/admin/pembayaran/{po}	PembayaranPoController@update	head_admin/accounting
PUT	/admin/pembayaran/{payment}/approve	PembayaranPoController@approve	head_admin/accounting_admin
PUT	/admin/pembayaran/{payment}/verify	PembayaranPoController@verify	head_admin

Area: SPK

Method	Path	Controller@Method	Access
GET	/admin/spk	SPKController@index	head_admin/spk/accounting
POST	/admin/spk/{project}/store	SPKController@store	spk
PATCH	/admin/spk/{project}/{spk}/approve	SPKController@approve	head_admin
PATCH	/admin/spk/{project}/{spk}/finish	SPKController@finish	head_admin

B. API v1 (/api/v1/*)

Auth dominan: auth:sanctum.

Auth/User

Method	Path	Controller
POST	/api/v1/user/login	API\\V1\\Auth\\LoginController@login
POST	/api/v1/user/logout	API\\V1\\Auth\\LoginController@logout
PATCH	/api/v1/user/firebase-token	API\\V1\\FCM\\FCMController@update

Project/SPB/PO

Method	Path	Controller	Catatan
GET	/api/v1/project	ProjectController@index	access project/spv
GET	/api/v1/project/list-spb	SPB PM Controller@index	list SPB
POST	/api/v1/project/spb/{spb_no}	SPB PM Controller@create	create SPB
PATCH	/api/v1/project/spb/{spb_no}	SPB PM Controller@update	update SPB
GET	/api/v1/project/spb/{spb_no}/po	POController@index	list PO per SPB
GET	/api/v1/project/list-po	POListController@index	list PO
POST/PATCH	/api/v1/project/spb/{spb_no}/po/{po_no}	POController@update	receive/complaint/approve/reject sesuai role

Public-like utility API

Method	Path	Controller
GET	/api/v1/supplier	SupplierController@index
GET	/api/v1/project-list	ProjectController@list
GET	/api/v1/po-payment-receipt/po-list	POPaymentReceiptController@poList

C. Membership API

Berasal dari routes/membership.php.

Method	Path (indikatif)	Controller
POST	/membership/register	Membership\\RegisterController@store
POST	/membership/login	Membership\\LoginController@login
PATCH	/membership/fcm	Membership\\FcmController@store
POST	/membership/otp/request	Membership\\OtpController@store
POST	/membership/otp/check	Membership\\OtpController@check

Catatan Verifikasi

• Status: Partial
• Scope: Prefix final routes/membership.php di production bergantung route loading tambahan di bootstrap/provider.
• Action: Samakan tabel endpoint membership dengan hasil runtime route:list dari server target (rujuk VM-001).