hr-position-system/docs/# 系統表單欄位規範書 v1.1 (UX Optimized).md

系統表單欄位規範書 v1.1 (UX Optimized)

設計原則 (UX Design Principles):

1. Context First: 先確認組織架構 (BU/Dept)，再定義具體內容。
2. Key Data Top: 核心識別資料 (編號/名稱) 置頂。
3. Group by Type: 下拉選單 (Select) 集中，開關 (Switch) 集中，長文字 (Textarea) 沉底。

---

1. 崗位基礎資料模組 (Position Module)

表單代號: positionForm 資料表: Position

1.1 基礎資料頁籤 (tab-position-basic)

UX 邏輯: 先選組織(過濾條件) → 填寫核心識別 → 設定分類屬性 → 填寫詳細描述。

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
[組織定義]
1	事業體	pos_businessUnit	businessUnit	select	否	聯動 L1
2	處級單位	pos_division	division	select	否	聯動 L2
3	部級單位	pos_department	department	select	否	聯動 L3
4	課級單位	pos_section	section	text	否	-
[核心識別]
5	崗位編號	pos_code	positionCode	text	是	唯一識別
6	崗位名稱	pos_name	positionName	text	是	-
7	生效日期	pos_effectiveDate	effectiveDate	date	否	預設今日
[分類屬性]
8	崗位級別	pos_level	positionLevel	select	否	L1-L7
9	崗位類別	pos_category	positionCategory	select	否	連動帶出名稱
10	崗位類別名稱	pos_categoryName	positionCategoryName	text	否	Readonly
11	崗位性質	pos_type	positionType	select	否	FT/PT/CT...
12	崗位性質名稱	pos_typeName	positionTypeName	text	否	Readonly
13	編制人數	pos_headcount	headcount	number	否	-
[詳細描述]
14	崗位描述	pos_desc	description	textarea	否	rows=6
15	崗位備注	pos_remark	remark	textarea	否	rows=4

1.2 招聘要求資料頁籤 (tab-position-recruit)

UX 邏輯: 先定義「要招什麼樣的人(Target)」→「硬性條件(Must)」→「軟性技能(Plus)」→「廣告文案(Text)」。

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
[招聘職位定義]
1	招聘職位代碼	rec_position	recruitPosition	select	否	ENG, MGR...
2	對外職稱	rec_jobTitle	jobTitle	text	否	顯示在招聘網的名稱
3	上級崗位編號	rec_superiorCode	superiorPositionCode	text	否	-
4	工作性質	rec_jobType	jobType	select	否	招聘用分類
[硬性資格]
5	最低學歷	rec_eduLevel	educationLevel	select	否	-
6	專業要求	rec_majorReq	majorRequirements	text	否	Modal 選擇
7	工作經驗	rec_expYears	experienceYears	select	否	-
8	薪酬范圍	rec_salaryRange	salaryRange	select	否	-
9	要求性別	rec_gender	requiredGender	select	否	-
10	年齡限制 (Min)	rec_minAge	minAge	number	否	併排顯示
11	年齡限制 (Max)	rec_maxAge	maxAge	number	否	併排顯示
[技能與證照]
12	語言要求	rec_langReq	langRequirements	text	否	-
13	證照要求	rec_certReq	certRequirements	select	否	-
14	技能要求	rec_skillReq	skillRequirements	text	否	Tag input
15	其他要求	rec_otherReq	otherRequirements	text	否	-
[文案描述]
16	職位描述 (JD)	rec_jobDesc	recruitJobDesc	textarea	否	廣告用
17	崗位要求 (Req)	rec_positionReq	recruitRequirements	textarea	否	廣告用
18	招聘備注	rec_remark	recruitRemark	textarea	否	內部用

---

2. 職務基礎資料模組 (Job Module)

表單代號: jobForm 資料表: Job

UX 邏輯: 先分類 → 再命名 → 設定權限/福利(開關) → 備註。

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
[分類與識別]
1	職務類別	job_category	jobCategoryCode	select	是	-
2	職務類別名稱	job_categoryName	jobCategoryName	text	否	Readonly
3	職務編號	job_code	jobCode	text	是	-
4	職務名稱	job_name	jobName	text	是	-
5	職務英文名稱	job_nameEn	jobNameEn	text	否	-
[屬性設定]
6	職務層級	job_level	jobLevel	text	否	敏感欄位
7	生效日期	job_effectiveDate	effectiveDate	date	否	-
8	排列順序	job_sortOrder	sortOrder	number	否	-
9	預算編制人數	job_headcount	headcount	number	否	-
[福利開關]
10	全勤獎金	job_hasAttBonus	hasAttendanceBonus	checkbox	否	Toggle Switch
11	住房補貼	job_hasHouseAllow	hasHousingAllowance	checkbox	否	Toggle Switch
[備註]
12	職務備注	job_remark	remark	textarea	否	-

