title: “Recruitment ATS — Applicant Tracking System” description: “Sistem pelacakan pelamar dengan job posting, kanban pipeline 6 tahap, dan React Query di SNISHOP ERP.”

Recruitment ATS — Applicant Tracking System

Recruitment ATS mengelola seluruh proses rekrutmen dari pembuatan lowongan hingga penerimaan karyawan. Sistem menggunakan kanban board dengan 6 tahap pipeline untuk melacak progress setiap pelamar.

Arsitektur

Akses Halaman

URL: /recruitment-ats

Dua Tab Utama

Tab	Label	Konten
`jobs`	Lowongan	Daftar job posting dengan create/edit
`applicants`	Pelamar	Kanban pipeline pelamar

Statistik

Metrik	Perhitungan
Active Jobs	COUNT JobPosting `status = 'open'`
Total Applicants	COUNT semua Applicant
In Process	COUNT Applicant `status ≠ hired, rejected`
Total Hired	COUNT Applicant `status = 'hired'`

Entitas: JobPosting

Field	Tipe	Deskripsi
`company_id`	string	ID perusahaan
`position_title`	string	Judul posisi
`department`	string	Departemen
`description`	string	Deskripsi pekerjaan
`requirements`	array	Daftar persyaratan
`salary_range_min`	number	Gaji minimum
`salary_range_max`	number	Gaji maksimum
`employment_type`	enum	Jenis pekerjaan
`job_location`	string	Lokasi kerja
`closing_date`	date	Tanggal penutupan
`status`	enum	Status lowongan
`posted_by`	string	ID pembuat
`posting_date`	date	Tanggal posting

Jenis Pekerjaan

Tipe	Label
`full_time`	Full Time
`part_time`	Part Time
`contract`	Kontrak
`internship`	Magang

Status Lowongan

Status	Label	Keterangan
`open`	Dibuka	Masih menerima lamaran
`closed`	Ditutup	Sudah ditutup
`on_hold`	Ditunda	Ditunda sementara

Entitas: Applicant

Field	Tipe	Deskripsi
`company_id`	string	ID perusahaan
`job_id`	string	ID lowongan yang dilamar
`name`	string	Nama pelamar
`email`	string	Email pelamar
`phone`	string	Nomor telepon
`resume_url`	string	URL file CV/resume
`cover_letter`	string	Surat lamaran
`status`	enum	Status pipeline
`applied_date`	date	Tanggal melamar
`notes`	string	Catatan dari recruiter

Kanban Pipeline

7 Kolom Status

Kolom	Status	Warna	Deskripsi
New	`new`	Biru	Pelamar baru masuk
Screening	`screening`	Cyan	Sedang diseleksi berkas
Interview Scheduled	`interview_scheduled`	Kuning	Jadwal interview sudah diatur
Interviewed	`interviewed`	Orange	Sudah diinterview
Offer Extended	`offer_extended`	Hijau Muda	Penawaran sudah diberikan
Hired	`hired`	Hijau	Diterima
Rejected	`rejected`	Merah	Ditolak

Alur Progresi

Tombol “Maju”

Setiap pelamar memiliki tombol “Maju” yang memajukan status ke tahap berikutnya:

new → screening → interview_scheduled → interviewed → offer_extended → hired

Applicant Detail Dialog

Dialog detail pelamar menampilkan:

Info	Detail
Nama	Nama lengkap pelamar
Email	Alamat email
Telepon	Nomor telepon
Lowongan	Posisi yang dilamar
Tanggal Melamar	`applied_date`
Resume	Link download CV
Cover Letter	Isi surat lamaran
Catatan	Catatan dari recruiter
Status Buttons	Tombol untuk ubah status (termasuk reject)

React Query

ATS menggunakan React Query (useQuery, useMutation, useQueryClient) untuk manajemen data:

Hook	Fungsi
`useQuery`	Fetch data job posting dan applicant
`useMutation`	Create/update/delete job dan applicant
`useQueryClient`	Invalidate cache setelah mutasi

Keuntungan React Query

Fitur	Manfaat
Automatic Caching	Data di-cache, tidak re-fetch saat navigasi kembali
Background Refetch	Data di-refresh di background
Optimistic Updates	UI update instan sebelum server response
Mutation Retry	Retry otomatis jika mutasi gagal

Job Posting Card

Setiap lowongan ditampilkan dalam card dengan informasi:

Field	Tampilan
Position Title	Judul besar di card
Department	Badge departemen
Employment Type	Badge tipe (full-time/part-time/contract)
Salary Range	Format Rupiah (min - max)
Location	Lokasi kerja
Closing Date	Tanggal penutupan
Status	Badge warna (open/closed/on_hold)
Applicant Count	Jumlah pelamar

Integrasi dengan HR Module

Saat pelamar berstatus hired, data bisa dikonversi menjadi CompanyMember (karyawan baru) melalui proses onboarding di EmployeeForm.

Tips Penggunaan

