docs: rewrite SYSTEM-DESIGN v0.2 for Vue+Julia target architecture
Grounded in the actual repo state (3 overlapping frontend stacks, two copies of each formula, no API wiring, no schema, no deploy path). Documents target layout app/ (Vue 3 + Vite) + service/ (HTTP.jl) + core/ offline fallback, engine-selection rule, API contract, data contract, PWA strategy, security items and a 6-phase plan. v0.1 kept in archive/.
This commit is contained in:
1 parent
4f74a509d5
commit
09f0a62a7c
3 files changed
+626
-290
No files matched your search
@@ -0,0 +1,369 @@
|
||||
# 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`
|
||||
Reference in new issue
Block a user