Files
REG_IBL/one-ui/agreement/one-md-packet-v8/README_TESTING.md
2026-05-25 20:01:37 +07:00

430 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 📚 ONE MD PACKET V8 - TESTING DOCUMENTATION
## 📖 Overview
Selamat datang di dokumentasi testing untuk modul **One MD Packet V8**. Modul ini adalah sistem manajemen paket pemeriksaan medis (Medical Check-up) yang terintegrasi dengan Agreement/MOU perusahaan.
---
## 📂 Struktur Dokumentasi
### 1. 📘 [TESTING_GUIDE.md](./TESTING_GUIDE.md) - **PANDUAN UTAMA**
**Untuk:** Tester, QA Engineer, Developer
**Ukuran:** ~5000 baris
**Waktu Baca:** 30-45 menit
**Isi:**
- ✅ Deskripsi lengkap modul
- ✅ Fitur-fitur utama
-**33 skenario testing** detail (A1-H2)
- ✅ Step-by-step instructions
- ✅ Expected results
- ✅ Test data examples
- ✅ Bug reporting template
- ✅ Tips & tricks
**Kapan Digunakan:**
- Saat mulai testing pertama kali
- Sebagai referensi lengkap untuk setiap test case
- Untuk memahami detail requirement
---
### 2. 📋 [TEST_CASE_MATRIX.md](./TEST_CASE_MATRIX.md) - **QUICK REFERENCE**
**Untuk:** Tester, Test Lead
**Ukuran:** ~500 baris
**Waktu Baca:** 10-15 menit
**Isi:**
- ✅ Checklist 33 test cases
- ✅ Priority levels (P0-P3)
- ✅ Test phases (1-3)
- ✅ Calculation verification tests
- ✅ Testing log template
- ✅ Quick start guide
**Kapan Digunakan:**
- Daily testing activities
- Tracking test progress
- Quick lookup saat lupa test case
- Reporting test summary
---
### 3. 🎯 [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - **KONSEP KUNCI**
**Untuk:** Semua (Tester, Developer, BA)
**Ukuran:** ~1000 baris
**Waktu Baca:** 15-20 menit
**Isi:**
- ✅ Perbedaan Profile vs Panel
- ✅ State diagrams & flows
- ✅ UI/UX differences
- ✅ Calculation formulas
- ✅ Debugging tips
- ✅ Decision tree
**Kapan Digunakan:**
- Saat bingung perbedaan Profile dan Panel
- Untuk memahami business logic
- Debugging issues terkait price calculation
- Training new team members
---
### 4. 📄 [README_TESTING.md](./README_TESTING.md) - **FILE INI**
**Untuk:** Overview & Navigation
**Ukuran:** Short
**Waktu Baca:** 5 menit
**Isi:**
- ✅ Overview dokumentasi
- ✅ Navigation guide
- ✅ Quick links
- ✅ Getting started
---
## 🚀 GETTING STARTED
### Untuk Tester Baru
**Step 1: Baca Konsep Dasar (15 menit)**
1. Baca [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) bagian "Konsep Dasar"
2. Pahami perbedaan Profile dan Panel
3. Lihat contoh-contoh yang diberikan
**Step 2: Setup Testing Environment (15 menit)**
1. Login ke aplikasi
2. Pastikan ada data test:
- Minimal 2 perusahaan
- Minimal 2 MOU (1 active, 1 released)
- Data test/pemeriksaan tersedia
3. Buka Browser Console (F12)
**Step 3: Mulai Testing (Follow Phase 1)**
1. Buka [TEST_CASE_MATRIX.md](./TEST_CASE_MATRIX.md)
2. Mulai dari Phase 1: Basic Functionality
3. Untuk detail setiap test case, lihat [TESTING_GUIDE.md](./TESTING_GUIDE.md)
4. Check off setiap test yang sudah dilakukan
**Step 4: Report Issues**
1. Gunakan bug template di [TESTING_GUIDE.md](./TESTING_GUIDE.md) section "Bug Reporting"
2. Include screenshot/video
3. Attach console error logs
**Total Time:**
- Persiapan: 30 menit
- Phase 1 Testing: 2-3 jam
- Phase 2 Testing: 2-3 jam
- Phase 3 Testing: 2-3 jam
- **Total: 7-9 jam (1-2 hari kerja)**
---
### Untuk Developer
**Untuk Fix Bug:**
1. Baca bug report dari tester
2. Lihat test case detail di [TESTING_GUIDE.md](./TESTING_GUIDE.md)
3. Cek [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) untuk business logic
4. Use debugging tips di PROFILE_VS_PANEL_GUIDE.md
5. Fix dan test locally
6. Return to tester untuk retest
**Untuk Add Feature:**
1. Understand current behavior via testing guides
2. Write test cases untuk feature baru
3. Update testing documentation
4. Implement feature
5. Self-test dengan test cases
6. Hand over to QA
---
### Untuk Product Owner / BA
**Review Requirements:**
1. Baca [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) untuk understand business logic
2. Verify test scenarios di [TESTING_GUIDE.md](./TESTING_GUIDE.md) sesuai requirement
3. Confirm calculation formulas benar
4. Review test data examples
---
## 🗺️ NAVIGATION MAP
### Saya ingin...
**"Memahami apa itu Profile dan Panel"**
→ [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - Section "Konsep Dasar"
**"Melihat daftar semua test cases"**
→ [TEST_CASE_MATRIX.md](./TEST_CASE_MATRIX.md) - Section "Quick Reference"
**"Detail step-by-step test case tertentu"**
→ [TESTING_GUIDE.md](./TESTING_GUIDE.md) - Find by ID (e.g., C5)
**"Cara menghitung pro-rata distribution"**
→ [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - Section "Key Formulas"
**"Contoh lengkap test scenario"**
→ [TESTING_GUIDE.md](./TESTING_GUIDE.md) - Section F (Integration Testing)
**"Quick checklist untuk hari ini"**
→ [TEST_CASE_MATRIX.md](./TEST_CASE_MATRIX.md) - Mark checkboxes
**"Report bug yang saya temukan"**
→ [TESTING_GUIDE.md](./TESTING_GUIDE.md) - Section "Bug Reporting Template"
**"Understand kenapa harga tidak update"**
→ [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - Section "Debugging Tips"
**"Lihat UI screenshot/diagram"**
→ [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - Section "UI/UX Differences"
---
## 📊 TEST COVERAGE
### Functional Areas
| Area | Test Cases | Priority | Estimated Time |
|------|-----------|----------|----------------|
| Search & Filter | A1-A3 | P1 | 30 min |
| CRUD Packet | B1-B5 | P0 | 1 hour |
| Packet Details | C1-C11 | P0 | 3 hours |
| Import/Copy | D1-D2 | P2 | 30 min |
| Edge Cases | E1-E5 | P1-P2 | 1 hour |
| Workflows | F1-F3 | P0 | 2 hours |
| Compatibility | G1-G2 | P1-P2 | 1 hour |
| Performance | H1-H2 | P2 | 30 min |
| **TOTAL** | **33 cases** | | **~9 hours** |
---
## 🎯 KEY CONCEPTS
### Packet Types
- **Profile (PR):** Harga = Sum of items (read-only)
- **Panel (PN):** Harga = Customizable (with lock mechanism)
### Panel States
- **Unlocked:** Harga auto-updates on add/remove items
- **Locked:** Harga fixed (doesn't change)
### Key Workflows
1. Create → Add Items → Save
2. Edit → Modify Items → Save
3. Edit → Custom Price → Lock → Save
### Critical Logic
- Pro-rata distribution when editing packet price
- Discount calculation: `Price = Bruto - (Bruto × Disc%) - DiscRp`
- Lock mechanism after save to database
---
## 📝 QUICK CHECKLIST
### Before Starting Testing
- [ ] Documentation dibaca (minimal overview)
- [ ] Environment ready (login, data test)
- [ ] Browser console open (F12)
- [ ] Understanding Profile vs Panel
### During Testing
- [ ] Follow test cases systematically
- [ ] Mark checkboxes in TEST_CASE_MATRIX.md
- [ ] Take screenshots for issues
- [ ] Note console errors
- [ ] Test on multiple browsers (if applicable)
### After Testing
- [ ] All test cases checked
- [ ] Bugs reported with template
- [ ] Test summary filled
- [ ] Pass rate calculated
- [ ] Sign-off completed
---
## 🐛 COMMON ISSUES & SOLUTIONS
### Issue 1: "Harga Paket tidak update setelah add item"
**Possible Causes:**
- Panel type dalam mode LOCKED
- Check chip "Dikunci" visible?
- Check console log: "Panel LOCKED - NOT updating"
**Solution:**
- Ini expected behavior untuk locked panel
- Untuk unlock: klik Edit Harga → ubah → Save
**Reference:** [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - "Panel Locked Flow"
---
### Issue 2: "Pro-rata distribution tidak sesuai"
**Check:**
- Apakah sum of item prices = packet price?
- Apakah semua Disc % = 0?
- Apakah last item dapat rounding difference?
**Reference:** [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - "Key Formulas" #2
---
### Issue 3: "Tidak bisa edit Harga Paket"
**Possible Causes:**
1. Packet type = Profile (cannot edit)
2. Panel not in edit mode
3. Field tidak dalam edit state (perlu klik icon Edit dulu)
**Reference:** [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) - "Comparison Table"
---
## 📞 SUPPORT & CONTACT
### Questions About Testing?
- Check documentation first (most answers are here)
- Still stuck? Contact QA Lead
- Bug found? Use bug template
### Documentation Issues?
- Typo or unclear instruction?
- Missing information?
- Outdated content?
→ Report to documentation maintainer
---
## 🔄 VERSION HISTORY
| Version | Date | Changes | Author |
|---------|------|---------|--------|
| 1.0 | 2026-01-22 | Initial documentation created | AI Assistant |
| | | - TESTING_GUIDE.md | |
| | | - TEST_CASE_MATRIX.md | |
| | | - PROFILE_VS_PANEL_GUIDE.md | |
| | | - README_TESTING.md | |
---
## 📚 DOCUMENT STRUCTURE
```
one-md-packet-v8/
├── README_TESTING.md (THIS FILE)
│ └── Overview & Navigation
├── TESTING_GUIDE.md (MAIN GUIDE)
│ ├── Description
│ ├── Features
│ ├── 33 Test Scenarios (A1-H2)
│ ├── Bug Template
│ └── Tips & Test Data
├── TEST_CASE_MATRIX.md (CHECKLIST)
│ ├── Test Case Table
│ ├── Test Phases
│ ├── Calculation Tests
│ └── Testing Log
└── PROFILE_VS_PANEL_GUIDE.md (CONCEPT)
├── Concept Explanation
├── Comparison Table
├── State Diagrams
├── Examples
├── Formulas
└── Debugging Tips
```
---
## 🎓 RECOMMENDED READING ORDER
### First Time Testing
1. **Start:** README_TESTING.md (this file) - 5 min
2. **Concept:** PROFILE_VS_PANEL_GUIDE.md sections "Konsep Dasar" & "Comparison Table" - 10 min
3. **Practice:** TEST_CASE_MATRIX.md section "Quick Start Guide" - 5 min
4. **Detail:** TESTING_GUIDE.md sections A, B, C for detailed steps - 30 min
5. **Do:** Start testing with TEST_CASE_MATRIX.md checklist - 2-3 hours
### Quick Reference (Daily Use)
1. Open TEST_CASE_MATRIX.md for today's checklist
2. Use TESTING_GUIDE.md as detailed reference
3. Use PROFILE_VS_PANEL_GUIDE.md when confused about behavior
### Debugging Issues
1. PROFILE_VS_PANEL_GUIDE.md - "Debugging Tips"
2. TESTING_GUIDE.md - Find related test case
3. Console logs - Compare with expected logs
4. Formulas - Verify calculations
---
## ✅ SUCCESS CRITERIA
Testing dianggap **COMPLETE** jika:
- ✅ All P0 test cases: **100% pass**
- ✅ All P1 test cases: **≥ 95% pass**
- ✅ All P2 test cases: **≥ 90% pass**
- ✅ No critical/high bugs open
- ✅ All workflows tested end-to-end
- ✅ Cross-browser compatibility verified
- ✅ Test summary documented
- ✅ Sign-off obtained
---
## 🚀 LET'S START!
### New Tester?
**Start Here:** [PROFILE_VS_PANEL_GUIDE.md](./PROFILE_VS_PANEL_GUIDE.md) (15 min read)
### Ready to Test?
**Go To:** [TEST_CASE_MATRIX.md](./TEST_CASE_MATRIX.md) (Phase 1)
### Need Details?
**Reference:** [TESTING_GUIDE.md](./TESTING_GUIDE.md) (Full guide)
---
**Happy Testing! 🎉**
---
**Module:** One MD Packet V8
**Documentation Version:** 1.0
**Last Updated:** 2026-01-22
**Maintained By:** Development Team
**Status:** ✅ Ready for Use
---
## 📖 APPENDIX: QUICK LINKS
### Internal Documentation
- [Main Testing Guide](./TESTING_GUIDE.md)
- [Test Case Matrix](./TEST_CASE_MATRIX.md)
- [Profile vs Panel Guide](./PROFILE_VS_PANEL_GUIDE.md)
### Code Files
- `components/oneMdPacketList.vue` - Packet list
- `components/oneMdPacketPxList.vue` - Packet details
- `components/oneMdPacketTestList.vue` - Test selection
- `components/oneMdPacketNew.vue` - Create/edit dialog
- `modules/packet.js` - Packet state management
- `modules/px.js` - Detail state management
- `store.js` - Main store
### Related Modules
- `one-api/application/controllers/v1/masterdata/Packet_v8.php` - Backend API
---
**END OF README**