Radit_Arahman_Putra23/ProjectKP

Fork 0

Files

T

raditarahman5-cloud ac6c3473d4 Initial commit for combined ProjectKP

2026-06-28 15:14:51 +07:00

23 KiB

Raw Blame History

Analisis Mendalam Codebase: KP-ASOY + Laravel_KP

Dibuat: 2026-05-19 | Tujuan: Mempersiapkan integrasi penuh Frontend (KP-ASOY) ↔ Backend (Laravel_KP)

1. Gambaran Umum Arsitektur

Sistem ini terdiri dari dua proyek Laravel terpisah yang dirancang untuk berkomunikasi via HTTP API:

Aspek	KP-ASOY (Frontend)	Laravel_KP (Backend)
Peran	UI / Presentasi Layer	API / Business Logic / Database
Port	`8001`	`8000`
Laravel	^13.0 (PHP ^8.3)	^12.0 (PHP ^8.2)
Auth	Session-based (dari API token)	Laravel Sanctum Token
Database	`database_monitoring` (sama)	`database_monitoring`
Env: Backend URL	`BACKEND_API_URL=http://127.0.0.1:8000/api`	—

Catatan Kritis: Kedua proyek masih mengarah ke database yang sama. Ini membuat banyak controller di KP-ASOY masih query langsung ke DB, padahal seharusnya semua data diambil via API dari Laravel_KP.

2. Struktur Direktori Lengkap

2.1 Laravel_KP (Backend API)

Laravel_KP/
├── app/
│   ├── Exports/
│   │   └── PenugasanExport.php          # Export Excel (Maatwebsite)
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── AuthController.php        # Login, Logout, Register, Me, UpdateProfile
│   │   │   ├── PegawaiController.php     # CRUD Pegawai (TIDAK ada route-nya di api.php!)
│   │   │   ├── UnitKerjaController.php   # Index Unit Kerja
│   │   │   └── Api/
│   │   │       └── PenugasanController.php  # Dashboard, CRUD Penugasan, Export
│   │   └── Middleware/
│   │       └── CheckRole.php             # Role check via Auth::user() untuk Sanctum
│   └── Models/
│       ├── User.php        # HasApiTokens, relasi ke Pegawai & Penugasan
│       ├── Pegawai.php     # NIP, Nama, Jabatan, user_id → belonsgToMany Penugasan
│       ├── Penugasan.php   # SoftDeletes, pivot ke Pegawai via penugasan_pegawai
│       └── UnitKerja.php
├── database/
│   └── migrations/
│       ├── 000...create_users_table.php         # users, password_reset_tokens, sessions
│       ├── 000...create_cache_table.php          # cache
│       ├── 000...create_jobs_table.php           # jobs queue
│       ├── 2026_04_21_create_pegawai_table.php   # pegawai + softDeletes
│       ├── 2026_04_21_create_penugasan_table.php # penugasan + penugasan_pegawai pivot
│       ├── 2026_04_21_create_unit_kerjas_table.php
│       └── 2026_04_28_create_personal_access_tokens_table.php  # Sanctum
├── routes/
│   ├── api.php    # Semua endpoint REST API
│   └── web.php    # Hanya redirect ke login (minimal)
└── .env
    # APP_URL=http://127.0.0.1:8000
    # DB_DATABASE=database_monitoring
    # CORS_ALLOWED_ORIGINS=http://localhost:8001,http://127.0.0.1:8001

2.2 KP-ASOY (Frontend)

