w-web-perm 1.1.13 → 1.1.14

package/src/js/rowDigest.mjs

@@ -1,193 +1,123 @@
-//列內容指紋與載入基準(F-26 過期快照保護; R-PRINCIPLE-00 原則 3「遇衝突或歧義:收嚴＋提示」; 規則帳本 R-BASELINE-01; ADR-037): 純函數(不依賴 Vue／DOM／ORM), 前端與伺服端同一份.
-//
-//基準(baseline)＝「編輯草稿所依據之那一版資料」之逐列內容指紋 [[id, digest], ...]; 於**開啟編輯(建立草稿)時**由草稿所依據之那份整表計算並綁定,
-//之後即使資料推播使 store 變新, 舊草稿仍帶舊基準(外審 B.1: 存檔當下才取基準, 證明的是「store 新」而不是「待存之編輯內容新」).
-//伺服端於整表寫入之互斥鎖內以庫內整表現況比對(表級, R-PRINCIPLE-00 原則 7, 使用者 2026-10-22 裁示): 表內任何一列之內容與載入時不同, 或列被增刪, 即整次拒收 saveStale、零寫入, 提示重新載入;
-//不部分變更、不上鎖, 先動先贏(run07 版只比對「本次將寫入之列」, run11 改為整表).
-//指紋只含內容欄位(排除 order 與伺服器管理欄 userId／timeCreate／userIdUpdate／timeUpdate): 外部同步整來源重寫使每列之建立／更新時間皆變, 內容未變者不應使草稿作廢; order 由儲存時依列序重給
-//(外部列之 order 由外部擁有), 僅 order 不同不是內容變更.
+//載入基準(多人同時編輯之過期保護, 先動先贏; R-PRINCIPLE-00 原則 3、使用者 2026-10-22 裁示原則 10; 規則帳本 R-BASELINE-01、R-CONTRACT-01; ADR-037 Update(perm-run01)):
+//本檔為套內轉接層, 摘要、基準與比對一律由 w-serv-orm 共用核心(w-serv-orm/src/baseline.mjs, 零 import 之同構純函數, 版本 h1)計算, 套內不再自帶指紋演算法:
+//  - 摘要 digestRow: 依寫入契約(src/schema/contracts)之 fields 白名單; undefined／null／'' 同一空值; 數字與字串不互轉; 物件鍵序無關.
+//  - 基準 buildBaseline: 有序 [[id, 摘要]], 序即名次(order 數值, 主鍵碼元); 他人重排被偵測, 系統重編號(名次不變)不誤擋.
+//  - 比對 compareBaseline: 增、刪、改、名次任一不同即不符.
+//基準＝「編輯草稿所依據之那一版資料」之基準, 於開啟編輯(建立草稿)時由草稿所依據之整表計算並綁定, 之後即使 store 變新, 舊草稿仍帶舊基準.
+//伺服端於表鎖內以新鮮讀取之庫內整表比對(先動先贏, 零寫入, 不部分變更、不上鎖); 前端用同一組函數判定草稿是否已過期(提示「資料已被更新」).
+//舊格式(套內版, 無 'h1:' 前綴)或不識版本之基準一律拒收 baselineFormat, 提示重新載入, 不降級為「未帶基準」.
 //
 //未帶基準之舊客戶端: 後台列維持舊行為(最後寫入者勝, ADR-013); 但**修改外部列之指派欄**無從證明快照新舊(Lv1 放行之指派欄不得因舊快照還原外部已撤銷之授權, 外審 B.2), 依原則 3 收嚴拒收(saveBaselineRequired).
 
-import { SERVER_FIELDS } from './externalRows.mjs'
-
+import { buildBaseline, compareBaseline as compareCore, isBaselineValid, digestRow } from 'w-serv-orm/src/baseline.mjs'
+import contracts from '../schema/contracts/index.mjs'
 
-let isStr = (v) => typeof v === 'string'
-let isObj = (v) => v !== null && typeof v === 'object'
 
