集士工作流程圖 ↔ 現有模組對照

集士外勞聘僱管理系統(pidi_admin)|泳道、資料表、Controller、ref_menu 選單交叉對照

產生日期:2026-05-22|資料庫:pidi_new|選單表:ref_menu

1. 結論

流程圖是業務全景;本系統沒有單一「集士流程」模組,而是依 ref_menu 頂層分組拆成: 雇主管理 → 函件管理 → 外勞管理 → 入出境管理 → 報表/帳務。

核心資料鏈:

company_info → com_case → recruit_docs → labo_case_his →(labo_inout|eng_permission_lab|visa_doc|labo_health_chk|labo_residence_permit|labo_passport)→ AccountDetail/debit_record/發票

  • 單一外勞總覽:worker/laborer/manage(選單:外勞資料)
  • 實際辦理入境/出境:多為 laboInout/*
  • 人員多分頁:protected/views/worker/laborer/manage/edit_worker.php
flowchart TB subgraph lane1 [雇主泳道] CI[CompanyInfo / cust] CF[ComFactory / HomeCustAddr] CCT[ComContact] CCTR[ComContract] CR[ComRegulations] end subgraph lane2 [案件泳道] CC[ComCase] LCH[LaboCaseHis] end subgraph lane3 [招募帳務橋接] RD[RecruitDocs / RecruitPrc] AC[account/charge] end subgraph lane4 [外勞合規] LI[LaboInout] EPL[EngPermissionLab] VD[VisaDoc] LB[LabBody / worker/body] LP[LabPermit / worker/permit] PP[LabPassport / worker/passport] LF[worker/finger] end subgraph lane5 [保險薪資服務] CHN[ComHealthNo / ComInsuranceNo] AR[AppReport 加退保表] LS[LaboSalary] INV[account/invoice + FeeReport] end CI --> CC --> RD --> LCH LCH --> LI LCH --> EPL LCH --> VD LCH --> LB LCH --> LP LCH --> PP LI --> AC CHN --> AR AC --> INV

3. 泳道詳表:資料表、Action、選單

3.1 雇主泳道

圖上概念資料表ModelController / Action選單 → Route
雇主company_infoCompanyInfoCustController: admin, view, create, update雇主資料管理 → cust/admin
工地(機構)com_factoryComFactoryComFactoryController: admin(cust tab3)(分頁內)
工地(居家)home_cust_addrHomeCustAddrHomeCustAddrController(分頁內)
負責人com_perComPercomPer/admincust tab2
聯絡人com_contactComContactcomContact/admincust tab4
作業規則com_regulationsComRegulationsadmin, listMang雇主作業原則匯出 → ./ComRegulations/listMang
服務合約com_contractComContractcomContract/admin雇主合約管理 → comContract/admin
國內人才newsagent—newsagent/admin國內求才登記 → newsagent/admin
CRM 潛在客marketing_consultMarketingConsultMarketingConsultController行銷統計 → ./marketingConsult/exportAdmin
業開custome_salesCustomeSalesCustomeSalesController合約確認單 → /customeSales
勞保投保字號com_insured_people_numberComInsuredPeopleNumbercomInsuredPeopleNumber/admin勞保每月投保人數管理
案件com_caseComCasecomCase/admin雇主案件管理 → comCase/admin

FK:com_case.ci_id → company_info;cc_WorkPlace → com_factory 或 home_cust_addr(依 C/H)。

protected/models/ComCase.php (約 141–146 行)LEFT JOIN com_factory AS cf ON (ci.ci_ComCategory="C" AND cc.cc_WorkPlace=cf.cf_id)
LEFT JOIN home_cust_addr AS hca ON (ci.ci_ComCategory="H" AND cc.cc_WorkPlace=hca.hca_id)

3.2 案件 → 招募面

圖上概念資料表ModelAction選單 → Route
外勞在案labo_case_hisLaboCaseHislaboCaseHis/admin;LabWorker update*(外勞資料內)
招募函recruit_docsRecruitDocsadmin, create, update招募函管理 → recruitDocs/admin
遞補函fill_recruit_docs 等FillRecruitDocsfillRecruitDocs/admin遞補函管理 → fillRecruitDocs/admin
文件認證recruit_prcRecruitPrcrecruitPrc/admin文件認證管理 → recruitPrc/admin
入國通報arrival_notice—arrivalNotice/admin入國通報管理 → arrivalNotice/admin
函件統計——docsCount/admin函件人數統計表 → docsCount/admin

FK:labo_case_his.cc_id → com_case;rd_id → recruit_docs;lab_id → laborer。

「招募」在此系統指核准函/遞補函文件流,非一般徵才 ATS。

3.3 帳務面(橋接)

圖上概念資料表類別Action選單 → Route
外勞應收AccountDetail 等AccChargeaccount/charge/manage費用管理 → account/charge/manage/index
收款項目ItemName, ItemIncome—account/charge/item收款項目設定
過帳審核—AccChargeVerifyaccount/charge/verify過帳審核(雇主管理下)
申辦費用——account/charge/fee外勞申辦費用管理
雇主服務費樣式/設定表AccServiceaccount/service/set, change, style雇主服務費群組
入境寫應收——LaboInoutController::actionForin(流程內,無獨立選單)

3.4 外勞居留、護照

圖上概念資料表ModelAction選單
居留證labo_residence_permitLabPermitworker/permit/operation, manage居留證作業/列表
護照labo_passportLabPassportworker/passport/*護照加簽/列表
人員分頁同上LabWorkeractionEditWorkeredit_worker #permit, #passport
舊版居留同上LaboResidencePermitlaboArc/adminlegacy
命名陷阱:worker/permit = 居留證,不是聘僱許可(聘僱許可看 engPermissionLab)。

3.5 入出境泳道

圖上狀態資料表Controller Action選單 → Route
入境labo_inoutactionForin, actionForinadmin入境作業 → laboInout/forinadmin
預備出境同上actionPreForout, actionPreForoutadmin預備出境 → laboInout/preforoutadmin
出境同上actionForout*, actionForoutmang出境作業/待辦
釋出同上actionRelease, actionReleaseadmin釋出作業
轉出/轉入lch_TurnOutDate, lch_TurnInDateactionTurnout(作業內)
休假/返鄉休假 + labo_inoutworker/vacation/manage休假辦理
指紋labo_finger_prnworker/finger/operation指紋按印
遣返—LabAlert::getBodyNeedOut無選單
edit_worker.php 分頁 (#inout, #hire, #recruit, #health, #permit, #passport)

LaboInoutController 主要 action:forin, forout, preForout, cancelForout, foroutLeavecheck, foroutVisa, foroutFillrd, foroutQuotaCancel, turnout, extension, release, admin, forinadmin, foroutadmin, releaseadmin, preForoutadmin, foroutmang, delete

3.6 健檢/聘僱許可

圖上概念資料表Action選單
健檢labo_health_chkworker/body/operation, manage體檢作業/列表
聘僱許可函eng_permission_labengPermissionLab: admin, receive, turnout聘僱許可管理 → engPermissionLab/admin
聘僱到期—eplmExpiry/adminExpiry聘僱到期處理
廢聘/轉出labo_quota_cancellaboQuotaCancel/admin廢聘文管理
工作許可labo_work_permitlaboWorkPermit/admin(另一套,依業務區分)

3.7 簽證面

圖上概念資料表Action選單
簽證visa_docVisaDoc: admin, send, receive, writeOff…入國引進許可函 → visaDoc/admin
離境備查labo_leave_checklaboLeaveCheck/admin離境備查管理
人員歷史同上LabWorker getHisVisa, getHisLeaveCheckedit_worker #recruit

3.8 健保/勞保區

圖上概念資料表程式位置選單
健保證號com_health_noComHealthNoController多從 cust/設定進入
勞保證號com_insurance_noComInsuranceNoController同上
加保/退保/3合1—AppReport: AddInsur31, CancelInsur31, AddHealthInsur…申請報表 → appReport/admin Tab3
勞保每月投保人數com_insured_people_numbercomInsuredPeopleNumber/admin雇主管理下

保險 = 主檔 CRUD + AppReport 列印,無獨立線上加保 API。

3.9 薪資/獎金/代扣款

圖上概念資料表Action選單
薪資調薪labo_salarylaboSalary/admin未在 ref_menu
薪資切結/出境薪資單—AppReport SalaryAffidavit, ForoutSalaryappReport/admin
獎金計算——無;最接近授扣書 → report/award/index
代扣款debit_record, debit_maindebitmain/admin銀行扣款-扣款管理
外勞帳戶labo_accountlaboAccount;worker/upload/account銀行帳戶上傳
所得稅labo_taxworker/upload/tax所得稅上傳

3.10 服務區(收費通知)

圖上概念實作對應選單
收費通知account/charge/manage、FeeReport、DebitMain、account/invoice/enable費用管理、移工年度費用統計、銀行扣款、開立發票
雇主服務費account/service/*雇主服務費群組
發票account/invoice/*發票作業群組

4. 核心資料流

flowchart LR CI[company_info] CC[com_case] RD[recruit_docs] LCH[labo_case_his] LAB[laborer] LI[labo_inout] EPL[eng_permission_lab] VD[visa_doc] LHC[labo_health_chk] LRP[labo_residence_permit] LP[labo_passport] AD[AccountDetail] CI --> CC CC --> RD RD --> LCH LAB --> LCH LCH --> LI LCH --> EPL LCH --> VD LCH --> LHC LCH --> LRP LAB --> LP LCH --> AD LI --> AD

5. 圖 ↔ 程式落差

流程圖名詞程式現況
收費通知無字面模組;用費用管理+發票+扣款+ FeeReport
獎金計算無;report/award 為銀行授扣書
遣返無選單;LabAlert 體檢不合格提醒
健保/勞保主檔有 Model,多走 AppReport 列印
薪資計算laboSalary 可能未掛選單
國內人才對應「國內求才登記」newsagent/admin

6. 建議第一站 URL

以下為 Yii path 格式(站點根路徑需依本機設定,例如 /pidi_admin/):

流程第一站第二站(可選)
雇主 → 工地 → 合約cust/admincomCase/admin、comContract/admin
案件 → 招募 → 外勞comCase/adminrecruitDocs/admin → worker/laborer/manage
單一外勞全流程worker/laborer/manage各分頁或 laboInout、visaDoc
加退保表單appReport/admincomHealthNo、comInsuranceNo
收款/發票account/charge/manageaccount/invoice/enable

7. 白話總結

這張「集士工作流程」圖在系統裡不是一個按鈕跑完全程,而是:

  • 雇主管理(cust、comCase)管公司與案件;
  • 函件管理(RecruitDocs、engPermissionLab、visaDoc)管招募與許可文件;
  • 外勞管理(worker/laborer/manage)一頁看多段生命週期,但入境出境常要進 laboInout;
  • 健保勞保多在 申請報表 AppReport 印表;
  • 收費在 account 費用管理、發票與銀行扣款。

圖上的「收費通知」「獎金」「遣返」沒有同名選單,請用上文表格的最接近功能代替。