@codihaus/odp-app-hr 0.1.0

package/app/lib/policy-engine.ts

@@ -0,0 +1,116 @@
+import type {
+    Person, Policy, PolicyKey,
+    AnnualLeaveBaseParams, AnnualLeaveTenureBonusParams,
+    SickLeaveBaseParams, PersonalLeaveBaseParams,
+    InsuranceEligibilityParams, ProbationPeriodParams,
+    LeaveBalance, BenefitFlag,
+} from "../types"
+
+const MS_PER_YEAR = 365.25 * 24 * 3600 * 1000
+
+export function tenureYears(start_date: string | undefined, asOf: Date = new Date()): number {
+    if (!start_date) return 0
+    const start = new Date(start_date).getTime()
+    if (Number.isNaN(start)) return 0
+    return Math.max(0, (asOf.getTime() - start) / MS_PER_YEAR)
+}
+
+export function highestApplicableBonus(
+    tiers: AnnualLeaveTenureBonusParams["tiers"],
+    years: number,
+): number {
+    let bonus = 0
+    for (const t of tiers) {
+        if (years >= t.after_years && t.bonus > bonus) bonus = t.bonus
+    }
+    return bonus
+}
+
+function getPolicy<P>(policies: Policy[], key: PolicyKey): P | null {
+    const p = policies.find(p => p.key === key && p.enabled)
+    return p ? (p.params as P) : null
+}
+
+interface ComputedLeaveTotal { type: string, total: number }
+
+export function computeLeavePolicyValues(person: Person, policies: Policy[]): ComputedLeaveTotal[] {
+    const out: ComputedLeaveTotal[] = []
+    const empType = person.employment_type ?? "Full-time"
+
+    const annualBase = getPolicy<AnnualLeaveBaseParams>(policies, "annual_leave_base")
+    const annualBonus = getPolicy<AnnualLeaveTenureBonusParams>(policies, "annual_leave_tenure_bonus")
+    const sickBase = getPolicy<SickLeaveBaseParams>(policies, "sick_leave_base")
+    const personalBase = getPolicy<PersonalLeaveBaseParams>(policies, "personal_leave_base")
+
+    if (annualBase) {
+        const base = annualBase.days_by_employment_type[empType] ?? 0
+        const bonus = annualBonus
+            ? highestApplicableBonus(annualBonus.tiers, tenureYears(person.start_date))
+            : 0
+        out.push({ type: "annual", total: base + bonus })
+    }
+    if (sickBase) {
+        out.push({ type: "sick", total: sickBase.days_by_employment_type[empType] ?? 0 })
+    }
+    if (personalBase) {
+        out.push({ type: "personal", total: personalBase.days_by_employment_type[empType] ?? 0 })
+    }
+    return out
+}
+
+export function computeBenefitsPolicyValues(person: Person, policies: Policy[]): { key: string, eligible: boolean }[] {
+    const out: { key: string, eligible: boolean }[] = []
+    const empType = person.employment_type ?? "Full-time"
+
+    const health = getPolicy<InsuranceEligibilityParams>(policies, "health_insurance_eligibility")
+    const social = getPolicy<InsuranceEligibilityParams>(policies, "social_insurance_eligibility")
+
+    if (health) {
+        out.push({ key: "health_insurance", eligible: health.employment_types.includes(empType) })
+    }
+    if (social) {
+        out.push({ key: "social_insurance", eligible: social.employment_types.includes(empType) })
+    }
+    return out
+}
+
+export function suggestProbationMonths(person: Person, policies: Policy[]): number | null {
+    const probation = getPolicy<ProbationPeriodParams>(policies, "probation_period")
+    if (!probation) return null
+    const empType = person.employment_type ?? "Full-time"
+    return probation.months_by_employment_type[empType] ?? null
+}
+
+export function applyPolicies(person: Person, policies: Policy[]): Person {
+    const leaveTotals = computeLeavePolicyValues(person, policies)
+    const benefitVals = computeBenefitsPolicyValues(person, policies)
+
+    const next_leave_balance: LeaveBalance[] = leaveTotals.map(({ type, total }) => {
+        const existing = person.leave_balance.find(l => l.type === type)
+        if (existing && existing.source === "override") {
+            return { ...existing, policy_value: total, remaining: existing.total - existing.used }
+        }
+        const used = existing?.used ?? 0
+        return { type, total, used, remaining: total - used, source: "policy", policy_value: total }
+    })
+
+    const policyTypes = new Set(leaveTotals.map(l => l.type))
+    for (const existing of person.leave_balance) {
+        if (!policyTypes.has(existing.type)) next_leave_balance.push(existing)
+    }
+
+    const next_benefits_eligibility: BenefitFlag[] = benefitVals.map(({ key, eligible }) => {
+        const existing = person.benefits_eligibility.find(b => b.key === key)
+        if (existing && existing.source === "override") {
+            return { ...existing, policy_value: eligible }
+        }
+        return { key, eligible, source: "policy", policy_value: eligible }
+    })
+
+    const policyBenefitKeys = new Set(benefitVals.map(b => b.key))
+    for (const existing of person.benefits_eligibility) {
+        if (!policyBenefitKeys.has(existing.key)) next_benefits_eligibility.push(existing)
+    }
+
+    return { ...person, leave_balance: next_leave_balance, benefits_eligibility: next_benefits_eligibility }
+}

