Doc_chelvyn/Mito/Sfa/FDD/SFA – CMS – Staff Registrat...

167 lines
9.8 KiB
Markdown

| **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 |