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