package/app/pages/hr/departments.vue

@@ -0,0 +1,114 @@
+<template>
+    <ModulePage
+        :title="$t('departments.title')"
+        icon="i-ph-tree-structure-light"
+        padding="default"
+        max-width="full"
+    >
+        <template #actions>
+            <UButton
+                v-if="canCreate"
+                icon="i-ph-plus"
+                :label="$t('departments.create')"
+                color="primary"
+                size="sm"
+                @click="showForm = true"
+            />
+        </template>
+
+        <div
+            v-if="loading"
+            class="flex items-center justify-center py-16"
+        >
+            <UIcon
+                name="i-ph-spinner-gap-light"
+                class="size-6 animate-spin text-muted"
+            />
+        </div>
+
+        <div
+            v-else-if="!departments.length"
+            class="flex flex-col items-center justify-center py-16 text-muted"
+        >
+            <UIcon
+                name="i-ph-tree-structure-light"
+                class="size-12 mb-3 opacity-30"
+            />
+            <p class="text-sm">
+                {{ $t('departments.empty') }}
+            </p>
+            <UButton
+                v-if="canCreate"
+                class="mt-4"
+                icon="i-ph-plus"
+                :label="$t('departments.create')"
+                color="primary"
+                size="sm"
+                @click="showForm = true"
+            />
+        </div>
+
+        <div
+            v-else
+            class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6"
+        >
+            <HrDepartmentCard
+                v-for="dept in departments"
+                :key="dept.id"
+                :department="dept"
+                @edit="openEdit(dept)"
+                @delete="handleDelete(dept)"
+            />
+        </div>
+
+        <HrDepartmentFormModal
+            v-if="showForm"
+            :department="editingDept"
+            @close="closeForm"
+            @saved="onSaved"
+        />
+    </ModulePage>
+</template>
+
+<script lang="ts" setup>
+const { t } = useI18n()
+const toast = useToast()
+const { departments, loading, fetchDepartments, deleteDepartment } = useDepartments()
+const { can } = usePermissionRegistry()
+const canCreate = computed(() => can('hr', 'create'))
+const canDelete = computed(() => can('hr', 'delete'))
+
+const showForm = ref(false)
+const editingDept = ref<any | null>(null)
+
+onMounted(() => fetchDepartments(true))
+
+function openEdit(dept: any) {
+    editingDept.value = dept
+    showForm.value = true
+}
+
+function closeForm() {
+    showForm.value = false
+    editingDept.value = null
+}
+
+async function onSaved() {
+    closeForm()
+    await fetchDepartments(true)
+}
+
+async function handleDelete(dept: any) {
+    try {
+        await deleteDepartment(dept.id)
+        toast.add({ title: t('departments.toast.deleted'), color: 'success' })
+    }
+    catch (err: any) {
+        const code = err?.data?.code ?? err?.code
+        const msg = code === 'DEPT_HAS_MEMBERS'
+            ? t('departments.errors.has_members')
+            : (err?.message ?? t('hr.toast.error'))
+        toast.add({ title: msg, color: 'error' })
+    }
+}
+</script>

package/app/pages/hr/employees/[id]/activity.vue

