# PRD — Aplikasi Project Management IT

| | |
|---|---|
| **Versi** | 1.0 (Draft) |
| **Tanggal** | 6 November 2026 |
| **Stack** | Laravel 13, MySQL 8.x, Blade + Alpine.js/Livewire (atau Inertia), Tailwind CSS |
| **Sumber** | Template Excel `Format_Project_Management_IT_4.xlsx` dan prototipe web HTML (localStorage) |

---

## 1. Latar Belakang

Pelacakan proyek IT (contoh: *PROJECT KUPPRUM – Review Program Post Go-Live*) saat ini dilakukan di Excel dengan 3 sheet: **Dashboard**, **Project Plan**, **Pengaturan**. Excel cukup untuk satu orang, tetapi:

- Data tidak terpusat, versi file mudah berbeda-beda.
- Tidak ada hak akses dan jejak perubahan (siapa mengubah apa).
- Kalender dan pengingat due date harus dibuat manual.
- Satu file untuk satu proyek, sehingga sulit melihat banyak proyek sekaligus.

Prototipe HTML (localStorage) sudah membuktikan alur dan tampilannya. Aplikasi Laravel ini adalah versi multi-user dengan database MySQL.

## 2. Tujuan & Non-Tujuan

### Tujuan
1. Mengelola task proyek secara terpusat (CRUD, status otomatis, progres).
2. Dashboard progres yang akurat dan real-time per proyek.
3. Tampilan Timeline (Gantt mingguan) dan Kalender event berbasis due date atau rentang pengerjaan.
4. Export ke Excel dengan format seperti template, dan export `.ics` untuk kalender.
5. Master data (Modul, SBU, PIC, Tipe Task) yang bisa diubah pengguna tanpa developer.
6. Import data awal dari file Excel template yang sudah ada.

### Non-Tujuan (v1)
- Dependensi antar task (predecessor/successor) dan critical path.
- Time tracking/timesheet, biaya, dan resource leveling.
- Integrasi dua arah dengan Google/Outlook Calendar (v1 hanya export `.ics` dan link "Tambah ke Google Calendar").
- Aplikasi mobile native (UI cukup responsif).

## 3. Pengguna & Hak Akses

| Peran | Deskripsi | Hak |
|---|---|---|
| **Admin** | Pengelola sistem | Semua fitur, kelola user, semua proyek |
| **Project Manager (PM)** | Pemilik proyek | CRUD proyek miliknya, master data proyek, semua task di proyek itu, export/import |
| **Member (PIC)** | Pelaksana | Lihat proyek yang diikuti, edit task miliknya (progres, tanggal, catatan), tidak bisa hapus task |
| **Viewer** | Pemangku kepentingan | Hanya lihat Dashboard, Plan, Kalender, dan boleh export |

Implementasi: Laravel Policies + Gates. Peran disimpan per proyek di tabel pivot `project_user` (satu user bisa PM di proyek A dan Member di proyek B). Admin bersifat global (`users.is_admin`).

## 4. Ruang Lingkup Fitur

### 4.1 Manajemen Proyek
- CRUD proyek: judul, nama proyek, project manager, tanggal mulai proyek.
- Daftar proyek (kartu) dengan ringkasan progres.
- Arsip proyek (soft delete).
- Duplikasi proyek (salin master data, opsional salin task).

**Acceptance criteria**
- PM hanya melihat proyek tempat ia menjadi anggota.
- Tanggal mulai proyek menjadi titik awal kolom pertama Timeline.

### 4.2 Pengaturan Proyek (setara sheet *Pengaturan*)
| Parameter | Tipe | Default | Keterangan |
|---|---|---|---|
| `ref_date_manual` | date, nullable | null | Kosong = pakai tanggal hari ini (zona waktu `Asia/Jakarta`) |
| `timeline_scale` | enum 1/7/14 | 7 | Hari per kolom timeline |
| `due_soon_days` | int ≥ 0 | 3 | Ambang "due segera" |