Buat job posting dengan deskripsi dan persyaratan yang jelas untuk menarik pelamar berkualitas
Review pelamar baru secara berkala dan majukan yang memenuhi syarat ke tahap screening
Jadwalkan interview segera setelah screening selesai
Berikan catatan pada setiap pelamar untuk referensi di tahap selanjutnya
Tutup lowongan yang sudah terisi agar tidak menerima lamaran baru
Gunakan data statistik (active jobs, total hired) untuk evaluasi proses rekrutmen

Entity Relationship Diagram

Tabel Schema — Entitas Rekrutmen

JobPosting

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan pembuat lowongan
`position_title`	string	Ya	Judul posisi yang ditawarkan
`department`	string	Ya	Departemen penempatan
`description`	string	Ya	Deskripsi lengkap pekerjaan
`requirements`	array[string]	Tidak	Daftar persyaratan kualifikasi
`salary_range_min`	number	Tidak	Batas bawah gaji
`salary_range_max`	number	Tidak	Batas atas gaji
`employment_type`	enum	Tidak	Jenis pekerjaan (default: `full_time`)
`job_location`	string	Tidak	Lokasi penempatan kerja
`posting_date`	date	Tidak	Tanggal lowongan diposting
`closing_date`	date	Ya	Tanggal penutupan lowongan
`status`	enum	Tidak	Status lowongan (default: `open`)
`posted_by`	string	Tidak	User ID HR yang membuat posting

Applicant

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan tujuan lamaran
`job_posting_id`	string	Ya	ID lowongan yang dilamar
`full_name`	string	Ya	Nama lengkap pelamar
`email`	string (email)	Ya	Alamat email pelamar
`phone`	string	Tidak	Nomor telepon pelamar
`resume_url`	string	Tidak	URL file CV/resume
`cover_letter`	string	Tidak	Surat lamaran
`application_date`	datetime	Tidak	Tanggal dan waktu melamar
`current_status`	enum	Tidak	Status pipeline (default: `new`)
`education`	array[object]	Tidak	Riwayat pendidikan
`experience`	array[object]	Tidak	Riwayat pengalaman kerja
`skills`	array[string]	Tidak	Daftar keahlian
`assigned_to`	string	Tidak	HR/Hiring Manager yang menangani
`notes`	string	Tidak	Catatan dari recruiter

InterviewSchedule

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`applicant_id`	string	Ya	ID pelamar yang diinterview
`interview_type`	enum	Tidak	Tipe wawancara
`interview_date`	datetime	Ya	Tanggal dan waktu interview
`interview_location`	string	Tidak	Lokasi atau link wawancara
`interviewer_ids`	array[string]	Tidak	User IDs interviewer
`description`	string (max 1000)	Tidak	Agenda dan topik wawancara
`status`	enum	Tidak	Status jadwal (default: `scheduled`)
`interview_notes`	string	Tidak	Catatan hasil wawancara
`rating`	number (1-5)	Tidak	Rating kandidat
`feedback`	array[object]	Tidak	Feedback per interviewer
`recommendation`	enum	Tidak	Rekomendasi akhir (`pass`/`reject`/`undecided`)

CompanyInvitation

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan pengundang
`company_name`	string	Tidak	Nama perusahaan
`invited_email`	string	Ya	Email yang diundang
`invited_by`	string	Ya	Email pengundang
`invited_by_name`	string	Tidak	Nama pengundang
`role`	enum	Tidak	Role yang diberikan (default: `employee`)
`department`	string	Tidak	Departemen penempatan
`position`	string	Tidak	Jabatan
`description`	string (max 1000)	Tidak	Pesan undangan
`permissions`	object	Tidak	Hak akses detail
`message`	string	Tidak	Pesan tambahan
`status`	enum	Tidak	Status undangan (default: `pending`)
`expires_at`	datetime	Tidak	Waktu kedaluwarsa undangan
`accepted_at`	datetime	Tidak	Waktu undangan diterima
`rejected_at`	datetime	Tidak	Waktu undangan ditolak
`cancelled_at`	datetime	Tidak	Waktu undangan dibatalkan

CompanyMember

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`user_id`	string	Tidak	Link ke User entity
`user_email`	string	Ya	Email pengguna
`user_name`	string	Tidak	Nama pengguna
`role`	enum	Tidak	Role perusahaan (default: `employee`)
`employee_id`	string	Tidak	Link ke Employee entity
`department`	string	Tidak	Departemen
`position`	string	Tidak	Jabatan
`status`	enum	Tidak	Status keanggotaan (default: `active`)
`joined_date`	date	Tidak	Tanggal bergabung
`invited_by`	string	Tidak	Email yang mengundang
`permissions`	object	Tidak	Hak akses detail
`assigned_locations`	array[string]	Tidak	Lokasi gudang/outlet yang diizinkan
`working_hours`	object	Tidak	Jam kerja (start, end)
`salary`	number	Tidak	Gaji karyawan
`notes`	string	Tidak	Catatan tambahan

Employee

