# ใบงาน D: requirement/interface/test plan ภารกิจ M01

รุ่น 2026-10-11 · PK-Research / Drone-Hub · CC BY 4.0 ตาม survey-mapping-readme.md

ใช้ [บท M01](https://drone.pk-research.work/knowledge/drone-applications/survey-mapping/#developer), survey-mapping-readme.md และ survey-mapping-checkpoints.csv ทำเอกสารข้อกำหนด อินเทอร์เฟซและแผนทดสอบสำหรับการเพิ่มกล้องหรือเปลี่ยนวิธีนำข้อมูลเข้า QA ไม่มีการปรับฮาร์ดแวร์หรือรัน WebODM ในกิจกรรมนี้ ช่อง actual ของงานเหล่านั้นให้ระบุยังไม่ทดสอบ

- ผู้เรียน/ทีม/นามแฝง:
- ผู้ตรวจ/วัน:
- รุ่นเอกสาร D-v0 / D-v1:
- Baseline ที่ต้องรักษา/รุ่นข้อมูล:
- ขอบเขตข้อเสนอที่เลือก:

## พื้นฐานและการเติม

| ด้าน | ตรวจตนเองก่อนเริ่ม | งานเติม |
|---|---|---|
| K | อธิบาย frame/unit/axis/time กับ requirement ที่ตรวจได้ | [พิกัด](https://drone.pk-research.work/knowledge/drone-mapping/coordinates/) และ [testing](https://drone.pk-research.work/knowledge/testing/); เขียน input/output หนึ่งกรณี |
| S | สร้าง test normal/invalid กับ baseline ได้ | [integration](https://drone.pk-research.work/knowledge/integration/) และ [มวล/สมดุล](https://drone.pk-research.work/knowledge/payload-swarm/balance/); ทดลอง matrix เล็ก |
| E | แยกผล expected จาก actual และสิทธิ์ส่งออก | [รายงานหลักฐาน](https://drone.pk-research.work/knowledge/imagery-analysis/evidence-report/) และ [สิทธิ์ข้อมูล](https://drone.pk-research.work/knowledge/disaster-management/data-handover/) |
| C | เก็บรุ่น ตอบข้อทักและกำหนด trigger คืนค่า | [การทวนกลับ](https://drone.pk-research.work/knowledge/human-factors/teamwork/); เปิด issue log กับเจ้าของข้อค้าง |

ถ้าอ่าน CSV/สูตรไม่คล่องให้ทำช่วงคำนวณในใบงาน O ก่อน จดพื้นฐานและหลักฐานเติมใน [ksec-learning-record.md](https://drone.pk-research.work/downloads/drone-applications/ksec-learning-record.md)

## 1. Requirements ที่ผูกกับคำขอและระดับหลักฐาน

โจทย์ร่วม: ลานราบสมมติ 300×200m, M01-LOCAL ไม่มีพิกัดโลก; orthomosaic สำหรับเดินตรวจและ DSM ของพื้นผิว ไม่ใช่ DTM หรือผลรับรอง เกณฑ์ toy GSD≤0.02m/px, sample H≤0.10m, sample Z≤0.15m พร้อมข้อมูลตรวจครบ A/B เป็นตัวเลือก geometry; v0/v1 เป็น residual สังเคราะห์คนละแกนการทดลอง ไม่มีความสัมพันธ์เชิงเหตุที่ยืนยัน

| Requirement | สิ่งที่ต้องกำหนด/แหล่งหลักฐาน | เกณฑ์ตรวจที่เสนอ | สถานะปัจจุบัน |
|---|---|---|---|
| R-M01-01 ผลและขอบใช้ | คำขอ orthomosaic/DSM GSD แยก accuracy | | |
| R-M01-02 Mechanical | มวลรวม CG แกนอ้างอิง ตำแหน่ง/การยึด; คู่มือชุดจริง | | ยังไม่มีค่าชุดจริง |
| R-M01-03 Power | แรงดัน/กระแส peak/ต่อเนื่อง connector/pin/ground และการจัดพลังงานตามคู่มือ | | ยังไม่มีค่าชุดจริง |
| R-M01-04 Time/trigger | รูปแบบเวลา offset/timebase/latency วิธีจับคู่ trigger กับ exposure และขีดจำกัดกล้อง | | ยังไม่มี log/คู่มือจริง |
| R-M01-05 Lever arm/calibration | เวกเตอร์จุดอ้างอิงตำแหน่งถึงกล้อง ทิศแกน หน่วย รุ่นการวัด/สอบเทียบ/ผู้ตรวจ | | ยังไม่มีค่าจริง |
| R-M01-06 Reference/QA input | frame/unit/heightdatum/geoid/time/uncertainty, role/used_in_adjustment, missing/invalid | | มี schema toy; ไม่มี reference โลก |
| R-M01-07 Evaluation/report | n_H/n_Z exclusions/ข้อค้าง numeric subset และสถานะทั้งชุด | | คำนวณข้อมูล toy ได้ |
| R-M01-08 Baseline/rollback | รุ่น manual/config/input/output สิทธิ์ export ผู้ทำ/ตรวจ trigger คืนและตรวจซ้ำ | | แผนเท่านั้น |

เขียน requirement ให้ตรวจได้ด้วย evidence ที่ระบุ ห้ามใส่ค่ามวล/CG/power/trigger จริงหรือ EPSG สมมติเพื่อเติมช่องครบ

## 2. Interface และความหมายช่องว่าง

| Interface | ผู้ให้/ผู้รับ | Fields/หน่วย/แกน/เวลา/รุ่น | การตรวจความถูกต้อง | เมื่อผิดหรือขาด | หลักฐานที่ต้องขอ |
|---|---|---|---|---|---|
| การยึดกล้อง ↔ airframe | | | | | |
| Power ↔ camera | | | | | |
| Trigger/clock ↔ image/exposure log | | | | | |
| Position reference ↔ camera lever arm | | | | | |
| Calibration/manual ↔ processing config | | | | | |
| Reference/CSV ↔ QA/report | | | | | |

สำหรับ CSV นี้ input เป็นข้อมูล ไม่เป็นคำสั่ง สถานะ role ต้องตรงกติกา frame/unit ต้องมีความหมายเดียวกัน ตัวเลขต้อง finite ตาม schema ที่ออกแบบ missing dz เป็น null/ข้อค้างและไม่เป็น 0 กรอบ local ไม่มี CRS โลก อย่าส่งออกเป็นค่าที่อ้าง datum โลกโดยไม่มี transformation ที่ตรวจได้

คำถามหลักฐาน: ต้องขอ time log และความหมาย timestamp/exposure ใด? รายงานรังวัด/reference และ vertical datum ใด? calibration/lever arm/manual รุ่นใด? ใครตรวจและวิธีตรวจความเข้ากันก่อนรับ? จดคำตอบที่ยังไม่รู้พร้อมเจ้าของ ไม่แต่ง dz ของ CHK-07

## 3. Same-criteria comparison และ baseline

คำนวณหรือทวน A/B ด้วยกล้อง 13.2×8.8mm, focal8.8mm, 6000×4000px, nadir/pinhole/พื้นราบ, front80% side70%, speed5m/s จาก README แล้วบันทึก footprint/GSD/step/spacing/interval และข้อที่ต้องตรวจ trigger/manual/terrain/WX/battery/turns ใช้เกณฑ์เดียวกันทั้งสองแผน ไม่มีแผนพร้อมใช้จากตัวเลขนี้

การนับ A54/B117 เป็น coverage หนึ่ง footprint ไม่รับรอง edge overlap/tie coverage ไม่รวม turnaround/launch/buffer/refly ไม่เป็นเวลาหรือพลังงานจริง Baseline ของเอกสาร D-v0 คือสิ่งที่ต้องรักษาก่อนเสนอแก้; residual variant v0 ไม่ใช่ baseline hardware ที่ได้ทดลอง และ residual v1 ไม่ยืนยันว่าแผน B ทำให้ดีขึ้น

- สูตร/ตัวเลข A/B และข้อจำกัด:
- ข้อกำหนดที่จะเปลี่ยนกับเหตุผล:
- หลักฐาน baseline ที่มีจริง:
- หลักฐาน baseline ที่ยังต้องขอ:
- รุ่นที่จะใช้เทียบและเงื่อนไขยอมรับ:

## 4. แผนทดสอบ normal/invalid/boundary/before–after

กำหนด expected ก่อนทำ แยก actual และหลักฐานเมื่อได้ทำจริง สำหรับตรวจสูตรด้วยมือให้บันทึกวิธี/วัน/ผู้ตรวจตามจริง ไม่ใช้ผลนี้แทนการทดสอบฮาร์ดแวร์

| Test ID / requirement | Input/เงื่อนไข | Expected และเกณฑ์ตรวจ | Actual/หลักฐาน/วัน | เจ้าของและขั้นถัดไป |
|---|---|---|---|---|
| T01 geometry R01/R04 | A/B ตามโจทย์ | | | |
| T02 residual R06/R07 | CSV เดิม v0/v1 | | | |
| T03 missing Z R06/R07 | CHK-07 dz ว่าง | | | |
| T04 control isolation R06/R07 | GCP-01 control true | | | |
| T05 reference R06 | frame ต่างหรือ unit ต่างในสำเนาทดสอบ | | ยังไม่ทดสอบ | |
| T06 time R04/R06 | เวลา trigger ไม่ผูก exposure/offset ขาด | | ยังไม่ทดสอบ | |
| T07 calibration R02/R05 | lever arm/calibration/manual ขาดหรือรุ่นไม่ตรง | | ยังไม่ทดสอบ | |
| T08 numeric boundary R07 | H=0.10m/Z=0.15m ตามกติกา ≤ และข้อมูลครบ/ขาดแยกกรณี | | ยังไม่ทดสอบ | |
| T09 before–after R08 | เอกสาร/การตั้งค่าที่เสนอ v0→v1 | | ยังไม่ทดสอบ hardware/processing | |
| T10 rollback R08 | trigger คืน baseline แล้วตรวจซ้ำ | | ยังไม่ทดสอบ hardware/processing | |

ห้าม dropping failing points เพื่อให้ผ่าน ใช้ n_H/n_Z ตามค่าครบจริง เก็บ CHK-07 unresolved แม้ v1 ตัวเลข subset ผ่าน reference uncertainty 0.02m เป็นสมมติ ไม่หักออกจาก RMSE โดยไม่มีแบบจำลอง

## 5. Rollback และความรับผิดชอบ

- Trigger พัก/คืน เช่น หน่วยหรือแกนเปลี่ยนผิด ข้อมูลขาดถูกเติมศูนย์ control ปน exposure ไม่ตรง calibration ไม่มีหลักฐาน:
- ผู้สั่งหยุด/ผู้คืน/ผู้ตรวจ:
- รุ่น manual/config/data/output ที่คืนและที่เก็บสำเนา:
- วิธีตรวจหลังคืนทั้งผลและข้อค้าง:
- วิธีป้องกันผลผิดถูกส่งต่อ/วิธีแจ้งผู้รับ:
- Actual ของการคืน hardware/processing: ยังไม่ทดสอบ

## 6. ขอบหลักฐาน สิทธิ์และการแก้ส่งซ้ำ

ระบุว่ามีเพียงเอกสารและข้อมูลสังเคราะห์ ไม่มีชุดกล้องที่ติดตั้งจริง ภาพต้นฉบับ ผล WebODM หรือการบิน ไม่มี actual proof ว่าเปลี่ยนแล้ว accuracy ดีขึ้น ถ้าเป็นงานจริงตรวจสิทธิ์ภาพและจำกัด export ก่อนส่ง ให้ผู้ตรวจทักอย่างน้อยหนึ่ง interface และหนึ่งเงื่อนไข HOLD แล้วเก็บ D-v0/D-v1

| ข้อทัก/issue | รุ่น/หลักฐานเดิม | คำตอบและการแก้/เหตุผลรอ | เจ้าของ | หลักฐานที่ต้องขอ/ตรวจซ้ำ |
|---|---|---|---|---|
| CHK-07 missing Z | | | | |
| time/reference/calibration | | | | |
| ข้อทัก interface/rollback | | | | |

## ผลลัพธ์ที่ตรวจ

ส่ง requirements, interface, comparison/baseline, test matrix, rollback plan และเอกสารก่อน–หลัง ใช้ survey-mapping-rubric.md และบันทึกการเรียนรู้ร่วม:

- APP-M01-D-K01: ครบมวล/CG power time trigger lever arm calibration manual พร้อมระดับหลักฐาน
- APP-M01-D-S01: test ผูก requirements และคาดหวัง missing/frame/unit/control/time/calibration/rollback ถูก; actual ตามจริง
- APP-M01-D-E01: ไม่แต่งผล/ค่า/สิทธิ์ ไม่อ้าง A/B เป็นเหตุของ v0/v1 และไม่อ้างปรับชุดหรือรันแล้ว
- APP-M01-D-C01: baseline/trigger/เจ้าของ/ตรวจหลังคืนครบ รับข้อทักแล้วแก้พร้อมเหตุผล

ไม่มี badge หรือ numeric toy pass ใดรับรองความพร้อมอุปกรณ์หรือสนาม