@@ -0,0 +1,10 @@
+<script lang="ts" setup>
+const { person, isReadonly } = useEmployeeDetail()
+</script>
+
+<template>
+    <HrPersonActivityTab
+        :person-id="person.id"
+        :readonly="isReadonly('activity')"
+    />
+</template>

package/app/pages/hr/employees/[id]/assets.vue

@@ -0,0 +1,14 @@
+<script lang="ts" setup>
+const route = useRoute()
+const { person, isReadonly } = useEmployeeDetail()
+
+const EMPLOYEE_STAGES = ["probation", "active", "resigned"]
+
+if (!EMPLOYEE_STAGES.includes(person.value.stage)) {
+    await navigateTo(`/hr/employees/${route.params.id}/profile`, { replace: true })
+}
+</script>
+
+<template>
+    <HrEmployeesAssetsTab :person="person" :readonly="isReadonly('assets')" />
+</template>

package/app/pages/hr/employees/[id]/employment.vue

@@ -0,0 +1,14 @@
+<script lang="ts" setup>
+const route = useRoute()
+const { person, isReadonly } = useEmployeeDetail()
+
+const EMPLOYEE_STAGES = ["probation", "active", "resigned"]
+
+if (!EMPLOYEE_STAGES.includes(person.value.stage)) {
+    await navigateTo(`/hr/employees/${route.params.id}/profile`, { replace: true })
+}
+</script>
+
+<template>
+    <HrEmployeesTab :person="person" :readonly="isReadonly('employment')" />
+</template>

package/app/pages/hr/employees/[id]/index.vue

@@ -0,0 +1,9 @@
+<script lang="ts" setup>
+definePageMeta({
+    redirect: (to) => `/hr/employees/${to.params.id}/profile`,
+})
+</script>
+
+<template>
+    <div />
+</template>

package/app/pages/hr/employees/[id]/offboarding.vue

@@ -0,0 +1,7 @@
+<script lang="ts" setup>
+const { person } = useEmployeeDetail()
+</script>
+
+<template>
+    <HrOffboardingTab :person="person" />
+</template>

package/app/pages/hr/employees/[id]/profile.vue

@@ -0,0 +1,11 @@
+<script lang="ts" setup>
+const { person, isReadonly, onUpdated } = useEmployeeDetail()
+</script>
+
+<template>
+    <HrPersonProfileTab
+        :person="person"
+        :readonly="isReadonly('profile')"
+        @updated="onUpdated"
+    />
+</template>

package/app/pages/hr/employees/[id]/provisioning.vue

@@ -0,0 +1,17 @@
+<script lang="ts" setup>
+const route = useRoute()
+const { person, isReadonly } = useEmployeeDetail()
+
+const EMPLOYEE_STAGES = ["probation", "active", "resigned"]
+
+if (!EMPLOYEE_STAGES.includes(person.value.stage)) {
+    await navigateTo(`/hr/employees/${route.params.id}/profile`, { replace: true })
+}
+</script>
+
+<template>
+    <HrEmployeesProvisioningTab
+        :person="person"
+        :readonly="isReadonly('provisioning')"
+    />
+</template>

package/app/pages/hr/employees/[id].vue