Field	Tipe	Required	Deskripsi
`company_id`	string	Ya	ID perusahaan
`user_id`	string	Tidak	Link ke User entity
`employee_id`	string	Ya	ID karyawan unik
`full_name`	string	Ya	Nama lengkap karyawan
`email`	string	Ya	Email karyawan
`phone`	string	Tidak	Nomor telepon
`department`	enum	Ya	Departemen
`position`	string	Ya	Jabatan
`description`	string (max 1000)	Tidak	Deskripsi/catatan karyawan
`employment_type`	enum	Tidak	Jenis pekerjaan (default: `full_time`)
`hire_date`	date	Ya	Tanggal diterima
`salary`	number	Tidak	Gaji bulanan
`bank_account`	object	Tidak	Info rekening bank
`emergency_contact`	object	Tidak	Kontak darurat
`address`	string	Tidak	Alamat
`date_of_birth`	date	Tidak	Tanggal lahir
`status`	enum	Tidak	Status karyawan (default: `active`)
`avatar_url`	string	Tidak	URL foto profil

State Machine — Application Lifecycle

Transisi Status Pelamar

Dari	Ke	Trigger	Deskripsi
—	`new`	Submit lamaran	Pelamar mendaftar ke lowongan
`new`	`screening`	Tombol “Maju”	recruiter meloloskan seleksi berkas
`new`	`rejected`	Tombol “Reject”	Berkas tidak memenuhi syarat
`screening`	`interview_scheduled`	Tombol “Maju” + buat InterviewSchedule	Jadwalkan interview
`screening`	`rejected`	Tombol “Reject”	Gagal tahap screening
`interview_scheduled`	`interviewed`	InterviewSchedule status → `completed`	Interview telah dilaksanakan
`interview_scheduled`	`rejected`	Tombol “Reject”	Tidak hadir atau gagal interview
`interviewed`	`offer_extended`	Tombol “Maju”	Kandidat layak mendapat penawaran
`interviewed`	`rejected`	Tombol “Reject”	Tidak lolos tahap interview
`offer_extended`	`hired`	Tombol “Maju”	Pelamar menerima penawaran
`offer_extended`	`rejected`	Tombol “Reject”	Pelamar menolak penawaran
`hired`	—	Konversi otomatis	Data dikonversi ke Employee + CompanyMember + CompanyInvitation

Sequence Diagrams

1. Submit Lamaran

2. Jadwal Interview

3. Offer Letter & Hiring

Enum Tables

application_status (Applicant.current_status)

Nilai	Label	Warna Badge	Deskripsi
`new`	Pelamar Baru	Biru	Lamaran baru masuk, belum direview
`screening`	Screening	Cyan	Sedang dalam tahap seleksi berkas
`interview_scheduled`	Interview Scheduled	Kuning	Jadwal interview sudah ditentukan
`interviewed`	Interviewed	Orange	Interview sudah dilaksanakan
`offer_extended`	Offer Extended	Hijau Muda	Penawaran kerja sudah diberikan
`hired`	Hired	Hijau	Pelamar diterima sebagai karyawan
`rejected`	Rejected	Merah	Lamaran ditolak di tahap manapun

employment_type (JobPosting.employment_type)

Nilai	Label	Deskripsi
`full_time`	Full Time	Pekerjaan penuh waktu
`part_time`	Part Time	Pekerjaan paruh waktu
`contract`	Kontrak	Pekerjaan berbasis kontrak jangka tertentu
`internship`	Magang	Program magang / internship

job_status (JobPosting.status)

Nilai	Label	Deskripsi
`open`	Dibuka	Lowongan aktif menerima lamaran
`closed`	Ditutup	Lowongan sudah ditutup, tidak menerima lamaran
`on_hold`	Ditunda	Lowongan ditunda sementara

interview_type (InterviewSchedule.interview_type)

Nilai	Label	Deskripsi
`phone_screening`	Phone Screening	Wawancara telepon awal
`first_round`	First Round	Interview putaran pertama
`second_round`	Second Round	Interview putaran kedua
`final_round`	Final Round	Interview putaran akhir
`hr_round`	HR Round	Interview khusus dengan tim HR

interview_status (InterviewSchedule.status)

Nilai	Label	Deskripsi
`scheduled`	Terjadwal	Interview belum dilaksanakan
`completed`	Selesai	Interview sudah dilaksanakan
`cancelled`	Dibatalkan	Interview dibatalkan

interview_recommendation (InterviewSchedule.recommendation)

Nilai	Label	Deskripsi
`pass`	Lolos	Kandidat direkomendasikan untuk lanjut
`reject`	Tolak	Kandidat tidak direkomendasikan
`undecided`	Belum Diputuskan	Interviewer belum memberikan keputusan

invitation_status (CompanyInvitation.status)

Nilai	Label	Deskripsi
`pending`	Menunggu	Undangan belum direspon
`accepted`	Diterima	Undangan sudah diterima
`rejected`	Ditolak	Undangan ditolak oleh penerima
`expired`	Kedaluwarsa	Undangan sudah melewati batas waktu
`cancelled`	Dibatalkan	Undangan dibatalkan oleh pengirim