KP-ASOY/
├── app/
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── UserLoginController.php       # Login/Logout/Settings/User CRUD via API
│   │   │   ├── ActivityController.php        # CRUD Activity — MASIH query DB lokal!
│   │   │   └── Admin/
│   │   │       ├── ActivityController.php    # Monitor kegiatan Admin — MASIH DB lokal!
│   │   │       └── SuperAdminController.php  # Dashboard SuperAdmin — MASIH DB lokal!
│   │   └── Middleware/
│   │       └── RoleMiddleware.php            # Cek role dari session('user')
│   └── Models/
│       ├── User.php      # Tanpa HasApiTokens, relasi hasMany Activity
│       └── Activity.php  # SoftDeletes; fillable: nama_kegiatan, keterangan, status, user_id
├── resources/views/
│   ├── login-user.blade.php
│   ├── welcome.blade.php
│   ├── user/
│   │   ├── dashboard.blade.php
│   │   ├── activity-list.blade.php
│   │   ├── activity-detail.blade.php
│   │   ├── activity-edit.blade.php
│   │   ├── input-activity.blade.php
│   │   └── settings.blade.php
│   ├── admin/
│   │   ├── dashboard.blade.php
│   │   ├── users.blade.php
│   │   ├── create-user.blade.php
│   │   └── kegiatan/
│   └── superadmin/
│       ├── dashboard.blade.php
│       └── user/
├── routes/
│   └── web.php    # Routing web dengan middleware role
└── .env
    # APP_URL=http://127.0.0.1:8001
    # DB_DATABASE=database_monitoring
    # BACKEND_API_URL=http://127.0.0.1:8000/api

3. Alur Autentikasi (Sudah Terintegrasi)

[Browser] → POST /login-user (KP-ASOY:8001)
         → UserLoginController::login()
         → Http::post('http://127.0.0.1:8000/api/login', [username, password])
         → Laravel_KP: AuthController::login()
             - Cek username/email di tabel users
             - Hash::check password
             - Hapus token lama
             - createToken('kp-asoy-token') → Sanctum
         → Response JSON: { token, user:{id,name,username,email,role,jabatan} }
         → KP-ASOY: session(['api_token', 'user', 'role', 'user_id', 'user_name', 'username'])
         → Redirect by role:
             - 'admin'      → /admin/dashboard
             - 'superadmin' → /superadmin/dashboard
             - 'user'       → /user/dashboard

4. Semua Endpoint API Backend (Laravel_KP)

Public (tanpa token)

Method	Endpoint	Controller	Fungsi
POST	`/api/login`	AuthController@login	Login, return Sanctum token

Protected — auth:sanctum

Method	Endpoint	Controller	Fungsi
POST	`/api/logout`	AuthController@logout	Hapus token aktif
GET	`/api/me`	AuthController@me	Data user yang login
PUT	`/api/profile/update`	AuthController@updateProfile	Update email/password
POST	`/api/register`	AuthController@register	Buat user baru
GET	`/api/users`	Closure inline	List semua user (semua role)
GET	`/api/pegawai`	Closure inline	List user dengan role='user'
GET	`/api/dashboard`	PenugasanController@dashboard	Stats + 5 aktivitas terbaru
GET	`/api/penugasan`	PenugasanController@index	List semua penugasan
POST	`/api/penugasan`	PenugasanController@store	Buat penugasan baru
GET	`/api/penugasan/{id}`	PenugasanController@show	METHOD TIDAK ADA
PUT	`/api/penugasan/{id}`	PenugasanController@update	METHOD TIDAK ADA
POST	`/api/penugasan/{id}/update-status`	PenugasanController@updateStatus	Ubah status penugasan
POST	`/api/penugasan/{id}/delete`	PenugasanController@destroy	Batalkan penugasan
GET	`/api/notifications`	PenugasanController@notifications	METHOD TIDAK ADA
GET	`/api/unit-kerja`	UnitKerjaController@index	List unit kerja
GET	`/api/export-penugasan`	PenugasanController@export	Download Excel

5. Skema Database Lengkap

Tabel `users`

Kolom	Tipe	Keterangan
id	bigint PK
name	string	Nama lengkap
username	string UNIQUE	Login identifier
email	string UNIQUE
password	string	bcrypt hashed
role	enum	Migration: `superadmin,admin,pegawai` tapi kode pakai `user`
jabatan	string nullable
created_at / updated_at	timestamp

