薪工循環

薪工循環操作手冊

本手冊涵蓋 iDempiere ERP 行動 App 中薪工循環（Payroll Cycle）的所有模組操作說明，包含薪資明細、假別管理、班別排程、出勤記錄、請假申請，以及員工互動模組（投票系統、成就徽章、任務看板、通知偏好、我的頁面）。共計 12 個畫面，完整覆蓋人力資源管理需求。

模組總覽

薪資明細（Payslip）

查看各期薪資的 29 項明細，涵蓋底薪、出勤、加班、津貼、扣除與合計六大區塊。資料表為 HR_PayrollLine。

假別餘額（Leave Balance Dashboard）

自訂儀表板顯示 18 種台灣法定假別的年度餘額，整合年假額度、人事調整與請假記錄三個資料來源。

假別調整（Leave Adjustment）

管理假別調整記錄，支援文件動作（完成/作廢）與狀態篩選。資料表為 HR_Adjustment。

班別定義（Shift Definition）

定義各班別的上下班時間、休息時間與輪班津貼。資料表為 HR_Shift。

輪班排程（Rotating Shift）

將員工指派至特定班別，設定有效期間。資料表為 HR_RotatingShift。

打卡紀錄（Punch Card）

查看員工出勤打卡記錄，含打卡時間、地點與訊息。資料表為 RV_HR_Card（唯讀檢視）。

請假申請（Leave Application）

員工自助請假，選擇假別、起迄日期，系統自動計算天數。支援送簽與作廢操作。

一、薪資明細（Payslip）

薪資明細畫面提供完整的薪資條查閱功能，包含 29 項欄位，依六大區塊分類呈現。所有金額欄位以貨幣格式顯示。

薪資明細欄位

區塊 欄位名稱 說明
基本資訊 AD_User_ID 員工姓名（關聯查詢）
HR_PayrollSummary_ID 薪資期間（關聯查詢）
BaseSalary 底薪
HourlyRate 時薪
出勤 WorkDays 出勤天數
PersonalLeaveHours 事假時數
SickLeaveHours 病假時數
UnusedAnnualLeave 未使用特休天數
加班 WeekdayOvertimeHours 平日加班時數
HolidayOvertimeHours 假日加班時數
TotalOvertimeAllowance 加班津貼合計
津貼 MealAllowance 伙食津貼
ChildCareAllowance 育兒津貼
ShiftAllowance 輪班津貼
ProjectAllowance 專案津貼
HousingAllowance 住宿津貼
NightTransportationAllowance 夜班交通津貼
SpecialBonus 特別獎金
扣除 LaborInsurance 勞工保險費
HealthInsurance 健康保險費
SalaryIncomeTax 薪資所得稅
WelfareFundContribution 福利金
Accommodation 宿舍扣款
合計 GrossPay 應發合計（底薪 + 加班 + 津貼）
Deductions 扣除合計
NetPay 實發金額（應發 – 扣除）
PensionContribution 公司提撥退休金
PensionSelfContribution 個人自提退休金

操作方式

  1. 從儀表板「薪工循環」分類進入「薪資明細」模組
  2. 列表顯示各期薪資記錄，依建立日期倒序排列
  3. 可依單據編號搜尋特定期間的薪資
  4. 點擊任一記錄查看 29 項薪資明細
  5. 明細頁面依六大區塊分類顯示，金額欄位以貨幣格式呈現
  6. 員工姓名與薪資期間為關聯查詢欄位，自動顯示名稱
  7. 此為唯讀畫面，薪資計算由 iDempiere 後台處理

二、假別餘額（Leave Balance Dashboard）

自訂假別餘額儀表板，整合三個資料來源（HR_Holiday 年假額度、HR_Adjustment 人事調整、HR_Transaction 請假記錄），三個 API 並行查詢後即時彙算，涵蓋台灣勞基法規定的 18 種假別。

18 種台灣法定假別

代碼 假別名稱 代碼 假別名稱
Y 特休（Annual Leave） Q 公傷病假（Work Injury Leave）
R 加班補休（Comp Time） G 公差（Official Leave）
E 事假（Personal Leave） M 婚假（Marriage Leave）
S 病假（Sick Leave） P 公假（Public Holiday）
Z 奬勵休假（Reward Leave） I 防疫接種隔離（Epidemic Prevention）
C 生理假（Menstrual Leave） A 陪產檢及陪產假（Paternity Leave）
D 喪假（Bereavement Leave） B 產假（Maternity Leave）
T 曠職（Absence） O 其它（Other）
K 產檢假（Prenatal Checkup） X 家庭照顧假（Family Care Leave）

