REG_IBL/one-ui/agreement/one-md-packet-v8/README_TESTING.md

📚 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 - 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 - 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 - 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 - 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 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
2. Mulai dari Phase 1: Basic Functionality
3. Untuk detail setiap test case, lihat TESTING_GUIDE.md
4. Check off setiap test yang sudah dilakukan

Step 4: Report Issues

1. Gunakan bug template di 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
3. Cek 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 untuk understand business logic
2. Verify test scenarios di 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 - Section "Konsep Dasar"

"Melihat daftar semua test cases" → TEST_CASE_MATRIX.md - Section "Quick Reference"

"Detail step-by-step test case tertentu" → TESTING_GUIDE.md - Find by ID (e.g., C5)

"Cara menghitung pro-rata distribution" → PROFILE_VS_PANEL_GUIDE.md - Section "Key Formulas"

"Contoh lengkap test scenario" → TESTING_GUIDE.md - Section F (Integration Testing)

"Quick checklist untuk hari ini" → TEST_CASE_MATRIX.md - Mark checkboxes

"Report bug yang saya temukan" → TESTING_GUIDE.md - Section "Bug Reporting Template"

"Understand kenapa harga tidak update" → PROFILE_VS_PANEL_GUIDE.md - Section "Debugging Tips"

"Lihat UI screenshot/diagram" → 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 - "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 - "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 - "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 (15 min read)

Ready to Test?

Go To: TEST_CASE_MATRIX.md (Phase 1)

Need Details?

Reference: 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
• Test Case Matrix
• Profile vs Panel Guide

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