ปรับปรุง phase 6 ให้ครบถ้วน

web/app/utils/snapshot.ts

@@ -0,0 +1,43 @@
+/**
+ * เปลี่ยน snapshot fields ของ version (จาก GET .../versions) ให้เป็น list ที่ UI ใช้แสดงได้
+ * snapshot มี 2 รูปตามที่ backend เก็บ (phase 3):
+ * - เอกสารผูก template:  { key: { value: string, missing: boolean } }
+ * - เอกสารไม่ผูก template: map ดิบ { key: value }
+ * pure function — แยกไว้ให้ unit test ได้ (Phase 7)
+ */
+
+export interface SnapshotEntry {
+  key: string
+  value: string
+  missing: boolean
+}
+
+export function normalizeSnapshot(fields: unknown, orderKeys?: string[]): SnapshotEntry[] {
+  if (fields === null || fields === undefined || typeof fields !== 'object') return []
+
+  const entries = new Map<string, SnapshotEntry>()
+  for (const [key, raw] of Object.entries(fields as Record<string, unknown>)) {
+    if (raw !== null && typeof raw === 'object' && 'value' in raw) {
+      const obj = raw as { value?: unknown; missing?: unknown }
+      entries.set(key, {
+        key,
+        value: obj.value === null || obj.value === undefined ? '' : String(obj.value),
+        missing: obj.missing === true,
+      })
+    } else {
+      entries.set(key, { key, value: raw === null || raw === undefined ? '' : String(raw), missing: false })
+    }
+  }
+
+  const list = [...entries.values()]
+  if (orderKeys?.length) {
+    // เรียงตามลำดับ field defs ของ template — key ที่ไม่มีใน defs ต่อท้ายตามตัวอักษร
+    const rank = new Map(orderKeys.map((k, i) => [k, i]))
+    list.sort((a, b) => {
+      const ra = rank.get(a.key) ?? orderKeys.length
+      const rb = rank.get(b.key) ?? orderKeys.length
+      return ra === rb ? a.key.localeCompare(b.key) : ra - rb
+    })
+  }
+  return list
+}