Skip to content

Latest commit

 

History

History
3986 lines (2247 loc) · 641 KB

picking.md

File metadata and controls

3986 lines (2247 loc) · 641 KB

挑工系統

系統基本資料

系統環境

Photon OS 4.0 (VM)

IP Addr: 192.168.6.39

技術

採前後端技術分離+MySQL

  • 前端:Next.js 14.x + React 18 (TypeScript)
  • 後端:ASP.NET Core 6.0 C#
  • 資料庫: MySQL 8.0

網站發布使用domain:

軟體架構

採用Docker 整合 3 個專案進行整合部署。

需求單狀態

由業務建立挑工需求單,送出需求單後,在後台由海外部人員進行處理作業。

  1. 編輯中(0): 業務建立需求單後的狀態。
  2. 申請中(1): 業務完成挑工後,送出需求單的狀態。
  3. 媒合中(2): 海外部接收到挑工需求單後,進行詢問移工是否合意期間時的設定的狀態。
  4. 已合意(3): 移工口頭答應,尚等文件簽回。
  5. 結案(4): 海外部完成移工合意後,並且完成評工表回簽上傳後,開始進行移工引進流程,則狀態為結案。產生案件編號。
  6. 中止(5): 海外部進行詢問移工合意失敗或由業務提出中止需求的狀態。

移工挑選紀錄

挑工需求單內移工挑選紀錄。

  1. 正式(0): 業務進行替客挑工時,確認挑選此移工後,新增挑選清單後的初始狀態。
  2. 歷史(1): 由海外部退回需求單,業務需要重新挑工,但此筆挑選資料保留。

挑選志願序

由業務進行替客挑工時,挑選移工的順序,並完成提交(申請中)。

  1. 正選(0): 業務挑工。
  2. 備選(1): 業務挑工。

移工履歷狀態

由系統或海外部人員進行變更移工履歷狀態。

  1. 隱藏(Hide): 海外部自行設定。
  2. 開放(Open): 由系統自動修改(業務取回挑工需求單)或海外部自行設定。
  3. 中選(Chose): 當業務挑選此移工為正選後,並送出需求單後,需求單狀態為"申請中"時,由系統自動修改。
  4. 合意(Match): 海外部自行設定。挑工需求單狀態為結案後,由系統或海外修改。
  5. 已入境(Lab_in): 海外部自行設定(引進案件流程結束)。
  6. 退出(Something): 海外部自行設定。
  7. 合意後退出(Leave): 海外部自行設定。
  8. 刪除(Del)
  9. 其他

失效狀態顯示條件:

  1. 當挑選志願序為"備選(0)"
  2. 履歷狀態"不為開放(Open)"
  3. 移工挑選狀態為挑選(0),則顯示失效。

操作更動狀態

退回 挑工需求單系統流程

由海外部進行修改。

  1. 需求單狀態變成"編輯中"
  2. 移工挑選狀態: 正選與備選移工的挑選狀態都變更為 "取消挑選(1)
  3. 挑選志願序: 資料不變更。
  4. 履歷狀態: 由海外部人員操作決定 隱藏、開放或退出。

提交 挑工需求單流程

由業務於[前台 member]操作

  • API名稱:submitPickerRequire
  • 操作:前站-業務權限-需求單管理。
  • 狀態更動前檢查:
    1. 業務權限
    2. 需求單狀態為"編輯中(0)"。
    3. 評工表必填欄位檢查。
    4. 挑選清單內有2份履歷,且皆為"開放(Open)"。
  • 更動狀態:
    1. 需求單狀態改為"申請中(1)"。
    2. 挑選清單內挑選狀態為"挑選(0)"且志願序為"正選(0)",將該履歷狀態改為"中選(Chose)"。
    3. 寫需求單異動歷程記錄/移工履歷異動紀錄

取回 挑工需求單流程

由業務於[前台 member]操作

  • API名稱:retrievePickerRequire
  • 操作:前站-業務權限-需求單管理。
  • 狀態更動前檢查:
    1. 業務權限
    2. 需求單狀態為"申請中(1)"。
  • 更動狀態:
    1. 需求單狀態改為"編輯中(0)"。
    2. 挑選清單內挑選狀態為"挑選(0)"、志願序為"正選(0)"、履歷狀態為"中選(Chose)",將該履歷狀態改為"開放(Open)"。
    3. 寫需求單異動歷程記錄/移工履歷異動紀錄。

更新 挑工需求單狀態流程

由海外部於[後台 admin]操作

  • API名稱:updatePickerRequireState
  • 流程狀態:
    • 編輯中 (業務人員) : 退回需求單的狀態。由海外人員變更移工履歷狀態。
    • 申請中 (海外部人員): 業務送出需求單後的狀態。
    • 媒合中 (海外部人員): 不會變更移工履歷狀態(正選履歷狀態 = 中選),並由海外詢問移工意願。
    • 結案: (海外部人員): 表示移工已合意,並已上傳已媒合女傭簽名的評工表後,完成確認與狀態變更為結案。系統自動變更移工履歷狀態=合意。並產生引進移工案件編號。
    • 中止 (海外部人員): 變更此狀態時,由海外人員變更移工履歷狀態。
  • 操作:後台-挑工案件管理-案件需求作業。
  • 狀態更動前檢查:
    1. 管理權限 (目前未套用)
    2. 需求單狀態不能為 "編輯中(0)" (需由業務進行送出作業)
    3. 評工表必填欄位檢查。
    4. 挑選清單內有2份履歷,且皆為"開放(Open)"。
  • 更動狀態:
    1. 需求單狀態改為"申請中(1)"。
    2. 挑選清單內挑選狀態為"挑選(0)"且志願序為"正選(0)",將該履歷狀態改為"中選(Chose)"。
    3. 寫需求單異動歷程記錄/移工履歷異動紀錄

後台管理- 功能列說明

會員資料管理
1. 會員申請審核(已建立,待測試) 2. 會員管理作業 3. 會員資料報表
移工履歷管理
1. 新增移工履歷(已建立,待測試) 2. 移工履歷管理 3. 移工資料報表
挑工案件管理
1. 挑工需求作業(已建立,待測試) 2. 案件進度管理 3. 案件資料報表
引進流程管理
1. 移工進度更新 2. 移工進度管理 3. 新增入境通知 4. 入境通知管理
系統管理
1. 頁面選單設計 2. 網站角色管理(已建立、待導入角色管理) 3. 使用者權限
其他

後端API開發

資料夾說明

[wwwroot]->公共資源,放可隨意讀取的圖片

[App_Code]->共用類別、通用Function處理

[Controllers]->API呼叫

[CustomExceptionMiddeware]->中介池[客製],目前用來處理錯誤訊息統一回覆格式

[FileUpload]->檔案上傳公共資料夾,目前未對其做安全性限制

[Models]->類別定義

[ModuleFile]->範本檔

[Security]->登入驗證相關

Controllers資料夾內層說明

[admin]->後站API呼叫

[acount]->使用者/帳號查詢

[agency]->國內外供應商

[picker]->移工履歷/挑工作業/引進作業

[websystem]->系統選單/角色設計/使用者角色對應

[member]->前站API呼叫

[common]->公共資料/無敏感性資料 API呼叫 ex:地區/教育程度

資料庫連線

所有資料庫連線資訊皆在appsetting.json

開發時,appsetting.json中參數

"DebugMode": {
"isOpen": false, =>要改成true,才能在開發環境透過192開頭的IP進行資料庫連線。
"//isOpen": "是否在開發模式,用於上方資料庫連線取哪一個連線字串"
}
在更新程式碼時,該參數要維持false。使正式build時取用的是docker內部IP(172開頭碼)

認證說明

使用JWT Token進行登入許可。
使用AcionFilter進行登入驗證。JWT加密字串,在appsetting.json。

目前登入驗證分為admin/member [ 管理平台(後台) / 前台]

後台登入,取得該帳號的系統角色身份與可以瀏覽的選單資訊。

使用adminController繼承,該類別即可對該API進行後台登入驗證,並取得使用者資料。

前站登入,有SFOMS帳號者可以登入,只有單一身分。

使用memberController繼承,該類別即可對API進行前台登入驗證,並取得使用者資料。

