w-web-perm 1.1.13 → 1.1.15

package/src/components/VePemiBlngGrups.vue

@@ -128,7 +128,7 @@
 
                     <!-- 資料已被更新提示(R-PRINCIPLE-00 原則 7): 開框後他人或外部同步改了群組表, 本視窗之草稿與基準維持開框時之版本、不重建, 存檔將被伺服端拒收; 以 v-for 渲染(無提示時不渲染任何節點) -->
                     <div
-                        v-for="ks in (staleNotice ? 1 : 0)"
+                        v-for="ks in ((staleNotice || subjectNotice) ? 1 : 0)"
                         :key="`stale-${ks}`"
                         data-fmid="pemi-blng-grups-banner-stale"
                         style="padding:5px 15px; border-top:1px solid #ddd; background:#FFE0B2; color:#444; font-size:0.8rem; overflow-wrap:anywhere;"
@@ -221,7 +221,9 @@ import getKpLossy from '../js/getKpLossy.mjs'
 import fmtLossyMsg from '../js/fmtLossyMsg.mjs'
 import pairRowsToSnapshot from '../js/pairRowsToSnapshot.mjs'
 import { makeBaseline } from '../js/rowDigest.mjs'
-import { isDraftStale } from '../js/draftSync.mjs'
+import { isDraftStale, planDialogSync, checkSubject } from '../js/draftSync.mjs'
+import { applySavedRows } from '../js/applySaved.mjs'
+import { isCellEditing, bindCellEditingStopRetry } from '../js/cellEditing.mjs'
 import { makeRowStates, getChangedIdx, buildRowsSend } from '../js/relDialogSend.mjs'
 import { getRefState, getRawModeMap, putRefEntry } from '../js/editorRefRows.mjs'
 import { getRefWarns, getRefWarnText } from '../js/getAuthWarn.mjs'