Master data per proyek (dropdown di Plan):
- **Modul / Departemen** (maks. 12)
- **SBU (Sub Business Unit)** (maks. 12)
- **PIC** (maks. 12) — terhubung ke user, atau teks bebas bila PIC bukan user sistem
- **Tipe Task** (maks. 8)

Batas jumlah mengikuti template Excel agar export tetap rapi. Batas dapat dijadikan konfigurasi.

**Acceptance criteria**
- Master data baru langsung muncul di dropdown, filter, dan Dashboard tanpa reload penuh.
- Menghapus master data yang sudah dipakai task **ditolak** atau meminta konfirmasi. Task tetap menyimpan relasi (lihat §7, `ON DELETE RESTRICT`). Alternatif yang disarankan: nonaktifkan (`is_active = 0`) agar tidak muncul di dropdown baru tetapi task lama tetap valid.
- Mengganti nama master data otomatis ikut tampil di semua task (karena relasi ID, bukan teks).

### 4.3 Project Plan (setara sheet *Project Plan*)
**Kolom task**

| Kolom | Input | Keterangan |
|---|---|---|
| No | otomatis | Urutan tampil |
| Modul | dropdown | master Modul |
| SBU | dropdown | master SBU (opsional) |
| Item / Kebutuhan | teks panjang | wajib |
| Tipe | dropdown | master Tipe |
| PIC | dropdown | master PIC |
| Target / Due Date | date | opsional |
| Mulai | date | opsional |
| Selesai | date | opsional, `selesai ≥ mulai` |
| Durasi (hari) | otomatis | `selesai − mulai + 1` |
| % Progres | 0–100 | |
| Status | otomatis | lihat §5 |
| Info Due | otomatis | lihat §5 |
| Catatan | teks | opsional |

**Fitur**
- Edit inline (autosave per sel, indikator tersimpan) dan tombol "+ Tambah task".
- Cari teks (item, catatan, PIC, modul, SBU), filter Modul, SBU, Status, PIC, Tipe.
- Urutkan (due date, status, modul) dan drag-and-drop urutan manual.
- Hapus dengan opsi Urungkan (soft delete).
- Saat progres diisi 100% dan tanggal Selesai kosong, isi otomatis dengan hari ini (dapat dimatikan).
- Penyorotan sel Due Date: merah muda = terlewati, kuning = due segera.
- Tampilan **Timeline** (Gantt, read-only) berisi 26 kolom periode sesuai `timeline_scale`:
  - hijau = bagian yang sudah dikerjakan (`mulai … mulai + durasi × progres − 1`)
  - biru = sisa rencana
  - oranye = task terlambat
  - kuning muda = periode hari ini
  - ◆ = target due date

### 4.4 Dashboard (setara sheet *Dashboard*)
- Posisi per tanggal acuan.
- 7 kartu KPI: Total, Selesai, Berjalan, Open, Terlambat, Due ≤ N hari, Progres Total.
- Distribusi status (donut) dan tabel status (jumlah, %).
- Tabel **Progres per Modul**: Total, Selesai, Berjalan, Open, Terlambat, Due Segera, Progres rata-rata. Baris **"Lain-lain"** bila ada task bermodul di luar daftar, dan baris **Total**.
- Tambahan v1: filter Dashboard per SBU dan Progres per SBU (tabel yang sama dengan modul).
- Grafik **Due Date per Periode** (12 periode, stacked Selesai/Belum).

### 4.5 Kalender
- Tampilan **Bulan** dan **Agenda** (daftar event mendatang dikelompokkan per tanggal).
- Sumber event: **Due date** atau **Mulai–Selesai** (rentang); task tanpa mulai/selesai tetap tampil di due date.
- Event diwarnai menurut status; klik event membuka kartu preview (judul, tanggal, modul, SBU, tipe, PIC, progres, catatan).
- Filter Modul, SBU, Status, PIC.
- Aksi per event: **Tambah ke Google Calendar** (URL template) dan **Unduh .ics**.
- **Export .ics** untuk seluruh hasil filter: event *all-day*, `SUMMARY = [Modul] Item`, `DESCRIPTION` berisi detail, `UID` stabil (`task-{id}@domain`) agar import ulang tidak menduplikasi.
- Opsi v1.1: **feed iCal berlangganan** (URL dengan token per user) supaya Google/Outlook sinkron otomatis.

