Skip to content

[feature] Simpany 薪資申報同步與欠薪對帳 - #73

Merged
YJack0000 merged 3 commits into
mainfrom
claude/simpany-salary
Sep 28, 2026
Merged

YJack0000 merged 3 commits into
mainfrom
claude/simpany-salary

Conversation

@YJack0000

Copy link
Copy Markdown
Contributor

Simpany 整合加上唯讀的薪資申報:

  • SimpanyClient.listSalaryMonthlyForms / getSalaryForm(沿用自動登入與 token 快取),全部經 assertSalaryReadOnly:只允許 GET、路徑與 query 白名單。
  • 只解析需要的欄位:身分證字號、地址、國籍一律不讀、不存、不回傳。
  • migration 0027:simpany_salary_forms(每月一列,區分未建立/表單空白/已申報)與 simpany_salary_declarations(每人每月申報金額)。
  • salary_arrears:以申報的實際發薪為應發、以薪資交易與薪資單為已發,依付款日 FIFO 沖最舊的月份;未申報月份以最近一次申報推估並標示 estimated;對不到員工的薪資支出列為待指派。
  • MCP:simpany_list_salary_declarations、simpany_sync_salary_declarations、salary_arrears(server 1.7.0)。
  • 薪資頁新增「Simpany 薪資申報」區塊。

部署前:prod 需先套用 migration 0027。

驗證:tsc、lint、build 通過。

- SimpanyClient.listSalaryMonthlyForms / getSalaryForm,assertSalaryReadOnly(GET + 路徑/query 白名單)
- 解析時丟掉身分證字號 / 地址 / 國籍;薪資錯誤訊息不附 body 片段
- migration 0027:simpany_salary_forms(月份狀態)+ simpany_salary_declarations(員工 × 月)
- src/lib/simpany-salary.ts:冪等同步、salaryReconciliation(payslip 期別優先 + FIFO,未申報月份估計另計)
- MCP:simpany_list_salary_declarations、simpany_sync_salary_declarations、salary_arrears;SERVER_VERSION 1.7.0
- 薪資頁 Simpany 薪資申報區塊:月份格、欠薪表、明細 Sheet、未指定員工的薪資支出;zh-TW / en
- docs:integrations.md、mcp.md
@github-actions

github-actions Bot commented Sep 28, 2026 •

Copy link
Copy Markdown

✅ SonarQube Quality Gate passed — pathorsAI_internal

0 open issues on this PR.

@YJack0000
YJack0000 merged commit 7273249 into main Sep 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants