Documentation · Engineering reference

Interactive data flow simulators

Live flag toggles on the left, step-by-step table flows on the right. Each simulator traces real Tracopus tables (fs_* protected core, ts_* enhancement), REST APIs, schedulers, and approval authority — without changing production data.

Pick a simulator below to launch the interactive tool. Toggle org/role flags and watch SQL steps, Mermaid diagrams, and capability matrices update in real time.

Open a simulator

These are live learning tools — not static docs. Each page opens with a flag panel and two tabs: Table data flow and Flag behavior. Click a card to start.

ℹ️
How these differ from screen docs & scenarios
Screen docs explain Luxury UI pages (charts, filters, buttons). Scenario guide walks testers through clicks with permissions and checklists. Data flow simulators answer “what row changes in which table when this org flag flips?” — ideal for admins, backend engineers, and integration leads.
💡
Two tabs on every simulator
Table data flow — numbered steps, SQL samples, Mermaid diagrams, sample row diffs. Flag behavior — live journey strip, capability matrix, and change banner when you toggle a flag.
8Simulators
2Tabs each
40+Flow steps
LiveFlag toggles

Recommended learning path — leave stack

Start with policy and balances, then request/approve, then cross-cutting delegation.

1
Leave policy & accrual — Global Leave Policy Center, opening balance import, LEAVE_ACCRUAL / LEAVE_CARRY_FORWARD schedulers, balance ledger.
Open →
2
Leave request & approve — Create → SUBMITTED → manager/delegate approve → TaskActivity promotion → optional attendance sync.
Open →
3
Approval delegation — ts_approval_delegation_model, resolve(), canAct, universal inbox, acting-for badges.
Open →

Simulator details

Expanded summaries — each card links to the same interactive page as the launch strip above.

Leave · Policy platform

Leave policy & accrual

Global policy publish, rules_json accruals, employee balance rows, monthly accrual job, carry-forward/lapse, handoff to submit flow.

ts_leave_policy_version Schedulers GLP Center
Open simulator →
Leave · Workflow

Leave request & approve

fs_emp_leave_master_model lifecycle, balance reserve on submit, pending SUBMITTED queue, approve/debit, promotion, universal inbox LEAVE domain.

SUBMITTED pending Delegate approve
Open simulator →
HRMS · Timesheet

Timesheet flags & approval

Weekly timesheet workflow, on-behalf submit (enableTimeSheetSubmissionOnBehalfOf), auto-approve own/others, PENDING_APPROVAL weeks, manager approve, conflicts, reopen, TaskActivity promotion.

fs_task_activity Week status
Open simulator →
HRMS · Attendance

Attendance & regularization

Mark attendance, PENDING_APPROVAL / auto-approve paths, regularization bridge to fs_user_attendance_model, delegate acting-for on pending.

fs_user_attendance_model Regularization
Open simulator →
Cross-cutting · Authority

Approval delegation

Org master flag, delegation scopes (TIMESHEET / LEAVE / ATTENDANCE), effectiveApproverIds, per-domain pending queries, universal inbox merge + act.

ts_approval_delegation canAct
Open simulator →
Admin · RBAC

Roles & permissions

personaModules, Automatic vs configured allow list, defaultPersona, switcher, page preview → org pagePersonaMap, Role Bar inheritance.

role.json personaModules
Open simulator →
Admin · Access

Persona navigation

personaNavigationAdditional, disabledPersonas/paths/modules, pagePersonaMap route guards, role persona catalog merge.

pagePersonaMap Org kills
Open simulator →
Leave · Calendar

Working day resolver

Shift policy assignment, jurisdiction holidays, WDR fallback chain, leaveBlockNonWorkingDayLeave validation on apply.

fs_holiday_model Shift policy
Open simulator →

What each simulator covers

SimulatorPrimary tablesKey org flagsRelated guides
Leave policy & accrual ts_leave_global_policy, ts_leave_policy_version, balance ledger, fs_schedule_model leaveManagementEnabled, globalLeavePoliciesEnabled Configure global leave, OB import Open
Leave request & approve fs_emp_leave_master_model, balance engine, fs_task_activity_model leaveManagementEnabled, leaveAutoSyncToAttendance Apply leave, Approve leave Open
Timesheet Timesheet week / day / submission staging, TaskActivity hours timesheetApprovalEnabled, partialWeekSubmissionEnabled, enableTimeSheetSubmissionOnBehalfOf, auto-approve flags Log timesheet, Submit timesheet, Approve timesheet Open
Attendance fs_user_attendance_model, regularization model attendanceEnabled, attendanceRegularizationEnabled Mark attendance, Approve attendance Open
Delegation ts_approval_delegation_model, inbox adapters approvalDelegationEnabled, universalApprovalInboxEnabled My Approvals, Workspace flow Open
Roles & permissions role.json, Application Config Role Bar rbacAdminEnabled, personaModules, adminModules.rolesEnabled Roles screen guide, Admin scenario Open
Persona navigation Application Config snapshot, sidebar catalog personaNavigationEnabled, disabledPersonas, pagePersonaMap Persona navigation, Admin scenario Open
Working day resolver Shift policy, fs_holiday_model, jurisdiction WDR shiftPoliciesEnabled, leaveBlockNonWorkingDayLeave Shift policies, Leave config Open

Schedulers referenced in simulators

LEAVE_ACCRUAL

Monthly (1st, 06:00) — credits entitlements from published policy or classic config; idempotent ledger rows with periodKey=yyyy-MM.

LEAVE_CARRY_FORWARD

Daily scan — applies carry-forward caps and fiscal/calendar lapse rules from rules_json.

LEAVE_PROMOTION_RETRY

Every 15 min (optional) — retries failed TaskActivity promotion after leave approve.

APPROVAL_SLA_REMINDER

Daily reminder emails for SUBMITTED leave / pending approvals when org reminder flag is on.

Frequently asked questions

Do flag toggles change my workspace?

No. Simulators are read-only learning tools in the documentation site. They show what would happen if flags were ON or OFF — they do not call your Tracopus backend.

Where is SQL in the simulators?

Each step in the Table data flow tab includes representative SQL blocks and sample row tables showing column values before/after the step.

How do simulators relate to Application Config?

Org flags come from modules.HRMS.configurations.leaveAdditional (and related paths). See Application config reference for the full key list; simulators show runtime effect per flag.