Tabel `pegawai`

Kolom	Tipe	Keterangan
id	bigint PK
nip	string UNIQUE
nama	string
jabatan	string
user_id	FK → users
deleted_at	timestamp	SoftDeletes

Tabel `penugasan`

Kolom	Tipe	Keterangan
id	bigint PK
nomor_surat	string nullable UNIQUE
kegiatan	string	Nama kegiatan
tanggal_mulai	date
tanggal_selesai	date nullable
status	enum	`proses`, `selesai`, `telah_ditinjau`
created_by	FK → users	Admin yang membuat
approved_by	FK → users nullable	SuperAdmin penyetuju
approved_at	timestamp nullable
alasan_hapus	text nullable	Alasan pembatalan
deleted_at	timestamp	SoftDeletes

Tabel `penugasan_pegawai` (Pivot)

Kolom	Tipe	Keterangan
id	bigint PK
penugasan_id	FK → penugasan
pegawai_id	FK → pegawai

Tabel `activities` (KP-ASOY Lokal — TIDAK ADA di Backend)

Kolom	Tipe	Keterangan
id	bigint PK
user_id	FK → users
nama_kegiatan	string
keterangan	text nullable
status	string	`on_progres`, `selesai`
deleted_at	timestamp	SoftDeletes

6. Relasi Antar Model

Laravel_KP (Backend)

User ─── hasOne ──────────── Pegawai
User ─── hasMany ─────────── Penugasan (as created_by)
User ─── hasMany ─────────── Penugasan (as approved_by)
Pegawai ─ belongsToMany ──── Penugasan (via penugasan_pegawai)
Penugasan ─ belongsToMany ── Pegawai (via penugasan_pegawai)
Penugasan ─ belongsTo ────── User (pembuat)
Penugasan ─ belongsTo ────── User (penyetuju)

KP-ASOY (Frontend)

User ─── hasMany ─────────── Activity
Activity ─ belongsTo ──────── User

7. Analisis Controller per Controller

7.1 `UserLoginController` (KP-ASOY) — SUDAH TERINTEGRASI ✅

Semua method sudah menggunakan Http::withToken(session('api_token')):

login() → POST /api/login
logout() → POST /api/logout
updateSettings() → PUT /api/profile/update
userList() → GET /api/users
storeUser() → POST /api/register
destroyUser() → DELETE /api/users/{id} (endpoint backend belum ada!)

Kekurangan: editUser() dan updateUser() hanya return view tanpa data dari API.

7.2 `ActivityController` (KP-ASOY) — BELUM TERINTEGRASI ❌

Semua method masih pakai Auth::id() dan model Activity:: langsung:

index() → query Activity::where('user_id', Auth::id())
store() → Activity::create([...])
list(), show(), edit(), update(), selesai()

Target: Semua operasi ini harus diganti dengan HTTP call ke backend menggunakan session('api_token') dan memetakan Activity ke entitas Penugasan di backend.

7.3 `Admin/ActivityController` (KP-ASOY) — BELUM TERINTEGRASI ❌

dashboard() → query Activity::, User:: langsung ke DB
index() → query dengan filter search/status/bulan langsung ke DB
show(), edit(), update(), destroy() → langsung ke DB

7.4 `Admin/SuperAdminController` (KP-ASOY) — BELUM TERINTEGRASI ❌

index() → query Activity::, User::withCount('activities') langsung ke DB
approve() → Activity::findOrFail($id)->update(['status' => 'selesai']) langsung ke DB
destroy() → SoftDelete langsung ke DB
userIndex(), editUser(), updateUser(), destroyUser() → langsung ke DB

7.5 `AuthController` (Laravel_KP) — BAIK ✅

Full implementasi login, register, me, logout, updateProfile. Semua return JSON.