company_role (CompanyInvitation.role / CompanyMember.role)

Nilai	Label	Deskripsi
`owner`	Owner	Pemilik perusahaan
`admin`	Admin	Administrator perusahaan
`supervisor`	Supervisor	Penyelia divisi
`store_admin`	Store Admin	Admin toko/outlet
`stock_admin`	Stock Admin	Admin stok/gudang
`finance_admin`	Finance Admin	Admin keuangan
`hr_admin`	HR Admin	Admin HR / rekrutmen
`transaction_admin`	Transaction Admin	Admin transaksi
`employee`	Employee	Karyawan biasa
`production_operator`	Production Operator	Operator produksi
`qc_inspector`	QC Inspector	Inspektor quality control
`sales_marketing`	Sales & Marketing	Tim sales dan marketing
`partner_distributor`	Partner Distributor	Mitra distributor

employee_status (Employee.status)

Nilai	Label	Deskripsi
`active`	Aktif	Karyawan aktif bekerja
`on_leave`	Cuti	Karyawan sedang cuti
`terminated`	Nonaktif	Karyawan sudah tidak bekerja

member_status (CompanyMember.status)

Nilai	Label	Deskripsi
`active`	Aktif	Anggota aktif
`inactive`	Nonaktif	Anggota dinonaktifkan
`pending`	Menunggu	Undangan belum diterima

RBAC — Recruitment ATS

Aksi	Owner	Admin	HR Admin	Supervisor	Employee
Lihat semua JobPosting	✅	✅	✅	✅	❌
Buat JobPosting	✅	✅	✅	❌	❌
Edit JobPosting	✅	✅	✅	❌	❌
Hapus JobPosting	✅	✅	❌	❌	❌
Ubah status JobPosting	✅	✅	✅	❌	❌
Lihat semua Applicant	✅	✅	✅	✅	❌
Tambah Applicant	✅	✅	✅	❌	❌
Majukan status Applicant	✅	✅	✅	❌	❌
Reject Applicant	✅	✅	✅	❌	❌
Buat InterviewSchedule	✅	✅	✅	❌	❌
Isi feedback interview	✅	✅	✅	✅	❌
Konversi Applicant → Employee	✅	✅	✅	❌	❌
Kirim CompanyInvitation	✅	✅	✅	❌	❌
Lihat data Employee	✅	✅	✅	✅	✅ (diri sendiri)
Edit data Employee	✅	✅	✅	❌	❌
Kelola permissions member	✅	✅	❌	❌	❌
Hapus Employee	✅	✅	❌	❌	❌

Catatan RLS (Row-Level Security)

Semua entitas rekrutmen menggunakan RLS berbasis company_id:

Kondisi	Akses
`data.company_id == user.data.active_company_id`	Akses penuh ke data dalam perusahaan aktif
`created_by_id == user.id`	Akses ke data yang dibuat sendiri
`user_condition.role == 'admin'`	Akses penuh ke semua data (system admin)
`data.invited_email == user.email` (CompanyInvitation)	Undangan yang ditujukan ke email user
`data.user_email == user.email` (CompanyMember)	Data keanggotaan milik sendiri
`data.user_id == user.id` (Employee)	Data karyawan milik sendiri

Referensi Schema Nested Object

Bagian ini mendokumentasikan struktur detail untuk field bertipe object dan array[object] yang merujuk pada sub-schema dari masing-masing entitas.

Applicant.education — Sub-Schema

Setiap elemen dalam array education pada entitas Applicant memiliki struktur berikut:

Field	Tipe	Deskripsi
`school_name`	string	Nama institusi pendidikan
`degree`	string	Gelar (misal: S1, D3, S2)
`field`	string	Bidang studi / jurusan
`graduation_year`	number	Tahun kelulusan

Contoh data:

[
  {
    "school_name": "Universitas Indonesia",
    "degree": "S1",
    "field": "Teknik Informatika",
    "graduation_year": 2023
  }
]

Applicant.experience — Sub-Schema

Setiap elemen dalam array experience pada entitas Applicant memiliki struktur berikut:

Field	Tipe	Deskripsi
`company_name`	string	Nama perusahaan tempat bekerja
`position`	string	Jabatan di perusahaan tersebut
`duration_years`	number	Lama bekerja dalam tahun
`description`	string	Deskripsi tanggung jawab dan pencapaian

Contoh data:

[
  {
    "company_name": "PT Maju Bersama",
    "position": "Frontend Developer",
    "duration_years": 2,
    "description": "Mengembangkan dashboard internal menggunakan React dan TypeScript"
  }
]

InterviewSchedule.feedback — Sub-Schema

Setiap elemen dalam array feedback pada entitas InterviewSchedule memiliki struktur berikut:

Field	Tipe	Deskripsi
`interviewer_id`	string	User ID interviewer yang memberikan feedback
`feedback_text`	string	Catatan atau komentar dari interviewer
`rating`	number	Rating individu dari interviewer (1-5)

