Files
2026-11-16 01:39:59 +07:00

370 lines
29 KiB
Markdown

# SYSTEM DESIGN — hydraucal / sprinkler-calculation
> เวอร์ชัน 0.1 (16 พ.ย. 2026) · สถานะ: ออกแบบหลังสำรวจ repo จริง · เอกสารนี้เป็น "แบบก่อสร้าง" ไม่ใช่รายงานสถานะ
---
## 1. บริบทและเป้าหมาย
เว็บ `farm-planning` เป็นเครื่องมือช่วยตัดสินใจเรื่องน้ำในแปลงเกษตร (คำนวณขนาดสระ, ปริมาณน้ำของพืช, ระบบน้ำหยด/สปริงเกลอร์, คูส่ง-คูระบาย, บ่อหน่วงน้ำ) ปัจจุบันเป็น static site ยุค 2019 ที่พึ่ง Start Bootstrap "Creative" + Bootstrap 4 และตัวคำนวณยังเป็นไฟล์ JS ที่ไม่ทำงาน
เป้าหมายของ repo `hydraucal`:
| เป้าหมาย | คำอธิบาย |
|---|---|
| G1 ใช้งานได้จริง | หน้าเว็บทุกหน้าต้องเปิดได้ ไม่มี asset 404 ไม่มี JS error |
| G2 คำนวณถูกและตรวจสอบได้ | สูตรแยกเป็นโมดูลบริสุทธิ์ (pure) มี unit test เทียบค่าอ้างอิง |
| G3 ข้อมูลอ่านได้โดยมนุษย์ | JSON คีย์เต็มคำ ไม่มี `field2`/`field3` แบบ export จาก Excel |
| G4 ต่อยอดเป็น PWA + API | ใช้ offline ได้ และมี backend รับงานคำนวณหนัก/เก็บโปรเจกต์ |
---
## 2. สถานะปัจจุบัน (วัดจริงจาก repo)
| รายการ | ค่า |
|---|---|
| ไฟล์ทั้งหมด (ไม่รวม `.git`) | 2,560 ไฟล์ |
| ขนาด | 296 MB |
| commit | **0** (repo ว่างตอน clone, ไฟล์ถูกคัดลอกเข้ามาภายหลัง) |
| HTML ที่เป็นหน้าใช้งานจริง | 2 (`index.html` ราก, `coding/index.html` สำเนา) |
| CSS สำเร็จรูป | ไม่มี `creative.min.css` ที่ `index.html` เรียก |
| ข้อมูล JSON | 11 ไฟล์ใน `open data/JSON/` (ETo 5 ไฟล์ใช้ได้ 138 แถว = 116 จังหวัดที่มีข้อมูล, Kc 3 ไฟล์เสีย) |
| โมดูลคำนวณ | 4 ไฟล์ stub (`water demand.js`, `ETo; Penman-Monteith.js`, `data collection.js`, `test.js`) |
| API ที่เคยออกแบบ | `coding/logic/farm-planning.postman_collection.json` — 16 endpoint |
| โครงสร้าง DB | `SQL/` ว่าง (มีแต่ `desktop.ini`) |
### โครงสร้างระดับบนสุดที่ปะปนกันอยู่
```
hydraucal/
├── index.html ← หน้าเว็บ (ซ่อมแล้วในงานนี้)
├── css/ ← creative.css (compile จาก coding/scss) + legacy.css [เพิ่มใหม่]
├── coding/ ← ซอร์สเดิม: html, css, js, scss, vendor, logic/
├── flat icon/ logo/ font/ image ประกอบ/ profile&backgroud/
├── Document/ ← เอกสารวิธีคำนวณ 16 หัวข้อ (docx/pdf/xlsx)
├── open data/ ← JSON + Spreadsheet (ETo, Kc)
├── PWA-fam-plans/ ← docker compose ทดลอง (joomla, postgres, nodejs, golang)
├── e-book/ แรงบันดาลใจ/ แนวทางการหาเงิน/ หลักฐาน*/ อื่นๆ/ ← ไฟล์ส่วนตัว/อ้างอิง ไม่ใช่ซอร์ส
├── startbootstrap-*/ ---/ ← template สำเนา 3 ชุด (ซ้ำ)
└── _readme.txt ← ⚠️ ไฟล์เรียกค่าไถ่ransomware (ดู §10 R1)
```
---
## 3. ปัญหาที่ต้องแก้ (เรียงตามผลกระทบ)
| # | ปัญหา | หลักฐาน | ผลกระทบ |
|---|---|---|---|
| P1 | path ของ asset พังทั้งหน้า | `../vendor/...`, `/flat_icon/...`, `..dist/clipboard.min.js` ไม่มีอยู่จริง | หน้าเว็บไม่มีสไตล์ ไม่มีไอคอน |
| P2 | ไฟล์ CSS หลักหาย | `creative.min.css` ไม่มีใน repo (เหลือแต่ `coding/scss/*.scss`) | hero/nav/การ์ดเสียรูปแบบ |
| P3 | markup ไม่ถูกต้อง | `<p>` ครอบ `<div>`, `<a>` ครอบ `<h3>`, `id` ซ้ำ 4 จุด, `</div>` เกิน 2 ตัว | เบราว์เซอร์จัด DOM เอง ผลลัพธ์ไม่แน่นอน |
| P4 | JS อ้าง element ที่ไม่มี | `custom.js` เรียก `#myBtn` ทุก scroll | `TypeError` ทุกครั้งที่เลื่อนหน้า |
| P5 | ข้อมูล Kc เสีย | 3 ไฟล์ Thai chars = 0, control escape 200+ | คำนวณปริมาณน้ำของพืชไม่ได้ |
| P6 | โฟลเดอร์/ไฟล์ชื่อไทย + เว้นวรรค | `logo ใหม่/`, `flat icon/retention pond.svg` | URL ต้อง encode, deploy บน server/Linux เสี่ยงพัง |
| P7 | ไม่มี git history | commit = 0 | ย้อนกลับไม่ได้ ตรวจ diff ไม่ได้ |
| P8 | ขยะปนซอร์ส | `~WRL0005.tmp` 356 KB, `.download` 155 ไฟล์, template ซ้ำ 3 ชุด, `desktop.ini` 71 ไฟล์ | repo หนัก, หาไฟล์จริงยาก |
---
## 4. หลักการออกแบบ
1. **แยกชั้นชัด**: เนื้อหา (HTML) / รูปแบบ (CSS) / ตรรกะคำนวณ (JS module) / ข้อมูล (JSON) / บริการ (API) — ห้ามให้สูตรคณิตศาสตร์อยู่ใน HTML หรือ inline script
2. **สูตรต้องทดสอบได้**: ฟังก์ชัน pure รับ input object คืน `{ value, unit, steps, warnings }` — `steps` ไว้แสดงที่มาของผลลัพธ์ให้เกษตรกรเห็น (ตรวจสอบย้อนกลับได้)
3. **ไม่พึ่ง CDN ในส่วนวิกฤต**: ฟอนต์/ตัวนับผู้ชมอยู่นอก repo ได้ แต่ CSS/JS ที่ทำให้หน้าทำงานต้องอยู่ใน repo
4. **ข้อมูลเป็น JSON คีย์เต็มคำ** กลุ่ม → ชนิด → รายการ (แบบเดียวกับที่ใช้ในโปรเจกต์ transit)
5. **ชื่อไฟล์/โฟลเดอร์ ASCII** ทั้งหมด (ไฟล์ไทยเดิมเก็บใน `archive/`)
---
## 5. สถาปัตยกรรมเป้าหมาย
```
┌──────────────────────────────────────────────────────────────┐
│ ชั้นนำเสนอ web/ (static, ไม่มี build) │
│ index.html · pages/*.html · assets/{css,js,img} │
│ PWA: manifest.webmanifest + sw.js (precache เฉพาะที่ใช้) │
└───────────────┬──────────────────────────────────────────────┘
│ import (ES module, relative path)
┌───────────────▼──────────────────────────────────────────────┐
│ ชั้นตรรกะ core/ (pure JS, ไม่แตะ DOM) │
│ units · evapotranspiration · water_balance · reservoir │
│ irrigation_drip · irrigation_sprinkler · channel · basin │
│ water_value · scheduling │
│ ทุกโมดูล: (input) → { value, unit, steps[], warnings[] } │
└───────────────┬──────────────────────────────────────────────┘
│ fetch (JSON, read-only)
┌───────────────▼──────────────────────────────────────────────┐
│ ชั้นข้อมูล data/ (JSON มนุษย์อ่านได้ + JSON Schema) │
│ crops/crop_coefficient.json · climate/eto_by_region.json │
│ hydrology/province_runoff.json · prices/crop_price.json │
└───────────────┬──────────────────────────────────────────────┘
│ (เฟส 3, ถ้าต้องการเก็บโปรเจกต์/คำนวณหนัก)
┌───────────────▼──────────────────────────────────────────────┐
│ ชั้นบริการ service/ (HTTP API) │
│ POST /api/v1/waters/calculate/* · POST /api/v1/capacities │
│ GET /api/v1/provinces · /api/v1/crops │
│ เก็บผลคำนวณ + export PDF (แทน postman collection เดิม) │
└──────────────────────────────────────────────────────────────┘
```
เหตุผลที่ยัง **ไม่ต้องมี build step**: หน้าเว็บมี 10-13 หน้า, JS รวมไม่ถึง 100 KB — ใช้ ES module ตรง ๆ ได้ ลดความซับซ้อนของ toolchain (ถ้าภายหลังต้องการ bundle ค่อยเพิ่ม Vite โดยไม่ต้องรื้อโครง)
---
## 6. โครงสร้างโฟลเดอร์เป้าหมาย + mapping
```
hydraucal/
├── web/
│ ├── index.html ← จาก index.html (ซ่อมแล้ว)
│ ├── pages/
│ │ ├── pond_calculation.html ← ยังไม่มี (poolcal.html เดิมหาย)
│ │ ├── water_value.html
│ │ ├── crop_water.html
│ │ ├── irrigation_pressure.html
│ │ ├── glossary.html
│ │ └── ...
│ ├── assets/css/{creative.css,legacy.css,custom.css}
│ ├── assets/js/{app.js, pages/*.js}
│ ├── assets/img/{icons,logos,photos}
│ ├── manifest.webmanifest
│ └── sw.js
├── core/ ← ใหม่ทั้งหมด
│ ├── units.js
│ ├── evapotranspiration.js
│ ├── water_balance.js
│ ├── reservoir.js
│ ├── irrigation_drip.js
│ ├── irrigation_sprinkler.js
│ ├── channel.js
│ ├── basin.js
│ ├── water_value.js
│ └── scheduling.js
├── data/
│ ├── schema/*.schema.json
│ ├── crops/{crop_coefficient.json,crop_list.json}
│ ├── climate/eto_by_region.json
│ ├── hydrology/province_runoff.json
│ └── prices/crop_price.json
├── service/ ← เฟส 3
│ ├── openapi.yaml
│ └── src/...
├── tests/ ← node --test
│ ├── core/*.test.js
│ └── web/assets.test.js ← ตรวจว่า asset ทุกไฟล์มีจริง
├── docs/{SYSTEM-DESIGN.md,DATA-CONTRACT.md,DESIGN.md,AGENTS.md}
├── archive/ ← ของเดิมที่ไม่ได้ใช้ (template ซ้ำ, .download, tmp)
└── README.md
```
### Mapping ของเดิม → ที่ใหม่
| ของเดิม | ที่ใหม่ | หมายเหตุ |
|---|---|---|
| `index.html` | `web/index.html` | ซ่อมแล้ว (path, markup, `#myBtn`) |
| `coding/scss/*.scss` | build → `web/assets/css/creative.css` | เก็บ scss ไว้เป็น source |
| `coding/css/custom.css` | `web/assets/css/custom.css` | ใช้ `size_card_2` อยู่ |
| `coding/vendor/*` | คงไว้ หรือย้าย `web/assets/vendor/` | ต้องอัปเกรด Bootstrap 4.2.1 → 5.3 ทีหลัง (ต้องแก้ `data-*` → `data-bs-*`) |
| `flat icon/*.svg` | `web/assets/img/icons/` | เปลี่ยนชื่อเป็น ASCII (`retention pond.svg` → `retention_pond.svg`) |
| `logo/**` | `web/assets/img/logos/` | `logo ใหม่/2566-09-08 11-51-40.png` → `logo_mark_2566.png` |
| `coding/js/water demand.js` ฯลฯ | `core/*.js` | เขียนใหม่ (ของเดิมเป็น stub ที่รันไม่ได้) |
| `open data/JSON/ปริมาณ…ภาค*.json` | `data/climate/eto_by_region.json` | รวม 5 ไฟล์เป็นชุดเดียว + เปลี่ยนคีย์ |
| `open data/JSON/Kc*.json` | `data/crops/crop_coefficient.json` | **ต้องสร้างใหม่** (ข้อมูลเสีย) |
| `coding/logic/farm-planning.postman_collection.json` | `service/openapi.yaml` | แปลง 16 endpoint เป็นสเปก |
| `PWA-fam-plans/` | `archive/` | เป็น docker ทดลอง ไม่ผูกกับโปรเจกต์ |
| `_readme.txt` | **ลบทิ้ง** | ⚠️ ไฟล์เรียกค่าไถ่ (ransomware) ไม่ใช่เอกสารโปรเจกต์ |
---
## 7. โมดูลคำนวณ
หน้าตาข้อมูลเข้า-ออกมาตรฐาน (ทุกโมดูลเหมือนกัน เพื่อให้ UI สร้างฟอร์มและแสดงผลแบบเดียวกันได้):
```js
// core/reservoir.js
export function calculateReservoirVolume(input) {
// input: ReservoirInput (ดู DATA-CONTRACT.md)
return {
value: 4800, // ปริมาตรสุทธิ
unit: 'm3',
steps: [
{ label: 'พื้นที่ผิวน้ำ', value: 1200, unit: 'm2' },
{ label: 'ความลึกใช้การ', value: 4, unit: 'm' },
{ label: 'หักน้ำระเหย+รั่วซึม 30 วัน', value: 60, unit: 'm3' }
],
warnings: ['ความลึกใช้การน้อยกว่า 2 ม. — ระบบจะแห้งเร็วในหน้าแล้ง']
};
}
```
| โมดูล | หน้าที่ | แหล่งสูตร |
|---|---|---|
| `evapotranspiration.js` | ETo (Penman-Monteith) จากอุณหภูมิ/ความชื้น/ลม/รังสี | ข้อมูล ETo รายจังหวัดใน repo + FAO-56 |
| `water_balance.js` | ETc = Kc × ETo, ปริมาณน้ำรายวัน/รายสัปดาห์ | ตาราง Kc (ต้องสร้างใหม่) |
| `reservoir.js` | สระน้ำท่า / นอง / ฝน / ใต้ดิน | `Document/คำนวณขนาดสระน้ำ/` |
| `irrigation_drip.js` | เทปน้ำหยด / หัวน้ำหยด | `Document/การให้น้ำภายใต้แรงดัน/` |
| `irrigation_sprinkler.js` | มินิสปริงเกลอร์แรงดันต่ำ / สปริงเกลอร์แรงดันสูง (hydraulics: อัตราการไหล, head loss, จำนวนหัวต่อโซน) | `Document/การให้น้ำภายใต้แรงดัน/` |
| `channel.js` | คูส่งน้ำ / คูระบายน้ำ (Manning) | `Document/คูน้ำ`, `Document/คูระบายน้ำ` |
| `basin.js` | บ่อหน่วงน้ำ | `Document/บ่อหน่วงน้ำ` |
| `water_value.js` | มูลค่าน้ำ (บาท/ลบ.ม.) | `Document/มูลค่าน้ำ` |
| `scheduling.js` | จัดรอบเวรใช้น้ำในคูส่งน้ำ | งานใหม่ ( homepage การ์ดที่ 9 ) |
| `units.js` | แปลง ไร่/ตร.ม./ลิตร/บาร์ ฯลฯ | — |
> **กติกาการเขียนสูตร**: ห้ามใช้ magic number ในฟังก์ชัน — ค่าคงที่ (ความหนาแน่นน้ำ, ค่า g, สัมประสิทธิ์การระเหยของถาดวัด) ต้องประกาศเป็น named export พร้อมหน่วยและแหล่งอ้างอิงใน comment เพราะผู้ใช้ต้องตรวจย้อนกลับได้
---
## 8. สัญญาข้อมูล (Data Contract)
### 8.1 กติกาคีย์
- คีย์เป็นคำเต็ม ภาษาอังกฤษ snake_case ห้ามใช้ `field2`, `col3`, `a`, `b`
- หน่วยอยู่ในชื่อคีย์เสมอ: `_mm`, `_m3`, `_rai`, `_m`, `_percent`, `_baht_per_m3`
- ค่าที่เป็นตัวเลือกใช้รหัสภาษาอังกฤษ ไม่ใช่คำไทย (ไทยอยู่ใน `label_th`)
### 8.2 ตัวอย่าง: `data/crops/crop_coefficient.json` (สร้างใหม่แทน Kc ที่เสีย)
```json
{
"schema_version": "1.0",
"crop_groups": [
{
"crop_group_id": "perennial",
"label_th": "พืชหลายปี",
"crops": [
{
"crop_id": "durian",
"label_th": "ทุเรียน",
"stages": [
{ "stage_id": "establishment", "label_th": "เริ่มปลูก", "duration_day": 365, "kc": 0.60 },
{ "stage_id": "development", "label_th": "เจริญเติบโต", "duration_day": 730, "kc": 0.85 },
{ "stage_id": "maturity", "label_th": "ให้ผลเต็มที่", "duration_day": 1095, "kc": 1.00 }
]
}
]
}
]
}
```
### 8.3 ตัวอย่าง: `data/climate/eto_by_region.json` (แปลงจาก 5 ไฟล์เดิม)
```json
{
"schema_version": "1.0",
"unit": "mm_per_day",
"regions": [
{
"region_id": "north",
"label_th": "ภาคเหนือ",
"provinces": [
{
"province_id": "mae_hong_son",
"label_th": "แม่ฮ่องสอน",
"monthly_eto_mm_per_day": {
"january": 2.83, "february": 3.55, "march": 4.51,
"april": 5.31, "may": 5.20, "june": 4.68,
"july": 4.31, "august": 4.16, "september": 4.22,
"october": 4.05, "november": 3.45, "december": 2.92
}
}
]
}
]
}
```
งานแปลง: 144 แถว (139 จังหวัด + 5 แถวหัวตาราง) จาก `open data/JSON/ปริมาณ…ภาค*.json` → ต้องแมปคีย์ `field2…field13` → ชื่อเดือนเต็ม, แปลงชื่อจังหวัดไทย → `province_id` (อ้างรหัสจังหวัดมาตรฐาน 2 หลัก)
### 8.4 Schema บังคับ
ทุกไฟล์ข้อมูลต้องมี JSON Schema คู่กันใน `data/schema/` และมี test ตรวจ (`node --test tests/data/*.test.js`) — กันข้อมูลเพี้ยนแบบ P5 หลุดเข้ามาอีก
---
## 9. บริการ (เฟส 3)
แปลงจาก postman collection เดิม (16 endpoint) เป็น REST ที่มี version:
| Method | Path | ใช้ทำอะไร |
|---|---|---|
| POST | `/api/v1/waters/calculate/daily` | ปริมาณน้ำอุปโภค-บริโภค ต่อวัน/คน/วัน |
| POST | `/api/v1/waters/calculate/plant` | ความต้องการน้ำของพืช (จาก ETo × Kc) |
| POST | `/api/v1/waters/calculate/animal` | น้ำสำหรับปศุสัตว์ |
| POST | `/api/v1/waters/calculate/industry` | น้ำสำหรับอุตสาหกรรมในฟาร์ม |
| POST | `/api/v1/capacities/reservoir` | ปริมาตรสระ (ท่า/นอง/ฝน/ใต้ดิน) |
| POST | `/api/v1/capacities/runoff` | น้ำท่ารายจังหวัด |
| POST | `/api/v1/capacities/rain_harvest` | พื้นที่รับน้ำฝน |
| POST | `/api/v1/capacities/loss` | น้ำระเหย + รั่วซึม |
| GET | `/api/v1/provinces` · `/api/v1/crops` | ข้อมูลอ้างอิงสำหรับ dropdown |
| POST | `/api/v1/reports/pdf` | export ผลคำนวณเป็น PDF (ใช้ฟอนต์ TH Sarabun New ตาม `Document/แม่แบบไฟล์ที่ส่งออก.txt`) |
หลักการ: endpoint เรียก `core/` ตัวเดียวกับฝั่งเว็บ — **สูตรอยู่ที่เดียว** ไม่มีสำเนาใน backend
---
## 10. ความเสี่ยง
| ID | ความเสี่ยง | มาตรการ |
|---|---|---|
| R1 | ⚠️ `_readme.txt` ในราก repo คือข้อความเรียกค่าไถ่ (ransomware) ลงวันที่ 13 พ.ย. 2020 — แปลว่าเครื่อง/โฟลเดอร์นี้เคยถูกโจมตี ไฟล์ที่หาย (creative.min.css, poolcal.html, โลโก้, Kc JSON) อาจเป็นผลจากเหตุนั้น | อย่า commit ไฟล์นี้ · สแกนเครื่องด้วย Windows Defender/full scan · เปลี่ยนรหัสผ่านที่เคยเก็บใน `PWA-fam-plans/v.3.8.yaml` (มี `secret_password` ในไฟล์) · สำรอง repo ขึ้น remote ที่มี versioning |
| R2 | ข้อมูล Kc สร้างใหม่จากศูนย์ อาจคลาดเคลื่อน | อ้างตาราง Kc จากกรมชลประทาน/FAO-56 และเก็บ `source_reference` ในไฟล์ JSON ทุกไฟล์ |
| R3 | ชื่อไฟล์ไทย/เว้นวรรค ทำ URL พังบน server Linux | normalize เป็น ASCII ทั้งหมดในเฟส 1 |
| R4 | Bootstrap 4 → 5 ต้องแก้ `data-toggle`/`ml-auto`/`input-group-prepend` | ทำหลังปิด P1-P4 แล้ว และมี visual check ทุกหน้า |
| R5 | repo 296 MB ทำให้ clone/push ช้า | ย้าย `archive/`, `e-book/`, `แรงบันดาลใจ/`, ไฟล์ `.download` ออก หรือใช้ Git LFS เฉพาะ pdf/docx |
---
## 11. แผนงาน
| เฟส | งาน | เกณฑ์ตรวจรับ |
|---|---|---|
| **0 — กู้สภาพ (ทำแล้วบางส่วน)** | ซ่อม `index.html`, compile `creative.css` จาก scss, เพิ่ม `legacy.css`, เพิ่ม `#myBtn`, backup ไฟล์เดิม, commit แรก | asset ในเครื่อง 200 ทุกไฟล์ · ไม่มี JS error · tag balance = 0 · `id` ไม่ซ้ำ |
| **1 — จัดบ้าน** | ย้ายเข้าโครง `web/ core/ data/ docs/`, เปลี่ยนชื่อไฟล์เป็น ASCII, ย้ายขยะไป `archive/`, ลบ `_readme.txt`, เพิ่ม `.gitignore` | `find` ไม่พบชื่อไทยใน path ที่ deploy · repo < 50 MB |
| **2 — ข้อมูล + สูตร** | สร้าง `eto_by_region.json` (144 แถว), สร้าง `crop_coefficient.json`, เขียน `core/` 9 โมดูล + unit test | test ผ่านทั้งหมด · ค่าที่คำนวณตรงกับตัวอย่างใน `Document/` อย่างน้อย 3 เคส |
| **3 — หน้าเว็บจริง + PWA** | ทำหน้า `pond_calculation`, `crop_water`, `water_value`, `irrigation_*` ต่อจาก `core/` · เพิ่ม manifest + sw.js | ใช้งาน offline ได้หลังโหลดครั้งแรก · Lighthouse PWA ผ่าน |
| **4 — API** | `service/` ตาม openapi.yaml, ต่อ PDF export | ยิง endpoint ตาม postman เดิมได้ผลเท่ากับฝั่งเว็บ |
---
## 12. Checklist ตรวจรับ (ใช้ซ้ำได้ทุกครั้งที่แก้)
```bash
# 1) asset ในเครื่องต้องมีจริงทุกไฟล์ (รันบน localhost:8090)
# tests/web/assets.test.js — สร้างในเฟส 1
node tests/web/assets.test.js
# 2) markup ต้องสมดุล (ไม่มี tag ค้าง/เกิน) — มีแล้ว
python tools/check_html_balance.py index.html
# 3) ข้อมูลต้องผ่าน schema และห้ามมี control escape — เฟส 2
node --test tests/data/
# 4) สูตรต้องผ่านเคสอ้างอิง — เฟส 2
node --test tests/core/
```
ผลตรวจล่าสุด (เฟส 0): ข้อ 2 ผ่าน · ข้อ 1 ตรวจด้วยเบราว์เซอร์จริง — รูป 16/16 โหลดได้, CSS 10/10 ไฟล์เข้า, `dupId` = 0, JS error = 0
---
## ภาคผนวก A — สิ่งที่ซ่อมใน `index.html` (เฟส 0)
| เดิม | ใหม่ |
|---|---|
| `../vendor/...`, `/flat_icon/...`, `..dist/clipboard.min.js` | path จริงในโปรเจกต์ (`coding/vendor/...`, `flat%20icon/...`) |
| Bootstrap CDN 4.0.0 + vendor 4.2.1 (โหลดซ้ำ) | ใช้ vendor 4.2.1 ตัวเดียว |
| `../css/creative.min.css` (ไม่มีไฟล์) | `css/creative.css` (compile จาก `coding/scss/creative.scss`) |
| `<link href="...png" />` (ไม่มี `rel`) | `<link rel="shortcut icon">` + `logo/logo-farm-planning.ico` |
| `<p>` ครอบ `<div>`, `<a>` ครอบ `<h3>`, `<h4><a>…</h4></a>` | โครงสร้างถูกต้องตาม HTML5 |
| `id="inputGroup-sizing-default"` ซ้ำ 4 ครั้ง | `label-name`, `label-email`, `label-subject`, `label-message` |
| `text-indent: 2.5emv`, `width=100px` | `2.5em`, `width="100"` |
| ไม่มี `#myBtn` (แต่ `custom.js` เรียก) | เพิ่มปุ่ม + `coding/css/gototop.css` |
| `clipboard.min.js` หาย | inline script ใช้ `navigator.clipboard` + fallback |
| `<div class="a">` คั่นกลาง `.row > .col-*` | เอา wrapper ออก ให้ grid ถูกต้อง |
| โลโก้ 7 ไฟล์ที่ไม่มีใน repo (5 กรม + Builk + Fastwork) | เปลี่ยนเป็นลิงก์ข้อความ (ไม่เกิด broken image) |
| คำผิด: ดาว์นโหลด, ดูส่งน้ำ, ดูระบายน้ำ, Lat's Go, ความคุ้มค้า, หนึ่งใจช่องทาง | แก้เป็น ดาวน์โหลด, คูส่งน้ำ, คูระบายน้ำ, ไปดู, ความคุ้มค่า, อีกหนึ่งช่องทาง |
ซอร์สเดิมสำรองไว้ที่ `index.html.bak-20261116`