w-web-perm 1.0.48 → 1.0.50

package/docs/WWebPerm.mjs.html

@@ -48,10 +48,8 @@
             <pre class="prettyprint source linenums"><code>import path from 'path'
 import fs from 'fs'
 import get from 'lodash-es/get.js'
-import each from 'lodash-es/each.js'
 import map from 'lodash-es/map.js'
 import keys from 'lodash-es/keys.js'
-import size from 'lodash-es/size.js'
 import join from 'lodash-es/join.js'
 import iseobj from 'wsemi/src/iseobj.mjs'
 import isestr from 'wsemi/src/isestr.mjs'
@@ -70,15 +68,16 @@ import fsIsFolder from 'wsemi/src/fsIsFolder.mjs'
 import fsIsFile from 'wsemi/src/fsIsFile.mjs'
 import replace from 'wsemi/src/replace.mjs'
 import strdelleft from 'wsemi/src/strdelleft.mjs'
-import haskey from 'wsemi/src/haskey.mjs'
-import arrHas from 'wsemi/src/arrHas.mjs'
-import ltdtDiffByKey from 'wsemi/src/ltdtDiffByKey.mjs'
 import ltdtmapping from 'wsemi/src/ltdtmapping.mjs'
+import pmKeyMutex from 'wsemi/src/pmKeyMutex.mjs'
 import WServHapiServer from 'w-serv-hapi/src/WServHapiServer.mjs'
 import WServOrm from 'w-serv-orm/src/WServOrm.mjs'
 import ds from '../src/schema/index.mjs'
 import { getUserRules } from '../src/plugins/mShare.mjs'
+import procCore from './procCore.mjs'
 import procLang from './procLang.mjs'