畫面結構

📅
年度選擇器

頂部顯示年度（如 < 2026 >），點擊左右箭頭切換年份，即時重新計算該年度的假別餘額。

🎲
摘要卡片

上方顯示最常用三種假別（特休、加班補休、病假）的餘額摘要。綠色表示尚有餘額，紅色表示已用完。

📊
完整假別表格

DataTable 列出 18 種假別，每列包含：假別名稱、應有天數、已用天數、調整天數、剩餘天數。剩餘天數 = 應有 + 調整 – 已用。

資料計算公式

項目 資料來源 篩選條件
應有天數（Entitled） HR_Holiday AD_User_ID = 當前使用者
調整天數（Adjusted） HR_Adjustment AD_User_ID + 年度 + DocStatus=’CO’
已用天數（Used） HR_Transaction AD_User_ID + 年度 + IsClosed=true
剩餘天數（Remaining） 計算值 Entitled + Adjusted – Used

操作方式

  1. 從儀表板「薪工循環」分類進入「假別餘額」模組
  2. 畫面載入後顯示當年度假別餘額
  3. 點擊年度選擇器的左右箭頭切換年份
  4. 查看上方摘要卡片快速了解特休、補休、病假餘額
  5. 下方表格列出所有 18 種假別的詳細數據
  6. 點擊右上角重新整理按鈕可強制更新資料

三、假別調整（Leave Adjustment）

管理人事部門對員工假別的手動調整記錄。資料表為 HR_Adjustment，支援完整的文件動作流程。

主要欄位

欄位 說明
Description 調整說明（搜尋欄位）
AD_User_ID 員工姓名（關聯查詢）
LeaveType 假別類型
LeaveDays 調整天數（正數為增加，負數為扣除）
LeaveHours 調整時數
IsAutoGenerated 是否為系統自動產生
DocStatus 單據狀態（Draft / Complete / Void）

操作方式

  1. 從儀表板進入「假別調整」模組
  2. 列表顯示所有調整記錄，可依說明欄位搜尋
  3. 使用狀態篩選晶片（Draft / Complete / Void）篩選記錄
  4. 點擊查看調整明細：員工、假別、調整天數/時數
  5. 草稿狀態（Draft）的記錄可執行「完成」動作使調整生效
  6. 草稿狀態的記錄也可執行「作廢」動作取消調整
  7. 已完成的調整會自動反映在假別餘額儀表板中

四、班別定義（Shift Definition）

定義公司內各種班別的工作時間與相關福利。資料表為 HR_Shift。

主要欄位

欄位 說明
Name 班別名稱（如：早班、中班、晚班、大夜班）
WorkingHoursFrom 上班時間
WorkingHoursTo 下班時間
BreakTimeFrom 休息開始時間
BreakTimeTo 休息結束時間
ShiftAllowance 輪班津貼金額

操作方式

  1. 從儀表板進入「班別定義」模組
  2. 列表依班別名稱排序，顯示班別名稱、上下班時間、津貼
  3. 可依班別名稱搜尋
  4. 使用啟用狀態篩選晶片篩選
  5. 點擊查看完整班別定義：工作時間、休息時間、津貼金額
  6. 班別定義由管理員在 iDempiere 後台維護

五、輪班排程（Rotating Shift）

將員工指派至特定班別，設定有效期間，用於排班管理。資料表為 HR_RotatingShift。

主要欄位

欄位 說明
Name 排程名稱
AD_User_ID 員工姓名（關聯查詢）
HR_Shift_ID 指派班別（關聯查詢）
ValidFrom 有效起始日期
ValidTo 有效結束日期
WorkingHoursFrom 上班時間（可覆寫班別預設值）
WorkingHoursTo 下班時間（可覆寫班別預設值）
BreakTimeFrom 休息開始時間
BreakTimeTo 休息結束時間

操作方式

  1. 從儀表板進入「輪班排程」模組
  2. 列表顯示員工、班別、有效期間
  3. 可依名稱搜尋，使用啟用狀態篩選
  4. 點擊查看排程明細，含完整的上下班與休息時間
  5. 有效期間（ValidFrom/ValidTo）定義排程的適用範圍

六、打卡紀錄（Punch Card）

查看員工出勤打卡記錄，資料來源為 RV_HR_Card 唯讀檢視，僅供查閱。

主要欄位

欄位 說明
UserName 員工姓名
CardNumber 卡號
UserWorkNo 工號
ActionTime 打卡時間
Location 打卡地點
Message 訊息

操作方式

  1. 從儀表板進入「打卡紀錄」模組
  2. 列表依打卡時間倒序排列，顯示最新的打卡記錄
  3. 可依員工姓名或卡號搜尋
  4. 點擊查看完整打卡明細：員工、卡號、工號、時間、地點、訊息
  5. 此為唯讀檢視（RV_ 前綴），不支援新增或修改操作

七、請假申請（Leave Application）

員工自助請假功能，從 App 端直接建立請假單，系統自動計算請假天數，並透過文件動作流程進行簽核。

操作方式

  1. 從儀表板進入「請假申請」模組
  2. 點擊右上角「+」建立新的請假單
  3. 選擇假別類型（HR_LeaveType 下拉選單）
  4. 選擇請假起始日期與結束日期
  5. 系統自動計算請假天數
  6. 填寫請假說明（選填）
  7. 儲存後請假單為「草稿」狀態
  8. 點擊「送簽（Complete）」提交請假申請
  9. 如需取消，可在草稿狀態執行「作廢（Void）」
  10. 列表支援 Draft / Submitted / Void 狀態篩選晶片
  11. 返回鍵會觸發未儲存變更確認對話框，避免意外遺失

八、員工互動模組

員工互動模組透過遊戲化與社群功能提升員工參與度，包含 5 個子模組。後端需要 tw.ninniku.hrm iDempiere 插件提供 8 張資料表（TW_Poll, TW_PollOption, TW_PollVote, TW_Badge, TW_BadgeProgress, TW_Mission, TW_MissionVolunteer, TW_NotificationPref）。

8.1 投票系統（Poll）

🗳
投票列表

顯示所有進行中的投票，含標題、說明、截止日期。支援下拉刷新。

✅
投票參與

未投票者顯示選項清單（單選）+ 投票按鈕。已投票者顯示結果長條圖（票數與百分比）。

➕
建立投票

填寫標題、說明、截止日期、至少 2 個選項，可開啟匿名投票模式。

投票資料表

資料表 用途 主要欄位
TW_Poll 投票主檔 Name, Description, PollType, DeadLine, IsAnonymous
TW_PollOption 投票選項 TW_Poll_ID, Name, SeqNo
TW_PollVote 投票記錄 TW_Poll_ID, TW_PollOption_ID, AD_User_ID

操作方式

  1. 從儀表板「社群」分類或「我的頁面」進入「投票」模組
  2. 瀏覽進行中的投票清單
  3. 點擊投票卡片進入詳情頁面
  4. 如尚未投票，選擇一個選項後點擊「投票」按鈕
  5. 投票後自動顯示結果長條圖（各選項票數與百分比）
  6. 建立投票：點擊右下角浮動按鈕（+），填寫標題、說明、截止日期
  7. 新增至少 2 個選項（點擊「新增選項」按鈕）
  8. 如需匿名投票，開啟「匿名投票」開關
  9. 送出後投票即刻生效

8.2 成就徽章（Badge）

遊戲化徽章系統，依達成條件自動解鎖，分為四種稀有度等級。

稀有度分級

代碼 等級 色彩 說明
N 普通（Normal） 灰色 基礎成就，容易達成
R 稀有（Rare） 藍色 需要一定努力才能達成
E 史詩（Epic） 紫色 進階成就，較難達成
L 傳說（Legendary） 琥珀色 頂級成就，極難達成

徽章資料表

資料表 用途 主要欄位
TW_Badge 徽章定義 Name, Description, Icon, TargetValue, Rarity
TW_BadgeProgress 解鎖進度 AD_User_ID, TW_Badge_ID, CurrentValue, IsUnlocked, UnlockedDate

操作方式

  1. 從儀表板「社群」分類進入「徽章」模組
  2. 上方顯示已解鎖的徽章（彩色圖示 + 稀有度標籤）
  3. 下方顯示未解鎖的徽章（灰色圖示 + 進度條）
  4. 進度條顯示目前值 / 目標值，達成目標後自動解鎖
  5. 徽章解鎖邏輯由 iDempiere 伺服器端的 Model Validator 觸發