Contoh data:

[
  {
    "interviewer_id": "user_abc123",
    "feedback_text": "Kandidat memiliki kemampuan komunikasi yang baik dan penguasaan teknis memadai",
    "rating": 4
  },
  {
    "interviewer_id": "user_def456",
    "feedback_text": "Perlu pendalaman di bidang system design",
    "rating": 3
  }
]

Employee.bank_account — Sub-Schema

Field bank_account pada entitas Employee memiliki struktur berikut:

Field	Tipe	Deskripsi
`bank_name`	string	Nama bank (misal: BCA, Mandiri, BNI)
`account_number`	string	Nomor rekening bank
`account_name`	string	Nama pemilik rekening

Contoh data:

{
  "bank_name": "BCA",
  "account_number": "1234567890",
  "account_name": "Budi Santoso"
}

Employee.emergency_contact — Sub-Schema

Field emergency_contact pada entitas Employee memiliki struktur berikut:

Field	Tipe	Deskripsi
`name`	string	Nama kontak darurat
`relationship`	string	Hubungan dengan karyawan (misal: istri, suami, orang tua)
`phone`	string	Nomor telepon kontak darurat

Contoh data:

{
  "name": "Siti Rahayu",
  "relationship": "Istri",
  "phone": "081234567890"
}

CompanyMember.working_hours — Sub-Schema

Field working_hours pada entitas CompanyMember memiliki struktur berikut:

Field	Tipe	Default	Deskripsi
`start`	string (HH:mm)	`09:00`	Jam mulai kerja
`end`	string (HH:mm)	`17:00`	Jam selesai kerja

Contoh data:

{
  "start": "08:00",
  "end": "17:00"
}

CompanyInvitation.permissions / CompanyMember.permissions — Sub-Schema Lengkap

Field permissions pada CompanyInvitation dan CompanyMember berisi objek dengan boolean flags yang menentukan hak akses member. Berikut daftar lengkap seluruh permission:

Hak Akses Umum (Default Aktif untuk Semua Member)

Permission	Tipe	Default	Deskripsi
`can_view_dashboard`	boolean	`true`	Melihat dashboard utama
`can_view_tasks`	boolean	`true`	Melihat daftar tugas
`can_create_tasks`	boolean	`true`	Membuat tugas baru
`can_edit_tasks`	boolean	`true`	Mengedit tugas
`can_view_notes`	boolean	`true`	Melihat catatan
`can_create_notes`	boolean	`true`	Membuat catatan baru
`can_edit_notes`	boolean	`true`	Mengedit catatan

Hak Akses Umum (Default Nonaktif)

Permission	Tipe	Default	Deskripsi
`can_delete_tasks`	boolean	`false`	Menghapus tugas
`can_delete_notes`	boolean	`false`	Menghapus catatan

Hak Akses HR & Keuangan

Permission	Tipe	Default	Deskripsi
`can_view_hr`	boolean	`false`	Melihat data HR (karyawan, rekrutmen)
`can_edit_hr`	boolean	`false`	Mengedit data HR
`can_view_finance`	boolean	`false`	Melihat laporan keuangan
`can_edit_finance`	boolean	`false`	Mengedit data keuangan

Hak Akses Inventori

Permission	Tipe	Default	Deskripsi
`can_view_inventory`	boolean	`false`	Melihat data inventori / stok
`can_edit_inventory`	boolean	`false`	Mengedit data inventori
`can_transfer_inventory`	boolean	`false`	Melakukan transfer antar lokasi
`can_approve_stock_opname`	boolean	`false`	Menyetujui hasil stock opname
`can_count_stock_opname`	boolean	`false`	Menghitung stock opname

Hak Akses Proyek

Permission	Tipe	Default	Deskripsi
`can_view_projects`	boolean	`false`	Melihat daftar proyek
`can_edit_projects`	boolean	`false`	Mengedit data proyek

Hak Akses POS (Point of Sale)

Permission	Tipe	Default	Deskripsi
`can_view_pos`	boolean	`false`	Melihat tampilan POS
`can_use_pos`	boolean	`false`	Menggunakan POS untuk transaksi
`can_manage_cashier_shift`	boolean	`false`	Mengelola shift kasir

Hak Akses Laporan & Manajemen

Permission	Tipe	Default	Deskripsi
`can_view_reports`	boolean	`false`	Melihat laporan
`can_manage_members`	boolean	`false`	Mengelola anggota tim
`can_manage_roles`	boolean	`false`	Mengelola role dan hak akses
`can_view_settings`	boolean	`false`	Melihat pengaturan sistem
`can_edit_settings`	boolean	`false`	Mengedit pengaturan sistem

Hak Akses Produksi

Permission	Tipe	Default	Deskripsi
`can_create_production_batch`	boolean	`false`	Membuat batch produksi
`can_release_production_qc`	boolean	`false`	Melepaskan hasil QC produksi

