@codihaus/odp-app-hr 0.1.0

package/server/api/hr/settings/leave-types/[id].delete.ts

@@ -0,0 +1,14 @@
+import { customEndpoint } from "@odp/sdk"
+
+export default defineEventHandler(async (event) => {
+    assertPermission(event, { module: 'hr', action: 'admin' })
+    const id = getRouterParam(event, 'id')
+    const userApi = event.context.userApi
+
+    const result = await userApi.request(customEndpoint({
+        path: `/hr/settings/leave-types/${id}`,
+        method: "DELETE",
+    }))
+
+    return result
+})

package/server/api/hr/settings/leave-types/[id].patch.ts

@@ -0,0 +1,16 @@
+import { customEndpoint } from "@odp/sdk"
+
+export default defineEventHandler(async (event) => {
+    assertPermission(event, { module: 'hr', action: 'admin' })
+    const id = getRouterParam(event, 'id')
+    const body = await readBody(event)
+    const userApi = event.context.userApi
+
+    const result = await userApi.request(customEndpoint({
+        path: `/hr/settings/leave-types/${id}`,
+        method: "PATCH",
+        body: JSON.stringify(body),
+    }))
+
+    return result
+})

package/server/api/hr/settings/leave-types/index.get.ts

@@ -0,0 +1,13 @@
+import { customEndpoint } from "@odp/sdk"
+
+export default defineEventHandler(async (event) => {
+    assertPermission(event, { module: 'hr', action: 'read' })
+    const userApi = event.context.userApi
+
+    const result = await userApi.request(customEndpoint({
+        path: "/hr/settings/leave-types",
+        method: "GET",
+    }))
+
+    return result
+})

package/server/api/hr/settings/leave-types/index.post.ts

@@ -0,0 +1,15 @@
+import { customEndpoint } from "@odp/sdk"
+
+export default defineEventHandler(async (event) => {
+    assertPermission(event, { module: 'hr', action: 'admin' })
+    const body = await readBody(event)
+    const userApi = event.context.userApi
+
+    const result = await userApi.request(customEndpoint({
+        path: "/hr/settings/leave-types",
+        method: "POST",
+        body: JSON.stringify(body),
+    }))
+
+    return result
+})

package/shared/types/form-layout.ts

@@ -0,0 +1,30 @@
+export interface HrFormField {
+    key: string
+    label?: string
+    type?: string
+    colspan?: number
+    options?: Array<{ value: string, label: string }>
+    required?: boolean
+    placeholder?: string
+}
+
+export interface HrFormSection {
+    title?: string
+    columns?: 1 | 2
+    fields: HrFormField[]
+}
+
+export type HrFormLayout = HrFormSection[]
+
+export interface HrInfoRow {
+    label: string
+    key: string
+    format?: 'date' | 'currency' | 'phone' | 'badge'
+}
+
+export interface HrInfoSection {
+    title?: string
+    rows: HrInfoRow[]
+}
+
+export type HrInfoLayout = HrInfoSection[]

package/shared/types/index.ts

@@ -0,0 +1,2 @@
+// Nuxt auto-imports from individual files in shared/types/
+// Do not re-export here to avoid duplicated import warnings

package/shared/types/integration.ts

@@ -0,0 +1,41 @@
+export type ProviderType = 'authentik' | 'google_workspace' | 'microsoft_365' | 'webhook'
+
+export interface HrProvider {
+    id: string
+    name: string
+    type: ProviderType
+    config: Record<string, unknown>
+    enabled: boolean
+    default_group?: string
+    actions: {
+        on_hire: boolean
+        on_resign: boolean
+        on_reactivate: boolean
+    }
+    date_created?: string
+    date_updated?: string
+}
+
+export interface HrProvisioningLog {
+    id: string
+    person_id: string
+    provider_id: string
+    action: 'create' | 'disable' | 'enable' | 'retry'
+    status: 'success' | 'failed' | 'skipped'
+    request_payload?: Record<string, unknown>
+    response_data?: Record<string, unknown>
+    error_message?: string | null
+    date_created: string
+}
+
+export interface ProvisioningStatus {
+    provider_id: string
+    provider_name: string
+    provider_type: ProviderType
+    status: 'active' | 'disabled' | 'not_created' | 'error'
+    username: string | null
+    last_action: string | null
+    last_action_date: string | null
+    last_error: string | null
+    last_log_id: string | null
+}

package/shared/types/leave.ts

@@ -0,0 +1,53 @@
+export interface LeaveType {
+    id: number
+    name: string
+    key: string
+    color?: string
+    archived?: boolean
+}
+
+export interface LeaveBalance {
+    id: number
+    person_id: number | string
+    leave_type_id: LeaveType | number
+    policy_total: number
+    override_total?: number | null
+    override_reason?: string | null
+    used: number
+    // Computed helpers (front-end only)
+    total?: number
+    remaining?: number
+    source?: 'policy' | 'override'
+    type?: string
+    policy_value?: number
+    override_note?: string
+}
+
+export interface LeaveRequest {
+    id: string | number
+    person_id: string | number
+    person_name?: string
+    leave_type_id: LeaveType | number
+    leave_type?: string
+    start_date: string
+    end_date: string
+    from_date?: string
+    to_date?: string
+    days_count?: number
+    days?: number
+    reason?: string
+    status: 'Pending' | 'Approved' | 'Rejected' | 'Cancelled'
+    reject_reason?: string
+    reviewed_by?: string
+    reviewed_at?: string
+    date_created?: string
+}
+
+export interface CompanyHoliday {
+    id: number
+    name: string
+    date: string
+    year?: number
+    recurring?: boolean
+    sort?: number
+}