---

3. 部門職責模組 (DeptFunction Module)

表單代號: deptFunctionForm 資料表: DeptFunction

UX 邏輯: 組織架構 → 核心職責定義 → 管理與規模 → 策略性描述(使命/願景)。

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
[基本定義]
1	事業體	df_businessUnit	businessUnit	select	是	-
2	處級單位	df_division	division	select	是	-
3	部級單位	df_department	department	select	是	-
4	課級單位	df_section	section	text	否	-
5	職責編號	df_code	dfCode	text	是	-
6	職責名稱	df_name	dfName	text	是	-
[管理架構]
7	對應崗位	df_posTitle	positionTitle	select	是	綁定 Position
8	崗位級別	df_posLevel	positionLevel	select	否	-
9	部門主管職稱	df_managerTitle	managerTitle	text	否	-
10	人數上限	df_headcountLimit	headcountLimit	number	否	-
11	生效日期	df_effectiveDate	effectiveDate	date	是	-
12	狀態	df_status	status	select	否	Active/Inactive
[策略職責]
13	核心職責	df_coreFunc	coreFunctions	textarea	是	重點欄位 (Top)
14	部門使命	df_mission	mission	textarea	否	-
15	部門願景	df_vision	vision	textarea	否	-
16	KPIs	df_kpis	kpis	textarea	否	-
17	協作部門	df_collab	collaboration	textarea	否	-
18	備注	df_remark	remark	textarea	否	-

---

4. 崗位描述模組 (JobDescription Module)

表單代號: jobDescForm 資料表: JobDescription

UX 邏輯:

1. Header: 快速鎖定「這是誰的JD」。
2. Readonly Area: 顯示「他在哪裡工作」(提供撰寫JD的上下文)。
3. Reporting: 釐清「上下級關係」。
4. Main Body: 撰寫「做什麼」(Purpose/Resp)。
5. Requirements: 撰寫「需要什麼條件」。

4.1 識別與上下文 (Header & Context)

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
[員工綁定]
1	選擇員工(工號)	jd_empNo	empNo	text	否	搜尋 Modal
2	姓名	jd_empName	empName	text	否	Readonly
3	版本日期	jd_versionDate	versionDate	date	否	-
[崗位背景 (唯讀)]
4	崗位代碼	jd_posCode	positionCode	text	否	關聯鍵
5	崗位名稱	jd_posName	positionName	text	否	Readonly
6	所屬部門	jd_department	department	text	否	Readonly (組合字串)
7	任職地點	jd_location	workLocation	select	否	-
8	員工屬性	jd_empAttr	empAttribute	select	否	FT/PT...
9	部門職責引用	jd_dfCode	dfCode	text	否	關聯 DF 模組

4.2 匯報關係 (Reporting Lines)

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
10	直接主管	jd_supervisor	directSupervisor	text	否	姓名/職稱
11	匯報對象	jd_reportTo	reportTo	text	否	系統職務節點
12	職等&職務	jd_gradeJob	positionGradeJob	text	否	HR 用級別
13	直接下屬	jd_directReports	directReports	text	否	人數或職稱

4.3 職責詳情 (Responsibilities)

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
14	崗位設置目的	jd_purpose	positionPurpose	text	否	一句話摘要
15	主要職責	jd_mainResp	mainResponsibilities	textarea	否	核心內容 (大區塊)

4.4 任職資格 (Requirements)

#	欄位顯示名稱	標準化 HTML ID	資料庫欄位名稱	類型	必填	備註
16	教育程度	jd_eduLevel	educationLevel	text	否	-
17	工作經驗	jd_expReq	experienceRequirements	textarea	否	-
18	專業知識	jd_proKnowledge	professionalKnowledge	textarea	否	-
19	基本技能	jd_basicSkills	basicSkills	textarea	否	-
20	其他要求	jd_otherReq	otherRequirements	textarea	否	-