Hak Akses HPP & Distribusi

Permission	Tipe	Default	Deskripsi
`can_view_hpp`	boolean	`false`	Melihat perhitungan HPP (Harga Pokok Produksi)
`can_manage_channel_pricing`	boolean	`false`	Mengelola harga per channel distribusi
`can_view_distribution`	boolean	`false`	Melihat data distribusi
`can_create_distribution_shipment`	boolean	`false`	Membuat pengiriman distribusi
`can_confirm_distribution_shipment`	boolean	`false`	Mengonfirmasi pengiriman distribusi

Hak Akses B2B

Permission	Tipe	Default	Deskripsi
`can_view_b2b_invoices`	boolean	`false`	Melihat invoice B2B
`can_create_b2b_invoice`	boolean	`false`	Membuat invoice B2B
`can_verify_b2b_payment`	boolean	`false`	Verifikasi pembayaran B2B

Enum Tambahan — Employee.department

Field department pada entitas Employee menggunakan enum yang berbeda dari field department pada JobPosting atau CompanyMember (yang bertipe string bebas). Berikut daftar nilai enum untuk Employee.department:

Nilai	Deskripsi
`Management`	Departemen manajemen / pimpinan
`Sales`	Departemen penjualan
`Marketing`	Departemen pemasaran
`Operations`	Departemen operasional
`Finance`	Departemen keuangan
`IT`	Departemen teknologi informasi
`HR`	Departemen sumber daya manusia
`Customer Service`	Departemen layanan pelanggan

Perbedaan Field department antar Entitas

Entitas	Tipe	Format	Deskripsi
`JobPosting.department`	string	Teks bebas	Departemen diisi manual saat buat lowongan
`CompanyMember.department`	string	Teks bebas	Departemen diisi manual saat invite member
`Employee.department`	enum	Nilai terbatas	Dipilih dari daftar enum tetap (8 nilai)

Perbedaan employment_type antar Entitas

Terdapat perbedaan kecil nilai enum employment_type antara JobPosting dan Employee:

Nilai	JobPosting	Employee	Deskripsi
`full_time`	Ya	Ya	Pekerjaan penuh waktu
`part_time`	Ya	Ya	Pekerjaan paruh waktu
`contract`	Ya	Ya	Pekerjaan berbasis kontrak
`internship`	Ya	Tidak	Program magang (khusus JobPosting)
`intern`	Tidak	Ya	Magang (khusus Employee, penamaan berbeda)

Catatan: JobPosting menggunakan internship sedangkan Employee menggunakan intern untuk konsep yang sama. Perbedaan penamaan ini perlu diperhatikan saat konversi data dari Applicant yang di-hired menjadi Employee.

Kebijakan RLS (Row-Level Security) — Detail Lengkap

Berikut adalah aturan RLS lengkap untuk setiap operasi CRUD pada masing-masing entitas rekrutmen, diekstrak langsung dari definisi JSONC.

JobPosting — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	HR harus berada di perusahaan aktif
Create	`created_by_id == user.id`	Pengguna yang membuat data
Create	`user_condition.role == 'admin'`	System admin
Read	Sama dengan Create	Akses baca mengikuti aturan yang sama
Update	Sama dengan Create	Akses ubah mengikuti aturan yang sama
Delete	Sama dengan Create	Akses hapus mengikuti aturan yang sama

Applicant — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	HR di perusahaan aktif
Create	`created_by_id == user.id`	Pembuat data
Create	`user_condition.role == 'admin'`	System admin
Read	Sama dengan Create	Akses baca mengikuti aturan yang sama
Update	Sama dengan Create	Akses ubah mengikuti aturan yang sama
Delete	Sama dengan Create	Akses hapus mengikuti aturan yang sama

InterviewSchedule — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	HR di perusahaan aktif
Create	`created_by_id == user.id`	Pembuat data
Create	`user_condition.role == 'admin'`	System admin
Read/Update/Delete	Sama dengan Create	Semua operasi mengikuti aturan yang sama

CompanyInvitation — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	Pengundang di perusahaan aktif
Create	`created_by_id == user.id`	Pembuat undangan
Create	`data.invited_email == user.email`	Penerima undangan bisa membuat untuk dirinya sendiri
Create	`user_condition.role == 'admin'`	System admin
Read/Update/Delete	Sama dengan Create	Termasuk akses untuk penerima undangan (`invited_email`)

CompanyMember — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	Admin di perusahaan aktif
Create	`created_by_id == user.id`	Pembuat data
Create	`data.user_email == user.email`	Member bisa melihat data dirinya sendiri
Create	`data.user_id == user.id`	Member berdasarkan user_id
Create	`user_condition.role == 'admin'`	System admin
Read/Update/Delete	Sama dengan Create	Semua operasi mengikuti aturan yang sama

Employee — RLS Rules