package/shared/types/offboarding.ts

@@ -0,0 +1,46 @@
+export type OffboardingStatus = 'initiated' | 'in_progress' | 'completed' | 'cancelled'
+export type OffboardingExitType = 'voluntary' | 'involuntary' | 'mutual' | 'contract_end' | 'retirement'
+export type OffboardingTaskStatus = 'pending' | 'done' | 'na'
+
+export interface OffboardingTask {
+    id: number
+    offboarding_id: number
+    key: string
+    label: string
+    category: string
+    status: OffboardingTaskStatus
+    assignee?: string | null
+    completed_by?: string | null
+    completed_at?: string | null
+    notes?: string | null
+    sort?: number
+}
+
+export interface Offboarding {
+    id: number
+    person_id: number
+    status: OffboardingStatus
+    exit_type: OffboardingExitType
+    reason?: string | null
+    notice_date?: string | null
+    last_working_day?: string | null
+    rehire_eligible?: boolean
+    exit_interview_notes?: string | null
+    exit_interview_rating?: number | null
+    leave_payout_days?: number | null
+    leave_payout_amount?: number | null
+    final_settlement_notes?: string | null
+    workflow_instance_id?: string | null
+    initiated_by?: string | null
+    completed_by?: string | null
+    completed_at?: string | null
+    date_created?: string
+    date_updated?: string
+    tasks?: OffboardingTask[]
+}
+
+export interface OffboardingSettlement {
+    year: number
+    lines: { leave_type: string, allocated: number, used: number, remaining: number }[]
+    totalRemainingDays: number
+}

package/shared/types/person.ts

@@ -0,0 +1,54 @@
+export const LIFECYCLE_STAGES = ['talent', 'interviewing', 'offer', 'probation', 'active', 'resigned'] as const
+
+export type LifecycleStage = typeof LIFECYCLE_STAGES[number]
+
+export interface StageTransition {
+    id: string
+    person_id: string
+    from_stage: LifecycleStage | null
+    to_stage: LifecycleStage
+    reason?: string
+    performed_by?: string
+    date_created: string
+}
+
+export interface HrNote {
+    id: string
+    person_id: string
+    body: string
+    author?: string | null
+    date_created: string
+}
+
+export interface Person {
+    id: string
+    stage: LifecycleStage
+    employee_id?: string
+
+    // Identity
+    first_name: string
+    last_name: string
+    display_name: string
+    email?: string
+    phone?: string
+    avatar?: string | null
+    date_of_birth?: string
+    gender?: string
+    nationality?: string
+    id_number?: string
+    address?: string
+
+    // Recruitment
+    desired_position?: string
+    source?: string
+    department_id?: number | null
+
+    // Employment (filled after hire)
+    employment_type_id?: number | null
+    job_title?: string
+    start_date?: string
+    end_date?: string
+
+    date_created: string
+    date_updated?: string
+}

package/shared/types/settings.ts

@@ -0,0 +1,16 @@
+export interface HrSettings {
+    id: number
+    company_name?: string
+    currency?: string            // default 'VND'
+    fiscal_year_start?: number   // 1-12 (month)
+    probation_months_default?: number
+    leave_year_start?: number    // 1-12
+
+    // Stage label overrides (optional, defaults to LifecycleStage enum)
+    label_talent?: string
+    label_interviewing?: string
+    label_offer?: string
+    label_probation?: string
+    label_active?: string
+    label_resigned?: string
+}

package/shared/utils/template-render.ts