8.3 任務看板（Mission Board）

跨部門協作任務板，主管建立任務，員工志願報名參與。

任務狀態流程

角色 狀態代碼 狀態名稱 說明
任務 OP 開放（Open） 任務開放報名中
CL 關閉（Closed） 任務已結束
志工 O 待確認（Pending） 已報名，待主管確認
A 已接受（Accepted） 主管已核准
IP 進行中（In Progress） 正在執行任務
SB 已提交（Submitted） 成果已提交
CL 已結案（Closed） 任務完成結案

任務資料表

資料表 用途 主要欄位
TW_Mission 任務主檔 Name, Description, Difficulty (1-3), MaxVolunteers, DeadLine, Priority (H/N), Status (OP/CL)
TW_MissionVolunteer 志工記錄 TW_Mission_ID, AD_User_ID, Status (O/A/IP/SB/CL)

操作方式

  1. 從儀表板「社群」分類進入「任務看板」模組
  2. 看板分為兩區：上方為緊急任務（紅色標題，Priority=’H’），下方為一般任務
  3. 每張任務卡片顯示：名稱、難度星級（1-3 顆星）、志工人數（已報名/上限）、截止日期
  4. 點擊任務卡片進入詳情頁面
  5. 詳情頁面顯示任務說明、志工清單與狀態
  6. 名額未滿時點擊「報名」按鈕即可志願參與
  7. 建立任務：點擊右下角浮動按鈕（+），填寫名稱、說明、難度（滑桿 1-3）、志工上限、優先級、截止日期

8.4 通知偏好設定（Notification Preferences）

管理 7 類推播通知的開關設定，儲存於 TW_NotificationPref 資料表。

通知類型

通知類型 預設 說明
簽核通知 開啟 待簽核文件提醒
公告通知 開啟 公司公告推播
工作請求通知 開啟 工作請求狀態更新
投票通知 開啟 新投票建立提醒
徽章通知 開啟 徽章解鎖通知
任務通知 開啟 新任務發布提醒
生日/週年通知 關閉 同事生日與入職週年提醒

操作方式

  1. 從「設定」頁面 → 點擊「通知設定」進入
  2. 畫面顯示 7 個通知類型的開關
  3. 切換開關後自動儲存至伺服器（POST/PUT TW_NotificationPref）
  4. 無需手動按儲存按鈕

8.5 我的頁面（My Page）

個人化首頁，聚合多項資料來源，可取代預設的儀表板方格作為 App 首頁。

👋
時段問候語

依時段自動切換問候語（早安/午安/晚安）+ 使用者名稱 + 當日日期星期。

📊
摘要卡片

三張可點擊卡片：待簽核數（前往簽核列表）、徽章解鎖數/總數（前往徽章頁）、進行中投票數（前往投票列表）。

📰
動態內容區塊

最新公告（最多 3 則，來自 AD_Note）、進行中投票（最多 2 個）、開放任務（最多 2 個，含難度星級）。

操作方式

  1. 首頁模式設定為「我的頁面」後，開啟 App 即顯示個人首頁
  2. 切換方式：設定 → 首頁模式 → 選擇「我的頁面」
  3. 選擇後立即生效，重啟 App 後仍維持設定
  4. 摘要卡片可點擊前往對應功能頁面
  5. 動態區塊顯示最新資訊，自動從伺服器載入
  6. 如需切換回儀表板方格，在設定中選擇「儀表板」即可

技術與效能注意事項

⚡
伺服器端分頁

所有 Config-Driven 畫面採用 Document Framework 預設分頁（每頁 20 筆），確保列表載入效能。

🚀
並行 API 查詢

假別餘額儀表板透過 Future.wait 並行發送 3 個 API 查詢（HR_Holiday + HR_Adjustment + HR_Transaction），再於客戶端彙算。

🔒
FutureProvider 快取

假別餘額使用 FutureProvider.autoDispose，離開畫面時自動清除快取，下次進入重新載入最新資料。

👤
使用者識別

員工互動模組透過 tokenStorage.getUserId() 取得當前使用者 ID，tokenStorage.getLastUsername() 取得顯示名稱。

🌐 English Version

Payroll Cycle Operation Manual

