Skip to Content

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

  1. Lihat Profil — Profil perusahaan yang sedang berlaku ditampilkan, mencakup logo untuk kedua mode tampilan beserta data kontak dan alamatnya.
  2. Ubah Profil — Admin yang berwenang membuka profil untuk diperbarui.
  3. Isi Data dan Logo — Data perusahaan disunting dan logo diganti bila perlu, masing-masing satu berkas untuk mode terang dan gelap.
  4. Validasi — Isian diperiksa sebelum tersimpan, termasuk kelengkapan data wajib dan format email.
  5. Profil Tersimpan — Profil terbaru langsung dipakai di seluruh aplikasi dan pada dokumen yang dibuat setelahnya.

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
KodeTeksYa—Penanda unik perusahaan (BR-02)
Nama PerusahaanTeksYa—Nama resmi atau terdaftar (BR-02)
Nomor TeleponTeksYa—Kontak utama perusahaan (BR-02)
EmailTeksTidak—Harus berformat valid bila diisi (BR-02)
Situs WebTeksTidak——
Alamat LengkapTeksYa—Alamat bisnis perusahaan (BR-02)
Logo Mode TerangBerkasTidak—Satu berkas gambar, maksimal 1 MB (BR-03)
Logo Mode GelapBerkasTidak—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.

FieldKontrolSumber PilihanPerilaku
KodeText Input——
Nama PerusahaanText Input——
Nomor TeleponText Input——
EmailText Input——
Situs WebText Input—Diterima apa adanya, tanpa validasi format URL
Alamat LengkapTextarea——
Logo Mode TerangFile Uploader—Satu berkas gambar
Logo Mode GelapFile 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.

IDKriteria penerimaan
AC-01.1Pengguna dengan izin view melihat semua field profil beserta pratinjau logo terang dan gelap.
AC-01.2Field 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.

IDKriteria penerimaan
AC-02.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-02.2Kode, nama, telepon, dan alamat lengkap wajib diisi; email opsional tetapi harus berformat valid bila diisi.
AC-02.3Logo terang dan gelap masing-masing menerima satu file gambar.
AC-02.4Email dan situs web yang dikosongkan dikirim sebagai null.
AC-02.5Setelah berhasil, toast sukses tampil, cache tenant diperbarui, dan pengguna kembali ke mode lihat.
AC-02.6Pesan error ditampilkan pada field terkait.
AC-02.7Hanya satu logo yang diunggah — mode lain tidak menampilkan logo.
AC-02.8File logo lebih dari 1 MB atau bukan gambar — ditolak oleh pengunggah sebelum dikirim.
AC-02.9File logo yang dipakai dihapus dari Pengelola File — Perlu dikonfirmasi: perilakunya; file tercatat “Digunakan Di” di Pengelola File.
AC-02.10Dua admin mengubah profil bersamaan — simpan terakhir yang berlaku.
AC-02.11Situs 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.

IDKriteria penerimaan
AC-03.1Tombol Log Aktivitas di mode lihat membuka panel log dengan filter event, pelaku, dan rentang tanggal.

9. User Scenarios

RoleScenario
OwnerMengisi profil perusahaan saat pertama kali memakai sistem
OwnerMengunggah logo terang dan gelap agar tampil baik di kedua tema
AdminMemperbarui nomor telepon perusahaan, lalu mencetak ulang PDF PO dengan data baru
AuditorMemeriksa siapa yang mengubah alamat perusahaan

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat Profil Perusahaansettings:company:view:any—
Lihat Log Aktivitassettings:company:view:any—
Ubah Profil Perusahaansettings: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.
Terakhir diperbarui