Radit_Arahman_Putra23/ProjectKP
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit for combined ProjectKP

Browse Source
This commit is contained in:
raditarahman5-cloud
2026-06-28 15:14:51 +07:00
commit ac6c3473d4
203 changed files with 41848 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/codebase_analysis.md
+491
View File
@@ -0,0 +1,491 @@
# 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
```php
// 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`
```php
// 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
```php
// 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
```php
// 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)
1. **Seragamkan role value** → ubah migration/kode dari `pegawai` ke `user` secara konsisten
2. **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
3. **Perbaiki `store()`** → ganti `redirect()->back()` dengan `response()->json(201)`
4. **Tambah route di api.php**:
- `DELETE /api/users/{id}` → untuk hapus user
- Route lengkap `PegawaiController` (index, store, show, update, destroy, trash, restore)
5. **Tambah filter by user** di `GET /api/penugasan` → user hanya boleh lihat tugasnya sendiri
### 🟡 Prioritas 2 — Refactor Frontend Controllers
6. **Refactor `ActivityController`** → ganti semua `Activity::` dan `Auth::id()` dengan `Http::withToken(session('api_token'))->...`
7. **Refactor `Admin/ActivityController`** → semua operasi via API backend
8. **Refactor `SuperAdminController`** → gunakan endpoint API, bukan query DB langsung
9. **Perbaiki `Activity` model fillable** → tambahkan `tanggal`, `lokasi`, `deskripsi`
### 🟢 Prioritas 3 — Penyempurnaan
10. **Verifikasi konfigurasi CORS** di `config/cors.php` backend
11. **Hapus koneksi DB dari KP-ASOY** (kecuali sessions/cache)
12. **Implementasi notifikasi real** berdasarkan status perubahan penugasan
13. **Tambah endpoint edit/delete user** untuk SuperAdmin di backend
14. **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:
1. Putuskan apakah `Activity` (KP-ASOY) = `Penugasan` (Laravel_KP) atau dua entitas berbeda
2. Perbaiki method-method yang hilang di backend
3. Seragamkan nilai role di seluruh codebase
4. Refactor semua controller frontend untuk menggunakan API
docs/diagrams_mermaid.md
+274
View File
@@ -0,0 +1,274 @@
# Codingan Diagram (Mermaid) Lengkap - Sistem Monitoring Penugasan
Anda dapat menyalin (copy) kode-kode di bawah ini ke dalam **Mermaid Live Editor** (https://mermaid.live/) atau **Draw.io** (Insert > Advanced > Mermaid) untuk menjadikannya gambar.
---
## 1. Usecase Diagram Lengkap (Termasuk CRUD)
Menggambarkan interaksi menyeluruh dari autentikasi, CRUD data, hingga ekspor.
```mermaid
usecaseDiagram
actor Pegawai
actor Admin
actor "Super Admin" as SA
rectangle "Sistem Monitoring Penugasan" {
%% Autentikasi
usecase "Melakukan Login & Logout" as Auth
usecase "Mengelola Profil Diri" as Profil
%% CRUD Kegiatan
usecase "Melihat Daftar Kegiatan (Read)" as CRUD_R
usecase "Menambah Laporan Baru (Create)" as CRUD_C
usecase "Mengubah Laporan (Update)" as CRUD_U
usecase "Menghapus/Membatalkan Laporan (Delete)" as CRUD_D
%% Tindakan Lanjutan
usecase "Meninjau Kegiatan (Ubah ke Ditinjau)" as Review
usecase "Menyetujui Kegiatan (Ubah ke Selesai)" as Approve
usecase "Melihat Statistik Dashboard" as Dash
%% CRUD Pengguna
usecase "Manajemen Akun User & Pegawai (CRUD)" as KelolaUser
usecase "Mengekspor Laporan Excel" as Export
}
Pegawai --> Auth
Pegawai --> Profil
Pegawai --> CRUD_R
Pegawai --> CRUD_C
Pegawai --> CRUD_U
Admin --> Auth
Admin --> Profil
Admin --> Dash
Admin --> CRUD_R
Admin --> Review
Admin --> KelolaUser
SA --> Auth
SA --> Profil
SA --> Dash
SA --> CRUD_R
SA --> Approve
SA --> CRUD_D
SA --> KelolaUser
SA --> Export
```
---
## 2. Flowchart Sistem (Menyesuaikan dengan Gambar Referensi)
Flowchart ini disusun persis seperti gambar alur sistem yang Anda lampirkan, disesuaikan dengan arsitektur backend Monitoring Penugasan Pegawai di Dinas Tenaga Kerja dan Transmigrasi.
```mermaid
flowchart TD
%% Tampilan (Styling) Node agar rapi
classDef startEnd fill:#fff,stroke:#333,stroke-width:2px;
classDef process fill:#fff,stroke:#333,stroke-width:1px;
classDef decision fill:#fff,stroke:#333,stroke-width:1px;
classDef io fill:#fff,stroke:#333,stroke-width:1px;
Start([Mulai]):::startEnd --> B[Membuka Aplikasi]:::process
B --> C[Login]:::process
C --> D[/Input Username dan Password/]:::io
D --> E{Validasi?}:::decision
E -- Tidak --> D
E -- Ya --> F[Sistem Mengecek Role]:::process
F --> R_USER[Dashboard Pegawai]:::process
F --> R_ADMIN[Dashboard Admin]:::process
F --> R_SA[Dashboard Super Admin]:::process
%% ================= ALUR PEGAWAI =================
R_USER --> U_M{Menu User}:::decision
U_M --> U_M1[Tambah Laporan]:::process
U_M1 --> U_M1A[/Input Data & Upload Berkas/]:::io
U_M1A --> U_M1B[Simpan Data ke Database]:::process
U_M1B --> J1(( ))
U_M --> U_M2[Riwayat Laporan]:::process
U_M2 --> U_M2A[/Lihat Seluruh Laporan/]:::io
U_M2A --> U_M2B{Status Laporan?}:::decision
U_M2B -- Ditolak / Pending --> U_M2B1[/Input Data & Upload Berkas Ulang/]:::io
U_M2B1 --> J1
U_M2B -- Diterima / Selesai --> J1
%% ================= ALUR ADMIN =================
R_ADMIN --> A_M{Menu Admin}:::decision
A_M --> A_M1[Kelola Laporan]:::process
A_M1 --> A_M1A[/Lihat Laporan Masuk/]:::io
A_M1A --> A_M1B{Status Laporan?}:::decision
A_M1B -- Valid --> A_M1B1[Update Status 'Telah Ditinjau']:::process
A_M1B1 --> A_M1B1A[Update Data di DB]:::process
A_M1B1A --> J2(( ))
A_M1B -- Tidak Valid --> A_M1B2[Revisi Laporan / Tolak]:::process
A_M1B2 --> A_M1B2A[Update Data di DB]:::process
A_M1B2A --> J2
A_M1B -- Dipending --> A_M1B3[/Lihat Detail Laporan/]:::io
A_M1B3 --> J2
A_M --> A_M2[Riwayat Laporan]:::process
A_M2 --> A_M2A[/Lihat Seluruh Laporan/]:::io
A_M2A --> A_M2B[/Unduh Laporan/]:::io
A_M2B --> J2
A_M --> A_M3[Kelola Data Akun & Berkas]:::process
A_M3 --> A_M3A[/Input Data Pegawai Baru/]:::io
A_M3A --> A_M3B[Simpan Data di Database]:::process
A_M3B --> J2
%% ================= ALUR SUPER ADMIN =================
R_SA --> SA_M{Menu Super Admin}:::decision
SA_M --> SA_M1[Lihat Laporan]:::process
SA_M1 --> SA_M1B{Status Laporan?}:::decision
SA_M1B -- Diterima (Approve) --> SA_M1B1[/Update Status 'Selesai'/]:::io
SA_M1B -- Ditolak / Dipending --> SA_M1B2[/Lihat Detail Laporan/]:::io
SA_M1B1 --> J3(( ))
SA_M1B2 --> J3
%% ================= PENYELESAIAN =================
J1 --> N[/Notifikasi/]:::io
J2 --> N
J3 --> N
N --> K[Menu Profil]:::process
K --> L[Logout]:::process
L --> End([Selesai]):::startEnd
```
---
## 2.B Flowchart Logika Backend Murni (Alur Proses API & Database)
Flowchart ini adalah flowchart yang **sangat disarankan** untuk digunakan dalam Laporan Anda karena berfokus pada apa yang terjadi di "belakang layar" (Backend), mulai dari penerimaan Request HTTP, middleware, validasi, hingga interaksi dengan Database MySQL.
```mermaid
flowchart TD
classDef startEnd fill:#fff,stroke:#333,stroke-width:2px;
classDef process fill:#fff,stroke:#333,stroke-width:1px;
classDef decision fill:#fff,stroke:#333,stroke-width:1px;
classDef io fill:#fff,stroke:#333,stroke-width:1px;
Start([Mulai (Request dari Frontend)]):::startEnd --> REQ[/Menerima HTTP Request\n(POST/GET/PUT/DELETE)/]:::io
%% Middleware Auth & Role
REQ --> MID_AUTH{Cek Token Sanctum?}:::decision
MID_AUTH -- Tidak Valid / Kosong --> ERR401[/Return JSON: 401 Unauthorized/]:::io
MID_AUTH -- Valid --> MID_ROLE{Cek Role Akses?}:::decision
MID_ROLE -- Ditolak --> ERR403[/Return JSON: 403 Forbidden/]:::io
%% Validasi Controller
MID_ROLE -- Diizinkan --> CTRL[Controller Menerima Request]:::process
CTRL --> VAL{Validasi Payload Data\n(Input Kosong/Salah)?}:::decision
VAL -- Gagal --> ERR422[/Return JSON: 422 Unprocessable Entity/]:::io
%% Proses Database
VAL -- Sukses --> DB_OP[Eksekusi Logika Bisnis & Query Database]:::process
DB_OP --> DB_ACT{Jenis Operasi?}:::decision
DB_ACT -- Create/Insert --> DB1[Simpan Data Baru ke Tabel]:::process
DB_ACT -- Read/Select --> DB2[Ambil Data dari Tabel]:::process
DB_ACT -- Update --> DB3[Perbarui Data di Tabel]:::process
DB_ACT -- Delete --> DB4[Soft Delete Data (Ubah deleted_at)]:::process
DB1 --> RES[/Return JSON: 201 Created/]:::io
DB2 --> RES2[/Return JSON: 200 OK + Data/]:::io
DB3 --> RES2
DB4 --> RES2
%% End
ERR401 --> End([Selesai (Response Terkirim)]):::startEnd
ERR403 --> End
ERR422 --> End
RES --> End
RES2 --> End
```
---
## 3. Data Flow Diagram (DFD) Level 0 (Konteks)
Menggambarkan aliran input/output makro sistem.
```mermaid
flowchart LR
P[Pegawai] -- "Data Kredensial\nData Laporan Kegiatan\nData Edit Kegiatan" --> S((Sistem Monitoring\nPenugasan Pegawai))
S -- "Status Laporan\nDaftar Kegiatanku\nKonfirmasi Login" --> P
A[Admin] -- "Data Manajemen User (CRUD)\nInstruksi Review Laporan\nData Kredensial" --> S
S -- "Rekap Seluruh Laporan (Proses)\nData Tabel Pegawai\nDashboard Stats" --> A
SA[Super Admin] -- "Instruksi Approval (Selesai)\nInstruksi Pembatalan (Delete)\nPerintah Export Excel" --> S
S -- "Rekap Seluruh Laporan (Ditinjau)\nFile Export (XLSX)\nDashboard Stats" --> SA
```
---
## 4. Entity Relationship Diagram (ERD) Komprehensif
Menggambarkan seluruh struktur database berbasis Laravel Backend, termasuk token otentikasi Sanctum dan soft deletes (Fitur Hapus).
```mermaid
erDiagram
USERS ||--o| PEGAWAI : "Satu profil per user"
USERS ||--o{ PENUGASAN : "Dibuat oleh (created_by)"
USERS ||--o{ PENUGASAN : "Disetujui oleh (approved_by)"
PEGAWAI }|--|{ PENUGASAN_PEGAWAI : "Ditugaskan pada"
PENUGASAN }|--|{ PENUGASAN_PEGAWAI : "Melibatkan pegawai"
USERS ||--o{ PERSONAL_ACCESS_TOKENS : "Memiliki token (Login)"
USERS {
bigint id PK
string name
string username "UNIQUE"
string email "UNIQUE"
string password
enum role "superadmin, admin, user"
string jabatan "nullable"
timestamp created_at
timestamp updated_at
}
PEGAWAI {
bigint id PK
string nip "UNIQUE"
string nama
string jabatan
bigint user_id FK
timestamp deleted_at "Soft Deletes"
}
PENUGASAN {
bigint id PK
string nomor_surat "UNIQUE"
string kegiatan
string lokasi
text keterangan
date tanggal_mulai
date tanggal_selesai
enum status "proses, selesai, telah_ditinjau"
bigint created_by FK
bigint approved_by FK
timestamp approved_at
text alasan_hapus
timestamp deleted_at "Soft Deletes"
}
PENUGASAN_PEGAWAI {
bigint id PK
bigint penugasan_id FK
bigint pegawai_id FK
}
PERSONAL_ACCESS_TOKENS {
bigint id PK
string tokenable_type
bigint tokenable_id FK
string name
string token "UNIQUE"
text abilities
timestamp last_used_at
timestamp expires_at
}
```