This manual covers all modules in the Payroll Cycle of the iDempiere ERP mobile app, including Payslip, Leave Management, Shift Scheduling, Attendance Records, Leave Application, and Employee Engagement modules (Poll, Badge, Mission Board, Notification Preferences, My Page). A total of 12 screens for complete HR management.

Module Overview

Payslip

View 29-field payslip details covering base salary, attendance, overtime, allowances, deductions, and totals. Data table: HR_PayrollLine.

Leave Balance Dashboard

Custom dashboard showing annual leave balance for 18 Taiwan statutory leave types, integrating three data sources (entitlements, adjustments, usage).

Leave Adjustment

Manage leave adjustment records with document actions (Complete/Void) and status filters. Data table: HR_Adjustment.

Shift Definition

Define working hours, break times, and shift allowances for each shift type. Data table: HR_Shift.

Rotating Shift

Assign employees to specific shifts with validity periods. Data table: HR_RotatingShift.

Punch Card

View employee attendance punch card records (read-only). Data table: RV_HR_Card.

Leave Application

Employee self-service leave request with automatic day calculation and document action workflow.

1. Payslip

The Payslip screen provides comprehensive payroll viewing with 29 fields organized into six sections. All monetary fields display in currency format.

Payslip Field Structure

Section Fields
Basic Info Employee, Payroll Period, Base Salary, Hourly Rate
Attendance Work Days, Personal Leave Hours, Sick Leave Hours, Unused Annual Leave
Overtime Weekday Overtime Hours, Holiday Overtime Hours, Total Overtime Allowance
Allowances Meal, Child Care, Shift, Project, Housing, Night Transportation, Special Bonus
Deductions Labor Insurance, Health Insurance, Income Tax, Welfare Fund, Accommodation
Totals Gross Pay, Total Deductions, Net Pay, Company Pension, Self Pension

How to Use

  1. Navigate to “Payslip” from the Payroll Cycle category on the dashboard
  2. List shows payroll records sorted by creation date (newest first)
  3. Search by document number to find specific pay periods
  4. Tap any record to view the full 29-field payslip detail
  5. Details are organized into six sections with currency formatting
  6. This is a read-only screen; payroll calculations are processed in the iDempiere backend

2. Leave Balance Dashboard

Custom dashboard integrating three data sources (HR_Holiday, HR_Adjustment, HR_Transaction) via parallel API calls, covering 18 Taiwan statutory leave types.

18 Taiwan Statutory Leave Types

Code Leave Type Code Leave Type
Y Annual Leave Q Work Injury Leave
R Comp Time G Official Leave
E Personal Leave M Marriage Leave
S Sick Leave P Public Holiday
Z Reward Leave I Epidemic Prevention
C Menstrual Leave A Paternity Leave
D Bereavement Leave B Maternity Leave
T Absence O Other
K Prenatal Checkup X Family Care Leave

Calculation Formula

Item Data Source Filter
Entitled HR_Holiday AD_User_ID = current user
Adjusted HR_Adjustment AD_User_ID + year + DocStatus=’CO’
Used HR_Transaction AD_User_ID + year + IsClosed=true
Remaining Calculated Entitled + Adjusted – Used

How to Use

  1. Navigate to “Leave Balance” from the Payroll Cycle category
  2. The screen loads with the current year’s leave balances
  3. Tap left/right arrows on the year selector to switch years
  4. Summary cards at the top show balances for Annual Leave, Comp Time, and Sick Leave
  5. The table below lists all 18 leave types with Entitled / Used / Adjusted / Remaining columns
  6. Tap the refresh button to force-reload data from the server

3. Leave Adjustment

How to Use

  1. Navigate to “Leave Adjustment” from the dashboard
  2. List shows adjustment records; search by description
  3. Use status filter chips (Draft / Complete / Void) to filter records
  4. Tap to view details: Employee, Leave Type, Adjustment Days/Hours
  5. Draft records can be completed (to take effect) or voided (to cancel)
  6. Completed adjustments are automatically reflected in the Leave Balance Dashboard

4. Shift Definition

Field Description
Name Shift name (e.g., Morning, Afternoon, Night, Graveyard)
WorkingHoursFrom/To Start and end times for the shift
BreakTimeFrom/To Break period start and end times
ShiftAllowance Additional compensation amount for working this shift

5. Rotating Shift

How to Use

  1. Navigate to “Rotating Shift” from the dashboard
  2. List shows employees, assigned shifts, and validity periods
  3. Tap to view details including working hours and break times
  4. ValidFrom/ValidTo dates define the schedule’s effective range