7.6 `PenugasanController` (Laravel_KP) — PARTIAL ⚠️

✅ dashboard() → return JSON stats
✅ index() → return JSON list
❌ store() → return redirect(), bukan JSON (fatal untuk API)
❌ show() → method tidak ada
❌ update() → method tidak ada
✅ updateStatus() → return JSON
✅ destroy() → return JSON (tapi method hapus = batalkan, bukan delete)
✅ export() → return Excel download
❌ notifications() → method tidak ada

7.7 `PegawaiController` (Laravel_KP) — TIDAK DI-ROUTE ❌

Full CRUD tersedia (index, store, show, update, destroy, trash, restore) tapi tidak ada satupun route di api.php yang mengarah ke controller ini.

8. Middleware & Keamanan

Backend: `CheckRole` Middleware

// Membaca dari Auth::user() (Sanctum)
if (!$request->user() || !in_array($request->user()->role, $roles)) {
    return response()->json(['status' => false, 'message' => 'Akses ditolak'], 403);
}

Catatan: Middleware ini terdaftar tapi tidak digunakan di route manapun di api.php.

Frontend: `RoleMiddleware`

// Membaca dari session('user') yang tersimpan saat login
$user = session('user');
if (!in_array($user['role'], $roles)) { abort(403); }

Ini sudah tepat untuk frontend yang menggunakan session.

9. GAP INTEGRASI — Daftar Lengkap

GAP-01: Dua Entitas Data Yang Berbeda (KRITIS)

Backend punya Penugasan = penugasan dari admin ke pegawai (top-down)
Frontend punya Activity = kegiatan yang diinput sendiri user (bottom-up)
Keputusan diperlukan: Apakah Activity frontend = Penugasan backend? Atau keduanya berbeda?
Jika disamakan: field tidak cocok (Activity: nama_kegiatan, tanggal, lokasi, deskripsi vs Penugasan: nomor_surat, kegiatan, tanggal_mulai, tanggal_selesai)

GAP-02: Inkonsistensi Nilai Role (KRITIS)

Migration users: enum ['superadmin', 'admin', 'pegawai']
Kode backend (AuthController, api.php): menggunakan string 'user'
Kode frontend (web.php, RoleMiddleware): menggunakan 'user', 'admin', 'superadmin'
Harus dipilih satu: gunakan user atau pegawai secara konsisten

GAP-03: Method Hilang di PenugasanController

show($id) → terdaftar di route, method tidak ada
update(Request, $id) → terdaftar di route, method tidak ada
notifications() → terdaftar di route, method tidak ada

GAP-04: `store()` Return Redirect Bukan JSON

// SALAH (ini web controller, bukan API):
return redirect()->back()->with('success', '...');

// BENAR (untuk API):
return response()->json(['success' => true, 'data' => $penugasan], 201);

GAP-05: PegawaiController Tidak Di-Route

Full CRUD tersedia namun tidak ada satupun endpoint di api.php
Frontend tidak bisa mengakses data pegawai terpisah dari users

GAP-06: DELETE `/api/users/{id}` Tidak Ada di Backend

UserLoginController::destroyUser() di frontend memanggil DELETE /api/users/{id}
Route ini tidak terdaftar di backend → HTTP 404

GAP-07: ActivityController Masih Pakai DB Lokal

Semua CRUD Activity di frontend (user, admin, superadmin) query langsung ke database
Padahal database = database yang sama dengan backend, yang idealnya hanya diakses backend

GAP-08: Activity Model Fillable Tidak Lengkap

// Saat ini:
protected $fillable = ['nama_kegiatan', 'keterangan', 'status', 'user_id'];

// Tapi controller menyimpan:
Activity::create([..., 'tanggal' => ..., 'lokasi' => ...]);
// Field 'tanggal' dan 'lokasi' tidak ada di fillable → Mass Assignment Error!