Operasi	Kondisi	Keterangan
Create	`data.company_id == user.data.active_company_id` DAN `data.company_id != null/""`	HR di perusahaan aktif
Create	`created_by_id == user.id`	Pembuat data
Create	`data.user_id == user.id`	Karyawan bisa mengakses data dirinya sendiri
Create	`user_condition.role == 'admin'`	System admin
Read/Update/Delete	Sama dengan Create	Semua operasi mengikuti aturan yang sama

Ringkasan Pola RLS

Semua entitas mengikuti pola yang konsisten:

company_id match     → Akses penuh dalam scope perusahaan aktif
created_by_id match  → Akses ke data yang dibuat sendiri
user_id/email match  → Akses ke data milik sendiri (self-service)
role == 'admin'      → Akses penuh tanpa batasan (system override)

Diagram Alur Konversi Pelamar ke Karyawan

Validasi dan Constraints

Field Required per Entitas

Entitas	Field Required	Jumlah
JobPosting	`company_id`, `position_title`, `department`, `description`, `closing_date`	5
Applicant	`company_id`, `job_posting_id`, `full_name`, `email`	4
InterviewSchedule	`company_id`, `applicant_id`, `interview_date`	3
CompanyInvitation	`company_id`, `invited_email`, `invited_by`	3
CompanyMember	`company_id`, `user_email`	2
Employee	`company_id`, `employee_id`, `full_name`, `email`, `department`, `position`, `hire_date`	7

Format Field Khusus

Entitas	Field	Format	Keterangan
Applicant	`email`	email	Validasi format email
Applicant	`application_date`	date-time	ISO 8601 datetime
InterviewSchedule	`interview_date`	date-time	ISO 8601 datetime
InterviewSchedule	`description`	maxLength: 1000	Maksimal 1000 karakter
InterviewSchedule	`rating`	number (1-5)	Skala rating 1 sampai 5
CompanyInvitation	`description`	maxLength: 1000	Maksimal 1000 karakter
CompanyInvitation	`expires_at`	date-time	ISO 8601 datetime
CompanyInvitation	`accepted_at`	date-time	ISO 8601 datetime
CompanyInvitation	`rejected_at`	date-time	ISO 8601 datetime
CompanyInvitation	`cancelled_at`	date-time	ISO 8601 datetime
CompanyMember	`joined_date`	date	Format tanggal
Employee	`hire_date`	date	Format tanggal
Employee	`date_of_birth`	date	Format tanggal
Employee	`description`	maxLength: 1000	Maksimal 1000 karakter
JobPosting	`posting_date`	date	Format tanggal
JobPosting	`closing_date`	date	Format tanggal

Default Values per Entitas

Entitas	Field	Default	Deskripsi
JobPosting	`employment_type`	`full_time`	Jenis pekerjaan default
JobPosting	`status`	`open`	Status lowongan saat pertama dibuat
Applicant	`current_status`	`new`	Status pipeline pelamar baru
InterviewSchedule	`status`	`scheduled`	Status jadwal interview baru
CompanyInvitation	`role`	`employee`	Role default untuk undangan baru
CompanyInvitation	`status`	`pending`	Status undangan baru
CompanyMember	`role`	`employee`	Role default untuk member baru
CompanyMember	`status`	`active`	Status default member
CompanyMember.working_hours	`start`	`09:00`	Jam mulai kerja default
CompanyMember.working_hours	`end`	`17:00`	Jam selesai kerja default
Employee	`employment_type`	`full_time`	Jenis pekerjaan default
Employee	`status`	`active`	Status karyawan default

Mapping Entitas Sumber (JSONC)

Dokumentasi ini disusun berdasarkan file definisi entitas berikut:

File JSONC	Entitas	Lokasi
`JobPosting.jsonc`	JobPosting	`base44/entities/`
`Applicant.jsonc`	Applicant	`base44/entities/`
`InterviewSchedule.jsonc`	InterviewSchedule	`base44/entities/`
`CompanyInvitation.jsonc`	CompanyInvitation	`base44/entities/`
`CompanyMember.jsonc`	CompanyMember	`base44/entities/`
`Employee.jsonc`	Employee	`base44/entities/`

​title: “Recruitment ATS — Applicant Tracking System” description: “Sistem pelacakan pelamar dengan job posting, kanban pipeline 6 tahap, dan React Query di SNISHOP ERP.”

​Recruitment ATS — Applicant Tracking System

​Arsitektur

​Akses Halaman

​Dua Tab Utama

​Statistik

​Entitas: JobPosting

​Jenis Pekerjaan

​Status Lowongan

​Entitas: Applicant

​Kanban Pipeline

​7 Kolom Status

​Alur Progresi

​Tombol “Maju”

​Applicant Detail Dialog

​React Query

​Keuntungan React Query

​Job Posting Card

​Integrasi dengan HR Module

​Tips Penggunaan

​Entity Relationship Diagram

​Tabel Schema — Entitas Rekrutmen

​JobPosting

​Applicant

​InterviewSchedule

​CompanyInvitation

​CompanyMember

​Employee

​State Machine — Application Lifecycle

​Transisi Status Pelamar

​Sequence Diagrams