@@ -0,0 +1,313 @@
+<script lang="ts" setup>
+import type { Ref } from "vue"
+
+const { t } = useI18n()
+const route = useRoute()
+const api = useHrApi()
+
+const { data: person, status, refresh } = await useAsyncData(
+    `hr-person-${route.params.id}`,
+    () => api.getPerson(String(route.params.id)),
+    { watch: [() => route.params.id] },
+)
+
+const localPerson = ref<Person | null>(
+    person.value ? { ...person.value } : null,
+)
+watch(person, (p) => {
+    localPerson.value = p ? { ...p } : null
+})
+
+const EMPLOYEE_STAGES = ["probation", "active", "resigned"]
+
+const isEmployee = computed(() =>
+    localPerson.value ? EMPLOYEE_STAGES.includes(localPerson.value.stage) : false,
+)
+
+const tabDefs = computed(() => {
+    if (!localPerson.value) return []
+    const tabs = [
+        { id: "profile", label: t("hr.tabs.profile"), icon: "i-ph-user-light" },
+    ]
+    if (isEmployee.value) {
+        tabs.push(
+            {
+                id: "employment",
+                label: t("hr.tabs.employment"),
+                icon: "i-ph-briefcase-light",
+            },
+            {
+                id: "assets",
+                label: t("assets.tab_label"),
+                icon: "i-heroicons-computer-desktop",
+            },
+            {
+                id: "provisioning",
+                label: t("hr.tabs.provisioning"),
+                icon: "i-ph-plugs-connected-light",
+            },
+            {
+                id: "offboarding",
+                label: t("hr.tabs.offboarding"),
+                icon: "i-ph-sign-out-light",
+            },
+        )
+    }
+    tabs.push({
+        id: "activity",
+        label: t("hr.tabs.activity"),
+        icon: "i-ph-clock-light",
+    })
+    return tabs
+})
+
+const basePath = computed(() => `/hr/employees/${route.params.id}`)
+
+const tabItems = computed(() =>
+    tabDefs.value.map((tab) => ({
+        label: tab.label,
+        icon: tab.icon,
+        value: tab.id,
+    })),
+)
+
+const activeTab = computed(() => {
+    const rest = route.path.slice(basePath.value.length).split("/").filter(Boolean)
+    return rest[0] ?? "profile"
+})
+
+function onTabChange(value: string | number) {
+    navigateTo(`${basePath.value}/${value}`)
+}
+
+const readonlyTabs = computed(() =>
+    localPerson.value?.stage === "resigned" ? ["employment", "assets"] : [],
+)
+
+provideEmployeeDetail({
+    person: localPerson as Ref<Person>,
+    isReadonly: (tab: string) => readonlyTabs.value.includes(tab),
+    onUpdated: (p: Person) => {
+        localPerson.value = { ...p }
+        refresh()
+    },
+})
+
+const subtitle = computed(() => {
+    const p = localPerson.value
+    if (!p) return ""
+    const bits: string[] = []
+    if (p.job_title) bits.push(p.job_title)
+    if (p.desired_position && !p.job_title) bits.push(p.desired_position)
+    if (p.employee_id) bits.push(p.employee_id)
+    return bits.join(" · ")
+})
+
+// Employee lifecycle actions
+const { confirmProbation, reactivate } = usePeople()
+const { initiate: initiateOffboarding } = useOffboarding()
+const toast = useToast()
+const acting = ref(false)
+const showOffboard = ref(false)
+const offboardForm = ref<Record<string, any>>({ exit_type: "voluntary", rehire_eligible: true })
+
+const OFFBOARD_FIELD_NAMES = ["exit_type", "notice_date", "last_working_day", "rehire_eligible", "reason"]
+const { pickFields, fetchAll, isReady } = useHrFieldRegistry(["hr_offboarding"])
+const offboardFields = computed(() => pickFields("hr_offboarding", OFFBOARD_FIELD_NAMES))
+
+watch(showOffboard, (open) => {
+    if (open) {
+        offboardForm.value = { exit_type: "voluntary", rehire_eligible: true }
+        fetchAll()
+    }
+})
+
+async function runAction(fn: () => Promise<void>) {
+    acting.value = true
+    try {
+        await fn()
+        await refresh()
+    } catch {
+        // composable surfaces its own error toast
+    } finally {
+        acting.value = false
+    }
+}
+
+function onConfirmActive() {
+    return runAction(() => confirmProbation(String(route.params.id)))
+}
+
+function onReactivate() {
+    return runAction(() => reactivate(String(route.params.id)))
+}
+
+async function onInitiateOffboarding() {
+    if (!offboardForm.value.last_working_day) return
+    acting.value = true
+    try {
+        await initiateOffboarding(String(route.params.id), { ...offboardForm.value })
+        showOffboard.value = false
+        toast.add({ title: t("hr.offboarding.toast.initiated"), color: "success" })
+        navigateTo(`${basePath.value}/offboarding`)
+    }
+    catch (err: any) {
+        toast.add({ title: err?.message ?? t("hr.toast.error"), color: "error" })
+    }
+    finally {
+        acting.value = false
+    }
+}
+</script>
+
+<template>
+    <UDashboardPanel v-if="localPerson">
+        <template #header>
+            <UDashboardNavbar
+                :title="localPerson.display_name"
+                :ui="{ title: 'text-lg font-semibold' }"
+            >
+                <template #leading>
+                    <UButton
+                        icon="i-ph-arrow-left-light"
+                        variant="ghost"
+                        size="sm"
+                        @click="navigateTo('/hr/employees')"
+                    />
+                </template>
+
+                <template #right>
+                    <span
+                        v-if="subtitle"
+                        class="text-xs text-muted hidden lg:inline"
+                        >{{ subtitle }}</span
+                    >
+                    <UButton
+                        v-if="localPerson.stage === 'probation'"
+                        size="sm"
+                        color="primary"
+                        variant="soft"
+                        icon="i-ph-check-circle-light"
+                        :label="$t('hr.employees.actions.confirm_probation')"
+                        :loading="acting"
+                        @click="onConfirmActive"
+                    />
+                    <UButton
+                        v-if="localPerson.stage === 'probation' || localPerson.stage === 'active'"
+                        size="sm"
+                        color="error"
+                        variant="soft"
+                        icon="i-ph-sign-out-light"
+                        :label="$t('hr.offboarding.initiate')"
+                        :disabled="acting"
+                        @click="showOffboard = true"
+                    />
+                    <UButton
+                        v-if="localPerson.stage === 'resigned'"
+                        size="sm"
+                        color="primary"
+                        variant="soft"
+                        icon="i-ph-arrow-counter-clockwise-light"
+                        :label="$t('hr.employees.actions.reactivate')"
+                        :loading="acting"
+                        @click="onReactivate"
+                    />
+                </template>
+            </UDashboardNavbar>
+        </template>
+
+        <template #body>
+            <div class="flex flex-col h-full">
+                <UTabs
+                    :model-value="activeTab"
+                    :items="tabItems"
+                    variant="link"
+                    :content="false"
+                    @update:model-value="onTabChange"
+                />
+
+                <div class="flex-1 overflow-auto py-6">
+                    <NuxtPage />
+                </div>
+            </div>
+        </template>
+    </UDashboardPanel>
+
+    <UDashboardPanel v-else-if="status === 'pending'">
+        <template #body>
+            <div class="flex items-center justify-center h-64">
+                <UIcon
+                    name="i-ph-spinner"
+                    class="animate-spin size-6 text-muted"
+                />
+            </div>
+        </template>
+    </UDashboardPanel>
+
+    <UDashboardPanel v-else>
+        <template #header>
+            <UDashboardNavbar
+                :title="$t('hr.employees.title')"
+                :ui="{ title: 'text-lg font-semibold' }"
+            >
+                <template #leading>
+                    <UButton
+                        icon="i-ph-arrow-left-light"
+                        variant="ghost"
+                        size="sm"
+                        @click="navigateTo('/hr/employees')"
+                    />
+                </template>
+            </UDashboardNavbar>
+        </template>
+        <template #body>
+            <div class="flex items-center justify-center h-64">
+                <div class="text-center text-muted">
+                    <UIcon
+                        name="i-ph-warning-circle"
+                        class="size-10 mb-2 opacity-40"
+                    />
+                    <p>{{ $t('hr.employees.not_found') }}</p>
+                </div>
+            </div>
+        </template>
+    </UDashboardPanel>
+
+    <UModal
+        :open="showOffboard"
+        :title="$t('hr.offboarding.initiate')"
+        :ui="{ content: 'sm:max-w-2xl' }"
+        @update:open="showOffboard = $event"
+    >
+        <template #body>
+            <div class="space-y-4">
+                <p class="text-sm text-muted">{{ $t('hr.offboarding.initiate_hint') }}</p>
+                <div v-if="!isReady('hr_offboarding')" class="py-4 text-sm text-muted text-center">
+                    {{ $t('common.loading') }}
+                </div>
+                <FormRoot
+                    v-else-if="offboardFields.length"
+                    v-model="offboardForm"
+                    :fields="offboardFields"
+                />
+            </div>
+        </template>
+        <template #footer>
+            <div class="flex justify-end gap-2">
+                <UButton
+                    color="neutral"
+                    variant="outline"
+                    :label="$t('common.cancel')"
+                    @click="showOffboard = false"
+                />
+                <UButton
+                    color="primary"
+                    :label="$t('hr.offboarding.initiate')"
+                    :loading="acting"
+                    :disabled="!offboardForm.last_working_day"
+                    @click="onInitiateOffboarding"
+                />
+            </div>
+        </template>
+    </UModal>
+</template>