### 4.6 Export & Import Excel
**Export** — file `.xlsx` dengan 3 sheet yang sama seperti template:
- Sheet **Project Plan**: kolom A–M seperti template, **SBU di kolom N**, timeline dimulai kolom O (26 kolom), dropdown, format tanggal `dd-mmm-yy`, conditional formatting (status, due, Gantt), freeze pane `D9`.
- Sheet **Dashboard**: KPI, tabel status, progres per modul, due per periode, memakai **rumus Excel** (bukan nilai mati) sehingga tetap hidup bila diedit.
- Sheet **Pengaturan**: parameter dan daftar pilihan (Modul B, PIC D, Tipe F, SBU H).
- Grafik Excel tidak wajib di v1.

**Import** — unggah `.xlsx`:
- Membaca template asli (tanpa SBU) maupun hasil export aplikasi (dengan SBU di kolom N).
- Alur: unggah → **pratinjau** (jumlah task, master data baru yang akan dibuat, baris bermasalah) → konfirmasi.
- Master data yang belum ada dibuat otomatis (dengan konfirmasi). Mode: *tambahkan* atau *ganti semua task*.
- Baris tidak valid (tanggal rusak, progres di luar 0–100) dilaporkan per baris, bukan menggagalkan semua.

Library yang disarankan: `openspout/openspout` atau `phpoffice/phpspreadsheet` (via `maatwebsite/excel`). Pilih yang mendukung rumus, data validation, dan conditional formatting. Proses export/import besar dijalankan via **queue**.

### 4.7 Report Aktivitas Harian (*IT Activity Report*)
Laporan harian per tanggal, formatnya mengikuti contoh Excel "IT ACTIVITY REPORT – 5 November 2026".

| Kolom | Input | Keterangan |
|---|---|---|
| No | otomatis | Urutan per tanggal |
| Area | teks | Default dari pengaturan proyek (contoh: *Kupprum*) |
| Category | dropdown | Master Kategori (default: Improvement, Bug Fix, New Feature, Hardware, Preparation, Support) |
| Activity / Action Item | teks panjang | Boleh beberapa baris |
| Status | dropdown | `Done`, `In Progress`, `Pending`, `Blocked` |
| Progres | 0–100 | Mengisi 100 otomatis mengubah status jadi Done, dan sebaliknya |
| Target / Notes | teks | |

**Fitur**
- Navigasi tanggal (‹ › Hari ini, pemilih tanggal); satu report per proyek per tanggal.
- Ringkasan: jumlah Done / In Progress / Pending / Blocked dan rata-rata progres.
- **Tarik dari Project Plan**: membuat draf aktivitas dari task pada tanggal terpilih, tanpa duplikat (kunci `task_id` + tanggal):
  - `progres = 100` dan `Selesai = tanggal` → *Done*
  - `progres < 100` dan `Due = tanggal`, atau `0 < progres < 100` dengan tanggal berada di rentang Mulai–Selesai → *In Progress* / *Pending*
  - Category dipetakan dari Tipe task (Bug → Bug Fix, Fitur Baru → New Feature, Perubahan → Improvement, Hardware → Hardware, Persiapan → Preparation). Target/Notes diisi dari Due Date dan Catatan task.