@@ -272,7 +274,10 @@ export default {
             //baseline 為草稿所依據之那份群組列之逐列內容指紋, 存檔隨 updateGrups 第 2 參送伺服端; rowStates 為開框時各列之歸屬狀態, 存檔時判定使用者有無變更該列
             baseline: null,
             rowStates: null,
-            staleNotice: false, //有未存編輯時收到推播、且群組表已異於本視窗載入時之基準(R-PRINCIPLE-00 原則 7): true 時顯示「資料已被更新」提示; 每次 show() 歸零
+            staleNotice: false, //有未存編輯(含開啟中之儲存格編輯器)時收到推播、且群組表已異於本視窗載入時之基準(R-PRINCIPLE-00 原則 7、10): true 時顯示「資料已被更新」提示; 每次 show() 歸零
+            subject: null, //開框時之主體摘要 { id, name, saved }(第 114 項, R-SUBJECT-ID-01): 本對話框以**名稱**引用權限(群組 cpemis 的鍵是權限名稱), 存檔時以 id 驗主體仍是同一個實體(未被刪除、改名、刪除後以同名重建)
+            subjectNotice: false, //主體(權限)於開框後已被刪除、改名或以同名重建(id 不同): true 時顯示「資料已被更新」提示, 存檔將被拒收; 每次 show() 歸零
+            systemProcing: false, //程式端重建對話框內容期間為 true, 用於排除非使用者操作之 rowsChange (見 $ui.markDataReload; 開框中因推播重建時須用)
 
             items: [],
             itemsCheck: [],
@@ -304,14 +309,12 @@ export default {
 
     },
     watch: {
-        //store 之群組表被推播更新(整表以新陣列取代): 本視窗不重建(草稿與基準維持開框時之版本, 見 show()). 此刻有未存編輯者, 若表已異於載入時之基準(任一列內容不同或列增刪; 僅 order／伺服器管理欄不同不算)
-        //即顯示「資料已被更新」提示, 存檔時由伺服端以表雜湊拒收(saveStale); 無未存編輯者維持原行為(靜默, 存檔時才由伺服端拒收). 唯讀檢視無存檔, 不提示
-        grups: function(rows) {
-            let vo = this
-            if (!vo.bShow || !vo.isEditable || !vo.isModified || vo.ownSaving || !Array.isArray(vo.baseline)) {
-                return
-            }
-            vo.staleNotice = isDraftStale({ keys: vo.$ds.grups.keys, rows, baseline: vo.baseline })
+        //store 之群組表或權限(主體)表被推播更新(整表以新陣列取代): 處置見 syncStore
+        grups: function() {
+            this.syncStore()
+        },
+        pemis: function() {
+            this.syncStore()
         },
     },
     computed: {
@@ -505,7 +508,7 @@ export default {
                         // console.log('rowsChange cloneDeep(vo.opt.rows)', cloneDeep(vo.opt.rows))
 
                         //check
-                        if (!vo.syncState || vo.firstLoading || vo.firstSetting) {
+                        if (!vo.syncState || vo.firstLoading || vo.firstSetting || vo.systemProcing) {
                             return
                         }
 
@@ -1034,17 +1037,93 @@ export default {
 
         },
 
-        saveGrups: async function(rows, baseline) {
+        syncStore: function() {
+            //store 之群組表或權限(主體)表被推播更新(整表以新陣列取代)時的處置(R-PRINCIPLE-00 原則 10; 規則帳本 R-DRAFT-KEEP-01 規則 11、12; draftSync.planDialogSync):
+            //  ① 無未存修改(含無開啟中之儲存格編輯器)而群組表已異於載入基準 → 以新資料重建對話框內容並更新基準(對話框開而未編輯時不停在過期資料上; 修 (b));
+            //  ② 有未存修改或開啟中之編輯器 → 保留草稿、凍結基準, 顯示「資料已被更新」提示, 存檔時由伺服端拒收(saveStale);
+            //  ③ 自己存檔進行中所致之推播不是他人更新 → 不重建、不提示;
+            //  ④ 主體(權限)已被刪除、改名或以同名重建(第 114 項) → 不重建(無從續編), 顯示同一提示, 存檔時前端與之比對 id 拒收.
+            let vo = this
+            if (!vo.bShow || !Array.isArray(vo.baseline)) {
+                return
+            }
+            let sc = checkSubject({ subject: vo.subject, rows: vo.pemis })
+            vo.subjectNotice = sc !== 'ok'
+            let act = planDialogSync({
+                show: true,
+                storeChanged: true,
+                stale: isDraftStale({ keyTable: 'grups', rows: vo.grups, baseline: vo.baseline }),
+                dirty: vo.isModified === true,
+                editing: isCellEditing(get(vo, '$refs.rftable', null)),
+                saving: vo.ownSaving === true,
+            })
+            if (act === 'rebuild') {
+                if (sc === 'ok') {
+                    vo.rebuildDialog()
+                }
+            }
+            else if (act === 'keep') {
+                vo.staleNotice = true
+            }
+        },
+
+        rebuildDialog: function() {
+            //開框中以目前 store 重建對話框內容與基準(無未存修改時; 同 show() 之內容組裝, 不動 pm／bShow／isEditable／subject)
+            let vo = this
+            let p = vo.pemis.find((r) => r.id === get(vo, 'subject.id', ''))
+            let pemi = { ...vo.pemi, ...cloneDeep(p) }
+            let grups = cloneDeep(vo.grups)
+            let baseline = makeBaseline(grups, 'grups')
+            let items = vo.genItems(pemi, grups)
+            let rowStates = makeRowStates(items)
+
+            //markDataReload: 重建 opt 屬程式端寫入, 其後非同步觸發之 rowsChange 不得視為使用者變更
+            vo.$ui.markDataReload(vo)
+
+            vo.pemi = pemi
+            vo.items = items
+            vo.baseline = baseline
+            vo.rowStates = rowStates
+            vo.isModified = false
+            vo.staleNotice = false
+            vo.genOpt()
+            vo.$nextTick(() => {
+                vo.bindEditing()
+            })
+        },
+
+        bindEditing: function() {
+            //第 115 項(R-DRAFT-KEEP-01 規則 10): 儲存格編輯器開啟中視為有草稿(syncStore 以 ag-grid 的 getEditingCells 判定); 編輯結束(提交、Esc、失焦)時補做保留期間跳過之重建
+            let vo = this
+            bindCellEditingStopRetry(() => get(vo, '$refs.rftable', null), () => {
+                vo.afterEditing()
+            })
+        },
+
+        afterEditing: function() {
+            //儲存格編輯結束: 無未存修改而表於編輯期間已變新者, 補上一次同步處置(重建); 有未存修改者維持保留
+            let vo = this
+            if (vo.isModified !== true) {
+                vo.syncStore()
+            }
+        },
+
+        saveGrups: async function(rows, baseline, subject) {
             // console.log('method saveGrups', rows, baseline)
 
             let vo = this
 
             //3) updateGrups, 各自 catch + okX 旗標短路 (canonical 五段結構; 空清單檢查已上移至 doSave core())
-            //第 2 參 { baseline }: 開框時綁定之草稿基準(由 doSave 於流程開頭取得並傳入, 不於此讀 vo.baseline——存檔進行中若再次 show() 會換成新草稿之基準); 伺服端比對「本次將寫入之列」之庫內版本, 草稿之後被改過即整次拒收 saveStale(失敗路徑沿用下方 catch 顯示語系文字)
+            //第 2 參 { baseline, returnRows }: baseline 為開框時綁定之草稿基準(由 doSave 於流程開頭取得並傳入, 不於此讀 vo.baseline——存檔進行中若再次 show() 會換成新草稿之基準); 伺服端比對「本次將寫入之列」之庫內版本, 草稿之後被改過即整次拒收 saveStale(失敗路徑沿用下方 catch 顯示語系文字);
+            //returnRows: 成功時回傳寫入後之列(鎖內新鮮讀取), 立即 commit 進 store(規格第 8 節; R-SAVED-ROWS-01), 其後再開此視窗時基準即為最新, 不會被自己上一次之存檔誤擋
             let okSave = false
             vo.ownSaving = true //自己之寫入所致之推播不提示(成功路徑維持至視窗關閉; show() 歸零)
-            await vo.$fapi.updateGrups(rows, { baseline })
-                .then(() => { okSave = true })
+            //subject: 開框時之主體(權限)摘要 { id, name, saved }(由 doSave 於流程開頭取得並傳入): 伺服端於權限表鎖內新鮮讀取後以同一判準(draftSync.checkSubject)再驗一次, 被刪除、改名、刪除後同名重建一律拒收 saveSubjectChanged(R-SUBJECT-ID-01 規則 4; 前端自檢先擋, 此為推播未抵達時之伺服端強制)
+            await vo.$fapi.updateGrups(rows, { baseline, returnRows: true, subject })
+                .then((res) => {
+                    okSave = true
+                    applySavedRows('grups', res, (t, rs) => vo.$store.commit(vo.$store.types.UpdateTableData, { tableName: t, data: rs, source: 'savedRows' }))
+                })
                 .catch(async (err) => {
                     vo.ownSaving = false //失敗(含 saveStale 被拒): 視窗仍開著, 恢復監看
                     vo.$ui.updateLoading(false) //showCheckYes 前關 loading（modal 阻斷期間避免 loading 疊在底下）
@@ -1111,6 +1190,20 @@ export default {
                 //pemiName: 被編輯之權限名稱, 同樣於流程開頭(任何 await 之前)取得——等待後才讀 vo.pemi.name 會讀到新開啟之實體, 把舊草稿之歸屬寫成指派新實體(外審 sol R2)
                 let pemiName = get(vo, 'pemi.name', '')
 
+                //subject: 開框時之主體摘要 { id, name, saved }, 同樣於流程開頭取得並持有. isSubjectOk: 主體(權限)於存檔當下仍是開框時那一個實體(第 114 項, R-SUBJECT-ID-01; 原則 3、6):
+                //本對話框以名稱引用權限(群組 cpemis 的鍵是權限名稱)而不驗主體身分——開框後權限被刪除、改名, 或刪除後以同名重建(id 不同), 引用會靜默指向新實體(被同名新資料接管); 故以 id 比對存檔當下之權限表, 不符即整次拒存(零寫入)並提示重新載入
+                let subject = vo.subject
+                let isSubjectOk = () => checkSubject({ subject, rows: vo.pemis }) === 'ok'
+                let rejectSubject = async () => {
+                    vo.$ui.updateLoading(false)
+                    await vo.$dg.showCheckYes(vo.$t('relSubjectChangedPemi').split('{name}').join(get(subject, 'name', '')))
+                    return false
+                }
+                if (!isSubjectOk()) {
+                    unlockBtn()
+                    return await rejectSubject()
+                }
+
                 //1b) 無法無損表示之授權資料(R-AUTH-LOSSY-01, 主控複審 R4): 該列群組之 cpemis 含物件形式無法無損表示之格(getKpLossy)者, 本對話框不得改寫其字串——
                 //本對話框所管之歸屬／模式有變更 → 整次儲存拒絕並點名(原子, 其餘列亦不寫); 未變更 → 該列字串逐字元不動(見下方 kpLossyIdx)
                 //群組列之快照只取這一次: 有損檢查之值即下方寫入之值(外審 sol#2: 兩次讀取之間 store 可能被伺服器推送更新, 檢查與寫入看到不同資料)
@@ -1170,6 +1263,11 @@ export default {
                 //delay
                 await delay(300)
 
+                //主體身分複驗(第 114 項): 開 loading 與等待期間 store 可能再被推播更新, 送出前再比對一次
+                if (!isSubjectOk()) {
+                    return await rejectSubject()
+                }
+
                 //grups: 沿用 1b 之快照(見上)
 
                 //kpNewCpemis: 列索引 → 該列新 cpemis 字串; 只收「使用者有變更(kpChanged)、非有損、且 putRefEntry 判定本項確有變更」者, 其餘一律不收(由 buildRowsSend 原樣帶回)
@@ -1217,7 +1315,7 @@ export default {
                 // }
 
                 //saveGrups, 失敗時回 false: 失敗提示已由 saveGrups 顯示, 此處不關閉對話框(保留未存變更供重按儲存)
-                let okSave = await vo.saveGrups(grupsNew, baseline)
+                let okSave = await vo.saveGrups(grupsNew, baseline, subject)
                 if (!okSave) {
                     return false
                 }
@@ -1288,6 +1386,7 @@ export default {
             //default
             vo.isModified = false
             vo.staleNotice = false
+            vo.subjectNotice = false
             vo.ownSaving = false
 
             //isEditable, pemi
@@ -1297,12 +1396,15 @@ export default {
             //grup
             pemi = cloneDeep(pemi)
 
+            //subject: 開框時之主體摘要(第 114 項): 存檔時以 id 驗主體仍是同一個實體
+            let subject = { id: get(pemi, 'id', ''), name: get(pemi, 'name', ''), saved: vo.pemis.some((r) => r.id === get(pemi, 'id', '')) }
+
             //grups
             let grups = cloneDeep(vo.grups)
 
-            //baseline(F-26, R-BASELINE-01; 外審 B.1): 於生成 items 之同一處, 以 items 所依據之那份群組列(grups)計算並綁定為本次草稿之載入基準; 之後 store 推播變新不得更新它
-            //(存檔當下才由最新 store 取基準, 證明的是「store 新」而非「待存之編輯內容新」), 每次 show() 重新綁定. 欄位口徑與伺服端同一(vo.$ds.grups.keys 經 rowDigest.makeBaseline)
-            let baseline = makeBaseline(grups, vo.$ds.grups.keys)
+            //baseline(F-26, R-BASELINE-01; 外審 B.1): 於生成 items 之同一處, 以 items 所依據之那份群組列(grups)計算並綁定為本次草稿之載入基準; 之後 store 推播變新不得更新它,
+            //除非無未存修改時 syncStore 整個重建(存檔當下才由最新 store 取基準, 證明的是「store 新」而非「待存之編輯內容新」), 每次 show() 重新綁定. 摘要口徑與伺服端同一(寫入契約 grups, 經 rowDigest.makeBaseline／w-serv-orm buildBaseline)
+            let baseline = makeBaseline(grups, 'grups')
 
             //items
             let items = vo.genItems(pemi, grups)
@@ -1313,6 +1415,7 @@ export default {
             //save
             vo.isEditable = isEditable
             vo.pemi = pemi
+            vo.subject = subject
             vo.items = items
             vo.baseline = baseline
             vo.rowStates = rowStates
@@ -1323,6 +1426,11 @@ export default {
             //firstLoading
             vo.firstLoading = false
 
+            //第 115 項: 對話框內之 ag-grid 綁「儲存格編輯結束」監聽
+            vo.$nextTick(() => {
+                vo.bindEditing()
+            })
+
             //bShow
             vo.bShow = true
 

package/src/getPermUserInfor.mjs

@@ -5,6 +5,16 @@ import isfun from 'wsemi/src/isfun.mjs'
 import fetchJson from './fetchJson.mjs'
 
 
+/**
+ * 由外部應用(node端)查詢指定使用者之權限資訊
+ *
+ * @param {String} url 輸入權限系統之getPermUserInfor網址字串，須含'token={sysToken}'與'userId={userId}'兩個佔位符，例如'http://localhost:11006/api/getPermUserInfor?token={sysToken}&userId={userId}'
+ * @param {String} tokenSelf 輸入系統介接用之app使用者token字串
+ * @param {String} userIdTar 輸入欲查詢之使用者id字串。權限系統mappingBy為'id'(預設)時，此為該使用者於外部系統之使用者id(與登入對應同一判準：外部同步列對應其來源鍵srcKey，後台列對應其id，不是權限系統配發之內部id；命中多筆時伺服端拒絕，HTTP回應msg為ambiguousUserFromPerm、本函數reject為cannotGetUserDataByUrl；查無使用者則回全停用之空權限)；mappingBy為'email'或'name'時，此為權限系統users表內之內部id
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {Function} [opt.funConvertPerm] 輸入轉換函數，接收{user,rules}，回傳物件(可為Promise)以取代預設回傳值，未給則原樣回傳
+ * @returns {Promise} 回傳Promise，resolve為{user,rules}物件(或funConvertPerm轉換後之物件)，reject為錯誤鍵字串
+ */
 async function getPermUserInfor(url, tokenSelf, userIdTar, opt = {}) {
     //url: http://localhost:11006/api/getPermUserInfor?token={sysToken}&userId={userId}
     let errTemp = null

package/src/js/applySaved.mjs

@@ -0,0 +1,56 @@
+//存檔成功後立即以伺服端回傳之「寫入後之列」更新前端 store(多人同時編輯規格第 8 節; R-PRINCIPLE-00 原則 10; 規則帳本 R-SAVED-ROWS-01; ADR-037 Update(perm-run01)): 純函數(不依賴 Vue／DOM／ORM).
+//
+//背景: 存檔成功後新基準須取自伺服端、且須立即取得——若只等推播／輪詢(約 2 秒)才更新 store 與基準, 使用者存檔成功後立即再編輯再存, 會被自己上一次之存檔誤擋(api-verify01 實測 8 次中 7 次; perm run12 同見).
+//不得以「自己送出之值」當新基準: 寫入時 clearXSS 等會改寫部分字串(例 a<b 存為 a&lt;b), 以送出值當基準, 下次存檔會被自己之基準誤拒. 故 updateXxx 於成功時(客戶端帶 returnRows:true)回傳 { msg, rows, others }:
+//rows 為鎖內新鮮讀取之該表全部列, others 為引用連帶有改寫之引用端表(鍵為表名)之全部列. 前端把它們 commit 進 store(同 main.js recvData 之 UpdateTableData), 清單頁與對話框的重建照既有流程即以之為新資料與新基準; 其後抵達之同內容推播, 摘要相同, 不視為他人更新.
+
+let TABLES = ['targets', 'pemis', 'grups', 'users']
+let hasOwn = (o, k) => Object.prototype.hasOwnProperty.call(o, k)
+
+
+//isRows: 須為陣列且每列為物件、主鍵 id 為非空字串(正常資料恆是; 否則視為異常回傳而不套用, 退回等推播)
+let isRows = (rs) => Array.isArray(rs) && rs.every((r) => r !== null && typeof r === 'object' && typeof r.id === 'string' && r.id !== '')
+
+
+/**
+ * 取出存檔回傳中可套用之表資料: [{ tableName, data }, ...]; 回傳不是 { rows, others } 形狀(舊伺服端回字串、讀回失敗)或資料異常者回空陣列(呼叫端退回等推播)
+ *
+ * @param {String} keyTable 輸入本次存檔之表名(targets／pemis／grups／users)
+ * @param {*} res 輸入 updateXxx 之回傳(成功 msg key 字串, 或 { msg, rows, others })
+ * @returns {Array} 回傳 [{ tableName, data }, ...](本表在前, 引用端表在後; 表名不在白名單或資料異常者略過)
+ */
+function getSavedTables(keyTable, res) {
+    let out = []
+    if (res === null || typeof res !== 'object' || TABLES.indexOf(keyTable) < 0 || !isRows(res.rows)) {
+        return out
+    }
+    out.push({ tableName: keyTable, data: res.rows })
+    let others = (res.others !== null && typeof res.others === 'object') ? res.others : {}
+    Object.keys(others).forEach((t) => {
+        if (t !== keyTable && TABLES.indexOf(t) >= 0 && hasOwn(others, t) && isRows(others[t])) {
+            out.push({ tableName: t, data: others[t] })
+        }
+    })
+    return out
+}
+
+
+/**
+ * 存檔成功後以回傳之寫入後之列更新 store
+ *
+ * @param {String} keyTable 輸入本次存檔之表名
+ * @param {*} res 輸入 updateXxx 之回傳
+ * @param {Function} commitTable 輸入 (tableName, data) => void, 實際 commit UpdateTableData 之函數(同 main.js recvData)
+ * @returns {Boolean} 回傳是否已套用(false 為回傳不含可用之列, 前端退回等推播)
+ */
+function applySavedRows(keyTable, res, commitTable) {
+    let ts = getSavedTables(keyTable, res)
+    ts.forEach((t) => {
+        commitTable(t.tableName, t.data)
+    })
+    return ts.length > 0
+}
+
+
+export { getSavedTables, applySavedRows }
+export default applySavedRows

package/src/js/cellEditing.mjs

@@ -0,0 +1,91 @@
+//儲存格編輯器開啟中視為有草稿(第 115 項; R-PRINCIPLE-00 原則 10「有未存修改時收到推播不重建」; 規則帳本 R-DRAFT-KEEP-01 規則 10): 以 ag-grid 的 API 判定, 四清單頁與兩對話框共用.
+//
+//背景: 使用者在儲存格輸入了文字、尚未按 Enter(或尚未失焦)時, 輸入只在編輯器內, 還沒進 rows(rowsChange 尚未觸發, isModified 仍為假); 此時推播使清單重建(setRowData)會直接丟掉編輯器與輸入, 且不會有任何提示.
+//故編輯器開啟中視同有草稿: 不重建、凍結基準、提示「資料已被更新」; 編輯器關閉後(Enter 提交→isModified 為真續保留; Esc 或無變更→無草稿)若 store 於期間已變新, 補上一次重建.
+//
+//cmp 為 WAggridVue 元件實例(含 getApi(): ag-grid GridApi; w-aggrid-vue 2.1.9). 純函數: 不依賴 Vue; 取不到 api(尚未掛載、已銷毀)一律視為「未在編輯」.
+
+
+let apiOf = (cmp) => {
+    try {
+        let api = (cmp !== null && cmp !== undefined && typeof cmp.getApi === 'function') ? cmp.getApi() : null
+        return (api !== null && api !== undefined && typeof api.getEditingCells === 'function') ? api : null
+    }
+    catch (err) {
+        return null
+    }
+}
+
+
+/**
+ * 儲存格編輯器是否開啟中(ag-grid getEditingCells 非空)
+ *
+ * @param {Object} cmp 輸入 WAggridVue 元件實例(可為 null／undefined)
+ * @returns {Boolean} 回傳是否有儲存格正在編輯
+ */
+function isCellEditing(cmp) {
+    let api = apiOf(cmp)
+    if (api === null) {
+        return false
+    }
+    try {
+        let cs = api.getEditingCells()
+        return Array.isArray(cs) && cs.length > 0
+    }
+    catch (err) {
+        return false
+    }
+}
+
+
+let bound = new WeakSet()
+
+
+/**
+ * 對 ag-grid api 註冊一次「儲存格編輯結束」監聽(同一個 api 只註冊一次; 元件重建即換新 api, 需再呼叫)
+ *
+ * @param {Object} cmp 輸入 WAggridVue 元件實例
+ * @param {Function} onStop 輸入編輯結束(提交、Esc、失焦)後之回呼
+ * @returns {Boolean} 回傳是否已綁定(false 為 api 尚未可用, 呼叫端稍後重試)
+ */
+function bindCellEditingStop(cmp, onStop) {
+    let api = apiOf(cmp)
+    if (api === null || typeof api.addEventListener !== 'function') {
+        return false
+    }
+    if (bound.has(api)) {
+        return true
+    }
+    bound.add(api)
+    api.addEventListener('cellEditingStopped', () => {
+        try {
+            onStop()
+        }
+        catch (err) {
+            console.log('cellEditingStopped', err)
+        }
+    })
+    return true
+}
+
+
+/**
+ * 綁定編輯結束監聽, api 尚未可用時以短輪詢重試(元件於 v-if 內, 重建草稿後下一輪渲染才掛載)
+ *
+ * @param {Function} getCmp 輸入回傳 WAggridVue 元件實例之函數(每次重試重新取, 元件可能被重建)
+ * @param {Function} onStop 輸入編輯結束後之回呼
+ * @param {Number} [tries=30] 輸入最多重試次數(每次相隔 100 ms)
+ * @returns {void} 無回傳
+ */
+function bindCellEditingStopRetry(getCmp, onStop, tries = 30) {
+    if (bindCellEditingStop(getCmp(), onStop) || tries <= 0) {
+        return
+    }
+    setTimeout(() => {
+        bindCellEditingStopRetry(getCmp, onStop, tries - 1)
+    }, 100)
+}
+
+
+export { isCellEditing, bindCellEditingStop, bindCellEditingStopRetry }
+export default isCellEditing

package/src/js/draftSync.mjs

@@ -56,15 +56,91 @@ function planDraftSync({ first, editChanged, storeChanged, hasDraft, saving }) {
  * 草稿所依據之基準相對於目前 store 整表是否已過期(供顯示「資料已被更新」提示; 判準同伺服端 checkBaseline, 單一擁有者 rowDigest.compareBaseline)
  *
  * @param {Object} p 輸入參數物件
- * @param {Array} p.keys 輸入該表 schema 欄位名陣列
+ * @param {String} p.keyTable 輸入表名(targets／pemis／grups／users; 依其寫入契約計算)
  * @param {Array} p.rows 輸入目前 store 之該表列
  * @param {Array} p.baseline 輸入草稿載入時之基準
- * @returns {Boolean} 回傳是否過期(有任一列內容不同或列被增刪; 僅 order／伺服器管理欄不同不算)
+ * @returns {Boolean} 回傳是否過期(有任一列內容摘要不同、列被增刪或名次不同; 僅 order 數值改變而名次不變、或僅伺服器專有欄不同不算)
  */
-function isDraftStale({ keys, rows, baseline }) {
-    return isBaselineStale({ keys, rows, baseline })
+function isDraftStale({ keyTable, rows, baseline }) {
+    return isBaselineStale({ keyTable, rows, baseline })
 }
 
 
-export { refsChanged, planDraftSync, isDraftStale }
+/**
+ * 是否有未存之草稿: 已提交之未存修改(isModified), 或**儲存格編輯器開啟中**(已輸入、未按 Enter 或未失焦——編輯器內的輸入尚未進 rows, 但重建清單會直接丟棄它; 第 115 項, R-DRAFT-KEEP-01 規則 10)
+ *
+ * 四清單頁(changeParams 的 hasDraft)與兩對話框(planDialogSync)共用, 口徑單一.
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Boolean} p.dirty 輸入是否有已提交之未存修改(isModified 鏡像)
+ * @param {Boolean} p.editing 輸入儲存格編輯器是否開啟中(ag-grid getEditingCells 非空)
+ * @returns {Boolean} 回傳是否視為有草稿
+ */
+function hasDraftNow({ dirty, editing }) {
+    return dirty === true || editing === true
+}
+
+
+/**
+ * 反向關聯對話框(開著時)收到 store 推播之處置(第 114／115 項、修 (b); R-PRINCIPLE-00 原則 10「無未存修改時照舊重建」; 規則帳本 R-DRAFT-KEEP-01 規則 10～12)
+ *
+ * - 'none': 不須處置——未顯示、store 未變、表內容未異於載入基準(推播內容與載入時相同)、或此推播是自己存檔所致(saving)而無草稿
+ * - 'rebuild': 無未存修改(含無開啟中之儲存格編輯器)且表已異於載入基準 → 以新資料重建對話框內容並更新基準(對話框開而未編輯時不應停在過期的資料上)
+ * - 'keep': 有未存修改或開啟中之編輯器 → 保留草稿、凍結基準; 呼叫端依 stale 顯示「資料已被更新」提示
+ * - 'keepQuiet': 自己之存檔進行中(伺服端已寫入、回應未到)所致之推播, 不是他人更新 → 保留、不提示
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Boolean} p.show 輸入對話框是否顯示中
+ * @param {Boolean} p.storeChanged 輸入來源 store 是否變新(參照改變)
+ * @param {Boolean} p.stale 輸入表是否已異於對話框載入時之基準(isDraftStale)
+ * @param {Boolean} p.dirty 輸入是否有已提交之未存修改
+ * @param {Boolean} p.editing 輸入儲存格編輯器是否開啟中
+ * @param {Boolean} p.saving 輸入自己之存檔是否進行中
+ * @returns {String} 回傳 'none'｜'rebuild'｜'keep'｜'keepQuiet'
+ */
+function planDialogSync({ show, storeChanged, stale, dirty, editing, saving }) {
+    if (show !== true || storeChanged !== true) {
+        return 'none'
+    }
+    if (saving === true) {
+        return 'keepQuiet'
+    }
+    if (stale !== true) {
+        return 'none'
+    }
+    return hasDraftNow({ dirty, editing }) ? 'keep' : 'rebuild'
+}
+
+
+/**
+ * 驗證關聯對話框之主體(被編輯其歸屬之群組／權限)於存檔當下仍是開框時那一個實體(第 114 項; R-PRINCIPLE-00 原則 3、6; 規則帳本 R-SUBJECT-ID-01)
+ *
+ * 反向對話框以**名稱**引用主體(使用者 cgrups／群組 cpemis 的鍵是名稱), 不驗主體身分: 開框後主體被刪除並以同名重建(id 不同), 引用會靜默指向新實體(原則 6: 不得讓引用被同名新資料接管);
+ * 故以主體 id 與開框時之摘要(id、名稱、開框時是否已儲存)比對存檔當下的主體表: id 仍在、名稱未變才算同一實體. 不符一律拒收(收嚴, 原則 3), 提示重新載入.
+ * 開框時主體尚未儲存(store 查無該 id; 清單頁新增列未存即開對話框)者沿用既有行為(引用先指向尚不存在之名稱), 但其後 store 出現「同名而 id 不同」之另一實體時亦拒收(引用會被該實體接管).
+ *
+ * @param {Object} p 輸入參數物件
+ * @param {Object} p.subject 輸入開框時之主體摘要 { id, name, saved }(saved: 開框時 store 已有該 id)
+ * @param {Array} p.rows 輸入存檔當下之主體表列(store 的 grups 或 pemis)
+ * @returns {String} 回傳 'ok'｜'gone'(開框時已儲存之 id 現已不在: 已刪除或以同名重建)｜'renamed'(id 仍在但名稱不同)｜'taken'(開框時未儲存之主體, 現有同名而 id 不同之另一實體)｜'noSubject'(未提供有效之開框摘要, 收嚴拒收)
+ */
+function checkSubject({ subject, rows }) {
+    let id = (subject !== null && typeof subject === 'object') ? subject.id : undefined
+    let name = (subject !== null && typeof subject === 'object') ? subject.name : undefined
+    if (typeof id !== 'string' || id === '' || typeof name !== 'string' || name === '') {
+        return 'noSubject'
+    }
+    let list = (Array.isArray(rows) ? rows : []).filter((r) => r !== null && typeof r === 'object')
+    let hit = list.find((r) => r.id === id)
+    if (hit !== undefined) {
+        return hit.name === name ? 'ok' : 'renamed'
+    }
+    if (subject.saved === true) {
+        return 'gone'
+    }
+    return list.some((r) => r.name === name) ? 'taken' : 'ok'
+}
+
+
+export { refsChanged, planDraftSync, isDraftStale, hasDraftNow, planDialogSync, checkSubject }
 export default planDraftSync

package/src/js/externalRows.mjs

@@ -24,6 +24,12 @@ let isObj = (v) => v !== null && typeof v === 'object'
 let normV = (v) => JSON.stringify(v === undefined ? '' : v)
 
 
+//normC: 內容欄比對用——另視 null 與 ''／缺欄為同一空值(寫入契約之空值等價, 與基準 digestRow 同口徑; 0／false 仍異於空值).
+//  基準已視 null≡'' 為相同而通過, 此處若仍視為不同, 會對合法存檔回 saveExternalRowChanged(外審 sol#2, 2026-10-23); 相同者亦不重寫, 庫內原表示(null)不被改成 ''.
+//  from 欄不適用: null 與 '' 之 from 有別(歷史後台列, 見 checkExternalWrite), 一律用 normV.
+let normC = (v, k) => (k === 'from' ? normV(v) : JSON.stringify(v === undefined || v === null ? '' : v))
+
+
 /**
  * 判斷是否為外部列(from 為非空字串)
  *
@@ -85,15 +91,17 @@ function restoreExternalOrder(rows, ltdtOld) {
  * 將「外部列且僅伺服器管理欄(建立者／時間、更新者／時間)不同」之 diff 列移入 same(視為無變更, 不寫入)
  *
  * 外部同步每次整來源重寫, 使外部列之 timeUpdate／timeCreate／userId 隨之更新; 持舊快照之後台存檔若原樣送回該列, 其內容與庫內相同而僅伺服器管理欄較舊,
- * 寫入會把建立者與建立時間回退為舊值(D2 設計稿 S2). 內容相同即無須寫入. 只處理外部列, 後台列之 diff 判定不變.
+ * 寫入會把建立者與建立時間回退為舊值(D2 設計稿 S2). 內容相同即無須寫入. 預設只處理外部列, 後台列之 diff 判定不變.
+ * all 為真時不分外部列或後台列一律處理(perm-run01: 寫入契約 serverOnly——伺服器專有欄位存檔不採用客戶端值, 規格第 4、6 節; R-CONTRACT-01).
  *
  * @param {Object} p 輸入參數物件
  * @param {Array} p.keys 輸入該表 schema 欄位名陣列
  * @param {Object} p.r 輸入 ltdtDiffByKey 結果 { add, del, diff, same }
  * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @param {Boolean} [p.all=false] 輸入是否不分外部列或後台列(預設只外部列)
  * @returns {Object} 回傳新之 { add, del, diff, same }
  */
-function dropServerOnlyDiff({ keys, r, ltdtOld }) {
+function dropServerOnlyDiff({ keys, r, ltdtOld, all = false }) {
     let oldById = new Map()
     ltdtOld.forEach((o) => {
         if (isObj(o) && isStr(o.id)) {
@@ -105,7 +113,7 @@ function dropServerOnlyDiff({ keys, r, ltdtOld }) {
     let same = [...r.same]
     r.diff.forEach((row) => {
         let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
-        if (o !== undefined && isExternalRow(o) && fields.every((k) => normV(row[k]) === normV(o[k]))) {
+        if (o !== undefined && (all === true || isExternalRow(o)) && fields.every((k) => normC(row[k], k) === normC(o[k], k))) {
             same.push(row)
         }
         else {
@@ -121,14 +129,16 @@ function dropServerOnlyDiff({ keys, r, ltdtOld }) {
  *
  * 伺服器管理欄由伺服器擁有(procOrm save 只覆寫 userIdUpdate／timeUpdate, 建立者與建立時間取自送入之列); 外部同步每次整來源重寫使外部列之建立者／建立時間更新,
  * 持舊草稿(前端保留未存編輯, 見 draftSync)送回該列時, 基準因排除伺服器管理欄而通過(內容未變), 若原樣寫入就把較新之建立者與建立時間回退為舊值(R-EXT-OWN-01 S2 之同一缺陷, 外審 sol 第 3 點).
- * 故改動之外部列一律以庫內之伺服器管理欄寫入. 只處理庫內為外部列者(後台列之寫入不變); 庫內無該欄者不補.
+ * 故改動之外部列一律以庫內之伺服器管理欄寫入. 預設只處理庫內為外部列者(後台列之寫入不變); 庫內無該欄者(歷史列)不補、亦不採用客戶端送入之值(刪除該欄, 保留庫內值＝仍無該欄; perm-run01 外審 sol#3).
+ * all 為真時不分外部列或後台列一律處理(perm-run01: 寫入契約 serverOnly, 見 dropServerOnlyDiff).
  *
  * @param {Object} p 輸入參數物件
  * @param {Object} p.r 輸入 ltdtDiffByKey(及 dropServerOnlyDiff)結果 { add, del, diff, same }
  * @param {Array} p.ltdtOld 輸入該表庫內全部列
+ * @param {Boolean} [p.all=false] 輸入是否不分外部列或後台列(預設只外部列)
  * @returns {Object} 回傳新之 { add, del, diff, same }(不改輸入; 未改動之列為同一物件)
  */
-function restoreServerFields({ r, ltdtOld }) {
+function restoreServerFields({ r, ltdtOld, all = false }) {
     let oldById = new Map()
     ltdtOld.forEach((o) => {
         if (isObj(o) && isStr(o.id)) {
@@ -137,7 +147,7 @@ function restoreServerFields({ r, ltdtOld }) {
     })
     let diff = r.diff.map((row) => {
         let o = isObj(row) && isStr(row.id) ? oldById.get(row.id) : undefined
-        if (o === undefined || !isExternalRow(o)) {
+        if (o === undefined || (all !== true && !isExternalRow(o))) {
             return row
         }
         let out = { ...row }
@@ -145,6 +155,10 @@ function restoreServerFields({ r, ltdtOld }) {
             if (hasOwn(o, k)) {
                 out[k] = o[k]
             }
+            else {
+                //庫內無該欄(歷史列): 不採用客戶端送入之值(寫入契約 serverOnly: 保留庫內值＝仍無該欄; 外審 sol#3, 2026-10-23)
+                delete out[k]
+            }
         })
         return out
     })
@@ -182,6 +196,9 @@ function checkExternalWrite({ keyTable, keys, r, ltdtOld, lockExternalRows = tru
         bad.push({ key, reason, k, from: isStr(from) ? from : '' })
     }
 
+    //srcKey: 外部匯入之來源鍵為身分欄(與 from 同; perm-run03, R-IMPORT-01), 只由匯入端點寫入, 後台不可新增帶值之列、不可改既有列之值(不論 lockExternalRows; 缺欄／null／'' 同一空值)
+    let normSrc = (v) => (v === undefined || v === null ? '' : v)
+
     //add
     r.add.forEach((row, k) => {
         let f = isObj(row) ? normFrom(row.from) : ''
@@ -191,6 +208,9 @@ function checkExternalWrite({ keyTable, keys, r, ltdtOld, lockExternalRows = tru
         else if (lockExternalRows && f !== '') {
             push('saveFromNotAllowed', 'addFrom', k, f)
         }
+        else if (isObj(row) && normSrc(row.srcKey) !== '') {
+            push('saveFromNotAllowed', 'addSrcKey', k, '')
+        }
     })
 
     //del
@@ -211,6 +231,10 @@ function checkExternalWrite({ keyTable, keys, r, ltdtOld, lockExternalRows = tru
             push('saveFromNotAllowed', 'fromType', k, '')
             return
         }
+        if (o !== undefined && isObj(row) && normSrc(row.srcKey) !== normSrc(o.srcKey)) {
+            push(isExternalRow(o) ? 'saveExternalRowChanged' : 'saveFromNotAllowed', 'srcKeyChanged', k, isExternalRow(o) ? o.from : '')
+            return
+        }
         if (!lockExternalRows || o === undefined) {
             return
         }
@@ -218,7 +242,7 @@ function checkExternalWrite({ keyTable, keys, r, ltdtOld, lockExternalRows = tru
             if (nf !== o.from) {
                 push('saveExternalRowChanged', 'fromChanged', k, o.from)
             }
-            else if (lockFields.some((f) => normV(row[f]) !== normV(o[f]))) {
+            else if (lockFields.some((f) => normC(row[f], f) !== normC(o[f], f))) {
                 push('saveExternalRowChanged', 'fieldChanged', k, o.from)
             }
         }
@@ -262,5 +286,5 @@ function hasExternalDiff({ r, ltdtOld }) {
 }
 
 
-export { SERVER_FIELDS, ASSIGN_FIELD, isExternalRow, getLockFields, restoreExternalOrder, dropServerOnlyDiff, restoreServerFields, checkExternalWrite, hasExternalDiff }
+export { SERVER_FIELDS, ASSIGN_FIELD, isExternalRow, getLockFields, restoreExternalOrder, dropServerOnlyDiff, restoreServerFields, checkExternalWrite, hasExternalDiff, normC }
 export default isExternalRow