User Management¶
SSOT untuk manajemen akun pengguna dasar yang termasuk dalam paket Tier 1 Starter.
Last verified: 2026-04-01
1. Visi & Best Practice¶
User management dasar untuk sekolah harus mencakup: - daftar akun yang searchable dan bisa difilter - create/edit akun dasar - penetapan role operasional sekolah - aktivasi/nonaktif akun - reset password - audit log perubahan akun
Untuk Tier 1, targetnya bukan IAM enterprise, tetapi operasional admin sekolah yang rapi dan terkontrol.
2. Scope Tier 1¶
| Fitur | Kebutuhan Operasional |
|---|---|
| Daftar user | Admin bisa mencari dan memantau akun aktif/nonaktif |
| Create/edit user | Admin bisa menambah dan memperbarui akun dasar |
| Role assignment | Admin bisa menetapkan role sekolah yang sesuai |
| Activate/deactivate | Akun bisa dinonaktifkan tanpa dihapus |
| Reset password | Reset mandiri oleh admin untuk support harian |
| Audit log | Perubahan akun dapat ditelusuri |
3. Current Implementation Status¶
| Fitur | Status | Catatan |
|---|---|---|
| User list + filter + stats | ✅ Done | UserList.vue |
| Create/edit user | ✅ Done | UserFormModal.vue |
| Role assignment | ✅ Done | RoleAssignmentModal.vue |
| Activate/deactivate user | ✅ Done | Action table di UserList.vue |
| Reset password admin | ✅ Done | ResetPasswordView.vue |
| Audit log perubahan akun | ✅ Done | UserAuditLog.vue + structured audit search + timestamp/export mengikuti timezone sekolah |
4. QA Evidence¶
| Evidence | Status | Catatan |
|---|---|---|
Route /admin/users |
✅ Verified | Masuk smoke Starter |
Route /admin/users/audit-log |
✅ Verified | Surface audit tersedia |
Akses head_admin |
✅ Verified | Capability + route/menu parity |
| Starter smoke admin | ✅ Verified | tests/e2e/smoke/tier1_smoke.spec.ts |
| UAT admin user management | ✅ Verified | docs/qa/uat-scenarios.md |
5. Canonical API¶
GET /api/v1/users/listGET /api/v1/users/<id>POST /api/v1/usersPUT /api/v1/users/<id>PUT /api/v1/users/<id>/rolesDELETE /api/v1/users/<id>PUT /api/v1/users/<id>/activatePOST /api/v1/users/<id>/reset-passwordGET /api/v1/users/<id>/homeroom-eligibilityGET /api/v1/users/rolesGET /api/v1/users/stats
6. File References¶
Frontend¶
src/views/AdminViews/User/UserList.vuesrc/views/AdminViews/User/UserAuditLog.vuesrc/views/AdminViews/User/ResetPasswordView.vuesrc/views/AdminViews/User/components/UserFormModal.vuesrc/views/AdminViews/User/components/RoleAssignmentModal.vuesrc/components/common/ResetPasswordDialog.vuesrc/api/userManagementApi.jssrc/services/audit/audit.service.jssrc/router/adminRoutes.jssrc/config/menuRegistry.jssrc/config/roleCapabilities.js
QA¶
tests/e2e/smoke/tier1_smoke.spec.tsdocs/qa/uat-scenarios.md
7. Panduan Konfigurasi Implementor¶
Lihat configuration-guides/user-data.md — bagian user management dan role-permission-matrix.md.
Checklist go-live: - [ ] Admin sekolah dan Kepala TU dibuat - [ ] Role assignment sesuai matriks - [ ] Audit log dapat diakses
8. Panduan End User¶
| Role | Panduan |
|---|---|
| Kepala TU / Admin | head-admin.md |
| Staff TU | admin-staff.md |
Portal publish: portal-publish-guide.md