167 lines
9.8 KiB
Markdown
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 | |