GAP-09: CORS Belum Dipastikan Terkonfigurasi

Backend .env sudah ada CORS_ALLOWED_ORIGINS=http://localhost:8001,http://127.0.0.1:8001
Perlu verifikasi config/cors.php membaca env ini dengan benar

GAP-10: Session vs Token Auth Tidak Sinkron untuk SuperAdmin

SuperAdmin di KP-ASOY masih menggunakan Auth::user() dan Eloquent langsung
Harus diubah menggunakan session('api_token') untuk semua request ke backend

10. Peta Alur Integrasi Target

KP-ASOY (FE :8001)                          Laravel_KP (BE :8000)
─────────────────────────────────────────────────────────────────────
[LOGIN]
POST /login-user ──────────────────────────► POST /api/login
                 ◄────────────────────────── {token, user}

[USER — Input Kegiatan]
POST /activities/store ────────────────────► POST /api/penugasan
   Http::withToken($token)->post(...)        PenugasanController@store
                 ◄────────────────────────── {success, data}

[USER — List Kegiatan]
GET /activity-list ────────────────────────► GET /api/penugasan?user_id={id}
                 ◄────────────────────────── {success, data:[...]}

[USER — Update Kegiatan]
POST /activity/{id}/update ────────────────► PUT /api/penugasan/{id}
                 ◄────────────────────────── {success, data}

[ADMIN — Dashboard]
GET /admin/dashboard ──────────────────────► GET /api/dashboard
                 ◄────────────────────────── {stats, recent_activities}

[ADMIN — Tinjau Kegiatan]
POST /admin/kegiatan/{id}/update ──────────► POST /api/penugasan/{id}/update-status
   {status: 'telah_ditinjau'}               PenugasanController@updateStatus

[SUPERADMIN — Approve]
POST /superadmin/kegiatan/{id}/approve ───► POST /api/penugasan/{id}/update-status
   {status: 'selesai'}                      PenugasanController@updateStatus

[SUPERADMIN — Export]
GET /superadmin/export ────────────────────► GET /api/export-penugasan
                 ◄────────────────────────── file: Laporan_Kegiatan.xlsx

[ADMIN — Tambah User]
POST /admin/users/store ───────────────────► POST /api/register
                 ◄────────────────────────── {message, user}

[ADMIN — Hapus User]
DELETE /admin/users/{id} ──────────────────► DELETE /api/users/{id}  [BELUM ADA!]

11. Status Integrasi Per Fitur

#	Fitur	FE Controller	BE Endpoint	Status
1	Login	UserLoginController@login	POST /api/login	✅ Terintegrasi
2	Logout	UserLoginController@logout	POST /api/logout	✅ Terintegrasi
3	Update Profil	UserLoginController@updateSettings	PUT /api/profile/update	✅ Terintegrasi
4	Tambah User (Admin)	UserLoginController@storeUser	POST /api/register	✅ Terintegrasi
5	List User (Admin)	UserLoginController@userList	GET /api/users	✅ Terintegrasi
6	Hapus User (Admin)	UserLoginController@destroyUser	❌ Route belum ada	❌ Belum
7	Input Kegiatan (User)	ActivityController@store	POST /api/penugasan	❌ FE masih DB lokal
8	List Kegiatan (User)	ActivityController@list	GET /api/penugasan	❌ FE masih DB lokal
9	Detail Kegiatan (User)	ActivityController@show	❌ Method belum ada	❌ Belum
10	Edit Kegiatan (User)	ActivityController@update	❌ Method belum ada	❌ Belum
11	Selesaikan Kegiatan	ActivityController@selesai	POST /api/penugasan/{id}/update-status	❌ FE masih DB lokal
12	Dashboard Admin	Admin/ActivityController@dashboard	GET /api/dashboard	❌ FE masih DB lokal
13	Monitor Kegiatan (Admin)	Admin/ActivityController@index	GET /api/penugasan	❌ FE masih DB lokal
14	Tinjau Kegiatan (Admin)	Admin/ActivityController@update	POST /api/penugasan/{id}/update-status	❌ FE masih DB lokal
15	Dashboard SuperAdmin	SuperAdminController@index	GET /api/dashboard	❌ FE masih DB lokal
16	Approve Kegiatan (SA)	SuperAdminController@approve	POST /api/penugasan/{id}/update-status	❌ FE masih DB lokal
17	Hapus Kegiatan (SA)	SuperAdminController@destroy	POST /api/penugasan/{id}/delete	❌ FE masih DB lokal
18	Manajemen User (SA)	SuperAdminController@userIndex	GET /api/users	❌ FE masih DB lokal
19	Export Laporan	SuperAdminController@export	GET /api/export-penugasan	❌ FE hanya redirect error
20	Notifikasi User	ActivityController (statis)	❌ Method belum ada	❌ Belum
21	CRUD Pegawai	❌ Tidak ada di FE	❌ Tidak di-route	❌ Belum