-
-//cyrb53: 53 位元非密碼學雜湊(純 JS, 前後端皆可用; 用途為一致性比對, 非安全邊界)
-function cyrb53(str, seed = 0) {
-    let h1 = 0xdeadbeef ^ seed
-    let h2 = 0x41c6ce57 ^ seed
-    for (let i = 0; i < str.length; i++) {
-        let ch = str.charCodeAt(i)
-        h1 = Math.imul(h1 ^ ch, 2654435761)
-        h2 = Math.imul(h2 ^ ch, 1597334677)
-    }
-    h1 = Math.imul(h1 ^ (h1 >>> 16), 2246822507) ^ Math.imul(h2 ^ (h2 >>> 13), 3266489909)
-    h2 = Math.imul(h2 ^ (h2 >>> 16), 2246822507) ^ Math.imul(h1 ^ (h1 >>> 13), 3266489909)
-    return 4294967296 * (2097151 & h2) + (h1 >>> 0)
-}
+let hasOwn = (o, k) => Object.prototype.hasOwnProperty.call(o, k)
 
 
 /**
- * 取得列內容指紋所含欄位: schema 全部欄位扣除 order 與伺服器管理欄
+ * 取得表之寫入契約(表名須為 targets／pemis／grups／users)
  *
- * @param {Array} keys 輸入該表 schema 欄位名陣列(ds[keyTable].keys)
- * @returns {Array} 回傳欄位名陣列
+ * @param {String} keyTable 輸入表名
+ * @returns {Object} 回傳寫入契約
  */