- Entri report **independen** dari task setelah dibuat (mengubah report tidak mengubah task); relasi `task_id` hanya untuk mencegah duplikat dan menelusuri asal.
- **Salin teks** (format siap tempel ke WhatsApp/email) dan **Export Excel**: satu sheet untuk tanggal terpilih, atau satu sheet per tanggal untuk semua hari. Tata letak: judul di baris 1, header berwarna biru muda dengan filter di baris 3, sel Status berwarna (Done hijau, In Progress biru, Pending merah muda, Blocked oranye) dengan dropdown.
- Opsi v1.1: kirim report otomatis pukul 17:00 WIB ke email/WhatsApp PM dan kunci report (read-only) setelah dikirim.

**Acceptance criteria**
- Report tanggal lain tidak berubah ketika report tanggal terpilih diedit.
- "Tarik dari Project Plan" dua kali berturut-turut tidak menggandakan aktivitas.
- File Excel report dibuka tanpa peringatan, filter dan dropdown status berfungsi.

### 4.8 Notifikasi (v1.1)
- Email/in-app untuk PIC: task due ≤ N hari, task terlambat (ringkasan harian pukul 08:00 WIB via scheduler).
- Digest mingguan untuk PM.

### 4.9 Audit Log
- Catat perubahan task (siapa, kapan, field, nilai lama → baru). Paket yang disarankan: `spatie/laravel-activitylog`.
- Riwayat tampil di panel detail task.

## 5. Aturan Bisnis (WAJIB sama dengan Excel)

Tanggal acuan `R` = `ref_date_manual` jika diisi, jika tidak = hari ini (`Asia/Jakarta`). `p` = progres (0–1).

**Status** (hanya untuk task yang `item` terisi):
```
jika p ≥ 1                                              → "Selesai"
jika (due ≠ null dan due < R)
   atau (due = null dan selesai ≠ null dan selesai < R) → "Terlambat"
jika p > 0                                              → "Berjalan"
selain itu                                              → "OPEN"
```

**Info Due** (kosong jika `due` null):
```
p ≥ 1 : selesai null → "Selesai"
        selesai ≤ due → "Tepat waktu"
        selain itu    → "Telat {selesai − due} hr"
p < 1 : due < R  → "Lewat {R − due} hr"
        due = R  → "Jatuh tempo hari ini"
        due > R  → "H-{due − R}"
```

**Due segera**: `R ≤ due ≤ R + due_soon_days` dan status ≠ Selesai.
**Durasi** = `selesai − mulai + 1` (jika keduanya ada).
**Progres Total** = jumlah progres semua task ÷ jumlah task. **Progres Modul** = rata-rata progres task di modul itu.
**Due per Periode** (periode ke-*i*): `[mulai_proyek + i×skala, mulai_proyek + (i+1)×skala)`, dihitung menurut `due_date`, dipisah Selesai dan Belum (status ≠ Selesai).

Status & info due **tidak disimpan** di database, melainkan dihitung agar selalu mengikuti tanggal acuan (lihat §7.2).

## 6. Arsitektur Teknis

- **Laravel 13** (pastikan versi PHP sesuai persyaratan resmi Laravel 13; verifikasi sebelum setup), MySQL 8.x (`utf8mb4`), Redis (cache/queue, opsional).
- **UI**: Blade + Livewire 3/4 (inline edit & filter reaktif) dengan Alpine.js dan Tailwind; alternatif Inertia + Vue bila tim lebih nyaman.
- **Autentikasi**: Laravel Breeze/Fortify (email + password), opsional SSO nanti.
- **Otorisasi**: Policy `ProjectPolicy`, `TaskPolicy`.
- **Zona waktu**: `config('app.timezone') = 'Asia/Jakarta'`, simpan tanggal sebagai `DATE` (tanpa jam) agar bebas masalah zona waktu.
- **Struktur**: `app/Services/TaskStatusService` (satu sumber aturan §5), `DashboardService`, `ExcelExportService`, `ExcelImportService`, `IcsService`.
- **Layanan status**: implementasikan aturan §5 di **satu tempat** (accessor/enum `TaskStatus` + query scope SQL) dan beri unit test dengan tabel kasus dari §10.

## 7. Model Data (MySQL)

### 7.1 Skema

```sql
-- projects.report_area VARCHAR(100) NULL  -- Area default report harian (contoh: Kupprum)
-- users: bawaan Laravel + kolom tambahan
ALTER TABLE users ADD COLUMN is_admin TINYINT(1) NOT NULL DEFAULT 0;

CREATE TABLE projects (
  id            BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  title         VARCHAR(200) NOT NULL,          -- judul besar (A1 Excel)
  name          VARCHAR(255) NULL,              -- nama proyek
  manager_name  VARCHAR(120) NULL,
  start_date    DATE NOT NULL,                  -- tanggal mulai proyek
  ref_date_manual DATE NULL,
  timeline_scale TINYINT UNSIGNED NOT NULL DEFAULT 7,   -- 1/7/14
  due_soon_days TINYINT UNSIGNED NOT NULL DEFAULT 3,
  created_by    BIGINT UNSIGNED NOT NULL,
  created_at TIMESTAMP NULL, updated_at TIMESTAMP NULL, deleted_at TIMESTAMP NULL,
  CONSTRAINT chk_scale CHECK (timeline_scale IN (1,7,14)),
  FOREIGN KEY (created_by) REFERENCES users(id)
);

CREATE TABLE project_user (
  project_id BIGINT UNSIGNED NOT NULL,
  user_id    BIGINT UNSIGNED NOT NULL,
  role ENUM('pm','member','viewer') NOT NULL DEFAULT 'member',
  PRIMARY KEY (project_id, user_id),
  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
  FOREIGN KEY (user_id)    REFERENCES users(id)    ON DELETE CASCADE
);

-- Master data per proyek (4 tabel dengan pola sama; contoh: modules)
CREATE TABLE modules (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  project_id BIGINT UNSIGNED NOT NULL,
  name VARCHAR(100) NOT NULL,
  sort_order SMALLINT UNSIGNED NOT NULL DEFAULT 0,
  is_active TINYINT(1) NOT NULL DEFAULT 1,
  UNIQUE KEY uq_module (project_id, name),
  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
);
-- sbus(id, project_id, name, sort_order, is_active)        -- sama
-- task_types(id, project_id, name, sort_order, is_active)  -- sama
CREATE TABLE pics (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  project_id BIGINT UNSIGNED NOT NULL,
  user_id BIGINT UNSIGNED NULL,                 -- opsional: PIC yang punya akun
  name VARCHAR(100) NOT NULL,
  sort_order SMALLINT UNSIGNED NOT NULL DEFAULT 0,
  is_active TINYINT(1) NOT NULL DEFAULT 1,
  UNIQUE KEY uq_pic (project_id, name),
  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
  FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE SET NULL
);

CREATE TABLE report_categories (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  project_id BIGINT UNSIGNED NOT NULL,
  name VARCHAR(100) NOT NULL,
  sort_order SMALLINT UNSIGNED NOT NULL DEFAULT 0,
  is_active TINYINT(1) NOT NULL DEFAULT 1,
  UNIQUE KEY uq_repcat (project_id, name),
  FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
);

CREATE TABLE tasks (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  project_id BIGINT UNSIGNED NOT NULL,
  module_id BIGINT UNSIGNED NULL,
  sbu_id BIGINT UNSIGNED NULL,
  task_type_id BIGINT UNSIGNED NULL,
  pic_id BIGINT UNSIGNED NULL,
  item TEXT NOT NULL,
  due_date DATE NULL,
  start_date DATE NULL,
  end_date DATE NULL,
  progress TINYINT UNSIGNED NOT NULL DEFAULT 0,  -- 0..100
  note TEXT NULL,
  sort_order INT UNSIGNED NOT NULL DEFAULT 0,
  created_by BIGINT UNSIGNED NULL, updated_by BIGINT UNSIGNED NULL,
  created_at TIMESTAMP NULL, updated_at TIMESTAMP NULL, deleted_at TIMESTAMP NULL,
  CONSTRAINT chk_progress CHECK (progress BETWEEN 0 AND 100),
  CONSTRAINT chk_dates CHECK (end_date IS NULL OR start_date IS NULL OR end_date >= start_date),
  KEY idx_proj_due (project_id, due_date),
  KEY idx_proj_module (project_id, module_id),
  KEY idx_proj_sbu (project_id, sbu_id),
  KEY idx_proj_progress (project_id, progress),
  FOREIGN KEY (project_id)   REFERENCES projects(id)   ON DELETE CASCADE,
  FOREIGN KEY (module_id)    REFERENCES modules(id)    ON DELETE RESTRICT,
  FOREIGN KEY (sbu_id)       REFERENCES sbus(id)       ON DELETE RESTRICT,
  FOREIGN KEY (task_type_id) REFERENCES task_types(id) ON DELETE RESTRICT,
  FOREIGN KEY (pic_id)       REFERENCES pics(id)       ON DELETE SET NULL
);
```

