- Modul Consumable Item: model master, buku besar transaksi (stock ledger), purchase unit conversion, stock opname, dan transaction reversal - Integrasi ke Employee Management, Asset Unit, dan tiket/work order - Konfigurasi akses jaringan lokal (LAN) via 0.0.0.0:8000, ALLOWED_HOSTS, dan CSRF_TRUSTED_ORIGINS otomatis - Script pembuka firewall Windows (buka_firewall_lan.bat) dan menu interaktif run.bat - Skema migrasi 0019_consumableitem_consumabletransaction - Seeder 11 item consumable riil (seed_consumables.py) - Test suite komprehensif (41 automated tests, 100% lulus) - Pipeline CI/CD GitHub Actions (.github/workflows/ci.yml)
7.2 KiB
7.2 KiB
09 — Test Strategy & Test Plan
Tanggal Analisis: 26 Oktober 2026
Kondisi Eksisting: 0% Automated Test (assets/tests.py hanya 4 baris template default)
Status Verifikasi: Terverifikasi via code audit statis
1. Analisis Kesenjangan Pengujian (Testing Gap Analysis)
Repository saat ini sama sekali tidak memiliki pengujian otomatis (automated test).
Bukti langsung pada assets/tests.py:
from django.test import TestCase
# Create your tests here.
Ketiadaan test suite ini menimbulkan risiko regresi yang sangat tinggi, terutama karena sistem mengelola:
- Siklus hidup unit aset (status change logic).
- Perubahan kode aset induk yang mentranslasikan suffix ke ratusan unit turunan (
Asset.save()). - Transaksi distribusi serah terima, mutasi antar-karyawan, dan pengembalian unit.
- Parsing riwayat penghapusan data karyawan berbasis Regular Expression.
2. Strategi Pengujian yang Direkomendasikan (Test Strategy)
Pengujian harus dibagi menjadi 3 piramida pengujian:
/ \
/ E2E \ (Playwright / Cypress untuk UI Flow Kritis)
/-------\
/ Integr- \ (View & Request-Response Tests, Transaction Rollback)
/ ation \
/-------------\
/ Unit Testing \ (Model validations, logic helpers, formatters, export builders)
/-----------------\
2.1 Framework dan Tools
- Test Runner:
pytest+pytest-django(lebih ekspresif dan cepat dibanding defaultunittest/TestCase). - Mocking & Factory:
factory_boyuntuk pembuatan data dummy model yang terisolasi tanpa bergantung pada fixture statis. - Coverage Tool:
pytest-covdengan ambang batas target minimum 80% line coverage. - Database: Gunakan database SQLite in-memory untuk eksekusi test cepat pada CI, atau MySQL test container khusus.
3. Matriks Test Case Prioritas Tinggi (Critical Test Cases)
Berikut daftar skenario pengujian yang wajib dibuat sebelum memulai perubahan atau penambahan fitur:
3.1 Modul Autentikasi & Kontrol Akses (Security & Auth)
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-AUTH-01 | Login pengguna valid | Username & password terdaftar | Status code 302 redirect ke /, session auth terisi |
| TC-AUTH-02 | Login dengan Email | Format email terdaftar di User | Berhasil login dan redirect ke dashboard |
| TC-AUTH-03 | Login kredensial salah | Password salah | Status 200, pesan error muncul di context |
| TC-AUTH-04 | Proteksi URL anonim | Mengakses /aset/ tanpa login |
Redirect 302 ke /login/?next=/aset/ |
| TC-AUTH-05 | Bug Verification: asset_add |
Mengirim POST ke /aset/add/ tanpa session login |
Harus ditolak (401/302). Saat ini lolos (Bug SEC-001)! |
| TC-AUTH-06 | Akses Backup Database | User biasa (bukan superuser) akses /backup/ |
Mengembalikan status 403 Forbidden |
| TC-AUTH-07 | Detail Publik QR Code | Mengakses /public/unit/<uuid>/ tanpa login |
Status 200 OK (Akses publik diizinkan) |
3.2 Modul Master Aset & Siklus Unit Fisik
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-AST-01 | Pembuatan jenis aset unik | Kode aset baru "CCTV-EXT" |
Record tersimpan, status 200/JsonResponse success |
| TC-AST-02 | Validasi duplikasi kode aset | Kode aset yang sudah ada | Ditolak dengan pesan error validasi |
| TC-AST-03 | Pembuatan unit fisik | Suffix "001" pada aset "CCTV-EXT" |
Terbentuk unit "CCTV-EXT-001" dengan status "tersedia", UnitLog "created" otomatis tercipta |
| TC-AST-04 | Sinkronisasi perubahan kode aset induk | Ubah kode aset "LAPTOP" jadi "NB" |
Seluruh unit turunan "LAPTOP-001" otomatis berubah menjadi "NB-001" via atomic transaction |
| TC-AST-05 | Resolusi benturan kode unit anak | Update kode induk yang unit tujuannya sudah ada | Penambahan counter otomatis 002, 003 tanpa duplicate key error |
3.3 Modul Distribusi Aset (Handover, Mutasi, Return)
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-DIST-01 | Serah terima unit tersedia | Unit status "tersedia", Karyawan A |
Unit status menjadi "digunakan", assigned_to = Karyawan A, AssetAssignment type "handover", UnitLog "assigned" terbuat |
| TC-DIST-02 | Mutasi aset antar karyawan | Unit dipegang Karyawan A, dimutasi ke Karyawan B | Unit assigned_to berganti ke Karyawan B, AssetAssignment type "mutation" (from A to B), 2 baris UnitLog terbuat (returned & assigned) |
| TC-DIST-03 | Pengembalian unit ke gudang | Unit dipegang Karyawan B dikembalikan | Unit status kembali "tersedia", assigned_to = None, AssetAssignment type "return", UnitLog "returned" terbuat |
| TC-DIST-04 | Atomic Rollback saat gagal distribusi | Error di tengah proses penyimpanan | State database tidak berubah (unit tidak menggantung pada status yang salah) |
3.4 Modul Karyawan & Integritas Relasi
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-EMP-01 | Hapus karyawan yang memegang aset | Karyawan dengan held_units.count() > 0 |
Ditolak, karyawan tidak boleh terhapus |
| TC-EMP-02 | Hapus karyawan bebas tanggungan | Karyawan tanpa unit yang dipegang | Karyawan terhapus, log riwayat masa lalunya diperbarui dengan prefix teks nama & NIK |
| TC-EMP-03 | Validasi keunikan NIK | Input karyawan baru dengan NIK sama | Ditolak dengan response error NIK sudah terdaftar |
3.5 Modul Laporan & File Upload
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-DOC-01 | Validasi format file BAST | Upload file .exe atau .sh |
Ditolak dengan pesan format tidak diizinkan |
| TC-DOC-02 | Validasi ukuran file BAST | Upload dokumen > 5MB | Ditolak dengan pesan ukuran maksimal 5MB |
| TC-REP-01 | Export PDF Aset | Request GET /aset/export/?tab=karyawan |
Response content_type='application/pdf', header attachment valid |
| TC-REP-02 | Export Excel Aset | Request GET /aset/export-excel/ |
Response content_type='application/vnd.openxmlformats...', struktur spreadsheet valid |
4. Rencana Implementasi Test Suite (Test Execution Plan)
Struktur Direktori Pengujian yang Disarankan:
assets/
└── tests/
├── __init__.py
├── factories.py # Factory boy definitions
├── test_auth.py # Login, logout, permission checks
├── test_models.py # Model constraints & save() methods
├── test_views_asset.py # CRUD Asset & AssetUnit
├── test_views_distribusi.py # Handover, mutation, return
├── test_views_employee.py # CRUD Employee & deletion guard
├── test_exports.py # PDF & Excel response headers
└── test_security.py # Vulnerability regression tests
5. Kriteria Penerimaan Pengujian (Acceptance Gate)
Sebelum kode hasil upgrade atau bug fixing di-deploy ke environment staging/production:
- Zero Failing Tests: 100% test case lulus (
pytestreturncode 0). - Security Regression Pass: Tidak ada view yang bisa diakses anonim tanpa dekorator resmi.
- Migration Check: Perintah
python manage.py makemigrations --check --dry-runmenyatakan tidak ada migrasi yang tertinggal. - Flake8 / Linter Clean: Kode baru mematuhi standar formatting tanpa unresolved lint errors.