前站功能說明

訪客

頁面瀏覽-[首頁/國籍介紹]

挑工清單,可以挑3位喜愛工人,並填寫基本資料。

image.png

業務登入

使用SFOMS系統帳號登入。

image.png

\[業務功能列\]

  • 客戶申請查詢
  1. 督導指定業務拜訪,可從這裡查詢到該客戶當時填寫的基本資料及3名喜愛工人清單。
  2. 可從該頁面查詢後,加入到替客挑工的挑選清單。
  • 需求單管理
  1. 替客挑工需求單發起。需在AB1建立好資料,等系統同步時間後,再發起需求單。
  2. 使用契約編號發起需求單,僅能使用業務自己所負責的契約編號。
  3. 該契約編號並未限制只能發起一張需求單。[怕有其他使用情境]
  4. 從該頁面可以點選需求單,進入替客挑工模式。

\[履歷卡片\]

  • 履歷詳細資料
  1. 履歷詳細資料顯示
  2. 履歷PDF檔案瀏覽
  3. YT影片-移工自我介紹影片瀏覽
  • 替客挑工
  1. 替客挑工代入單號後,可新增該履歷進挑選清單。
  • TAG標示
  1. 指定工標示
  2. YouTube影片標示

\[替客挑工功能列\]

  • 單號
  1. 從需求單列表中點選需求單帶入。
  2. 單號點選時會進入到需求單主畫面。
  3. 該畫面可以進行[家庭成員修改/提交需求單/取回需求單/取消需求單]
  4. 提交需求單:須滿足以下條件
    1. 需求單須有核函申請的實辦件日期[SA20/SH20]。
    2. 評工表必填選項皆有資料。
    3. 挑選清單有首選/備選履歷,且兩份履歷皆為[開放]狀態。
  5. 取回需求單:需求單狀態須為[申請中],才能取回。否則聯繫海外部進行退回。取回時將開放首選移工履歷。
  6. 取消需求單:情境為受照顧者往生、雇主違約...等,不再需要替客挑工。
  • 評工表

填寫評工表,除了選項設計有防呆。當未儲存時無法離開該頁面。必填選項在提交需求單時才檢查,原因是評工表的填寫非一次性能完成。

  • 挑選清單

首選/備選 移工履歷。在該頁面可以交換志願序。若挑選後未儲存在右下角會有紅色提示框。需到該頁面進行儲存。

會員登入

待開發。

前站開發技術說明文件

資料夾說明

[components] 元件資料夾,包含Layout也視為一個元件。

[configs] 無使用,設定檔,透過該程式取公共參數,後改用環境參數。

[constants] 定義類別

[contexts] 共用function / 狀態管理 / fetchAction

[pages] 頁面(資料夾即route)

[public] 公共資源圖片...

[styles] 公共資源CSS設定

環境參數

[.env.development] 當使用yarn dev時,使用該環境參數

[.env.production] 當使用yarn build發布時,使用該環境參數

狀態管理

CountryFilterState.tsx

使用zustand進行狀態管理。
用於國籍選擇頁面時,上方Header選擇國籍切換時,可以傳入該參數到頁面中。
觸發資料寫入:上方Header下拉式清單
資料顯示:頁面篩選後資料

image.png

laborcart.tsx

使用useReducer、useContext進行狀態管理。
用於訪客拜訪時,挑工清單中的喜愛工人清單。
觸發資料寫入:移工履歷卡片中挑選按鈕。
資料顯示:Header挑工清單icon顯示、挑工清單頁面。

image.png

salesLaborCartStore.tsx

使用zustand進行狀態管理。
用於業務登入後,進行替客挑工。 挑工資料紀錄。
觸發資料寫入:需求單列表資料元件中[替客挑工]按鈕、移工履歷元件上[替客挑工]按鈕
資料顯示:替客挑工功能列、需求單號主畫面、挑選清單畫面。

image.png

套件(資源庫)使用

容器指令(docker)

docker指令

容器重新部屬:(因為設定了dockerFile)

  1. 把目前掛載全部stop並移除掛載 docker-compose down
  2. 重新打包映像檔並直接掛載 docker-compose up --build -d
  3. 刪除none-images(不必要的映像檔) docker rmi $(docker images -f "dangling=true" -q)

其他docker指令

  1. 目前docker掛載的映像檔 掛載狀態 docker-compose ps
  2. 把目前掛載全部stop並移除掛載 docker-compose down
  3. 目前有的映像檔資訊 docker images
  4. 從上方指令列出的資訊,找出ID並刪除,backend會有2個,一個是build一個是發行 docker rmi 映像檔ID
  5. cd到專案目錄 cd backend
  6. build映像檔,picking/backend是指定名稱v1是版號,會抓取目錄底下的Dockerfile執行 docker build -t picking/backend:v1 . docker build -t picking/member:v1 . docker build -t picking/admin:v1 .
  7. 移動到上層目錄 cd ..
  8. 目前docker有的映像檔,掛載並啟動 docker-compose up -d
  9. 目前docker掛載的映像檔,確認掛載狀態 docker-compose ps

查看後端log值

  • docker logs backend_v1
  • docker logs member_v1

挑工專案目錄

  • [picking/member]-前站
  • [picking/admin]-後站
  • [picking/backend]-後端API

技術討論紀錄