Progres disimpan sebagai integer 0–100 (bukan pecahan) agar tidak ada masalah pembulatan; konversi ke 0–1 hanya di layer perhitungan dan export.

Tabel report harian:

```sql
CREATE TABLE activity_reports (
  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
  project_id BIGINT UNSIGNED NOT NULL,
  report_date DATE NOT NULL,
  task_id BIGINT UNSIGNED NULL,                  -- asal task (opsional)
  area VARCHAR(100) NULL,
  category_id BIGINT UNSIGNED NULL,
  activity TEXT NOT NULL,
  status ENUM('Done','In Progress','Pending','Blocked') NOT NULL DEFAULT 'Done',
  progress TINYINT UNSIGNED NOT NULL DEFAULT 0,
  notes TEXT NULL,
  sort_order INT UNSIGNED NOT NULL DEFAULT 0,
  created_by BIGINT UNSIGNED NULL,
  created_at TIMESTAMP NULL, updated_at TIMESTAMP NULL, deleted_at TIMESTAMP NULL,
  CONSTRAINT chk_rep_progress CHECK (progress BETWEEN 0 AND 100),
  UNIQUE KEY uq_rep_task_day (project_id, report_date, task_id),  -- cegah duplikat saat "Tarik dari Plan"
  KEY idx_rep_day (project_id, report_date),
  FOREIGN KEY (project_id)  REFERENCES projects(id) ON DELETE CASCADE,
  FOREIGN KEY (task_id)     REFERENCES tasks(id) ON DELETE SET NULL,
  FOREIGN KEY (category_id) REFERENCES report_categories(id) ON DELETE SET NULL
);
```

Catatan: pada MySQL, `UNIQUE` dengan `task_id` NULL tidak saling bentrok, sehingga aktivitas manual (tanpa task) tidak dibatasi.

### 7.2 Menghitung Status di SQL

Dipakai oleh Dashboard (agregasi) dan filter status. `:r` = tanggal acuan.

```sql
CASE
  WHEN progress >= 100 THEN 'Selesai'
  WHEN (due_date IS NOT NULL AND due_date < :r)
    OR (due_date IS NULL AND end_date IS NOT NULL AND end_date < :r) THEN 'Terlambat'
  WHEN progress > 0 THEN 'Berjalan'
  ELSE 'OPEN'
END AS status
```

Contoh agregasi Dashboard per modul:
```sql
SELECT m.name, COUNT(t.id) total,
       SUM(status='Selesai') selesai, SUM(status='Berjalan') berjalan,
       SUM(status='OPEN') open_, SUM(status='Terlambat') terlambat,
       SUM(t.due_date BETWEEN :r AND DATE_ADD(:r, INTERVAL :n DAY) AND status<>'Selesai') due_segera,
       AVG(t.progress)/100 progres
FROM modules m
LEFT JOIN (SELECT t.*, <CASE di atas> AS status FROM tasks t
           WHERE project_id=:p AND deleted_at IS NULL) t ON t.module_id=m.id
WHERE m.project_id=:p AND m.is_active=1
GROUP BY m.id, m.name ORDER BY m.sort_order;
```

