# AGENTS.md

Dokumen ini wajib dibaca oleh semua AI coding agent, developer, dan model yang bekerja pada repository ini.

## Identitas Proyek

Nama aplikasi:

**Aplikasi Usulan Perbaikan Inventaris Perwakilan BKKBN Provinsi Sumatera Utara**

Peneliti:

- Nama: Renanda Nauval
- NIM: 2112000080
- Program Studi: Informatika

## Konteks Bisnis

Aplikasi mendigitalisasi alur:

**Pegawai → Bagian TU → Pimpinan → Bagian TU → Teknisi**

Tujuan utama:

- pembuatan tiket kerusakan;
- pemeriksaan TU;
- persetujuan pimpinan;
- penetapan SLA;
- penugasan teknisi;
- pencatatan progres;
- foto bukti penyelesaian;
- notifikasi;
- laporan;
- audit trail.

## Aturan Penting Agent

1. Baca seluruh dokumen di folder `docs/` sebelum coding.
2. Jangan mengerjakan fitur di luar fase aktif.
3. Jangan mengganti arsitektur tanpa alasan yang terdokumentasi.
4. Jangan memakai framework PHP seperti Laravel atau CodeIgniter.
5. Jangan menambahkan dependensi tanpa kebutuhan nyata.
6. Jangan menyimpan kredensial di source code.
7. Jangan menghapus file atau kode lama tanpa penjelasan.
8. Jangan membuat fitur bisnis pada Fase 1.
9. Selalu perbarui `docs/06-STATUS-PROJECT.md` setelah perubahan besar.
10. Selalu tuliskan file yang dibuat, diubah, dan keputusan teknis penting.

## Stack Wajib

- PHP Native 8.2+
- MySQL atau MariaDB
- PDO
- Composer
- Bootstrap 5 melalui CDN
- JavaScript sederhana
- MVC sederhana
- Apache/XAMPP/Laragon

## Batasan

Tidak termasuk:

- pengadaan aset;
- mutasi aset;
- penghapusan aset;
- akuntansi aset;
- pembayaran;
- vendor eksternal;
- integrasi penuh SIMAK-BMN;
- aplikasi mobile native;
- WhatsApp gateway;
- kecerdasan artifisial.

## Fase Aktif

Fase aktif saat starter dibuat:

**Fase 1 — Setup dan Fondasi Proyek**

Detail terdapat pada:

```text
prompts/FASE-1-SETUP-AWAL.md
```

## Sistem Desain UI

Setiap halaman baru wajib mengikuti:

```text
docs/09-UI-DESIGN-SYSTEM.md
```

Gunakan tema hijau, putih, dan abu-abu muda yang telah diterapkan. Jangan mengubah identitas visual utama tanpa instruksi eksplisit.