Perusahaan
- Code: SET-COM
- Module: Settings
- Type: Configuration
1. Overview
Perusahaan adalah profil resmi tenant: kode, nama, kontak, alamat, dan logo. Hanya ada satu profil per tenant, dan datanya dipakai secara konsisten di seluruh aplikasi, termasuk di dokumen transaksi seperti Pesanan Pembelian.
Hasil yang diharapkan: identitas bisnis tenant tampil konsisten di semua layar dan dokumen, dan bisa diperbarui sendiri oleh admin.
2. Problem
Tanpa profil perusahaan yang terpusat, identitas bisnis pada dokumen dan tampilan aplikasi mudah tidak konsisten atau ketinggalan zaman. Akibatnya:
- Dokumen yang dikirim ke supplier (misalnya PDF PO) butuh identitas perusahaan yang resmi dan seragam.
- Logo satu warna sering tidak terbaca di mode gelap atau terang.
- Perubahan alamat atau nomor telepon perusahaan harus langsung tercermin di dokumen baru.
3. Goals & Non-goals
3.1 Goals
- Identitas perusahaan tampil seragam di seluruh aplikasi dan di dokumen yang dikirim ke pihak luar.
- Perubahan data perusahaan langsung berlaku pada dokumen yang dibuat setelahnya.
- Logo tetap terbaca baik pada tampilan terang maupun gelap.
- Pembaruan profil dilakukan sendiri oleh admin, tanpa melibatkan tim teknis.
3.2 Non-goals
- Lebih dari satu perusahaan atau badan hukum dalam satu tenant.
- Data legal seperti NPWP dan NIB, serta rekening bank.
- Riwayat versi profil di luar catatan log aktivitas.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Perusahaan di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.
- BR-01 Setiap tenant hanya memiliki satu profil perusahaan.
- BR-02 Kode, nama, nomor telepon, dan alamat lengkap wajib diisi. Email boleh dikosongkan, tetapi harus berformat valid bila diisi.
- BR-03 Logo hanya menerima berkas gambar, satu berkas untuk tiap mode tampilan, maksimal 1 MB.
- BR-04 Perubahan profil langsung berlaku di seluruh aplikasi setelah disimpan.
- BR-05 Dokumen yang dibuat setelah perubahan memakai profil terbaru; dokumen yang sudah diunduh sebelumnya tidak ikut berubah.
- BR-06 Setiap perubahan profil tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Lihat Profil — Profil perusahaan yang sedang berlaku ditampilkan, mencakup logo untuk kedua mode tampilan beserta data kontak dan alamatnya.
- Ubah Profil — Admin yang berwenang membuka profil untuk diperbarui.
- Isi Data dan Logo — Data perusahaan disunting dan logo diganti bila perlu, masing-masing satu berkas untuk mode terang dan gelap.
- Validasi — Isian diperiksa sebelum tersimpan, termasuk kelengkapan data wajib dan format email.
- Profil Tersimpan — Profil terbaru langsung dipakai di seluruh aplikasi dan pada dokumen yang dibuat setelahnya.
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kode | Teks | Ya | — | Penanda unik perusahaan (BR-02) |
| Nama Perusahaan | Teks | Ya | — | Nama resmi atau terdaftar (BR-02) |
| Nomor Telepon | Teks | Ya | — | Kontak utama perusahaan (BR-02) |
| Teks | Tidak | — | Harus berformat valid bila diisi (BR-02) | |
| Situs Web | Teks | Tidak | — | — |
| Alamat Lengkap | Teks | Ya | — | Alamat bisnis perusahaan (BR-02) |
| Logo Mode Terang | Berkas | Tidak | — | Satu berkas gambar, maksimal 1 MB (BR-03) |
| Logo Mode Gelap | Berkas | Tidak | — | Satu berkas gambar, maksimal 1 MB (BR-03) |
7. UI Structure
Bagian ini mendefinisikan cara Perusahaan ditampilkan dan dioperasikan: kontrol form beserta sumber pilihannya. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Form & Details
Satu halaman dengan mode lihat dan ubah. Field opsional yang kosong tampil sebagai ”-” di mode lihat. Aksi: Ubah Data (lihat), Simpan (ubah), Log Aktivitas.
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Kode | Text Input | — | — |
| Nama Perusahaan | Text Input | — | — |
| Nomor Telepon | Text Input | — | — |
| Text Input | — | — | |
| Situs Web | Text Input | — | Diterima apa adanya, tanpa validasi format URL |
| Alamat Lengkap | Textarea | — | — |
| Logo Mode Terang | File Uploader | — | Satu berkas gambar |
| Logo Mode Gelap | File Uploader | — | Satu berkas gambar |
8. User Stories
US-01 - Melihat profil perusahaan
Sebagai admin, saya ingin melihat profil perusahaan, agar tahu data yang dipakai di dokumen.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Pengguna dengan izin view melihat semua field profil beserta pratinjau logo terang dan gelap. |
| AC-01.2 | Field opsional yang kosong tampil sebagai ”-”. |
US-02 - Mengubah profil perusahaan
Sebagai owner, saya ingin memperbarui profil perusahaan, agar identitas di aplikasi dan dokumen selalu benar.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-02.2 | Kode, nama, telepon, dan alamat lengkap wajib diisi; email opsional tetapi harus berformat valid bila diisi. |
| AC-02.3 | Logo terang dan gelap masing-masing menerima satu file gambar. |
| AC-02.4 | Email dan situs web yang dikosongkan dikirim sebagai null. |
| AC-02.5 | Setelah berhasil, toast sukses tampil, cache tenant diperbarui, dan pengguna kembali ke mode lihat. |
| AC-02.6 | Pesan error ditampilkan pada field terkait. |
| AC-02.7 | Hanya satu logo yang diunggah — mode lain tidak menampilkan logo. |
| AC-02.8 | File logo lebih dari 1 MB atau bukan gambar — ditolak oleh pengunggah sebelum dikirim. |
| AC-02.9 | File logo yang dipakai dihapus dari Pengelola File — Perlu dikonfirmasi: perilakunya; file tercatat “Digunakan Di” di Pengelola File. |
| AC-02.10 | Dua admin mengubah profil bersamaan — simpan terakhir yang berlaku. |
| AC-02.11 | Situs web diisi tanpa http(s):// — diterima apa adanya; tidak ada validasi format URL. |
US-03 - Riwayat perubahan
Sebagai owner, saya ingin melihat log aktivitas perusahaan, agar perubahan profil bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Log Aktivitas di mode lihat membuka panel log dengan filter event, pelaku, dan rentang tanggal. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Mengisi profil perusahaan saat pertama kali memakai sistem |
| Owner | Mengunggah logo terang dan gelap agar tampil baik di kedua tema |
| Admin | Memperbarui nomor telepon perusahaan, lalu mencetak ulang PDF PO dengan data baru |
| Auditor | Memeriksa siapa yang mengubah alamat perusahaan |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat Profil Perusahaan | settings:company:view:any | — |
| Lihat Log Aktivitas | settings:company:view:any | — |
| Ubah Profil Perusahaan | settings:company:update:any | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- File Manager — penyimpanan file logo.
- Appearance — berbagi data inisialisasi tenant.
- Purchase Order — kop PDF memakai profil perusahaan.
- Activity Logs — sumber log aktivitas.
Efek ke modul lain
- Logo tampil di sidebar, pemilih toko, sambutan pengguna, dan halaman auth.
- Kop dokumen PDF memakai profil perusahaan.