-function getDigestFields(keys) {
-    return (Array.isArray(keys) ? keys : []).filter((k) => k !== 'order' && SERVER_FIELDS.indexOf(k) < 0)
+function getContract(keyTable) {
+    if (typeof keyTable !== 'string' || !hasOwn(contracts, keyTable)) {
+        throw new Error(`invalid keyTable of contract: ${String(keyTable)}`)
+    }
+    return contracts[keyTable]
 }
 
 
 /**
- * 計算單列內容指紋(欄位依 schema 次序; 缺欄視為 null; 與列內其他鍵、鍵序無關)
+ * 由草稿所依據之整表列計算載入基準(核心 buildBaseline; 前端以畫面所見之同一快照自算, 不向後端取雜湊)
  *
- * @param {Object} row 輸入列物件
- * @param {Array} keys 輸入該表 schema 欄位名陣列
- * @returns {String} 回傳指紋字串
- */
-function rowDigest(row, keys) {
-    let fields = getDigestFields(keys)
-    let vals = fields.map((k) => {
-        let v = isObj(row) ? row[k] : undefined
-        return v === undefined ? null : v
-    })
-    return cyrb53(JSON.stringify(vals)).toString(36)
-}
-
-
-/**
- * 由草稿所依據之列計算載入基準(只含主鍵為字串之列)
+ * 主鍵缺漏或重複(資料異常, 正常不會發生)時不拋錯, 回傳空基準: 與非空之庫內整表比對必不符, 存檔被拒並提示重新載入(fail-closed).
  *
  * @param {Array} rows 輸入草稿所依據之那份列(開啟編輯時之 store 快照, 非存檔當下)
- * @param {Array} keys 輸入該表 schema 欄位名陣列
- * @returns {Array} 回傳 [[id, digest], ...]
- */
-function makeBaseline(rows, keys) {
-    let rs = []
-    ;(Array.isArray(rows) ? rows : []).forEach((r) => {
-        if (isObj(r) && isStr(r.id)) {
-            rs.push([r.id, rowDigest(r, keys)])
-        }
-    })
-    return rs
-}
-
-
-/**
- * 判斷客戶端送入之基準格式是否合法(陣列, 每項為 [字串, 字串])
- *
- * @param {*} baseline 輸入客戶端送入之基準
- * @returns {Boolean} 回傳是否合法
+ * @param {String} keyTable 輸入表名
+ * @returns {Array} 回傳 [[id, 'h1:…'], ...](依名次)
  */
-function isBaselineValid(baseline) {
-    if (!Array.isArray(baseline) || !baseline.every((e) => Array.isArray(e) && e.length === 2 && isStr(e[0]) && isStr(e[1]))) {
-        return false
+function makeBaseline(rows, keyTable) {
+    try {
+        return buildBaseline(Array.isArray(rows) ? rows : [], getContract(keyTable))
     }
-
-    //同 id 不得出現兩次(外審 sol R8): 同 id 帶不同版本為矛盾之基準, 由列序決定採哪版屬靜默擇一(R-PRINCIPLE-00 原則 3), 格式驗證即拒收
-    let ids = new Set()
-    for (let e of baseline) {
-        if (ids.has(e[0])) {
-            return false
-        }
-        ids.add(e[0])
+    catch (err) {
+        return []
     }
-    return true
-}
-
-
-/**
- * 取得基準中某列之指紋(供前端確認草稿所依據之某列版本於期間是否變動)
- *
- * @param {Array} baseline 輸入載入基準 [[id, digest], ...]
- * @param {String} id 輸入列 id
- * @returns {String|undefined} 回傳該列指紋; 基準內無該列為 undefined
- */
-function getBaselineDigest(baseline, id) {
-    let hit = (Array.isArray(baseline) ? baseline : []).find((e) => Array.isArray(e) && e[0] === id)
-    return hit === undefined ? undefined : hit[1]
 }
 
 
 /**
- * 表級比對: 目前整表與載入基準(草稿所依據之整表)逐列內容指紋與列集合之差異數
+ * 表級比對: 目前整表與載入基準(草稿所依據之整表)之差異
  *
- * 比對對象是整表而非「本次將寫入之列」(R-PRINCIPLE-00 原則 7, 使用者 2026-10-22 裁示「以表雜湊比對, 先動先贏」): 表內任何一列之內容(指紋口徑見 getDigestFields: 排除 order 與伺服器管理欄)與基準不同,
- * 或列被增刪(id 集合不同), 即視為資料已被他人／外部同步更新. 只含主鍵為字串之列(同 makeBaseline; 主鍵非字串之列 ORM 不允許入庫, 兩側一致忽略).
- * 前端(判定草稿是否過期、顯示提示)與伺服端(checkBaseline)共用本函數, 口徑單一.
+ * 前端(判定草稿是否過期、顯示提示)與伺服端(checkBaseline)共用, 口徑單一(核心 compareBaseline).
  *
  * @param {Object} p 輸入參數物件
- * @param {Array} p.keys 輸入該表 schema 欄位名陣列
- * @param {Array} p.rows 輸入目前整表之列(伺服端為庫內全部列, 前端為 store 之該表列)
- * @param {Array} p.baseline 輸入載入基準 [[id, digest], ...](須已通過 isBaselineValid; 非陣列視為空基準)
- * @returns {Object} 回傳 { nChanged, nRemoved, nAdded }: 內容指紋不同之列數／基準有而現已不在之列數／基準無而現在才有之列數; 三者皆 0 為一致
+ * @param {String} p.keyTable 輸入表名
+ * @param {Array} p.rows 輸入目前整表之列(伺服端為表鎖內新鮮讀取之全部列, 前端為 store 之該表列)
+ * @param {Array} p.baseline 輸入載入基準
+ * @returns {Object} 回傳 { nChanged, nRemoved, nAdded, reordered, reason }: 內容摘要不同之列數／基準有而現已不在之列數／基準無而現在才有之列數／名次是否不同／核心拒收鍵(相符為空字串);
+ *   基準格式不合時 reason 為 baselineFormat; 目前列之主鍵缺漏或重複(rowsInvalid)時拋錯(key 為 rowsInvalid)
  */
-function compareBaseline({ keys, rows, baseline }) {
-    let kp = new Map(Array.isArray(baseline) ? baseline : [])
-    let nChanged = 0
-    let nAdded = 0
-    let seen = new Set()
-    ;(Array.isArray(rows) ? rows : []).forEach((o) => {
-        if (!isObj(o) || !isStr(o.id) || seen.has(o.id)) {
-            return
-        }
-        seen.add(o.id)
-        if (!kp.has(o.id)) {
-            nAdded++
-        }
-        else if (kp.get(o.id) !== rowDigest(o, keys)) {
-            nChanged++
-        }
-    })
-    let nRemoved = 0
-    kp.forEach((v, id) => {
-        if (!seen.has(id)) {
-            nRemoved++
-        }
-    })
-    return { nChanged, nRemoved, nAdded }
+function compareBaseline({ keyTable, rows, baseline }) {
+    let c = compareCore(Array.isArray(rows) ? rows : [], baseline, getContract(keyTable))
+    if (c.ok) {
+        return { nChanged: 0, nRemoved: 0, nAdded: 0, reordered: false, reason: '' }
+    }
+    return { nChanged: c.changed.length, nRemoved: c.removed.length, nAdded: c.added.length, reordered: c.reordered === true, reason: c.reason }
 }
 
 
 /**
- * 判斷載入基準相對於目前整表是否已過期(compareBaseline 之布林版, 供前端提示用)
+ * 判斷載入基準相對於目前整表是否已過期(供前端提示用)
+ *
+ * 前端容錯: 基準格式不合或目前列主鍵異常皆視為過期(fail-closed, 提示重新載入).
  *
  * @param {Object} p 輸入參數物件(同 compareBaseline)
- * @returns {Boolean} 回傳 true 為過期(有任何一列內容不同或列被增刪)
+ * @returns {Boolean} 回傳 true 為過期(有任何一列內容不同、列被增刪或名次不同)
  */
 function isBaselineStale(p) {
-    let c = compareBaseline(p)
-    return c.nChanged + c.nRemoved + c.nAdded > 0
+    try {
+        return compareBaseline(p).reason !== ''
+    }
+    catch (err) {
+        return true
+    }
 }
 
 
 /**
- * 以載入基準做表級過期檢查(在表鎖內, 以庫內整表現況比對; 不符整次拒收、零寫入; R-PRINCIPLE-00 原則 7)
+ * 以載入基準做表級過期檢查(伺服端, 須在表鎖內以新鮮讀取之整表呼叫; 不符整次拒收、零寫入)
  *
- * 規則: 載入時之整表與目前整表有任何差異(compareBaseline: 任一列內容指紋不同, 或列被增刪)即過期, 不論差異是否落在「本次將寫入之列」——
- * 不部分變更(不逐項判斷哪些可蓋)、不上鎖, 先動先贏; 指紋排除 order 與伺服器管理欄, 故外部同步整批重寫但內容未變(含時間／建立者改變、order 重編)、純粹重排 order 皆不使草稿作廢.
- * 修改前之 run07 版只檢查「本次將寫入之列」(他人改別列不擋), 使用者 2026-10-22 裁示改為表級, 見 ADR-037 Update(run11).
+ * 規則: 載入時之整表與目前整表有任何差異(列內容、列增刪、名次)即過期, 不論差異是否落在「本次將寫入之列」——不部分變更, 先動先贏;
+ * 外部同步整批重寫但內容未變(含時間／建立者改變、order 重編而名次不變)不使草稿作廢.
+ * 基準格式或版本不識(含套內舊版指紋)→ saveBaselineFormat(提示重新載入, 不降級為未帶基準).
  *
  * @param {Object} p 輸入參數物件
- * @param {Array} p.keys 輸入該表 schema 欄位名陣列
- * @param {Array} p.ltdtOld 輸入該表庫內全部列
- * @param {Array} p.baseline 輸入客戶端載入基準(須已通過 isBaselineValid)
- * @returns {Object|null} 回傳 null 為通過; 否則 { key: 'saveStale', reason, n }: reason 為 rowChanged(有列內容不同)／rowRemoved(基準之列已不在)／rowAdded(多出基準沒有的列), 依序取第一個成立者; n 為差異總列數
+ * @param {String} p.keyTable 輸入表名
+ * @param {Array} p.ltdtOld 輸入該表庫內全部列(表鎖內新鮮讀取)
+ * @param {Array} p.baseline 輸入客戶端載入基準(任何值; 格式不合由核心判定)
+ * @returns {Object|null} 回傳 null 為通過; 否則 { key, reason, n }: key 為語系鍵(saveStale／saveBaselineFormat), reason 為核心拒收鍵(baselineMismatch／rowNotFound／baselineFormat)加細節
+ *   (baselineMismatch 時為 rowChanged／rowRemoved／rowAdded／rowReordered, 依序取第一個成立者; rowNotFound／baselineFormat 原樣), n 為差異列數(格式不合為 0, 僅名次不同為 1)
  */
-function checkBaseline({ keys, ltdtOld, baseline }) {
-    let c = compareBaseline({ keys, rows: ltdtOld, baseline })
-    let n = c.nChanged + c.nRemoved + c.nAdded
-    if (n === 0) {
+function checkBaseline({ keyTable, ltdtOld, baseline }) {
+    let c = compareBaseline({ keyTable, rows: ltdtOld, baseline })
+    if (c.reason === '') {
         return null
     }
-    let reason = c.nChanged > 0 ? 'rowChanged' : (c.nRemoved > 0 ? 'rowRemoved' : 'rowAdded')
-    return { key: 'saveStale', reason, n }
+    if (c.reason === 'baselineFormat') {
+        return { key: 'saveBaselineFormat', reason: 'baselineFormat', n: 0 }
+    }
+    let n = c.nChanged + c.nRemoved + c.nAdded
+    if (c.reason === 'rowNotFound') {
+        return { key: 'saveStale', reason: 'rowNotFound', n }
+    }
+    let reason = c.nChanged > 0 ? 'rowChanged' : (c.nRemoved > 0 ? 'rowRemoved' : (c.nAdded > 0 ? 'rowAdded' : 'rowReordered'))
+    return { key: 'saveStale', reason, n: n > 0 ? n : 1 }
 }
 
 
-export { cyrb53, getDigestFields, rowDigest, makeBaseline, isBaselineValid, getBaselineDigest, compareBaseline, isBaselineStale, checkBaseline }
+export { getContract, makeBaseline, isBaselineValid, digestRow, compareBaseline, isBaselineStale, checkBaseline }
 export default makeBaseline

package/src/schema/contracts/grups.mjs

@@ -0,0 +1,8 @@
+//grups 之寫入契約(規格與欄位政策見 users.mjs 之說明; 規則帳本 R-CONTRACT-01)
+export default {
+    table: 'grups',
+    pk: 'id',
+    fields: ['name', 'description', 'from', 'srcKey', 'cpemis'], //srcKey: 外部匯入之來源鍵(身分欄, 見 users.mjs)
+    serverOnly: ['userId', 'timeCreate', 'userIdUpdate', 'timeUpdate'],
+    orderKey: 'order',
+}

package/src/schema/contracts/index.mjs

@@ -0,0 +1,17 @@
+//四張表之寫入契約集合(鍵為表名): 伺服端(server/procCore.mjs)與前端(清單頁、關聯對話框)共用同一份, 以 w-serv-orm/src/baseline.mjs 之 buildBaseline／compareBaseline 計算與比對(規則帳本 R-CONTRACT-01)
+import users from './users.mjs'
+import grups from './grups.mjs'
+import pemis from './pemis.mjs'
+import targets from './targets.mjs'
+
+
+let contracts = {
+    users,
+    grups,
+    pemis,
+    targets,
+}
+
+
+export { contracts }
+export default contracts

package/src/schema/contracts/pemis.mjs

@@ -0,0 +1,8 @@
+//pemis 之寫入契約(規格與欄位政策見 users.mjs 之說明; 規則帳本 R-CONTRACT-01)
+export default {
+    table: 'pemis',
+    pk: 'id',
+    fields: ['name', 'description', 'from', 'srcKey', 'crules'], //srcKey: 外部匯入之來源鍵(身分欄, 見 users.mjs)
+    serverOnly: ['userId', 'timeCreate', 'userIdUpdate', 'timeUpdate'],
+    orderKey: 'order',
+}

package/src/schema/contracts/targets.mjs

@@ -0,0 +1,8 @@
+//targets 之寫入契約(規格與欄位政策見 users.mjs 之說明; 規則帳本 R-CONTRACT-01): 主鍵 id 即標的名稱(使用者給定)
+export default {
+    table: 'targets',
+    pk: 'id',
+    fields: ['description', 'from', 'srcKey'], //srcKey: 外部匯入之來源鍵(身分欄, 見 users.mjs; 外部匯入時 id＝srcKey)
+    serverOnly: ['userId', 'timeCreate', 'userIdUpdate', 'timeUpdate'],
+    orderKey: 'order',
+}

package/src/schema/contracts/users.mjs

@@ -0,0 +1,13 @@
+//users 之寫入契約(多人同時編輯, 規格 dspec/多人同時編輯之寫入契約.md 第 3～5 節; 規則帳本 R-CONTRACT-01): 前後端 import 同一檔, 純資料(零 import, 可進瀏覽器打包).
+//fields 明列(白名單): 存檔採用客戶端值且入基準之欄位; 不以「排除系統欄位」推得.
+//  from 為外部列身分(外部同步擁有, 後台不得改)與 isActive／cgrups 等皆為客戶端欄位或外部欄位, 入基準: 外部同步改變其中任一欄, 持舊畫面者存檔即被拒(以外部為主, 原則 5).
+//serverOnly: 伺服器專有欄位(建立者／建立時間／更新者／更新時間, 只由伺服端寫入): 不入基準, 存檔不採用客戶端值(取庫內值).
+//orderKey: 存檔依列序重編 order(updateTabItems), 故 order 不入列摘要, 改以「名次」入基準——他人重排被偵測、系統重編號(名次不變)不誤擋.
+//  外部列之 order 屬外部(R-EXT-OWN-01: 後台存檔不重編外部列之 order, 還原為庫內值), 排序口徑同一(order 數值, 主鍵碼元).
+export default {
+    table: 'users',
+    pk: 'id',
+    fields: ['name', 'email', 'description', 'from', 'srcKey', 'cgrups', 'isAdmin', 'isActive'], //srcKey: 外部匯入之來源鍵(身分欄, perm-run03; 與 from 同, 後台不可改〔externalRows.checkExternalWrite〕, 外部匯入補上或改變者持舊畫面者存檔即被拒)
+    serverOnly: ['userId', 'timeCreate', 'userIdUpdate', 'timeUpdate'],
+    orderKey: 'order',
+}

package/src/schema/tables/grups.mjs

@@ -33,6 +33,10 @@ let settings = {
         name: '來源', //供外部批次變更使用
         type: 'STRING',
     },
+    srcKey: {
+        name: '來源鍵', //外部匯入(syncAndReplaceTabs)依其差異同步之識別: 外部自訂、同一來源(from)內唯一且穩定; 後台列(from 為空)恆為空, 後台不可改(身分欄, 與 from 同; perm-run03, R-IMPORT-01)
+        type: 'STRING',
+    },
     cpemis: {
         name: '權限清單', //為json字串
         type: 'TEXT',

package/src/schema/tables/pemis.mjs

@@ -33,6 +33,10 @@ let settings = {
         name: '來源', //供外部批次變更使用
         type: 'STRING',
     },
+    srcKey: {
+        name: '來源鍵', //外部匯入(syncAndReplaceTabs)依其差異同步之識別: 外部自訂、同一來源(from)內唯一且穩定; 後台列(from 為空)恆為空, 後台不可改(身分欄, 與 from 同; perm-run03, R-IMPORT-01)
+        type: 'STRING',
+    },
     crules: {
         name: '管控對象清單', //為json字串
         type: 'TEXT',

package/src/schema/tables/targets.mjs

@@ -29,6 +29,10 @@ let settings = {
         name: '來源', //供外部批次變更使用
         type: 'STRING',
     },
+    srcKey: {
+        name: '來源鍵', //外部匯入(syncAndReplaceTabs)依其差異同步之識別: 外部自訂、同一來源(from)內唯一且穩定; 後台列(from 為空)恆為空, 後台不可改(身分欄, 與 from 同; perm-run03, R-IMPORT-01). targets 之 id 即標的名稱, 外部匯入時 id＝srcKey
+        type: 'STRING',
+    },
     userId: {
         name: '創建使用者主鍵',
         type: 'STRING',

package/src/schema/tables/users.mjs

@@ -37,6 +37,10 @@ let settings = {
         name: '來源', //標注使用者來源, 亦供外部批次變更使用
         type: 'STRING',
     },
+    srcKey: {
+        name: '來源鍵', //外部匯入(syncAndReplaceTabs)依其差異同步之識別: 外部自訂、同一來源(from)內唯一且穩定; 後台列(from 為空)恆為空, 後台不可改(身分欄, 與 from 同; perm-run03, R-IMPORT-01)
+        type: 'STRING',
+    },
     cgrups: {
         name: '權限群組清單', //為json字串
         type: 'TEXT',

package/srv.mjs

@@ -55,6 +55,22 @@ let getUserByToken = async (token) => {
         if (token === '{token-for-reject}') { //模擬部署方以舊版 w-web-sso helper(≤1.1.4)注入: 失敗時 reject 之字串含已代入系統介接權杖(合成秘密)與使用者權杖之完整網址
             return Promise.reject(`can not get user data by url[http://127.0.0.1:11007/api/getSsoUserInfor?token=SYNTH-SYS-SECRET-FOR-TEST&key=token&value=${token}]`)
         }
+        if (token === '{token-for-admin2}') { //測試用(perm-run03 範圍三): 第二位系統管理員, 供「標頭 token 與本體 __sysToken__ 為不同使用者」「本體 token 之使用者被停用」等 getUserIdByToken 完整驗證案例(其 perm users 列由測試自行建立／停用)
+            return {
+                id: 'id-for-admin2',
+                name: 'admin2',
+                email: 'admin2@example.com',
+                isAdmin: 'y',
+            }
+        }
+        if (token === '{token-for-member}') { //測試用(perm-run03 範圍四): 在 perm users 表內(測試自行建立)、有效、isAdmin='n' 但**通過** verifyClientUser(見下方)之瀏覽使用者, 供「通過連線閘之非管理員呼叫寫入函數被 requireAdmin 拒收」案例
+            return {
+                id: 'id-for-member',
+                name: 'member',
+                email: 'member@example.com',
+                isAdmin: 'n',
+            }
+        }
         if (token === '{token-for-verify-throw}') { //回有效使用者, 但 verifyClientUser / verifyAppUser 對其拋錯(Error.message 為合成秘密), 模擬部署方驗證函數拋錯
             return {
                 id: 'id-for-verify-throw',
@@ -75,6 +91,9 @@ let verifyClientUser = (user, from) => {
     if (process.env.NODE_ENV !== 'production' && user.id === 'id-for-verify-throw') { //測試用: 見 getUserByToken 之 '{token-for-verify-throw}'
         throw new Error('SYNTH-VERIFY-SECRET-FOR-TEST')
     }
+    if (process.env.NODE_ENV !== 'production' && user.id === 'id-for-member') { //測試用: 見 getUserByToken 之 '{token-for-member}'(部署方放行非管理員, 套件仍須於函數層級另檢查角色)
+        return true
+    }
     return user.isAdmin === 'y' //測試僅系統管理者使用
 }