6. Punch Card

How to Use

  1. Navigate to “Punch Card” from the dashboard
  2. Records are sorted by action time (newest first)
  3. Search by employee name or card number
  4. Tap to view details: Employee, Card Number, Work No., Action Time, Location, Message
  5. This is a read-only view (RV_ prefix); no create/update operations

7. Leave Application

How to Use

  1. Navigate to “Leave Application” from the dashboard
  2. Tap “+” to create a new leave request
  3. Select leave type from the HR_LeaveType dropdown
  4. Choose start and end dates; the system calculates days automatically
  5. Enter an optional description
  6. Save as Draft, then tap “Complete” to submit for approval
  7. Use “Void” to cancel a draft leave request
  8. List supports Draft / Submitted / Void status filter chips

8. Employee Engagement Module

8.1 Poll System

How to Use

  1. Navigate to “Poll” from the Social category on the dashboard
  2. Browse active polls in the list view
  3. Tap a poll card to enter the detail screen
  4. If not yet voted, select an option and tap the “Vote” button
  5. After voting, results are shown as progress bars with vote counts and percentages
  6. To create a poll: tap FAB (+), enter title, description, deadline, add at least 2 options
  7. Toggle “Anonymous” to hide voter identities

8.2 Achievement Badges

Rarity Color Description
Normal (N) Grey Basic achievements, easy to obtain
Rare (R) Blue Requires moderate effort
Epic (E) Purple Advanced achievements, harder to obtain
Legendary (L) Amber Top-tier achievements, extremely rare

8.3 Mission Board

Manager-created task board where employees volunteer for cross-department tasks.

Role Status Description
Mission OP (Open) / CL (Closed) Mission lifecycle
Volunteer O (Pending) Signed up, awaiting approval
A (Accepted) Approved by manager
IP (In Progress) Actively working on the task
SB (Submitted) Deliverables submitted
CL (Closed) Task completed and closed

8.4 Notification Preferences

Notification Type Default
Approval ON
Announcement ON
Request Updates ON
Poll Reminders ON
Badge Unlocked ON
Mission Board ON
Birthday / Anniversary OFF

8.5 My Page

Personalized home screen that can replace the default dashboard grid. Shows time-based greeting, three summary cards (Pending Approvals, Badges, Active Polls), and dynamic content blocks (latest announcements, active polls, open missions).

How to Use

  1. Go to Settings → Home Mode → select “My Page”
  2. The setting takes effect immediately and persists across app restarts
  3. Summary cards are tappable and navigate to their respective screens
  4. To switch back, select “Dashboard” in the Home Mode setting

🇯🇵 日本語版

給与サイクル操作マニュアル

本マニュアルは、iDempiere ERPモバイルアプリの給与サイクル（Payroll Cycle）に含まれる全モジュールの操作説明をカバーしています。給与明細、休暇管理、シフトスケジューリング、勤怠記録、休暇申請、および社員エンゲージメントモジュール（投票、バッジ、ミッションボード、通知設定、マイページ）を含む計12画面です。

モジュール一覧

給与明細（Payslip）

基本給、勤怠、残業、手当、控除、合計の6セクション29フィールドの給与明細を表示。データテーブル：HR_PayrollLine。

休暇残高ダッシュボード（Leave Balance）

18種類の台湾法定休暇の年間残高を表示するカスタムダッシュボード。3つのデータソースを統合して計算。

休暇調整（Leave Adjustment）

休暇調整レコードの管理。伝票アクション（完了/無効化）とステータスフィルタをサポート。

シフト定義（Shift Definition）

各シフトの勤務時間、休憩時間、シフト手当を定義。

ローテーションシフト（Rotating Shift）

従業員を特定のシフトに割り当て、有効期間を設定。

タイムカード（Punch Card）

従業員の出勤打刻記録を表示（読み取り専用）。

休暇申請（Leave Application）

従業員セルフサービスの休暇申請。日数自動計算と伝票アクションワークフロー対応。

1. 給与明細（Payslip）

フィールド構成

セクション 項目
基本情報 従業員、給与期間、基本給、時間給
勤怠 出勤日数、私用休暇時間、病気休暇時間、未使用年休
残業 平日残業時間、休日残業時間、残業手当合計
手当 食事、育児、シフト、プロジェクト、住宅、夜間交通、特別賞与
控除 労働保険、健康保険、所得税、福利厚生基金、宿舎
合計 総支給額、控除合計、手取り額、会社年金拠出、自己年金拠出

