np-dms/lcbp3

Fork 0

Files

admin c90a664f53

Build and Deploy / deploy (push) Successful in 1m0s

Details

260222:1053 20260222 refactor specs/ #1 03-Data-and-Storage

2026-02-22 10:53:23 +07:00

4.0 KiB

Raw Blame History

Drawing Revision Schema Update

วันที่: 25 ธันวาคม 2568 (2025-12-25) Session: Drawing Revision Schema Consistency Update

🎯 วัตถุประสงค์

ปรับปรุง schema ของตาราง Drawing (Shop Drawing และ As Built Drawing) ให้สอดคล้องกับ pattern ของตาราง revision อื่นๆ ในระบบ (เช่น correspondence_revisions, rfa_revisions)

📝 การเปลี่ยนแปลง

1. Schema Updates (`lcbp3-v1.7.0-schema.sql`)

1.1 เพิ่ม Columns ใน `shop_drawing_revisions`

is_current BOOLEAN DEFAULT NULL COMMENT '(TRUE = Revision ปัจจุบัน, NULL = ไม่ใช่ปัจจุบัน)'
created_by INT COMMENT 'ผู้สร้าง'
updated_by INT COMMENT 'ผู้แก้ไขล่าสุด'

เพิ่ม Foreign Keys สำหรับ created_by และ updated_by ไปยัง users table
เพิ่ม UNIQUE KEY uq_sd_current (shop_drawing_id, is_current) เพื่อ enforce ว่ามี is_current = TRUE ได้แค่ 1 row ต่อ drawing

1.2 เพิ่ม Columns ใน `asbuilt_drawing_revisions`

เหมือนกับ shop_drawing_revisions

1.3 เปลี่ยน Unique Constraint ของ `drawing_number`

เดิม: UNIQUE (drawing_number) - Global uniqueness
ใหม่: UNIQUE (project_id, drawing_number) - Project-scoped uniqueness

2. Views เพิ่มใหม่

-- View สำหรับ Shop Drawing พร้อม Current Revision
CREATE OR REPLACE VIEW vw_shop_drawing_current AS ...

-- View สำหรับ As Built Drawing พร้อม Current Revision
CREATE OR REPLACE VIEW vw_asbuilt_drawing_current AS ...

ประโยชน์:

Query ง่ายขึ้นโดยไม่ต้อง JOIN ทุกครั้ง
ตัวอย่าง: SELECT * FROM vw_shop_drawing_current WHERE project_id = 3

3. Seed Data Updates (`lcbp3-v1.7.0-seed-shopdrawing.sql`)

เพิ่ม UPDATE statement ท้ายไฟล์เพื่อ set is_current = TRUE สำหรับ revision ล่าสุดของแต่ละ drawing:

UPDATE shop_drawing_revisions sdr
JOIN (
  SELECT shop_drawing_id, MAX(revision_number) AS max_rev
  FROM shop_drawing_revisions
  GROUP BY shop_drawing_id
) latest ON sdr.shop_drawing_id = latest.shop_drawing_id
        AND sdr.revision_number = latest.max_rev
SET sdr.is_current = TRUE;

🔧 เหตุผลทางเทคนิค

ทำไมใช้ `DEFAULT NULL` แทน `DEFAULT FALSE`?

MariaDB/MySQL ไม่อนุญาตให้มี duplicate values ใน UNIQUE constraint รวมถึง FALSE หลายตัว:

`is_current`	ความหมาย	อนุญาตหลายแถว?
`TRUE`	Revision ปัจจุบัน	❌ ไม่ได้ (UNIQUE)
`NULL`	Revision เก่า	✅ ได้ (NULL ignored in UNIQUE)
`FALSE`	Revision เก่า	❌ ไม่ได้ (จะซ้ำกัน)

📁 ไฟล์ที่แก้ไข

ไฟล์	การเปลี่ยนแปลง
`specs/07-database/lcbp3-v1.7.0-schema.sql`	เพิ่ม columns, views, และ constraints
`specs/07-database/lcbp3-v1.7.0-seed-shopdrawing.sql`	เพิ่ม UPDATE statement สำหรับ is_current

✅ สถานะ

Schema updated
Seed data updated
Views created
Backend entities/DTOs update
Frontend types update

4.0 KiB Raw Blame History