Ringkasan: 5 dari 21 fitur (24%) sudah terintegrasi. 16 fitur (76%) belum terintegrasi.

12. Prioritas Perbaikan

🔴 Prioritas 1 — Perbaiki Backend (Harus Selesai Dulu)

Seragamkan role value → ubah migration/kode dari pegawai ke user secara konsisten
Implementasi method hilang di PenugasanController:
- show($id) → return JSON detail penugasan + petugas
- update(Request, $id) → update data penugasan, return JSON
- notifications() → return list penugasan yang sudah telah_ditinjau untuk user tertentu
Perbaiki store() → ganti redirect()->back() dengan response()->json(201)
Tambah route di api.php:
- DELETE /api/users/{id} → untuk hapus user
- Route lengkap PegawaiController (index, store, show, update, destroy, trash, restore)
Tambah filter by user di GET /api/penugasan → user hanya boleh lihat tugasnya sendiri

🟡 Prioritas 2 — Refactor Frontend Controllers

Refactor ActivityController → ganti semua Activity:: dan Auth::id() dengan Http::withToken(session('api_token'))->...
Refactor Admin/ActivityController → semua operasi via API backend
Refactor SuperAdminController → gunakan endpoint API, bukan query DB langsung
Perbaiki Activity model fillable → tambahkan tanggal, lokasi, deskripsi

🟢 Prioritas 3 — Penyempurnaan

Verifikasi konfigurasi CORS di config/cors.php backend
Hapus koneksi DB dari KP-ASOY (kecuali sessions/cache)
Implementasi notifikasi real berdasarkan status perubahan penugasan
Tambah endpoint edit/delete user untuk SuperAdmin di backend
Implementasi editUser() dan updateUser() di UserLoginController KP-ASOY

13. Kesimpulan

Secara arsitektur, rancangan pemisahan frontend (KP-ASOY) dan backend (Laravel_KP) sudah benar dan tepat. Fondasi integrasi sudah ada: autentikasi via Sanctum sudah berjalan, BACKEND_API_URL sudah dikonfigurasi, dan pattern Http::withToken() sudah digunakan di UserLoginController.

Masalah utama adalah sebagian besar fitur di KP-ASOY (terutama semua yang berhubungan dengan Activity/Kegiatan dan Dashboard) masih bypass API dan langsung mengakses database. Ini terjadi kemungkinan karena pengembangan dilakukan secara bertahap: login terintegrasi lebih dulu, sementara fitur-fitur lainnya masih dalam proses refactoring.

Langkah terpenting sebelum integrasi penuh:

Putuskan apakah Activity (KP-ASOY) = Penugasan (Laravel_KP) atau dua entitas berbeda
Perbaiki method-method yang hilang di backend
Seragamkan nilai role di seluruh codebase
Refactor semua controller frontend untuk menggunakan API

23 KiB Raw Blame History