@@ -0,0 +1,155 @@
+import MarkdownIt from "markdown-it"
+
+export type Context = Record<string, unknown>
+
+type Node
+    = | { kind: "text", value: string }
+        | { kind: "interp", path: string, format?: string }
+        | { kind: "each", path: string, body: Node[] }
+        | { kind: "if", path: string, body: Node[] }
+
+const md = new MarkdownIt({ html: false, linkify: true, breaks: true })
+
+interface Token {
+    kind: "text" | "open_each" | "close_each" | "open_if" | "close_if" | "interp"
+    raw: string
+    path?: string
+    format?: string
+    value?: string
+}
+
+const DIRECTIVE_RE = /\{\{\s*([^}]+?)\s*\}\}/g
+
+function tokenize(body: string): Token[] {
+    const tokens: Token[] = []
+    let lastIdx = 0
+    for (const match of body.matchAll(DIRECTIVE_RE)) {
+        const matchIdx = match.index!
+        if (matchIdx > lastIdx) {
+            const text = body.slice(lastIdx, matchIdx)
+            tokens.push({ kind: "text", raw: text, value: text })
+        }
+        const inner = match[1]!.trim()
+        if (inner.startsWith("#each ")) {
+            tokens.push({ kind: "open_each", raw: match[0], path: inner.slice(6).trim() })
+        } else if (inner === "/each") {
+            tokens.push({ kind: "close_each", raw: match[0] })
+        } else if (inner.startsWith("#if ")) {
+            tokens.push({ kind: "open_if", raw: match[0], path: inner.slice(4).trim() })
+        } else if (inner === "/if") {
+            tokens.push({ kind: "close_if", raw: match[0] })
+        } else {
+            const parts = inner.split("|").map(s => s.trim())
+            tokens.push({ kind: "interp", raw: match[0], path: parts[0]!, format: parts[1] })
+        }
+        lastIdx = matchIdx + match[0].length
+    }
+    if (lastIdx < body.length) {
+        const text = body.slice(lastIdx)
+        tokens.push({ kind: "text", raw: text, value: text })
+    }
+    return tokens
+}
+
+function parse(tokens: Token[]): Node[] {
+    const stack: Node[][] = [[]]
+    const meta: Array<{ kind: "each" | "if", path: string }> = []
+
+    for (const t of tokens) {
+        const top = stack[stack.length - 1]!
+        if (t.kind === "text") {
+            top.push({ kind: "text", value: t.value! })
+        } else if (t.kind === "interp") {
+            top.push({ kind: "interp", path: t.path!, format: t.format })
+        } else if (t.kind === "open_each") {
+            stack.push([])
+            meta.push({ kind: "each", path: t.path! })
+        } else if (t.kind === "open_if") {
+            stack.push([])
+            meta.push({ kind: "if", path: t.path! })
+        } else if (t.kind === "close_each" || t.kind === "close_if") {
+            const inner = stack.pop()!
+            const m = meta.pop()!
+            const parent = stack[stack.length - 1]!
+            parent.push({ kind: m.kind, path: m.path, body: inner } as Node)
+        }
+    }
+
+    if (stack.length !== 1) throw new Error("Template: unbalanced block directive")
+    return stack[0]!
+}
+
+function getPath(ctx: unknown, path: string): unknown {
+    if (path === "today") return new Date().toISOString().slice(0, 10)
+    const parts = path.split(".")
+    let cur: unknown = ctx
+    for (const part of parts) {
+        if (cur == null) return undefined
+        const m = part.match(/^([^[]+)\[(\d+)\]$/)
+        if (m) {
+            cur = (cur as Record<string, unknown>)[m[1]!]
+            if (Array.isArray(cur)) cur = cur[parseInt(m[2]!, 10)]
+            else return undefined
+        } else {
+            cur = (cur as Record<string, unknown>)[part]
+        }
+    }
+    return cur
+}
+
+function formatValue(value: unknown, format?: string): string {
+    if (value == null) return ""
+    if (format === "long" && typeof value === "string" && /^\d{4}-\d{2}-\d{2}/.test(value)) {
+        const d = new Date(value)
+        if (!Number.isNaN(d.getTime())) {
+            return d.toLocaleDateString("en-GB", { day: "numeric", month: "long", year: "numeric" })
+        }
+    }
+    if (typeof value === "object") return JSON.stringify(value)
+    return String(value)
+}
+
+function isTruthy(value: unknown): boolean {
+    if (value == null) return false
+    if (Array.isArray(value)) return value.length > 0
+    if (typeof value === "string") return value.length > 0
+    if (typeof value === "number") return value !== 0
+    if (typeof value === "object") return Object.keys(value as object).length > 0
+    return Boolean(value)
+}
+
+function renderNodes(nodes: Node[], ctx: Context): string {
+    let out = ""
+    for (const n of nodes) {
+        if (n.kind === "text") out += n.value
+        else if (n.kind === "interp") out += formatValue(getPath(ctx, n.path), n.format)
+        else if (n.kind === "if") { if (isTruthy(getPath(ctx, n.path))) out += renderNodes(n.body, ctx) } else if (n.kind === "each") {
+            const list = getPath(ctx, n.path)
+            if (Array.isArray(list)) {
+                for (const item of list) out += renderNodes(n.body, item as Context)
+            }
+        }
+    }
+    return out
+}
+
+export function renderTemplateMarkdown(body: string, ctx: Context): string {
+    return renderNodes(parse(tokenize(body)), ctx)
+}
+
+export function renderTemplateHtml(body: string, ctx: Context): string {
+    return md.render(renderTemplateMarkdown(body, ctx))
+}
+
+export const PLACEHOLDER_HINTS_PERSON: string[] = [
+    "full_name", "email", "employee_id", "department", "job_title",
+    "employment_type", "start_date", "manager", "work_location",
+    "contract.type", "contract.start_date", "contract.end_date", "contract.probation_end",
+    "compensation.base_salary", "compensation.currency", "compensation.pay_frequency",
+    "insurance.social_insurance_number", "insurance.tax_code",
+    "emergency_contact.name", "emergency_contact.phone",
+    "resignation.last_day", "resignation.reason",
+    "today",
+    "#each assets", "/each", "#each interviews", "/each",
+    "#if resignation.last_day", "/if",
+]