@ehfuse/taskbox 0.5.257 → 0.5.259

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -10,3 +10,4 @@ export * from "./employee";
10
10
  export * from "./provider";
11
11
  export * from "./theme";
12
12
  export * from "./workload";
13
+ export * from "./taskTemplate";
@@ -0,0 +1,49 @@
1
+ /**
2
+ * 업무 묶음 템플릿(프로젝트 템플릿) 타입이다 — 정형 절차를 **업무 여러 건 + 날짜까지** 통째로 찍어낸다.
3
+ *
4
+ * 본문 양식(TaskContentTemplate)이 "한 건의 본문"이라면 이쪽은 "절차 전체"다.
5
+ * 핵심은 두 가지다. ① 묶음 생성 ② **상대 일수(D+n)** — 기준일을 한 번 정하면 각 업무의 날짜가 계산된다
6
+ * (장례 절차·신규 입사자 온보딩처럼 매번 같은 순서로 도는 일이 대상이다).
7
+ *
8
+ * 반복 업무와 다른 축이다: 반복은 **같은 업무가 주기적으로** 도는 것이고,
9
+ * 템플릿은 **다른 업무 여러 건이 한 사건에서** 한꺼번에 파생되는 것이다.
10
+ */
11
+ import type { TaskBoxPriority } from "./item";
12
+ /** 템플릿 항목 1건이다(= 실행하면 업무 1건이 된다). */
13
+ export interface TaskTemplateItem {
14
+ title: string;
15
+ content?: string;
16
+ start_offset_days?: number;
17
+ due_offset_days?: number;
18
+ priority?: TaskBoxPriority;
19
+ label_keys?: string[];
20
+ manager_account_seq?: number;
21
+ manager_name?: string;
22
+ checklist?: string[];
23
+ }
24
+ /** 업무 묶음 템플릿 1건이다. */
25
+ export interface TaskBoxTaskTemplate {
26
+ seq: number;
27
+ name: string;
28
+ description?: string;
29
+ group_seq?: number;
30
+ items: TaskTemplateItem[];
31
+ }
32
+ /** 템플릿 저장 입력이다(등록·수정 공용 — seq 는 수정에만 쓴다). */
33
+ export type TaskBoxTaskTemplateInput = Omit<TaskBoxTaskTemplate, "seq">;
34
+ /** 템플릿을 실행해 만들 업무 1건의 값이다(소비처가 이대로 등록 API 를 부른다). */
35
+ export interface TaskTemplatePlannedTask {
36
+ title: string;
37
+ content: string;
38
+ start_date: string;
39
+ due_date: string;
40
+ priority: TaskBoxPriority;
41
+ label_keys: string[];
42
+ manager_account_seq: number;
43
+ manager_name: string;
44
+ checklist: {
45
+ label: string;
46
+ checked: boolean;
47
+ }[];
48
+ group_seq: number;
49
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * 업무 묶음 템플릿 계산 유틸이다 — 기준일 + 상대 일수(D+n)로 실제 날짜를 만든다.
3
+ *
4
+ * 여기는 **순수 계산**만 둔다(등록 API 호출은 소비처 몫). 그래야 "3월 2일 실행하면 어떤 날짜가 나오나"를
5
+ * 화면 미리보기와 실제 생성이 **같은 함수**로 계산하게 되어 둘이 어긋나지 않는다.
6
+ */
7
+ import type { TaskBoxTaskTemplate, TaskTemplateItem, TaskTemplatePlannedTask } from "../types";
8
+ /**
9
+ * 기준일에서 n일 뒤 날짜를 만든다("YYYY-MM-DD").
10
+ * 기준일 형식이 아니거나 n 이 숫자가 아니면 빈 문자열이다(날짜 없는 업무가 된다).
11
+ */
12
+ export declare function addDaysToDate(baseDate: string, days: number | undefined): string;
13
+ /** 템플릿 항목 하나를 실제 업무 값으로 편다. */
14
+ export declare function buildPlannedTask(item: TaskTemplateItem, baseDate: string, groupSeq: number): TaskTemplatePlannedTask;
15
+ /**
16
+ * 템플릿 전체를 실행 계획으로 편다 — 제목이 빈 항목은 버린다(만들어 봐야 못 알아보는 업무가 된다).
17
+ * 만드는 순서는 템플릿에 적힌 순서 그대로다(사람이 절차 순으로 적어 둔 것이 곧 순서다).
18
+ */
19
+ export declare function buildTemplateTasks(template: TaskBoxTaskTemplate, baseDate: string): TaskTemplatePlannedTask[];
20
+ /** 상대 일수를 사람이 읽는 표시로 만든다(D+0 = 기준일, 음수도 허용 — 사전 준비 업무). */
21
+ export declare function formatOffsetLabel(days: number | undefined): string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ehfuse/taskbox",
3
- "version": "0.5.257",
3
+ "version": "0.5.259",
4
4
  "description": "A React/MUI task inbox component with notices, per-user assignments, read tracking, and mobile card UI",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",