[2023.01.04 C# API 筆記] 使用DateTime.ToShortDateString()→會轉出"2023/01/01",但是反斜線會導致瀏覽器在接收時,轉換成"01/01/2023",導致前端日期欄位設定時無法接收 故須使用強制指定格式方式DateTime.ToString("yyyy-MM-dd"),使用-符號

[2023.01.12-技術討論 紀錄]

  1. PDF欄位核取框的命名規則改為"-"做字串後面參數值的拆分
  2. PDF檔案製作細節再做成文件
  3. 對於日期的顯示,目前先按挖空整行,由程式塞值"yyyy年MM月dd日"。之後政府表單若日期為表尾需拆3欄時再另行做共用function
  4. 重新對需求單內的挑選清單欄位作定義,改為正式與歷史。
  5. 移工履歷狀態值,在移工履歷管理內,僅有開放與隱藏,讓海外部人員操作,其他狀態皆由需求單做操作修改。
  6. 呈上移工履歷管理內,履歷非[開放、隱藏],不得在該介面直接修改,需到需求單管理內做推關或退回。
  7. 系統流程圖修改,判斷節點不應使用否定肯定句、將目前的狀態定義修改上去。
  8. 挑工系統進度會議PPT,前部分由致泰說明、後部分展示由佩芸說明。
  9. API部分,由致泰先將需要的API名稱列出,再由力偉跟佩芸認領開發。
  10. 評工表欄位新增"hope_other_content",API開發與前站修改。 11.判斷業務為利豐或萬通國際須詢問apple。
  11. co_s有資料新增,需重新倒入。co_g co_d co_o co_s需列入排程更新中

[2022.12.26-技術討論 紀錄]

  • MySQL 8.0 以上資料庫編碼 排序字符集

  • utf8mb4_unicode_ci 和 utf8mb4_general_ci

  1. 準確性 utf8mb4_unicode_ci 是基於標準的 Unicode 來排序和比較,能夠在各種語言之間精確排序 utf8mb4_general_ci 沒有實現 Unicode 排序規則,在遇到某些特殊語言或者字符集,排序結果可能不一致。 但是絕大多數情況下,這些特殊字符的順序並不需要那麼精確。
  2. 性能 utf8mb4_general_ci 在比較和排序的時候更快 utf8mb4_unicode_ci 在特殊情況下,Unicode 排序規則為了能夠處理特殊字符的情況,實現了略微複雜的排序算法。 但是在絕大多數情況下,不會發生此類複雜比較。相比選擇哪一種 collation,使用者更應該關心字符集與排序規則在 db 裡需要統一。
  3. utf8mb4_0900_ai_ci 推薦用 utf8mb4_unicode_ci,但是用 utf8mb4_general_ci 也沒啥問題。
  • MySQL 8.0 默認的是 utf8mb4_0900_ai_ci,屬於 utf8mb4_unicode_ci 中的一種,具體含義如下:

uft8mb4 表示用 UTF-8 編碼方案,每個字符最多佔 4 個字節。 0900 指的是 Unicode 校對算法版本。 (Unicode 歸類算法是用於比較符合 Unicode 標準要求的兩個 Unicode 字符串的方法)。 ai 指的是口音不敏感。也就是說,排序時 e,è,é,ê 和 ë 之間沒有區別。 ci 表示不區分大小寫。也就是說,排序時 p 和 P 之間沒有區別。 utf8mb4 已成為默認字符集,在 MySQL 8.0.1 及更高版本中將 utf8mb4_0900_ai_ci 作為默認排序規則。以前,utf8mb4_general_ci 是默認排序規則。由於 utf8mb4_0900_ai_ci 排序規則現在是默認排序規則,因此默認情況下新表格可以存儲基本多語言平面之外的字符。現在可以默認存儲表情符號。如果需要重音靈敏度和區分大小寫,則可以使用 utf8mb4_0900_as_cs 代替。

挑工系統優化-旅宿挑工

系統優化目標
* 建立整合帳號管理平台進行帳號管理與認證。
* 可進行一對多挑工,並且可設定多個正取與備取。
* 後台管理- 新增客戶資料管理功能(新增、修改、刪除與設定挑選工人數)
* 可進行挑選學生移工或社福移工。
* 現階段評估由業務人員至旅宿業者登入業務帳號進行協助挑工。
* 開發旅宿業者專有前端挑工Web App。
\## 資料表擴增欄位
* 因應旅宿業者挑工需求,進行資料表欄位新增與優化,以符合未來的設計。
* 預計新增客戶資料表、客戶類型資料表、使用者資料資料表。
* 針對帳號整合平台新增資料庫與相關資料表。
\## 優化系統主要修改系統分類
[整合帳號平台](新增)- 新開發系統平台,可進行帳號管理與系統登入認證使用。
* 自動同步HRM2 員工與帳號狀態
* 管理使用者所負責的系統清單。登入時經由此欄位進行系統認證。
* 使用者基本資料管理、系統使用者狀態(使用中 or 停用)
* 每一個使用者可使用的系統各自有自己的密碼。
[旅宿業務挑工](新增)- 新開發一套前台Web App,提供給業務到旅宿業者端進行協助挑工。
* 顯示學生移工頁面,可參照原業務挑工頁面。
* 挑工與清單管理,可進行一對多挑工,並且管理多個挑選移工清單。挑工時,可設定正取或備取。
* 送單與進度管理,針對以挑選移工進行管理,並且完成後,進行確認送單作業。 此時挑工狀態會轉為[申請中]。
[後台管理平台]
* 新增旅宿客戶管理,可新增旅宿業者相關資料,並綁定業務人員。
* 新增使用者帳號管理,預計規劃帶入HRM2資料進行新增。
* 移工登錄與管理新增移工身分欄位: 學生移工
* 挑工需求作業,新增旅宿業者挑工分類、與客戶角色。
* 網站角色管理功能修改角色功能並整合使用者帳號管理。
* 因應未來IFOMS與SFOMS 系統轉移到聘軒,進行帳號與角色對應調整(規劃下一個階段)。
[後端API服務]
* 調整同步SFOMS 資料庫的相關資料表,轉由開發API或讀取聘軒匯出的Excel進行同步更新。
* 新增旅宿業務挑工相關API
* 新增後台管理-旅宿客戶管理API
* 新增後台管理-使用者帳號管理API
* 調整移工履歷管理API
* 調整使用者角色管理API
\## 挑工系統優化各階段排程
[階段1] 評估與規劃階段(包含相關人員分配) [5/21~]
1.1 系統優化討論議題
* 依照目前需求,可需要進行相關討論議題如下:
1. 新旅宿業者挑工流程與規則。
2. 萬通人力帳號建立來源與權限管理 => 導入整合帳號平台
3. 旅社業者資料建立流程與資料內容
1.2 確認系統使用者角色
旅宿業者挑工: 業務人員
旅宿挑工需求單管理員: 海外部人員
旅宿挑工客戶資料管理: 海外部人員
外籍工讀生引進管理: 海外部人員
系統帳號管理: 資訊部人員
系統角色與權限管理: 資訊部人員
1.3 開發人員分配
旅宿挑工前台Web App : 善筠
挑工系統後台管理修改: 致泰
挑工系統後端API服務開發: 雅文
整合帳號管理平台: 致泰
[階段2] 系統架構調整與旅宿挑工頁面設計 [6/7~]
[階段3] 功能與流程實作開發(可能需要定期討論) [7月~]
[階段4] 功能展示與測試 [預計9月底~]

挑工系統優化-資料表

industry\_student

學生履歷

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

novarchar(30)仲介學生編號NOT NULL
enamevarchar(50)學生姓名NOT NULL
nationvarchar(2)國籍編號NOT NULL
birthdaydate出生日期NOT NULL
educationint教育程度NOT NULL
marrytinyint婚姻狀況NOT NULL
oagencyvarchar(20)國外仲介NOT NULL
source\_fromint資料來源NOT NULL
resume\_statusvarchar(12)履歷狀態NOT NULL
heightint身高NOT NULL
weightint體重NOT NULL
passporttinyint護照狀態NOT NULL
ischool\_datedate受訓日期DEFAULT NULL
oschool\_datedate結訓日期DEFAULT NULL
resume\_startdate履歷開放日DEFAULT NULL
resume\_enddate履歷關閉日DEFAULT NULL
file1\_typevarchar(40)檔案一格式DEFAULT NULL
file2\_typevarchar(40)檔案二格式DEFAULT NULL
abroad\_feeint國外辦件費DEFAULT '0'
come\_twtinyint來台經驗DEFAULT '0'
work\_id\_statetinyintID狀態DEFAULT '0'
video\_urlvarchar(200)影片連結DEFAULT NULL
updated\_timedatetime最近異動時間DEFAULT NULL
updated\_byvarchar(20)異動人DEFAULT NULL
updated\_by\_novarchar(20)異動人帳號DEFAULT NULL
created\_timedatetime建立時間NOT NULL
created\_byvarchar(20)建立人NOT NULL
created\_by\_novarchar(20)建立人帳號NOT NULL
Iagencyvarchar(12)\[X\]國內仲介DEFAULT NULL

[2024-08-08] 資料欄位定義 :

updated_time => modified_time
updated_by => modified_by
updated_by_no => modified_by_no

industry\_require

產學需求單

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

novarchar(20)需求單號NOT NULL
customer\_idint接單申請客戶IDNOT NULL
process\_statustinyint需求單狀態0:編輯中1:申請中2:媒合中3:已合意4:結案5:中止NOT NULL
apply\_rolevarchar(10)哪個角色提出申請sales:業務NOT NULL
is\_upload\_evaluateint是否已上傳回簽評工表NOT NULL

DEFAULT '0'

sales\_user\_novarchar(20)負責業務帳號NOT NULL
sales\_user\_namevarchar(20)負責業務NOT NULL
created\_timedatetime資料建立時間NOT NULL
updated\_timedatetime資料最後更新時間DEFAULT NULL
updated\_byvarchar(20)修改人DEFAULT NULL
updated\_by\_novarchar(20)修改人帳號DEFAULT NULL

[2024-08-08] 資料欄位定義 :

需要created_by、created_by_no
updated_time => modified_time
updated_by => modified_by
updated_by_no => modified_by_no

industry\_student\_status

挑工履歷狀態異動

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

student\_idint履歷IDNOT NULL
resume\_statusvarchar(12)履歷狀態 Hide:隱藏 Open:開放 Chose:中選 Match:合意 Lab\_in:已入境 Something:退出 Leave:合意後退出NOT NULL
resultvarchar(255)修改原因DEFAULT NULL
updated\_timedatetime更新時間NOT NULL
updated\_byvarchar(20)更新人NOT NULL
updated\_by\_novarchar(20)更新人帳號NOT NULL

[2024-08-08] 資料欄位定義 :

updated 改為 created ,沒有 updated
=>created_by、created_by_no、created_time

industry\_require\_student

學生需求單-工人清單

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

ir\_idint學生需求單ID \[industry\_require\]NOT NULL
is\_idint學生履歷ID\[industry\_student\]NOT NULL
pick\_statustinyint挑選狀態\[0挑選1取消\]NOT NULL
choose\_typeint挑選正取或備取\[0正取1備取\]NOT NULL
choose\_indexint挑選志願序\[從1開始\]NOT NULL
evaluate\_filevarchar(50)評工表檔案名稱DEFAULT NULL
created\_timedatetime資料建立時間NOT NULL
updated\_timedatetime資料最後更新時間DEFAULT NULL
updated\_byvarchar(20)修改人DEFAULT NULL
updated\_by\_novarchar(20)修改人帳號DEFAULT NULL

[2024-08-08] 資料欄位定義 :

created 改為 updated ,沒有 created
created_time 刪除

customer (暫時用)

客戶資料表(暫時用)

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

cus\_namevarchar(150)客戶名稱NOT NULL
cus\_novarchar(15)客戶編號NOT NULL
contact\_namevarchar(50)聯絡人NOT NULL
telvarchar(20)電話NOT NULL
addressvarchar(200)地址NOT NULL
sales\_user\_novarchar(20)負責業務IDDEFAULT NULL
sales\_user\_namevarchar(20)負責業務DEFAULT NULL
verify\_statusint審核狀態\[0:待審核1:審核通過2:審核失敗\]NOT NULL

DEFAULT '0'

updated\_timedatetime最近異動時間DEFAULT NULL
updated\_byvarchar(20)異動人DEFAULT NULL
updated\_by\_novarchar(20)異動人帳號DEFAULT NULL
created\_timedatetime建立時間NOT NULL
created\_byvarchar(20)建立人NOT NULL
created\_by\_novarchar(20)建立人帳號NOT NULL

[2024-08-08] 資料欄位定義 :

updated_time => modified_time
updated_by => modified_by
updated_by_no => modified_by_no

industry\_require\_history

產學需求單-進度歷程記錄

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

ir\_idint學生需求單ID \[industry\_require\]NOT NULL
process\_statustinyint需求單狀態 0:編輯中 1:申請中 2:處理中 3:結案 4:中止NOT NULL
resultvarchar(255)修改原因DEFAULT NULL
updated\_timedatetime更新時間NOT NULL
updated\_byvarchar(20)修改人NOT NULL
updated\_by\_novarchar(20)修改人帳號NOT NULL

[2024-08-08] 資料欄位定義 :

updated 改為 created ,沒有 updated
=>created_by、created_by_no、created_time

industry\_application

產學挑工申請單

欄位 長度備註預設值
idintPKAUTO\_INCREMENT

NOT NULL

novarchar(20)NOT NULL申請單單號
namevarchar(20)NOT NULL申請人
telvarchar(20)NOT NULL連絡電話
emailvarchar(255)NOT NULL信箱
city\_idintNOT NULL縣市ID
region\_idintNOT NULL地區ID
need\_natvarchar(10)DEFAULT NULL需求國籍
where\_knowvarchar(20)DEFAULT NULL從哪裡得知
apply\_usevarchar(20)DEFAULT NULL申請項目
fav\_lab\_numintNOT NULL喜愛的工人數量
file\_numintNOT NULL證明文件數量
created\_timedatetimeNOT NULL資料建立時間
updated\_timedatetimeDEFAULT NULL修改時間
updated\_byvarchar(20)DEFAULT NULL修改人
updated\_by\_novarchar(20)DEFAULT NULL修改人帳號
verify\_statusintNOT NULL審核狀態
verify\_reasonvarchar(255)DEFAULT NULL審核原因
sales\_user\_novarchar(20)DEFAULT NULL指派業務人員帳號

[2024-08-08] 資料欄位定義 :

外部使用者申請,不需要 created_by,若需要 created_by 為 sys
updated_time => modified_time
updated_by => modified_by
updated_by_no => modified_by_no

挑工系統優化-資料表 CREATE TABLE 指令

== 學生履歷 ==

CREATE TABLE industry_student (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
no varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '仲介學生編號',
ename varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '學生姓名',
nation varchar(2) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '國籍編號',
birthday date NOT NULL COMMENT '出生日期',
education int NOT NULL COMMENT '教育程度',
marry tinyint NOT NULL COMMENT '婚姻狀況',
oagency varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '國外仲介',
source_from int NOT NULL COMMENT '資料來源',
resume_status varchar(12) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '履歷狀態',
height int NOT NULL COMMENT '身高',
weight int NOT NULL COMMENT '體重',
passport tinyint(1) NOT NULL COMMENT '護照狀態',
ischool_date date DEFAULT NULL COMMENT '受訓日期',
oschool_date date DEFAULT NULL COMMENT '結訓日期',
resume_start date DEFAULT NULL COMMENT '履歷開放日',
resume_end date DEFAULT NULL COMMENT '履歷關閉日',
file1_type varchar(40) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '檔案一格式',
file2_type varchar(40) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '檔案二格式',
abroad_fee int DEFAULT '0' COMMENT '國外辦件費',
come_tw tinyint(1) DEFAULT '0' COMMENT '來台經驗',
work_id_state tinyint(1) DEFAULT '0' COMMENT 'ID狀態',
video_url varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '影片連結',
updated_time datetime DEFAULT NULL COMMENT '最近異動時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '異動人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '異動人帳號',
created_time datetime NOT NULL COMMENT '建立時間',
created_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '建立人',
created_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '建立人帳號',
Iagency varchar(12) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '[X]國內仲介',
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='挑工履歷-工人資料' ROW_FORMAT=DYNAMIC;

== 產學需求單 ==

CREATE TABLE industry_require (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
no varchar(20) NOT NULL COMMENT '需求單號',
customer_id int NOT NULL COMMENT '接單申請客戶ID',
process_status tinyint NOT NULL COMMENT '需求單狀態0:編輯中1:申請中2:媒合中3:已合意4:結案5:中止',
apply_role varchar(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '哪個角色提出申請sales:業務',
is_upload_evaluate int NOT NULL DEFAULT '0' COMMENT '是否已上傳回簽評工表',
sales_user_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '負責業務帳號',
sales_user_name varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '負責業務',
created_time datetime NOT NULL COMMENT '資料建立時間',
updated_time datetime DEFAULT NULL COMMENT '資料最後更新時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人帳號',
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='挑工需求單';

== 挑工履歷狀態異動 ==

CREATE TABLE industry_student_status (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
student_id int NOT NULL COMMENT '履歷ID',
resume_status varchar(12) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '履歷狀態 Hide:隱藏 Open:開放 Chose:中選 Match:合意 Lab_in:已入境 Something:退出 Leave:合意後退出',
result varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改原因',
updated_time datetime NOT NULL COMMENT '更新時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '更新人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '更新人帳號',
PRIMARY KEY (id)
)ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='挑工履歷狀態異動' ;

== 學生需求單-工人清單 ==

CREATE TABLE industry_require_student (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
ir_id int NOT NULL COMMENT '學生需求單ID [industry_require]',
is_id int NOT NULL COMMENT '學生履歷ID[industry_student]',
pick_status tinyint NOT NULL COMMENT '挑選狀態[0挑選1取消]',
choose_type int NOT NULL COMMENT '挑選正取或備取[0正取1備取]',
choose_index int NOT NULL COMMENT '挑選志願序[從1開始]',
evaluate_file varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '評工表檔案名稱',
created_time datetime NOT NULL COMMENT '資料建立時間',
updated_time datetime DEFAULT NULL COMMENT '資料最後更新時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人帳號',
PRIMARY KEY (id)
)ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='學生需求單-工人清單' ;

== 客戶資料表 (暫時用) ==

CREATE TABLE customer (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
cus_name varchar(150) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '客戶名稱',
cus_no varchar(15) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '客戶編號',
contact_name varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '聯絡人',
tel varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '電話',
address varchar(200) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '地址',
sales_user_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '負責業務ID',
sales_user_name varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '負責業務',
verify_status int DEFAULT 0 COMMENT '審核狀態[0:待審核1:審核通過2:審核失敗]',
updated_time datetime DEFAULT NULL COMMENT '最近異動時間'
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '異動人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '異動人帳號',
created_time datetime NOT NULL COMMENT '建立時間',
created_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '建立人',
created_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '建立人帳號',
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='客戶資料表' ROW_FORMAT=DYNAMIC;

== 產學需求單-進度歷程記錄==

CREATE TABLE industry_require_history (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
ir_id int NOT NULL COMMENT '學生需求單ID [industry_require]',
process_status tinyint NOT NULL COMMENT '需求單狀態 0:編輯中 1:申請中 2:處理中 3:結案 4:中止',
result varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改原因',
updated_time datetime NOT NULL COMMENT '更新時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '修改人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '修改人帳號',
PRIMARY KEY (id)
)ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='產學需求單-進度歷程記錄' ;

== 產學挑工申請單 ==

CREATE TABLE industry_application (
id int AUTO_INCREMENT NOT NULL COMMENT 'ID值',
no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '申請單單號',
name varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '申請人',
tel varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '連絡電話',
email varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL COMMENT '信箱',
city_id int NOT NULL COMMENT '縣市ID',
region_id int NOT NULL COMMENT '地區ID',
need_nat varchar(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '需求國籍',
where_know varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '從哪裡得知',
apply_use varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '申請項目',
fav_lab_num int NOT NULL COMMENT '喜愛的工人數量',
file_num int NOT NULL COMMENT '證明文件數量',
created_time datetime NOT NULL COMMENT '資料建立時間',
updated_time datetime DEFAULT NULL COMMENT '修改時間',
updated_by varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人',
updated_by_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '修改人帳號',
verify_status int NOT NULL DEFAULT 0 COMMENT '審核狀態',
verify_reason varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '審核原因',
sales_user_no varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci DEFAULT NULL COMMENT '指派業務人員帳號',
PRIMARY KEY (id)
)ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='產學挑工申請單' ;

挑工系統優化-後端專案資料夾Controllers內層說明

[admin]->後站API呼叫

  1. [acount]->使用者/帳號查詢
  2. [agency]->國內外供應商
  3. [customer]->客戶
  4. [industry]->學生履歷/學生挑工作業/引進作業 (旅宿挑工)
  5. [picker]->移工履歷/挑工作業/引進作業
  6. [reports]->表單文件
  7. [websystem]->系統選單/角色設計/使用者角色對應

[member]->前站API呼叫

[industry]->前站API呼叫 (旅宿挑工)

[common]->公共資料/無敏感性資料 API呼叫 ex:地區/教育程度

挑工系統優化-前台(業務登入)UI與API關係圖

image

UI 初步構想

image

評工表按鈕、挑選清單按鈕UI

image

挑工系統優化-技術討論紀錄

挑工流程優化-旅宿挑工API

#前台API#後台API

API規範說明

API呼叫與回傳
行為 格式 提交參數說明 範例
呼叫前後站API

(POST)

form 前端使用form提交參數

參數規則:為資料庫欄位名→依資料庫命名法(全小寫),用底線分隔

API命名規則:首單字,動詞全小寫,後面單字首字母大寫,ex:getLaborList

參數範例:first\_code
呼叫前後站登入API

(POST)

JSONObj 針對登入驗證,使用JSONObj,因為若使用套件有較好的相容性。
呼叫共用API

(GET)

資料無個資或敏感性資料,全使用GET
API回傳 JSONObj htmlCode (int):200、404....

在成功呼叫API下(htmlCode-200)

一律回傳此jsonObj格式

{

"succ":[boolean]成功/失敗取得資料,

"code": [int]結果狀態代碼,

"message": [string]結果狀態訊息,

"dataTime": [datetime]呼叫api時間,

"data": [jsonObj/jsonArray]回傳資料

}

{

"succ": true,

"code": "0",

"message": null,

"dataTime": "2022-08-16T10:36:35.2024454+08:00",

"data": [

{

"name": "基隆市",

"autoNo": 2

},....

]

}

## API回傳-固定參數說明
htmlStatus 回應資訊
200 Response body
succ code message data
true 0 null 該API須回傳的資料(jsonObj/jsonArray)
false 2 各api自定的錯誤訊息(可直接顯示訊息給使用者看的) null
401 在ActionFilter處理,因為需要有2種Token驗證方式
Response body
succ code message data
false 1 需要驗證。
false 2 Token 逾期或失效。
false 3 你擁有的角色無權限拜訪。
400 Response body(尚未設計統一回覆格式)
succ code message data
500 在Exception Middleware中統一處理 try….catch….
Response body
succ code message

(在除錯模式才會顯示,否則為空值避免竊取資訊)

data
false 1 Exception.Message
false 2 MySqlException.Message
false 3 FormatException
false 4 FileNotFoundException
false 5 IndexOutOfRangeException
false 6 OutOfMemoryException
7 寫入資料庫有錯誤
8 建立檔案讀寫有錯誤

後台管理API-新增挑工學生履歷

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 新增挑工學生履歷
POST/GET POST
URL URL+"/industry/createIndustryWorkers"
Token Yes
params

\[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*no string 仲介外勞編號 字串長度1~30
\*ename string 外勞姓名 字串長度1~20
\*nation string 國籍編號 字串長度1~2 01:泰國

02:菲律賓

03:印尼

05:越南

\*birthday date 出生日期 日期格式的字串

"2022-01-01"

"2022/01/01"

\*education int 教育程度 大於0整數 取【API-教育程度】中option\_no
\*marry int 婚姻狀況 大於0整數 0:單身

1:已婚

2:離婚

\*oagency string 國外仲介商 字串長度1~30 取【API-國外仲介】中sup\_no
\*sourceFrom int 資料來源 大於1整數 資料表-option\_item

1:門市招募

2:直聘工

3:指定工

4:回鍋工

5:赴海外挑工

6:新工

\*resumeStatus string 履歷狀態 字串長度1~12 Hide:隱藏

Open:開放

Chose:中選

Match:合意

Lab_in:已入境

Something:退出

Leave:合意後退出

\*height int 身高 大於1整數
\*weight int 體重 大於1整數
ischoolDate date || null 受訓日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

oschoolDate date || null 結訓日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

resumeStart date || null 履歷開放日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

resumeEnd date || null 履歷結束日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

passport int || null 護照狀態 大於0整數

可為空值

0:未完成

1:已完成

comeTw int || null 來台經驗 大於0整數

可為空值

0:否

1:是

workIdState int || null ID狀態 大於0整數

可為空值

0:未完成

1:已完成

abroadFee int || null 國外辦件費 大於0整數

可為空值

studentFiles object\[\] 外勞檔案資料 物件陣列

可為空值

file\_title

必須填[照片/履歷表]

需一次送2物件

videoUrl string 影片連結 字串長度1~200
\[{

"file_title": "string,檔案名稱"[照片/履歷表],

"file": "file,檔案"

}]

Return "data"(jsonObject):

{

"id": int,學生履歷id

}

Sample
ErrorCode

(code:2)

建立日期 架站建立

後台管理API-挑工學生履歷清單

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 挑工學生履歷清單
POST/GET POST
URL URL+"/industry/getIndustryWorkersList"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
no string 學生履歷編號
ename string 學生英文名
nation string 國籍 01:泰國

02:菲律賓

03:印尼

05:越南

resumeDate date 履歷逾期時間 履歷關閉日期<=該參數
resumeStatus string 履歷狀態 Hide:隱藏

Open:開放

Chose:中選

Match:合意

Lab_in:已入境

Something:退出

Leave:合意後退出

resumeStart date 履歷開放日期 履歷開放日期=該參數
resumeEnd date 履歷關閉日期 履歷結束日期=該參數
createdTime date 建立日期 建立日期>=該參數
若不以該參數為搜尋條件,請送空值或不傳送該參數。

清單資料全列為皆不送各參數或全部參數皆為空值,直接post。

Return "data"(jsonArray): \[

{

"id": int,學生履歷id,

"no": string,學生履歷編號,

"ename": string,學生英文名,

"nation": string,國籍[01:泰國02:菲律賓03:印尼05:越南],

"old": int,年齡,

"marry": int,婚姻狀態[0:單身1:已婚2:離婚],

"passport":int,護照狀態[0:未完成1:已完成],

"workIdState":int,ID狀態[0:未完成1:已完成],

"resumeStatus":string,履歷狀態[Hide:隱藏Open:開放Chose:中選Match:合意Lab_in:已入境Something:退出Leave:合意後退出],

"comeTw":int,來台經驗[0無1有],

"abroadFee":int,國外辦件費,

"resumeStart":date,履歷開放日期,

"resumeEnd":date,履歷關閉日期,

"createdTime":datetime,建立日期

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

後台管理API-挑工學生履歷明細

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 挑工學生履歷明細
POST/GET POST
URL URL+"/industry/getIndustryWorkerItem"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
id int 學生履歷id 大於1以上整數 取【API-挑工外勞履歷清單】中 id
Return "data"(jsonArray): \[

{

"id": int,學生履歷id,

"no": string,學生履歷編號,

"ename": string,外勞英文名,

"nation": string,國籍代號[01:泰國02:菲律賓03:印尼05:越南],

"birthday":date||null,生日,

"education": int,教育程度代號[對應API-教育程度],

"marry": string,婚姻狀態代號[0:單身1:已婚2:離婚],

"oagency":string,國外仲介代號[對應API-國外仲介],

"iagency":string,國內仲介代號[對應API-國內仲介],

"sourceFrom":int,資料來源[1:門市招募2:直聘工3:指定工4:回鍋工5:赴海外挑工6:新工],

"resumeStatus":string,履歷狀態[Hide:隱藏Open:開放Chose:中選Match:合意Lab_in:已入境Something:退出Leave:合意後退出],

"ischoolDate":date||null,受訓日期,

"oschoolDate":date||null,結訓日期,

"resumeStart":date||null,履歷開放日期,

"resumeEnd":date||null,履歷關閉日期,

"passport":int,護照狀態[0:未完成1:已完成],

"file_JPG":string,照片檔案路徑,

"file_PDF":string,履歷檔案路徑,

"height":int,身高,

"weight":int,體重,

"comeTw":int,來台經驗[0:無1:有],

"workIdState":int,id狀態[0:未完成1:已完成],

"abroadFee":int,國外辦件費,

"videoUrl":string,自我介紹影片,

"updatedTime":datetime,最近異動日期,

"createdTime":datetime,建立日期,

"createdBy":string,建立人員,

"createdByNo":string,建立人帳號

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

後台管理API-編輯挑工學生履歷

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 編輯挑工學生履歷
POST/GET POST
URL URL+"/industry/updateIndustryWorker"
Token Yes
params

\[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*id int 履歷ID 大於1整數
\*no string 學生履歷編號 字串長度1~30
\*ename string 學生英文姓名 字串長度1~20
\*nation string 國籍編號 字串長度1~2 01:泰國

02:菲律賓

03:印尼

05:越南

\*birthday date 出生日期 日期格式的字串

"2022-01-01"

"2022/01/01"

\*education int 教育程度 大於0整數 取【API-教育程度】中option\_no
\*marry int 婚姻狀況 大於0整數 0:單身

1:已婚

2:離婚

\*oagency string 國外仲介商 字串長度1~30 取【API-國外仲介】中sup\_no
\*sourceFrom int 資料來源 大於1整數 資料表-option\_item

1:門市招募

2:直聘工

3:指定工

4:回鍋工

5:赴海外挑工

6:新工

\*height int 身高 大於1整數
\*weight int 體重 大於1整數
ischoolDate date || null 受訓日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

送空值或未送該參數將清除該日期
oschoolDate date || null 結訓日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

送空值或未送該參數將清除該日期
resumeStart date || null 履歷開放日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

送空值或未送該參數將清除該日期
resumeEnd date || null 履歷結束日期 可為空值

日期格式的字串

"2022-01-01"

"2022/01/01"

送空值或未送該參數將清除該日期
passport int 護照狀態 大於0整數

可為空值

0:未完成

1:已完成

comeTw int 來台經驗 大於0整數

可為空值

0:否

1:是

workIdState int ID狀態 大於0整數

可為空值

0:未完成

1:已完成

abroadFee intl 國外辦件費 大於0整數

可為空值

videoUrl string 影片連結 字串長度1~200

不修改該值請傳原資料對應

履歷狀態與檔案更新請使用別支API

Return "data"(jsonObject):

{

"id": int,學生履歷id,

"effectRow": int,影響資料筆數

}

Sample
ErrorCode

(code:2)

建立日期 架站建立

後台管理API-編輯挑工學生履歷檔案

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 編輯挑工學生履歷檔案
POST/GET POST
URL URL+"/industry/updateIndustryWorkerFiles"
Token Yes
params

\[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*id int 履歷ID
\*studentFiles object\[\] 學生檔案資料 物件陣列

可送1個或2個物件

指定物件的file_title須為指定文字

file\_title

必須填[照片/履歷表]

\[{

"file_title": "string,檔案名稱"[照片/履歷表],

"file": "file,檔案"

}]

履歷內容與狀態更新請使用別支API

Return "data"(jsonObject):

{

"id": int,履歷ID,

"effectFile": int,影響檔案數

}

Sample
ErrorCode

(code:2)

//查無資料或資料庫回應時間過長。
{
    "succ": false,
    "code": "2",
    "message": "查無資料或資料庫回應時間過長。",
    "dataTime": "2024-07-11T15:30:12.6365455+08:00",
    "data": null
}
建立日期 架站建立

後台管理API-編輯挑工學生履歷狀態

URL:API ServerUrl+"/admin"

認證:後站Token(經Login取得)

API名稱 ##### 編輯挑工學生履歷狀態
POST/GET POST
URL URL+"/industry/updateIndustryWorkerStatus"
Token Yes
params

\[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*id int\[\] 履歷IDs
\*resumeStatus string 履歷狀態 字串長度1~12 Hide:隱藏

Open:開放

Chose:中選

Match:合意

Lab_in:已入境

Something:退出

Leave:合意後退出

result string||null 異動原因 字串長度0~225

可為空值

履歷內容與檔案更新請使用別支API

Return "data"(jsonObject):

{

"effectRow": int,影響資料筆數

}

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(未登入)API-學生履歷開放清單

URL:API ServerUrl+"/industry"

API名稱 學生履歷開放清單(看更多履歷)
POST/GET POST
URL URL+"/getStudentsList"
Token No
params

\[FromData\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*nation string 國家編號 字串長度為1~2之間 -1:不分類

01:泰國

02:菲律賓

03:印尼

05:越南

\*comeTw int 來台經驗 僅能輸入範圍-1~0 -1:不分類

0:無

1:有

no string 學生履歷編號 未送該參數→不查詢該條件
Return "data"(jsonArray):\[{

"studentId": "int,學生履歷ID",

"no": "string,學生履歷編號",

"ename": "string,學生英文姓名",

"nation": "string,國籍編號",

"birthday": "date,學生生日",

"old": "int,學生年齡",

"nationName": "string,國籍",

"education": "int,教育程度ID",

"createdTime": "datetime,建立時間",

"educationName": "string,教育程度",

"weight": "int,體重",

"height": "int,身高",

"photoFile": "string,照片URL",

"comeTw":boolean,來台經驗(null為false),

"resumeStatus": "string,履歷狀態",

"sourceFrom":"int,學生來源[1:門市招募2:直聘工3:指定工4:回鍋工5:赴海外挑工6:新工]",

"videoUrl": "string,影片連結"

}]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API - 學生履歷詳細資料

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 ##### 學生履歷詳細資料
POST/GET POST
URL URL+"/sales/getStudentWorkerItem"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*studentId int 學生履歷id 大於1以上整數 取【API-學生外勞履歷清單】中id
Return "data"(jsonArray): \[

{

"studentId": int,學生履歷ID,

"no": string,學生履歷編號,

"ename": string,英文名,

"nation": string,國籍代號[01:泰國02:菲律賓03:印尼05:越南],

"birthday":date,出生日期,

"old":string,年紀,

"education": int,教育程度代號[對應API-教育程度],

"educationName":string,教育程度,

"marry": int,婚姻狀態代號[0:單身1:已婚2:離婚],

"oagency":string,國外仲介代號[對應API-國外仲介],

"supCname":string,國外仲介,

"iagency":string,國內仲介代號[對應API-國內仲介],

"sourceFrom":int,資料來源[1:門市招募2:直聘工3:指定工4:回鍋工5:赴海外挑工6:新工],

"resumeStatus":string,履歷狀態[Hide:隱藏Open:開放Chose:中選Match:合意Lab_in:已入境Something:退出Leave:合意後退出],

"ischoolDate":date||null,受訓日期,

"oschoolDate":date||null,結訓日期,

"resumeStart":date||null,履歷開放日期,

"resumeEnd":date||null,履歷關閉日期,

"passport":int,護照狀態[0:未完成1:已完成],

"fileJPG":string,照片檔案路徑,

"filePDF":string,履歷檔案路徑,

"height":int,身高,

"weight":int,體重,

“videoUrl”:string,影片連結,

"comeTw":int,來台經驗[0:無1:有],

"workIdState":int,id狀態[0:未完成1:已完成],

"abroadFee":int,國外辦件費,

"updatedTime":datetime,最近異動日期,

"createdTime":datetime,建立日期,

"createdBy":string,建立人員,

"createdByNo":string,建立人帳號

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API - 取得登入者業務綁定的客戶清單 [暫時客戶資料表]

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 取得登入者業務綁定的客戶清單 \[暫時客戶資料表\]
POST/GET POST
URL URL+"/sales/getCustomerListsSales"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
cusNostring客戶編號 可送空值或無送該值
cusNamestring客戶名稱 可送空值或無送該值
Return "data"(jsonArray): \[

{

"customerId": int,接單申請客戶ID,,

"cusNo": string,客戶編號,

"cusName": string,客戶名稱(XX民宿),

"contactName": string,聯絡人(林OO),

"tel": string,電話,

"address": string,地址,

"email":string,email,

"cityName":string,地區-縣市,

"regionName":string,地區-區,

"salesUserNo": string,負責業務帳號,

"salesUserName":string,負責業務,

"createdTime":datetime,建立時間,

"updatedTime":datetime,最近異動時間,

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API - 產生(新增)產學需求單

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 ##### 產生(新增)產學需求單
POST/GET POST
URL URL+"/sales/createIndustryRequire"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*customerId int 接單申請客戶ID 從API-取得登入者業務綁定的客戶清單
Return "data"(jsonObject):

{

"irNo": string,需求單號,

"irId": int,需求單ID

}

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API - 取得產學需求單基本資料

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 ##### 取得產學需求單基本資料
POST/GET POST
URL URL+"/sales/getIndustryRequireItem"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId int 需求單ID 大於1整數 可從API-產生(新增)產學需求單
Return "data"(jsonArray): \[

{

"irId": "int,需求單ID",

"irNo": "string,需求單單號",

"customerId":"int,接單申請客戶ID",

"processStatus": "int,處理狀態

[0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止]",

"createdTime": "datetime,建立需求單日期",

"updatedTime": "datetime,需求單最後更新時間",

"cusNo": "string,客戶編號",

"cusName": "string,客戶名稱 (XXX民宿)",

"contactName": "string,聯絡人(林OO)",

"tel": "string,電話",

"address": "string,地址",

"laborData(JSONArray)": [ 挑選工人清單

{

"irsId": "int,挑選ID",

"isId:" int,"學生履歷ID",

"pickStatus": int,挑選狀態 [0:挑選1:取消挑選]-此API只會回傳狀態0",

"chooseType":" int,挑選正取或備取[0正取1備取]",

"chooseIndex":" int,挑選志願序[從1開始]",

"no": "string,學生編號",

"ename": "string,姓名",

"nation": "string,國籍ID",

"birthday": "string,生日",

"old": "int,年齡",

"nationName": "string,國籍",

"education": "int,教育程度ID",

"createdTime": "string,建立時間",

"educationName": "string,教育程度",

"weight": "int,體重",

"height": "int,身高",

"fileJPG": "string,照片URL",

"comeTw":boolean,來台經驗(null為false),

"resumeStatus": "string,履歷狀態[Hide:隱藏Open:開放Chose:中選Match:合意Lab_in:已入境Something:退出Leave:合意後退出]"

},...

]

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API-儲存產學需求單挑選工人清單

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 儲存產學需求單挑選工人清單
POST/GET POST
URL URL+"/sales/updateIndustryRequireLaborList"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId int 需求單號 大於1整數 可從API-取得產學需求單基本資料得知
\*rightIds int\[\] 正取學生履歷ID 可從API-學生履歷開放清單得知
\*readyIds int\[\] 備取學生履歷ID
Return "data"(jsonObject):

{

"irNo": string,需求單號,

"irId": int,需求單ID,

"processStatus": int,需求單狀態[0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止],

}

Sample
ErrorCode

(code:2)

//檢查挑選履歷狀態須為開放。
{
  "succ": false,
  "code": "2",
  "message": "提交錯誤,SUSI履歷狀態不為開放",
  "dataTime": "2024-06-28T16:42:40.5013058+08:00",
  "data": null
}

//檢查需求單狀態須為編輯模式,否則不能提交修改。

{
  "succ": false,
  "code": "2",
  "message": "提交錯誤,需求單不為編輯狀態。",
  "dataTime": "2024-06-28T16:34:49.6411009+08:00",
  "data": null
}

//查不到需求單

{
  "succ": false,
  "code": "2",
  "message": "查詢需求單錯誤,請提供單號給系統管理員查詢。",
  "dataTime": "2024-06-28T16:39:47.2897029+08:00",
  "data": null
}

//檢查正取數量最小須為1

{
  "succ": false,
  "code": "2",
  "message": "提交錯誤,正取最小數量需為1。",
  "dataTime": "2024-06-28T16:42:40.5013058+08:00",
  "data": null
}

//檢查備取數量最小須為1

{
  "succ": false,
  "code": "2",
  "message": "提交錯誤,備取最小數量需為1。",
  "dataTime": "2024-06-28T16:42:40.5013058+08:00",
  "data": null
}
建立日期 架站建立

前台(業務登入)API-提交產學需求單

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 ##### 提交產學需求單
POST/GET POST
URL URL+"/sales/updateIndustryRequire"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId int 需求單ID 大於1整數 可從API-取得產學需求單基本資料
Return "data"(jsonArray): \[

{

"irId": int,需求單ID

}

]

Sample
ErrorCode

(code:2)

//檢查需求單狀態與存在與否
{
  "succ": false,
  "code": "2",
  "message": "查無需求單。",
  "dataTime": "2024-06-28T17:19:11.4773461+08:00",
  "data": null
}
{
  "succ": false,
  "code": "2",
  "message": "需求單狀態不為[編輯中],無法提交。",
  "dataTime": "2024-06-28T17:18:45.0894484+08:00",
  "data": null
}

//*檢查需求單的契約編碼,是否有核函實辦件日期

{

"succ": false,

"code": "2",

"message": "查無需求單。" || "接單申請作業,該契約編號已做修刪。" || "該契約編號,查無指定流程的辦件日期。" || "該契約編號,尚未建立案件管理管制作業。" || "流程:SA20(SH20)無實辦件日",

"dataTime": "2023-01-04T11:06:08.4267987+08:00",

"data": null

}

//檢查挑選履歷

{
  "succ": false,
  "code": "2",
  "message": "挑選清單空白。",
  "dataTime": "2024-06-28T17:24:35.5796156+08:00",
  "data": null
}
{
  "succ": false,
  "code": "2",
  "message": "正取人數數量未滿1位。",
  "dataTime": "2024-06-28T17:24:35.5796156+08:00",
  "data": null
}
{
  "succ": false,
  "code": "2",
  "message": "備取人數數量未滿1位。",
  "dataTime": "2024-06-28T17:24:35.5796156+08:00",
  "data": null
}
{
  "succ": false,
  "code": "2",
  "message": "挑選清單,第1位履歷不為開放模式。請移除重新挑選。",
  "dataTime": "2024-06-28T17:24:35.5796156+08:00",
  "data": null
}

//*檢查評工表

{

"succ": false,

"code": "2",

"message": "評工表無資料" || "評工表基本資料欄位[受照顧者年紀]、[受照顧者身高]、[受照顧者體重],有未填值或值未大於0。" || "評工表基本資料欄位[受照顧者疾病],未填值。" || "評工表基本資料欄位[核函類別]為重招函,需填寫[預計離境日]" || "評工表基本資料欄位[核函類別]為遞補,需填寫[遞補效期]" || "評工表一般工作內容,至少選填1項。" || "評工表住宿條件,需填入工作環境的房間數與坪數。" || "評工表住宿條件,[工作環境]選擇其他說明不得空。",

"dataTime": "2023-01-04T11:04:43.1808806+08:00",

"data": null

}

建立日期 架站建立

前台(業務登入)API-提交後取回產學需求單

URL:API ServerUrl+"/industry"

認證:前站Token

##### API名稱 ##### 提交後取回產學需求單
POST/GET POST
URL URL+"/sales/retrieveIndustryRequire"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId int 需求單ID 大於1整數 可從API-取得產學需求單基本資料
Return "data"(jsonArray): \[

{

"irId": int,需求單ID

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API-取消產學需求單

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 取消產學需求單
POST/GET POST
URL URL+"/sales/cancelIndustryRequire"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId int 需求單ID 大於1整數 可從API-取得產學需求單基本資料
result string 取消原因 0~255字串
Return "data"(jsonArray): \[

{

"irId": int,需求單ID

"succ":int,異動資料筆數 (正常2筆)

}

]

Sample
ErrorCode

(code:2)

```json { "succ": false, "code": "2", "message": "查無需求單。", "dataTime": "2024-07-01T14:01:33.7765642+08:00", "data": null } ```
{
  "succ": false,
  "code": "2",
  "message": "需求單狀態不為[編輯中],無法提交。",
  "dataTime": "2024-07-01T14:01:12.0489998+08:00",
  "data": null
}
建立日期 架站建立

前台(業務登入)API-取得產學需求單清單

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 取得產學需求單清單
POST/GET POST
URL URL+"/sales/getIndustryRequireListSales"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
irNo string 需求單號 可送空值或無送該值
cusName string ##### 客戶名稱 可送空值或無送該值
cusNo string 客戶編號 可送空值或無送該值
processStatus int 處理狀態 大於-1的整數 可送空值或無送該值

-1:不分類

【0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止】

取該業務建立的需求單列表

若以上參數皆未送,或皆送空值。(查詢範圍鎖定建立日期2年內資料)

Return "data"(jsonArray): \[

{

"irId": int,需求單ID,

"irNo": "string,需求單單號",

"customerId": "int,接單申請客戶ID",

"processStatus": int,需求單狀態

【0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止】,

"cusNo": "string,客戶編號",

"cusName": "string,客戶名稱(XXX民宿)",

"contactName": "string,聯絡人(林OO)",

"createdTime": "datetime,建立日期",

},...

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

通用API-台灣縣市_旅宿

URL:API ServerUrl+"/common"

認證:無須Token

API名稱 ##### 台灣縣市
URL URL+"/getIndustryCitys"
POST/GET POST
params X
Return "data"(jsonArray):\[{

"name": "string,縣市名稱",

"autoNo": "int,縣市ID"

}]

Sample
ErrorCode

(code:2)

建立日期 架站建立

通用API-台灣縣市區域_旅宿

URL:API ServerUrl+"/common"

認證:無須Token

API名稱 ##### 台灣縣市區域
URL URL+"/getIndustryCityRegions"
POST/GET POST
params cityId:\[int\]縣市ID
Return "data"(jsonArray):\[{

"pkId": "int,區域ID",

"region": "string,區域名稱",

"cityId": "int,縣市ID",

"regionCode": "string,郵遞區號"

}]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(未登入)API-學生履歷開放清單_國籍總覽[*目前不使用]

URL:API ServerUrl+"/industry"

API名稱學生履歷開放清單\_國籍總覽(10筆)
POST/GETPOST
URLURL+"/getStudentsListAllNat"
TokenNo
params \[FromData\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*nationNos string\[\] 國家ID 01:泰國

02:菲律賓

03:印尼

05:越南

Return"data"(jsonArray):\[{

"nationNo": "string, 國家ID",

"totalStudents": int,學生履歷張數,

"studentData"(jsonArray, 最多10筆資料): [{

"id": "int,學生履歷ID",

"no": "string,學生履歷編號",

"ename": "string,學生英文姓名",

"nation": "string,國籍ID",

"birthday": "date,學生生日",

"old": "int,學生年齡",

"nationName": "string,國籍",

"education": "int,教育程度ID",

"createdTime": "datetime,建立時間",

"educationName": "string,教育程度",

"weight": "int,體重",

"height": "int,身高",

"photoFile": "string,照片URL",

"comeTw":boolean,來台經驗(null為false),

"resumeStatus": "string,履歷狀態",

"sourceFrom":"int,學生來源(1:門市招募2:直聘工3:指定工4:回鍋工5:赴海外挑工6:新工)",

"videoUrl": "string,影片連結"

}]

}]

Sample
ErrorCode(code:2)
建立日期架站建立

前台(業務登入)API-取得某客戶的所有產學需求單清單[*棄用]

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 取得某客戶的所有產學需求單清單
POST/GET POST
URL URL+"/sales/getCustomerIndustryRequireLists"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*customerIdint接單申請客戶ID大於1整數從API-取得登入者業務綁定的客戶清單
Return "data"(jsonArray): \[

{

"irId": int,需求單ID,

"irNo": string,需求單號,

"customerId": int,接單申請客戶ID,

"cusName": string,客戶名稱,

"contactName":string,聯絡人,

"salesUserNo":int,負責業務帳號,

"salesUserName":string,負責業務,

"verifyStatus":int,客戶資料審核狀態[0:待審核1: 審核通過2: 審核失敗],

"processStatus":tinyint,需求單狀態 [0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止]",

"applyRole":string,哪個角色提出申請 sales:業務,

"isUploadEvaluate":int,是否已上傳回簽評工表[0:無1:有],

}

]

Sample
ErrorCode

(code:2)

建立日期 架站建立

前台(業務登入)API-取得產學需求單挑選工人清單[*目前不使用]

URL:API ServerUrl+"/industry"

認證:前站Token

API名稱 取得產學需求單挑選工人清單
POST/GET POST
URL URL+"/sales/getIndustryRequireLaborList"
Token Yes
params \[FromForm\]
參數名

*為必送參數

型態 說明 限制 參數意義
\*irId string 需求單號
Return "data"(jsonArray): \[

{

"irId": int,需求單ID,

"irNo": "string,需求單單號",

"customerId": "int,接單申請客戶ID",

"processStatus": int,需求單狀態

【0:編輯中 1:申請中 2:媒合中 3:已合意 4:結案 5:中止】,

"cusNo": "string,客戶編號",

"cusName": "string,客戶名稱(XX民宿)",

"contactName": "string,聯絡人(林OO)",

"tel": "string,電話",

"address": "string,地址",

"salesUserNo": "string,負責業務帳號",

"applyRole": "string,哪個角色提出申請 sales:業務",

"verifyStatus": "int,客戶資料審核狀態[0:待審核1:審核通過2:審核失敗]",

"createdTime": "datetime,建立日期",

"laborData(JSONArray)": [ 挑選工人清單

{

"irsId": "int,挑選工人清單ID",

"isId:" int,"學生履歷ID",

"pickStatus": int,挑選狀態

[0:挑選1:取消挑選]-此API只會回傳狀態0",

"chooseType":" int,挑選志願序[0正取1備取]",

"chooseIndex":" int,挑選志願序[從1開始]",

"no": "string,仲介學生編號",

"ename": "string,學生姓名",

"nation": "string,國籍編號",

"birthday": "datetime,學生生日",

"old": "int,學生年齡",

"nationName": "string,國籍",

"education": "int,教育程度ID",

"createdTime": "datetime,建立時間",

"educationName": "string,教育程度",

"weight": "int,學生體重",

"height": "int,學生身高",

"fileJPG": "string,照片URL",

"comeTw":boolean,來台經驗(null為false),

"resumeStatus": "string,履歷狀態"

},...

]

},.....

]

Sample
ErrorCode

(code:2)

建立日期 架站建立