+import srLogInit from './srLog.mjs'
+import procStaInfor from './procStaInfor.mjs'
 
 
 /**
@@ -88,7 +87,7 @@ import procLang from './procLang.mjs'
  * @param {Function} WOrm 輸入資料庫ORM函數
  * @param {String} url 輸入資料庫連線字串，例如w-orm-lmdb為'./db'，或w-orm-mongodb為'mongodb://username:password@$127.0.0.1:27017'
  * @param {String} db 輸入資料庫名稱字串
- * @param {Function} getUserByToken 輸入處理函數，函數會傳入使用者token，通過此函數處理後並回傳使用者資訊物件，並至少須提供'id'、'email'、'name'、'isAdmin'欄位，且'isAdmin'限輸入'y'或'n'，且輸入'y'時會複寫權限系統該使用者之'isAdmin'欄位值
+ * @param {Function} getUserByToken 輸入處理函數，函數會傳入使用者token，通過此函數處理後並回傳使用者資訊物件，並至少須提供'id'、'email'、'name'、'isAdmin'欄位，且'isAdmin'限輸入'y'或'n'。注意: token 回傳之'isAdmin'僅供識別，權限系統一律以自身users表該使用者之'isAdmin'欄位值為權威，不會被 token 宣稱之值複寫
  * @param {Function} verifyClientUser 輸入驗證瀏覽使用者身份之處理函數，函數會傳入使用者資訊物件，通過此函數識別後回傳布林值，允許使用者回傳true，反之回傳false
  * @param {Function} verifyAppUser 輸入驗證應用程序使用者身份之處理函數，函數會傳入使用者資訊物件，通過此函數識別後回傳布林值，允許使用者回傳true，反之回傳false
  * @param {Object} [opt={}] 輸入設定物件，預設{}
@@ -315,6 +314,10 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
     let kpLang = procLang({ kpLangExt, webName, webDescription })
 
 
+    //srLog
+    let srLog = srLogInit(opt)
+
+
     //WServOrm
     let optWServOrm = {
         useCheckUser,
@@ -327,12 +330,35 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
     }
     catch (err) {
         console.log(err)
+        srLog.error({ event: 'WServOrm-init-error', msg: (err &amp;&amp; err.message) || 'WServOrmInitFailed' })
+        throw err //fail-fast: ORM 初始化失敗直接終止啟動, 不以 wp={} 繼續組裝出「port 起得來但 woItems/procOrm 為 undefined、CRUD 全 crash」的半死伺服器
     }
     let { woItems, procOrm } = wp
 
 
+    //pmKeyMutex: per-key in-memory mutex, 同 key 序列化、不同 key 並行.
+    //perm 為「整表批次 diff」寫入, key 粒度為 {op}:{keyTable}, 防同表並行 race (lost update).
+    let kmx = pmKeyMutex()
+
+
+    //procCore: 整表批次 diff 寫入邏輯 (updateTabItems + updateTargets/Pemis/Grups/Users)
+    let pc = procCore(woItems, procOrm, { srLog, kmx })
+
+
+    //procStaInfor: 統計資訊, fdLog 對齊 srLog 使用同一目錄(讀 settings.logFd, fallback 邏輯同 srLog.mjs); mock 由 settings.staEventMock 注入(e2e 統計圖穩定用)
+    let logFd = get(opt, 'logFd', '')
+    if (!isestr(logFd)) {
+        logFd = './_logs'
+    }
+    let psi = procStaInfor({ fdLog: logFd, mock: get(opt, 'staEventMock', false) })
+
+
     //getWebInfor
     let getWebInfor = (userId) => {
+
+        //info
+        srLog.info({ event: 'getWebInfor-success', userId })
+
         return {
 
             // webName, //已併入kpLang
@@ -395,162 +421,32 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
     // }
 
 
-    //updateTabItems
-    let updateTabItems = async (keyTable, userId, rows, keyDetect) => {
-        // console.log('updateTabItems', keyTable, userId, rows.length, keyDetect)
-
-        //ltdtmapping
-        rows = ltdtmapping(rows, ds[keyTable].keys)
-        // console.log('ltdtmapping rows', rows)
-
-        //重給order
-        rows = map(rows, (r, k) => {
-            r.order = k + 1
-            return r
-        })
-
-        //ckKey
-        let ckKey = (rows, key) => {
-            let err = null
-
-            //check
-            let kp = {}
-            each(rows, (v, k) => {
-
-                //value
-                let value = get(v, key, '')
-
-                //check
-                if (!isestr(value)) {
-                    err = `rows[${k}].${key} is not an effective string`
-                    return false //跳出
-                }
-
-                //check
-                if (haskey(kp, value)) {
-                    err = `rows[${k}].${key}[${value}] is duplicate`
-                    return false //跳出
-                }
-
-                //kp
-                kp[value] = true
-
-            })
-
-            return err
-        }
-
-        //偵測未給予或重複
-        let err = null
-        if (true) {
-            if (arrHas(keyTable, ['targets'])) {
-                err = ckKey(rows, 'id')
-                if (err !== null) {
-                    return Promise.reject(err)
-                }
-            }
-            if (arrHas(keyTable, ['pemis', 'grups'])) { //users可重複name故不列入
-                err = ckKey(rows, 'name')
-                if (err !== null) {
-                    return Promise.reject(err)
-                }
-            }
-            if (arrHas(keyTable, ['users'])) {
-                err = ckKey(rows, 'email')
-                if (err !== null) {
-                    return Promise.reject(err)
-                }
-            }
-        }
-
-        //ltdtDiffByKey
-        let ltdtOld = await woItems[keyTable].select()
-        let ltdtNew = rows
-        let r = ltdtDiffByKey(ltdtOld, ltdtNew, keyDetect)
-        // console.log('ltdtDiffByKey r', r)
-
-        //del
-        if (size(r.del) > 0) {
-            await procOrm(userId, keyTable, 'del', r.del) //須使用procOrm才有辦法自動給予相關欄位
-            // .catch((err) => {
-            //     console.log('woItems[keyTable].del err', err)
-            // })
-        }
-
-        //add
-        if (size(r.add) > 0) {
-            await procOrm(userId, keyTable, 'insert', r.add) //須使用procOrm才有辦法自動給予相關欄位
-            // .catch((err) => {
-            //     console.log('woItems[keyTable].insert err', err)
-            // })
-        }
-
-        //diff
-        if (size(r.diff) > 0) {
-            await procOrm(userId, keyTable, 'save', r.diff) //須使用procOrm才有辦法自動給予相關欄位
-            // .catch((err) => {
-            //     console.log('woItems[keyTable].save err', err)
-            // })
-        }
-
-        return ltdtNew
-    }
-
-
-    //updateTargets
-    let updateTargets = async (userId, rows) => {
-        rows = await updateTabItems('targets', userId, rows, 'id')
-        return rows
-    }
-
-
-    //updatePemis
-    let updatePemis = async (userId, rows) => {
-        rows = await updateTabItems('pemis', userId, rows, 'name')
-        return rows
-    }
-
-
-    //updateGrups
-    let updateGrups = async (userId, rows) => {
-        rows = await updateTabItems('grups', userId, rows, 'name')
-        return rows
-    }
-
-
-    //updateUsers
-    let updateUsers = async (userId, rows) => {
-        rows = await updateTabItems('users', userId, rows, 'id')
-        return rows
-    }
-
-
     //checkUser
     let checkUser = async(user) => {
         let id = get(user, 'id', '')
         if (!isestr(id)) {
             console.log('user', user)
-            console.log('can not get the userId')
-            return Promise.reject(`can not get the userId`)
+            srLog.error({ event: 'checkUser-error', msg: 'cannotGetUserId' })
+            return Promise.reject(`cannotGetUserId`)
         }
         let email = get(user, 'email', '')
         if (!isestr(email)) {
             console.log('user', user)
-            console.log('can not get the email of user')
-            return Promise.reject(`can not get the email of user`)
+            srLog.error({ event: 'checkUser-error', msg: 'cannotGetUserEmail' })
+            return Promise.reject(`cannotGetUserEmail`)
         }
         let name = get(user, 'name', '')
         if (!isestr(name)) {
             console.log('user', user)
-            console.log('can not get userName')
-            return Promise.reject(`can not get userName`)
+            srLog.error({ event: 'checkUser-error', msg: 'cannotGetUserName' })
+            return Promise.reject(`cannotGetUserName`)
         }
         let isAdmin = get(user, 'isAdmin', '')
         if (isAdmin !== 'y' &amp;&amp; isAdmin !== 'n') {
             console.log('user', user)
             console.log('user.isAdmin is not y or n', user.isAdmin)
-            console.log('can not get the role of user')
-            return Promise.reject(`can not get the role of user`)
+            srLog.error({ event: 'checkUser-error', msg: 'cannotGetUserRole' })
+            return Promise.reject(`cannotGetUserRole`)
         }
         return true
     }
@@ -573,8 +469,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!iseobj(userSelf)) {
             console.log(`token`, token)
-            console.log(`can not find the user from token`)
-            return Promise.reject(`can not find the user from token`)
+            srLog.error({ event: 'getTokenUser-error', msg: 'cannotFindUserFromToken' })
+            return Promise.reject(`cannotFindUserFromToken`)
         }
 
         //check userSelf
@@ -588,8 +484,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         if (!isestr(vSelf)) {
             console.log('userSelf', userSelf)
             console.log('mappingBy', mappingBy)
-            console.log('can not get the prop of user by mappingBy')
-            return Promise.reject(`can not get the prop of user by mappingBy`)
+            srLog.error({ event: 'getTokenUser-error', msg: 'cannotGetUserProp', mappingBy })
+            return Promise.reject(`cannotGetUserProp`)
         }
 
         //userFind
@@ -601,17 +497,14 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         if (!iseobj(userFind)) {
             console.log('userSelf', userSelf)
             console.log('mappingBy', mappingBy)
-            console.log('can not get the user from perm')
-            return Promise.reject(`can not get the user from perm`)
+            srLog.error({ event: 'getTokenUser-error', msg: 'cannotGetUserFromPerm', mappingBy })
+            return Promise.reject(`cannotGetUserFromPerm`)
         }
 
-        //複寫isAdmin
-        let isAdminSrc = get(userSelf, 'isAdmin', '')
-        let isAdminSelf = get(userFind, 'isAdmin', '')
-        if (isAdminSrc !== isAdminSelf) {
-            userFind.isAdmin = isAdminSelf
-        }
-        // console.log('userFind(isAdmin)', userFind)
+        //isAdmin 權威為 perm users 表之欄位值, 不以 token(getUserByToken)宣稱之 isAdmin 複寫。
+        //(2026-07-11 稽核 A-C1 裁決(b): 原此處有一段恆為 no-op 之「複寫isAdmin」死碼
+        // (userFind.isAdmin = isAdminSelf, 把自己指派給自己), 與 JSDoc 舊文「輸入'y'時會複寫」互斥;
+        // 依業主裁決採保守解: 刪除死碼、文件對齊實際行為, 不啟用 token→admin 提權路徑。)
 
         return userFind
     }
@@ -649,8 +542,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!b) {
             console.log('user', user)
-            console.log(`user does not have permission`)
-            return Promise.reject(`user does not have permission`)
+            srLog.error({ event: 'getAndVerifyClientUser-error', msg: 'userNoPermission', from })
+            return Promise.reject(`userNoPermission`)
         }
 
         return user
@@ -674,8 +567,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!iseobj(user)) {
             console.log(`token`, token)
-            console.log(`can not find the user from token`)
-            return Promise.reject(`can not find the user from token`)
+            srLog.error({ event: 'getAndVerifyAppUser-error', msg: 'cannotFindUserFromToken' })
+            return Promise.reject(`cannotFindUserFromToken`)
         }
 
         //verifyAppUser
@@ -687,8 +580,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!b) {
             console.log('user', user)
-            console.log(`user does not have permission`)
-            return Promise.reject(`user does not have permission`)
+            srLog.error({ event: 'getAndVerifyAppUser-error', msg: 'userNoPermission', from })
+            return Promise.reject(`userNoPermission`)
         }
 
         return user
@@ -709,8 +602,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!iseobj(payload)) {
             console.log('payload', payload)
-            console.log('invalid payload in req')
-            return Promise.reject(`invalid payload in req`)
+            srLog.error({ event: 'parsePayload-error', msg: 'invalidPayload' })
+            return Promise.reject(`invalidPayload`)
         }
 
         //from
@@ -719,8 +612,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!isestr(from)) {
             console.log('payload', payload)
-            console.log('invalid from in payload')
-            return Promise.reject(`invalid from in payload`)
+            srLog.error({ event: 'parsePayload-error', msg: 'invalidFromInPayload' })
+            return Promise.reject(`invalidFromInPayload`)
         }
 
         //rows
@@ -729,8 +622,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!isearr(rows)) {
             console.log('payload', payload)
-            console.log(`invalid rows in payload`)
-            return Promise.reject(`invalid rows in payload`)
+            srLog.error({ event: 'parsePayload-error', msg: 'invalidRowsInPayload' })
+            return Promise.reject(`invalidRowsInPayload`)
         }
 
         //inp
@@ -746,6 +639,9 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
     //syncAndReplaceTabs
     let syncAndReplaceTabs = async (userId, inp, keyTable) => {
 
+        //序列化同表之並行整表 delAll+insert: 防 lost update (同 keyTable 序列化, 不同表並行)
+        return await kmx('syncAndReplaceTabs:' + keyTable, async () => {
+
         //from
         let from = get(inp, 'from', '')
         // console.log('from', from)
@@ -753,8 +649,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!isestr(from)) {
             console.log('inp', inp)
-            console.log(`invalid from`)
-            return Promise.reject(`invalid from`)
+            srLog.error({ event: 'syncAndReplaceTabs-error', msg: 'invalidFrom', keyTable })
+            return Promise.reject(`invalidFrom`)
         }
 
         //rows
@@ -765,7 +661,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         if (!isearr(rows)) {
             console.log('inp', inp)
             console.log('keyTable', keyTable)
-            return Promise.reject(`invalid rows`)
+            srLog.error({ event: 'syncAndReplaceTabs-error', msg: 'invalidRows', keyTable })
+            return Promise.reject(`invalidRows`)
         }
 
         //save from
@@ -788,6 +685,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         // console.log('r', r)
 
         return r
+
+        })
     }
 
 
@@ -848,8 +747,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
         //check
         if (!iseobj(kur)) {
             console.log('userId', userId)
-            console.log(`can not get rules of user`)
-            return Promise.reject(`can not get rules of user`)
+            srLog.error({ event: 'getGenUserAndRulesByUserId-error', msg: 'cannotGetUserRules', userId })
+            return Promise.reject(`cannotGetUserRules`)
         }
 
         //grupsNames
@@ -923,8 +822,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('token', token)
                         console.log('[API]getUserByToken/check token: invalid token')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getUserByToken-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //getAndVerifyClientUser
@@ -935,10 +834,13 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     if (!iseobj(user)) {
                         console.log('token', token)
                         console.log('[API]getUserByToken/check user: invalid user')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getUserByToken-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
+                    //info
+                    srLog.info({ event: 'api/getUserByToken-success', userId: get(user, 'id', '') })
+
                     return user
                 }
 
@@ -970,8 +872,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('token', token)
                         console.log('[API]getPerm/check token: invalid token')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPerm-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //getAndVerifyClientUser, 發起token的所屬使用者, 驗證僅對client使用者, 不得使用app使用者
@@ -982,8 +884,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     if (!iseobj(userSelf)) {
                         console.log('token', token)
                         console.log('[API]getPerm/check userSelf: invalid userSelf')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPerm-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //userIdSelf, client使用者的userId
@@ -995,8 +897,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('token', token)
                         console.log('userSelf', userSelf)
                         console.log('[API]getPerm/check userIdSelf: invalid userIdSelf')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPerm-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //getGenUserAndRulesByUserId, 查找到的client使用者與權限
@@ -1009,10 +911,13 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('userSelf', userSelf)
                         console.log('userIdSelf', userIdSelf)
                         console.log('[API]getPerm/check userWithRulesSelf: invalid userWithRulesSelf')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPerm-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
+                    //info
+                    srLog.info({ event: 'api/getPerm-success', userId: userIdSelf })
+
                     return userWithRulesSelf
                 }
 
@@ -1043,8 +948,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     if (!isestr(tokenSelf)) {
                         console.log('req.query', get(req, 'query'))
                         console.log('[API]getPermUserInfor/check tokenSelf: invalid tokenSelf')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPermUserInfor-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //getAndVerifyAppUser, 發起token的所屬使用者, 驗證須為app使用者
@@ -1056,8 +961,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('tokenSelf', tokenSelf)
                         console.log('[API]getPermUserInfor/check userSelf: invalid userSelf')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPermUserInfor-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //userIdFind, 欲查找使用者的userId
@@ -1069,8 +974,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('tokenSelf', tokenSelf)
                         console.log('[API]getPermUserInfor/check userIdFind: invalid userIdFind')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/getPermUserInfor-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //getGenUserAndRulesByUserId, 查找到的使用者與權限
@@ -1081,10 +986,13 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     if (!iseobj(userWithRulesFind)) {
                         console.log('userIdFind', userIdFind)
                         console.log('[API]getPermUserInfor/check userWithRulesFind: invalid userWithRulesFind')
-                        console.log(`userId does not have permrules`)
-                        return Promise.reject(`userId does not have permrules`)
+                        srLog.error({ event: 'api/getPermUserInfor-error', msg: 'userIdNoPermrules' })
+                        return Promise.reject(`userIdNoPermrules`)
                     }
 
+                    //info
+                    srLog.info({ event: 'api/getPermUserInfor-success', userId: userIdFind })
+
                     return userWithRulesFind
                 }
 
@@ -1116,8 +1024,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('token', token)
                         console.log('[API]syncAndReplaceTabs/check token: invalid token')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/syncAndReplaceTabs-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //keyTable
@@ -1128,15 +1036,16 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('req.query', get(req, 'query'))
                         console.log('keyTable', keyTable)
                         console.log('[API]syncAndReplaceTabs/check keyTable: invalid keyTable')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/syncAndReplaceTabs-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //check keyTable
                     let allowedTables = ['targets', 'pemis', 'grups', 'users']
                     if (!allowedTables.includes(keyTable)) {
                         console.log('[API]syncAndReplaceTabs/check keyTable: unexpected keyTable', keyTable)
-                        return Promise.reject(`invalid keyTable: ${keyTable}`)
+                        srLog.error({ event: 'api/syncAndReplaceTabs-error', msg: 'invalidKeyTable', keyTable })
+                        return Promise.reject(`invalidKeyTable`)
                     }
 
                     //getAndVerifyAppUser
@@ -1146,8 +1055,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     if (!iseobj(user)) {
                         console.log('token', token)
                         console.log('[API]syncAndReplaceTabs/check user: invalid user')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/syncAndReplaceTabs-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //userId
@@ -1158,8 +1067,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                         console.log('token', token)
                         console.log('user', user)
                         console.log('[API]syncAndReplaceTabs/check userId: invalid userId')
-                        console.log(`token does not have permission`)
-                        return Promise.reject(`token does not have permission`)
+                        srLog.error({ event: 'api/syncAndReplaceTabs-error', msg: 'tokenNoPermission' })
+                        return Promise.reject(`tokenNoPermission`)
                     }
 
                     //parsePayload
@@ -1168,6 +1077,9 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
                     //syncAndReplaceTabs
                     let r = await syncAndReplaceTabs(userId, inp, keyTable)
 
+                    //info
+                    srLog.info({ event: 'api/syncAndReplaceTabs-success', userId, keyTable })
+
                     return r
                 }
 
@@ -1194,7 +1106,7 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
 
     //WServHapiServer
     instWServHapiServer = new WServHapiServer({
-        port: opt.serverPort,
+        port: serverPort,
         pathStaticFiles,
         apiName: 'api',
         apis,
@@ -1218,6 +1130,21 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
             let b = await p.checkToken(token)
             // console.log('b', b)
 
+            //ip, 對齊sso慣例x-forwarded-for取第1個, fallback到req remoteAddress, 取不到則略過
+            let ip = get(headers, 'x-forwarded-for', '').split(',')[0].trim()
+            if (!isestr(ip)) {
+                ip = get(req, 'info.remoteAddress', '') || get(req, 'socket.remoteAddress', '') || get(req, 'connection.remoteAddress', '')
+            }
+
+            //origin
+            let origin = get(headers, 'origin', '')
+
+            //referer
+            let referer = get(headers, 'referer', '')
+
+            //info
+            srLog.info({ event: 'verifyConn', ok: b, apiType, ip, origin, referer })
+
             return b
         },
         getUserIdByToken: async (token) => { //可使用async或sync函數
@@ -1227,7 +1154,8 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
             if (!isestr(userId)) {
                 console.log('token', token)
                 console.log('userId', userId)
-                return Promise.reject(`can not find user.id`)
+                srLog.error({ event: 'getUserIdByToken-error', msg: 'cannotFindUserId' })
+                return Promise.reject(`cannotFindUserId`)
             }
             return userId
         },
@@ -1247,10 +1175,34 @@ function WWebPerm(WOrm, url, db, getUserByToken, verifyClientUser, verifyAppUser
             // getGrupsList,
             // getUsersList,
 
-            updateTargets,
-            updatePemis,
-            updateGrups,
-            updateUsers,
+            updateTargets: pc.updateTargets,
+            updatePemis: pc.updatePemis,
+            updateGrups: pc.updateGrups,
+            updateUsers: pc.updateUsers,
+
+            getStaEvent: async (userId, timeLength, timeInterval) => {
+                try {
+                    let rs = await psi.getStaEvent(userId, timeLength, timeInterval)
+                    srLog.info({ event: 'getStaEvent-success', userId })
+                    return rs
+                }
+                catch (err) {
+                    srLog.error({ event: 'getStaEvent-error', userId, msg: (typeof err === 'string') ? err : ((err &amp;&amp; err.message) || 'cannotGetStaEvent') })
+                    throw err
+                }
+            },
+
+            getStaEventTable: async (userId) => {
+                try {
+                    let rs = await psi.getStaEventTable(userId)
+                    srLog.info({ event: 'getStaEventTable-success', userId })
+                    return rs
+                }
+                catch (err) {
+                    srLog.error({ event: 'getStaEventTable-error', userId, msg: (typeof err === 'string') ? err : ((err &amp;&amp; err.message) || 'cannotGetStaEventTable') })
+                    throw err
+                }
+            },
 
         },
         fnTableTags: 'tableTags-web-perm.json',
@@ -1276,7 +1228,7 @@ export default WWebPerm
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.4</a> on Sun Mar 29 2026 22:04:12 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Thu Jul 23 2026 11:17:11 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>