​1. Submit Lamaran

​2. Jadwal Interview

​3. Offer Letter & Hiring

​Enum Tables

​application_status (Applicant.current_status)

​employment_type (JobPosting.employment_type)

​job_status (JobPosting.status)

​interview_type (InterviewSchedule.interview_type)

​interview_status (InterviewSchedule.status)

​interview_recommendation (InterviewSchedule.recommendation)

​invitation_status (CompanyInvitation.status)

​company_role (CompanyInvitation.role / CompanyMember.role)

​employee_status (Employee.status)

​member_status (CompanyMember.status)

​RBAC — Recruitment ATS

​Catatan RLS (Row-Level Security)

​Referensi Schema Nested Object

​Applicant.education — Sub-Schema

​Applicant.experience — Sub-Schema

​InterviewSchedule.feedback — Sub-Schema

​Employee.bank_account — Sub-Schema

​Employee.emergency_contact — Sub-Schema

​CompanyMember.working_hours — Sub-Schema

​CompanyInvitation.permissions / CompanyMember.permissions — Sub-Schema Lengkap

​Hak Akses Umum (Default Aktif untuk Semua Member)

​Hak Akses Umum (Default Nonaktif)

​Hak Akses HR & Keuangan

​Hak Akses Inventori

​Hak Akses Proyek

​Hak Akses POS (Point of Sale)

​Hak Akses Laporan & Manajemen

​Hak Akses Produksi

​Hak Akses HPP & Distribusi

​Hak Akses B2B

​Enum Tambahan — Employee.department

​Perbedaan Field department antar Entitas

​Perbedaan employment_type antar Entitas

​Kebijakan RLS (Row-Level Security) — Detail Lengkap

​JobPosting — RLS Rules

​Applicant — RLS Rules

​InterviewSchedule — RLS Rules

​CompanyInvitation — RLS Rules

​CompanyMember — RLS Rules

​Employee — RLS Rules

​Ringkasan Pola RLS

​Diagram Alur Konversi Pelamar ke Karyawan

​Validasi dan Constraints

​Field Required per Entitas

​Format Field Khusus

title: “Recruitment ATS — Applicant Tracking System” description: “Sistem pelacakan pelamar dengan job posting, kanban pipeline 6 tahap, dan React Query di SNISHOP ERP.”

Recruitment ATS — Applicant Tracking System

Arsitektur

Akses Halaman

Dua Tab Utama

Statistik

Entitas: JobPosting

Jenis Pekerjaan

Status Lowongan

Entitas: Applicant

Kanban Pipeline

7 Kolom Status

Alur Progresi

Tombol “Maju”

Applicant Detail Dialog

React Query

Keuntungan React Query

Job Posting Card

Integrasi dengan HR Module

Tips Penggunaan

Entity Relationship Diagram

Tabel Schema — Entitas Rekrutmen

JobPosting

Applicant

InterviewSchedule

CompanyInvitation

CompanyMember

Employee

State Machine — Application Lifecycle

Transisi Status Pelamar

Sequence Diagrams

1. Submit Lamaran

2. Jadwal Interview

3. Offer Letter & Hiring

Enum Tables

application_status (Applicant.current_status)

employment_type (JobPosting.employment_type)

job_status (JobPosting.status)

interview_type (InterviewSchedule.interview_type)

interview_status (InterviewSchedule.status)

interview_recommendation (InterviewSchedule.recommendation)

invitation_status (CompanyInvitation.status)

company_role (CompanyInvitation.role / CompanyMember.role)

employee_status (Employee.status)

member_status (CompanyMember.status)

RBAC — Recruitment ATS

Catatan RLS (Row-Level Security)

Referensi Schema Nested Object

Applicant.education — Sub-Schema

Applicant.experience — Sub-Schema

InterviewSchedule.feedback — Sub-Schema

Employee.bank_account — Sub-Schema

Employee.emergency_contact — Sub-Schema

CompanyMember.working_hours — Sub-Schema

CompanyInvitation.permissions / CompanyMember.permissions — Sub-Schema Lengkap

Hak Akses Umum (Default Aktif untuk Semua Member)

Hak Akses Umum (Default Nonaktif)

Hak Akses HR & Keuangan

Hak Akses Inventori

Hak Akses Proyek

Hak Akses POS (Point of Sale)

Hak Akses Laporan & Manajemen

Hak Akses Produksi

Hak Akses HPP & Distribusi

Hak Akses B2B

Enum Tambahan — Employee.department

Perbedaan Field department antar Entitas

Perbedaan employment_type antar Entitas

Kebijakan RLS (Row-Level Security) — Detail Lengkap

JobPosting — RLS Rules

Applicant — RLS Rules

InterviewSchedule — RLS Rules

CompanyInvitation — RLS Rules

CompanyMember — RLS Rules

Employee — RLS Rules

Ringkasan Pola RLS

Diagram Alur Konversi Pelamar ke Karyawan

Validasi dan Constraints

Field Required per Entitas

Format Field Khusus