Skala awal kecil (puluhan–ribuan task per proyek), jadi tidak perlu kolom *generated*/materialized view.

## 8. Rute & Endpoint

**Web**
| Method | Path | Fungsi |
|---|---|---|
| GET | `/projects` | Daftar proyek |
| GET | `/projects/{p}/dashboard` | Dashboard |
| GET | `/projects/{p}/plan` | Plan (Tabel/Timeline lewat `?view=`) |
| GET | `/projects/{p}/calendar` | Kalender |
| GET | `/projects/{p}/reports` | Report Harian |
| GET | `/projects/{p}/settings` | Pengaturan & master data |
| GET | `/projects/{p}/export.xlsx` | Export Excel |
| POST | `/projects/{p}/import` | Import Excel (pratinjau → konfirmasi) |
| GET | `/projects/{p}/calendar.ics` | Export ICS (menerima parameter filter) |
| GET | `/ical/{token}.ics` | Feed langganan (v1.1) |

**JSON/Livewire actions** (`auth`, policy-protected)
- `POST /projects/{p}/tasks`, `PATCH /tasks/{t}` (per field, untuk autosave), `DELETE /tasks/{t}`, `POST /tasks/{t}/restore`, `POST /projects/{p}/tasks/reorder`
- `CRUD /projects/{p}/{modules|sbus|pics|task-types|report-categories}`
- `GET /projects/{p}/reports?date=YYYY-MM-DD`, `POST /projects/{p}/reports`, `PATCH /reports/{r}`, `DELETE /reports/{r}`, `POST /projects/{p}/reports/pull?date=` (tarik dari Plan)
- `GET /projects/{p}/reports/export.xlsx?date=` atau `?all=1`, `GET /projects/{p}/reports/text?date=` (teks siap salin)

**Validasi task (FormRequest)**: `item` wajib (maks. 5000), `*_id` harus milik proyek yang sama, tanggal valid, `end_date ≥ start_date`, `progress` integer 0–100.

## 9. UX / UI

- Navigasi: **Dashboard · Project Plan · Kalender · Report Harian · Pengaturan** (tab per proyek) dan pemilih proyek di header.
- Palet mengikuti template: navy `#1F3864`, biru `#2F5597`, status Selesai hijau `#2E8B57`, Berjalan biru `#2F75B5`, OPEN merah `#D64545`, Terlambat oranye `#C55A11`, Due segera kuning `#BF9000`.
- Referensi tampilan: prototipe HTML (`Project_Management_IT.html`).
- Responsif: tabel Plan boleh scroll horizontal; Kalender menjadi satu kolom di layar sempit.
- Aksesibilitas: kontras warna memadai dan status selalu disertai teks, tidak hanya warna.
- Bahasa antarmuka: Indonesia (siapkan `lang/id`, struktur mendukung bahasa lain).

## 10. Kasus Uji Kunci (Status & Info Due)

Dengan `R = 2026-11-06`:

| progres | due | selesai | Status | Info Due |
|---|---|---|---|---|
| 100 | 05-Nov | 05-Nov | Selesai | Tepat waktu |
| 100 | 05-Nov | 08-Nov | Selesai | Telat 3 hr |
| 100 | 05-Nov | – | Selesai | Selesai |
| 0 | 13-Nov | – | OPEN | H-7 |
| 0 | 06-Nov | – | OPEN | Jatuh tempo hari ini |
| 0 | 04-Nov | – | Terlambat | Lewat 2 hr |
| 50 | 04-Nov | – | Terlambat | Lewat 2 hr |
| 50 | 10-Nov | – | Berjalan | H-4 |
| 0 | – | 03-Nov | Terlambat | (kosong) |
| 0 | – | – | OPEN | (kosong) |

Data contoh (32 task dari template) dijadikan **seeder** dan dipakai sebagai uji regresi: total 32, selesai 19, open 13, progres total 59% pada `R = 2026-11-06`.

## 11. Persyaratan Non-Fungsional

| Area | Target |
|---|---|
| Performa | Halaman Plan/Dashboard < 1 detik untuk 1.000 task/proyek; export 1.000 task < 10 detik (queue bila lebih) |
| Keamanan | CSRF, validasi server-side, policy per proyek, rate limit login, password hash bawaan Laravel, escape output (XSS), query terparameter |
| Integritas | FK dan CHECK constraint, soft delete untuk task/proyek, transaksi pada import |
| Ketersediaan | Backup MySQL harian, retensi ≥ 30 hari |
| Kompatibilitas | Chrome/Edge/Firefox/Safari 2 versi terakhir |
| Observabilitas | Log error terpusat (Laravel Log/Sentry), audit log task |
| Pengujian | Unit (aturan §5), Feature (policy & CRUD), uji export/import (round-trip), Browser test (Dusk/Pest) untuk alur utama |

## 12. Rencana Rilis

| Fase | Isi | Estimasi |
|---|---|---|
| **M1 – Fondasi** | Setup Laravel 13, auth & peran, migrasi, master data, CRUD proyek | 1 minggu |
| **M2 – Plan & Status** | Tabel Plan inline edit, aturan status/info due, filter, seeder 32 task, unit test | 1,5 minggu |
| **M3 – Dashboard & Timeline** | KPI, status, per modul/SBU, due per periode, Timeline | 1 minggu |
| **M4 – Kalender & Report** | Bulan/Agenda, preview event, `.ics`, link Google Calendar; Report Harian (CRUD, tarik dari Plan, salin teks, export) | 1,5 minggu |
| **M5 – Excel** | Export dengan rumus & format, import + pratinjau | 1,5 minggu |
| **M6 – Hardening** | Audit log, notifikasi (v1.1), UAT, perbaikan, deploy | 1 minggu |

Total ±7,5 minggu untuk 1–2 developer. Estimasi kasar, sesuaikan setelah keputusan §13.

## 13. Pertanyaan Terbuka

1. Apakah satu aplikasi melayani **banyak proyek** (diasumsikan ya) atau hanya satu?
2. **PIC**: harus selalu user yang bisa login, atau boleh nama bebas? (Saat ini: keduanya didukung.)
3. Apakah **SBU** perlu satu task punya **beberapa** SBU (relasi many-to-many) atau cukup satu?
4. Apakah perlu **login SSO** (Google Workspace/Azure AD) atau cukup email + password?
5. Apakah Excel hasil export wajib memuat **grafik** seperti template asli?
6. Apakah notifikasi cukup email, atau perlu WhatsApp/Telegram?
7. Batas maksimum master data (12/12/12/8) dipertahankan atau dihilangkan di aplikasi (tetap dibatasi hanya saat export Excel)?
8. Lokasi hosting dan kebijakan backup (on-premise atau cloud)?

## 14. Kriteria Penerimaan Rilis v1

- [ ] Seeder 32 task menghasilkan angka Dashboard identik dengan Excel (§10).
- [ ] Semua aturan di §5 lolos unit test.
- [ ] Export Excel dibuka di Excel/LibreOffice tanpa peringatan, rumus terhitung ulang dengan hasil sama dengan aplikasi.
- [ ] Import file template asli (tanpa SBU) dan file hasil export (dengan SBU) berhasil, round-trip tanpa kehilangan data.
- [ ] File `.ics` terbaca oleh Google Calendar dan Outlook; import ulang tidak menduplikasi event.
- [ ] Report Harian: tarik dari Plan tanpa duplikat, export Excel sesuai format contoh, teks salin sesuai format.
- [ ] Hak akses: Viewer tidak dapat mengubah data; Member hanya mengedit task miliknya; anggota luar proyek mendapat 403.
- [ ] Master data (Modul, SBU, PIC, Tipe) dapat ditambah/diubah/dinonaktifkan oleh PM tanpa developer.