操作方法

  1. ダッシュボードの「給与サイクル」カテゴリから「給与明細」に移動
  2. 一覧は作成日の降順でソート
  3. 伝票番号で検索可能
  4. レコードをタップして29フィールドの詳細を表示
  5. 読み取り専用画面（給与計算はiDempiereバックエンドで処理）

2. 休暇残高ダッシュボード

3つのAPIを並列呼び出し（Future.wait）で取得し、18種類の台湾法定休暇の残高を計算します。

計算式

項目 データソース 計算
付与日数 HR_Holiday ユーザーIDでフィルタ
調整日数 HR_Adjustment ユーザーID + 年度 + DocStatus=’CO’
使用日数 HR_Transaction ユーザーID + 年度 + IsClosed=true
残日数 計算値 付与 + 調整 – 使用

操作方法

  1. 「休暇残高」モジュールに移動
  2. 当年度の休暇残高が表示される
  3. 年度セレクターの左右矢印で年を切り替え
  4. サマリーカード（年休、振替休日、病気休暇）で素早く確認
  5. テーブルで全18種類の休暇の詳細データを確認
  6. 更新ボタンで最新データを再読み込み

3. 休暇調整

操作方法

  1. 「休暇調整」モジュールに移動
  2. 説明フィールドで検索、ステータスフィルタチップ（下書き/完了/無効）で絞り込み
  3. タップして詳細表示：従業員、休暇タイプ、調整日数/時間
  4. 下書きレコードは「完了」（有効化）または「無効化」（キャンセル）が可能

4. シフト定義・ローテーション

画面 主要フィールド
シフト定義 シフト名、勤務開始/終了時間、休憩開始/終了時間、シフト手当
ローテーションシフト 名前、従業員、シフト、有効期間開始/終了、勤務時間、休憩時間

5. タイムカード

操作方法

  1. 「タイムカード」モジュールに移動
  2. 打刻時間の降順でソート表示
  3. 従業員名またはカード番号で検索
  4. タップして詳細表示：従業員、カード番号、社員番号、打刻時間、場所、メッセージ
  5. 読み取り専用ビュー（RV_プレフィックス）

6. 休暇申請

操作方法

  1. 「休暇申請」モジュールに移動
  2. 「+」をタップして新規休暇申請を作成
  3. 休暇タイプ、開始日、終了日を選択（日数は自動計算）
  4. 説明を入力（任意）
  5. 下書きとして保存後、「完了」で承認申請を提出
  6. 下書き状態で「無効化」によるキャンセルが可能

7. 社員エンゲージメントモジュール

7.1 投票システム

チーム投票の作成・参加機能。匿名投票をサポート。

操作方法

  1. 「ソーシャル」カテゴリから「投票」に移動
  2. アクティブな投票一覧を閲覧
  3. 投票カードをタップして詳細画面へ
  4. 未投票の場合、オプションを選択して「投票」ボタンをタップ
  5. 投票後、プログレスバーで結果（票数・パーセンテージ）を表示
  6. 投票作成：FAB（+）をタップ、タイトル・説明・期限・オプション（2つ以上）を入力

7.2 アチーブメントバッジ

レアリティ 色 説明
ノーマル (N) グレー 基本アチーブメント
レア (R) ブルー 中程度の努力が必要
エピック (E) パープル 上級アチーブメント
レジェンダリー (L) アンバー 最高レベルのアチーブメント

7.3 ミッションボード

マネージャーがタスクを作成し、従業員がボランティアとして参加するタスクボード。

役割 ステータス 説明
ミッション OP / CL オープン / クローズ
ボランティア O 保留中
A 承認済み
IP 進行中
SB 提出済み
CL 完了

7.4 通知設定

7種類の通知トグル：承認、お知らせ、リクエスト更新、投票、バッジ、ミッション、誕生日/記念日。切り替え後すぐにサーバーに保存されます。

7.5 マイページ

パーソナライズされたホーム画面。時間帯に応じた挨拶、サマリーカード3枚（承認待ち/バッジ/アクティブ投票）、動的コンテンツ（お知らせ、投票、ミッション）を表示。設定でダッシュボードグリッドとの切り替えが可能。

按 Enter 搜尋，ESC 關閉