| **Field** | **Value** | | --------------- | ------------------ | | Version | 1.0 | | Document Status | Draft | | Module | Login | | Process | Staff Registration | | System | SFA CMS | | Priority | Medium | | Type | Customization | # 1\. Introduction ## 1.1 Background Pengelolaan registrasi staff dealer ## 1.2 Purpose - 1\. API receive staff registration - 2\. Simpan profile staff - 3\. Validasi data - 4\. Approval / Reject - 5\. Revisi data - 6\. Aktivasi account staff - 7\. Notification status # 2\. Justification ## 2.1 Standard Proses Staff Registration merupakan bagian dari Login pada SFA Phase 2 dan dijalankan oleh CMS. Detail standard teknis tidak ditentukan pada Custom List. ## 2.2 Purpose of Modification Pengelolaan registrasi staff dealer ## 2.3 Considerations - Detail endpoint API, authentication mechanism, database structure, field teknis, dan error code mengikuti technical/API design apabila applicable. - Detail yang tidak tersedia pada Custom List ditandai sebagai TBD dan perlu dikonfirmasi pada technical design. # 3\. Modification Description ## 3.1 Integration / Process Overview SFA Mobile → CMS → Staff Registration → Result ## 3.2 Detail Fitur | Action | Description | | ------------------------------ | --------------------------------------------------------------------------------------- | | API receive staff registration | API receive staff registration dilakukan sebagai bagian dari proses Staff Registration. | | Simpan profile staff | Simpan profile staff dilakukan sebagai bagian dari proses Staff Registration. | | Validasi data | Validasi data dilakukan sebagai bagian dari proses Staff Registration. | | Approval / Reject | Approval / Reject dilakukan sebagai bagian dari proses Staff Registration. | | Revisi data | Revisi data dilakukan sebagai bagian dari proses Staff Registration. | | Aktivasi account staff | Aktivasi account staff dilakukan sebagai bagian dari proses Staff Registration. | | Notification status | Notification status dilakukan sebagai bagian dari proses Staff Registration. | ## 3.3 Business Flow | No. | Activity ID | Process | PIC | Description | | --- | --------------- | ------------------------------ | --- | ------------------------------ | | 1 | CMS-STAFF_RE-01 | API receive staff registration | CMS | API receive staff registration | | 2 | CMS-STAFF_RE-02 | Simpan profile staff | CMS | Simpan profile staff | | 3 | CMS-STAFF_RE-03 | Validasi data | CMS | Validasi data | | 4 | CMS-STAFF_RE-04 | Approval / Reject | CMS | Approval / Reject | | 5 | CMS-STAFF_RE-05 | Revisi data | CMS | Revisi data | | 6 | CMS-STAFF_RE-06 | Aktivasi account staff | CMS | Aktivasi account staff | | 7 | CMS-STAFF_RE-07 | Notification status | CMS | Notification status | ## 3.4 Expected Result - 1\. CMS bisa menerima dan menyimpan data registrasi staff dealer - 2\. User CMS bisa approve/reject atau meminta revisi registrasi staff - 3\. Account staff aktif setelah registrasi disetujui dan status dapat diinformasikan ke user ## 3.5 Data Requirement | No. | Field | Type | Mandatory | Description | | --- | ------------------------------ | ---- | --------- | ---------------------------------------------------------- | | 1 | API receive staff registration | TBD | TBD | Data yang dibutuhkan untuk API receive staff registration. | | 2 | Simpan profile staff | TBD | TBD | Data yang dibutuhkan untuk Simpan profile staff. | | 3 | Validasi data | TBD | TBD | Data yang dibutuhkan untuk Validasi data. | | 4 | Approval / Reject | TBD | TBD | Data yang dibutuhkan untuk Approval / Reject. | | 5 | Revisi data | TBD | TBD | Data yang dibutuhkan untuk Revisi data. | | 6 | Aktivasi account staff | TBD | TBD | Data yang dibutuhkan untuk Aktivasi account staff. | | 7 | Notification status | TBD | TBD | Data yang dibutuhkan untuk Notification status. | Catatan: Detail field teknis, database column, API field name, tipe data/file, maximum size, dan validation detail belum ditentukan pada Custom List. Detail tersebut perlu ditetapkan pada technical/API design. ## 3.6 Validation | No. | Validation | Condition | Expected Result | | --- | --------------------------------------- | --------- | ------------------------------------------------------------- | | 1 | Mandatory/required data | TBD | Validation mengikuti technical/business rule yang disepakati. | | 2 | Format & data validity | TBD | Validation mengikuti technical/business rule yang disepakati. | | 3 | Duplicate/existing data jika applicable | TBD | Validation mengikuti technical/business rule yang disepakati. | | 4 | Process/status validation | TBD | Validation mengikuti technical/business rule yang disepakati. | ## 3.7 Access Right | Component / Role | Access / Responsibility | | ---------------- | ----------------------------------------------------------------------------------- | | CMS | Melakukan aktivitas yang terkait dengan proses Staff Registration sesuai hak akses. | | User | Melakukan aktivitas yang terkait dengan proses Staff Registration sesuai hak akses. | ## 3.8 Error Handling | No. | Scenario | Handling | | --- | ------------------------- | ------------------------------------------------------------------------------ | | 1 | Invalid data | Request/process dianggap gagal dan error dicatat. Detail retry/error code TBD. | | 2 | Missing mandatory data | Request/process dianggap gagal dan error dicatat. Detail retry/error code TBD. | | 3 | API/communication failure | Request/process dianggap gagal dan error dicatat. Detail retry/error code TBD. | | 4 | Process failure | Request/process dianggap gagal dan error dicatat. Detail retry/error code TBD. | ## 3.9 Notification Notification mengikuti event/status pada proses apabila notification menjadi bagian dari task. Channel notification belum ditentukan pada Custom List dan perlu dikonfirmasi. ## 3.10 Audit Trail Aktivitas penting pada proses perlu dicatat untuk monitoring dan troubleshooting. Detail retention dan field audit log TBD. # 4\. API Specification Detail endpoint dan payload belum tersedia pada Custom List. Section ini disiapkan sebagai placeholder untuk technical/API design. | Parameter | Value | | -------------- | ---------------- | | Method | TBD | | Endpoint | TBD | | Authentication | TBD | | Content-Type | application/json | | Request | TBD | | Response | TBD | # 5\. Test Scripts | No. | Scenario | Test Steps | Test Data | Expected Result | Notes | | --- | ------------------------------------- | ---------------------------------------------------------------------------------------- | --------- | --------------------------------------------------- | ----- | | 1 | Valid process | Jalankan proses Staff Registration dengan kondisi Valid process. | TBD | Process sesuai expected result atau error handling. | TBD | | 2 | Mandatory data missing | Jalankan proses Staff Registration dengan kondisi Mandatory data missing. | TBD | Process sesuai expected result atau error handling. | TBD | | 3 | Invalid data | Jalankan proses Staff Registration dengan kondisi Invalid data. | TBD | Process sesuai expected result atau error handling. | TBD | | 4 | Duplicate/existing data if applicable | Jalankan proses Staff Registration dengan kondisi Duplicate/existing data if applicable. | TBD | Process sesuai expected result atau error handling. | TBD | | 5 | Integration/process failure | Jalankan proses Staff Registration dengan kondisi Integration/process failure. | TBD | Process sesuai expected result atau error handling. | TBD | # 6\. Acceptance Criteria - 1\. CMS bisa menerima dan menyimpan data registrasi staff dealer - 2\. User CMS bisa approve/reject atau meminta revisi registrasi staff - 3\. Account staff aktif setelah registrasi disetujui dan status dapat diinformasikan ke user # 7\. Open Issues / TBD | No. | Item | | --- | -------------------------------------- | | 1 | Detail field dan mandatory field — TBD | | 2 | Business/validation rule detail — TBD | | 3 | API endpoint — TBD | | 4 | API authentication — TBD | | 5 | Request/response payload — TBD | | 6 | Error code & error message — TBD | | 7 | Notification channel — TBD | | 8 | Audit log detail/retention — TBD |