HEARTS Merit System — Interactive Showcase

ICT Pilot · 2026

Employee Task, Reward & Performance Management

A fair, transparent, merit-based performance system for HEARTS Care Ethiopia — fixed base salary (10,000 ETB) plus performance incentive up to 36,000 ETB. ClickUp handles task execution; the HEARTS Dashboard is the system of record for points, claims, rewards, and audit.

10K ETBFixed base salary

36K ETBMax performance incentive

46K ETBMax monthly total

Task categories

User roles (RBAC)

Claim approval steps

Week rollout plan

End-to-End Workflow

Manager creates task
ClickUp

→

Employee completes

→

Supervisor verifies

→

Webhook sync
HEARTS API

→

Cycle close
Payment day

→

Employee claims reward

→

Finance approves payout

Architecture

See for full SVG roadmaps, ERD, and approval workflows.

ClickUp (N4PCC)

Task creation & assignment
Custom HEARTS fields
Status workflows
Webhooks → API

⟷

HEARTS Dashboard

Vue.js portals
Express API
Point engine
Claim & reward services

⟷

PostgreSQL

Immutable transactions
Audit logs
Leaderboards
Fraud flags

Strategic Decisions

Decision	Choice	Rationale
Task platform	ClickUp	Cross-functional; existing N4PCC workspace; custom fields for merit rules
Dashboard	Vue + Node + PostgreSQL	Central platform for points, claims, analytics, governance
Rollout	ICT pilot first	Backend, Frontend, Mobile, ICT Head — expandable by department
System of record	Split model	ClickUp = execution; Dashboard = points & audit (prevents manipulation)

Point Formula (Proposal v1.0)

final_points = base × priority × business_impact × quality × timeliness

Basic tasks always = 0. Final allocation at cycle close (payment day).

ETB Conversion (Pool-Based)

ETB_per_point = approved_pool ÷ total_approved_points
employee_incentive = points × ETB_per_point

Example: 36,000 ETB ÷ 720 pts = 50 ETB/pt · 300 pts → 15,000 ETB

Compensation Structure

Component	Amount (ETB)
Fixed monthly base salary	10,000
Performance incentive (points)	Up to 36,000
Maximum monthly compensation	46,000

5-Phase Roadmap

Visual Gantt chart and milestones in

Phase 1 · Weeks 1–2

Business Rules & ClickUp Setup

Finalize point/bonus/claim policies. Configure ClickUp workspace (statuses, custom fields, ICT lists). Map employees. Run 2-week parallel-tracking pilot (salary unchanged).

Phase 2 · Weeks 3–5

Integration & Database

PostgreSQL migration. ClickUp webhook receiver + reconciliation worker. Employee ↔ ClickUp account linking. E2E sync testing.

Phase 3 · Weeks 6–8

Employee & Supervisor Dashboards

My Tasks, My Points, Verification Queue, Team Performance, Leaderboards. RBAC middleware. Internal UAT with ICT staff.

Phase 4 · Weeks 9–11

Claims & Rewards

Point cycle close. Pool-based ETB. 4-step claim approval. Reward catalog. Fraud rules. Finance portal.

Phase 5 · Weeks 12–14

Analytics & Optimization

Management KPIs. Annual rankings. Audit viewer. Pilot retrospective. Department expansion playbook.

ClickUp vs Linear

Criterion	ClickUp	Linear	HEARTS
Cross-functional teams	Strong	Engineering-focused	ClickUp
Custom merit fields	Rich dropdowns	Limited	ClickUp
Manager usability	High	Lower outside eng	ClickUp
Engineering velocity	Good	Excellent	ClickUp for v1
Existing workspace	N4PCC / Hearts	None	ClickUp

Task Point Categories

Category	Points	Eligible	Examples
Basic	0	No	Admin, meetings, routine reporting
Minor	1–2	Yes	Small bug fix, copy change, config tweak
Major	3, 5, 8	Yes	API endpoint, page section, integration
Complex	13	Yes	Reward engine, ClickUp sync, payment workflows

Go-Live Acceptance Criteria

✓ ClickUp sync via webhook + reconciliation

Tasks appear in dashboard within minutes of status change.

✓ Basic tasks visible, always 0 points

Operational visibility without inflating rewards.

✓ Verified tasks only earn points

Minor/Major/Complex after supervisor acceptance.

✓ Claim chain cannot be skipped

Supervisor → Dept Head → Finance → Payout.

14-Week Implementation Roadmap

ICT pilot rollout · Weeks 1–14 · Team: ICT Head, Backend, Frontend, Finance, QA

W1W2W3W4W5 W6W7W8W9W10 W11W12W13W14

Phase 1Business & ClickUp

Policy · ClickUp · Pilot

Phase 2Integration & DB

Webhooks · Schema · Sync

Phase 3Dashboards

Employee · Supervisor UI

Phase 4Claims & Rewards

Claims · Cycle · Finance

Phase 5Analytics

KPIs · Audit · Go-live

M1 · Week 2

ClickUp configured, employees mapped, policies signed off.

M2 · Week 5

Webhook + reconciliation E2E passing; schema migrated.

M3 · Week 8

Supervisor verification queue live; UAT complete.

M4 · Week 11

First cycle close; claim chain operational.

M5 · Week 14

Management analytics; pilot retrospective; expansion playbook.

Budget (build)

460K–1.17M ETB software · Pool separate (mgmt decision).

End-to-End System Architecture

ClickUp = task execution · HEARTS Dashboard = points, claims, rewards, audit (system of record)

Data Flow — Task Sync & Point Cycle

Real-time webhook path + reconciliation fallback + immutable cycle close

Database Design (Entity Relationship)

PostgreSQL schema · Core entities and relationships for ICT pilot

Core (employees, roles) Tasks & sync Points & rewards Audit & fraud

Reward Claim Approval Workflow

4-step chain — cannot be skipped · points reserved on submit · self-approval blocked

Task Verification Workflow

Supervisor reviews in ClickUp or Dashboard · quality factor drives point calculation

Bonus Point Approval Workflow

Discretionary points · evidence required · monthly cap (20 pts default)

Point Cycle Close Workflow

Management closes cycle on payment day · transactions become immutable

HEARTS Merit Dashboard — My Tasks

Synced from ClickUp · Backend Developer 1

Task	Category	Status	Verification	Pts
Weekly standup notes	basic	completed	accepted	0
Fix login validation bug	minor	accepted	accepted	2
Build reward claim API	major	pending_verification	pending	5
ClickUp sync service	complex	in_progress	pending	13
Update team wiki page	basic	completed	accepted	0

My Points — Reward Wallet

Pending

Approved

Reserved

Available

After Cycle Close (July 2026)

Est. 2,400 ETB @ 75 ETB/point

70% of monthly target (60 pts)

Monthly Leaderboard — July 2026 ICT Pilot

Backend Developer 1

Backend Development

68 pts

5,100 ETB

Frontend Developer 1

Frontend Development

54 pts

4,050 ETB

Mobile Developer 1

Mobile Development

41 pts

3,075 ETB

ICT Supervisor

ICT Operations

28 pts

2,100 ETB

Supervisor — Verification Queue

Build reward claim API endpoint

Backend Developer 1 · major · 5 pts

Criteria: POST /claims endpoint with validation, RBAC, and audit logging.

✓ Accept Minor Issues Rework Reject

Add patient data export filter

Frontend Developer 1 · minor · 2 pts

Criteria: Date range filter on exports page with unit tests.

Claim Approval Flow — Sample

✓

Employee
Submitted

✓

Supervisor
Approved

Dept Head
Review

Finance
Approval

Redeemed
/ Paid

Employee	Reward	Points	ETB Value	Status
Backend Developer 1	Cash bonus	20	1,500 ETB	dept_head_review
Frontend Developer 1	Airtime	5	375 ETB	approved
Mobile Developer 1	Training sponsorship	25	1,875 ETB	finance_review

Closed Cycles

1,847

Total Points

360K

Reward Pool ETB

Open Fraud Flags

Department Breakdown

Dept	Points	ETB
Backend	820	61,500
Frontend	645	48,375
Mobile	382	28,650

KPIs

Avg ETB/point: 75.00

Verification lag: 1.2 days

Rework rate: 8%

Claim rejection: 3%

Compensation Structure

Component	Amount (ETB)
Fixed monthly base salary	10,000
Performance incentive (from approved points)	Up to 36,000
Maximum monthly compensation	46,000

Base salary is guaranteed. Incentive = approved points × (monthly pool ÷ total approved points), capped at 36,000 ETB per employee. Example: 36,000 ETB pool, 720 points → 50 ETB/pt; employee with 300 points earns 15,000 ETB.

Policy Principles

Outcome over volume

Reward accepted, verified work — not task count or hours logged.

Transparency before work

Point category and base points agreed in ClickUp before work starts.

Verification required

Supervisor must accept with note before points become eligible.

Sustainable pools

ETB value floats with approved monthly budget — not fixed per point.

Immutable ledger

Closed point transactions cannot be edited; corrections use adjustments.

Separation of duties

Task verification ≠ finance payout ≠ cycle close authority.

Approval Structure (Proposal)

Activity	Responsible Role
Create task	Team Lead
Assign task	Team Lead
Complete task	Employee
Review work	Supervisor
Validate quality	Department Head
Approve points	Management
Process payment	Finance

Employees cannot approve their own tasks.

Dashboard Authority Matrix

Decision	Employee	Supervisor	Dept Head	Finance	Management
Create task	—	✓	✓	—	✓
Verify task	—	✓	✓	—	—
Approve bonus	—	✓	✓	—	✓
Approve claim	Submit	Step 1	Step 2	Step 3	Exception
Close point cycle	—	—	—	—	✓
Configure rules	—	—	Recommend	Recommend	Approve

Point Multipliers (Proposal v1.0)

Priority Multiplier

Low	1.0×
Normal	1.2×
High	1.5×
Critical	2.0×

Business Impact

Individual	1.0×
Team	1.25×
Department	1.5×
Organization	2.0×
Strategic Project	3.0×

Quality Score

Excellent	100%
Very Good	90%
Good	75%
Needs Improvement	50%

Point Formula

final_points = base × priority × impact × quality × timeliness

Task Workflow

Task Creation → Assignment → Execution → Evidence → Supervisor Review → Quality Evaluation → Point Approval → Monthly Calculation → Payment

Bonus & Recognition

Category	Points	Approval	Evidence
Innovation / automation	3–13	Supervisor + Dept Head	Design doc, prototype, impact note
Process improvement	3–8	Supervisor + Dept Head	Before/after metrics
Emergency support	2–13	Supervisor + Dept Head	Incident ID, timeline, outcome
Knowledge sharing	1–5	Supervisor	Session recording, slides
Exceptional contribution	3–8	Supervisor + Management	Management note

Penalties, Adjustments & Fraud Prevention

Missed deadline / poor quality

Point reduction via quality score or management adjustment with justification.

False claim

Reject claim, subtract equivalent points, flag account for review.

Duplicate claim

Reject duplicate, warn employee; repeat cases trigger penalty.

Self-approval

Blocked at API layer for verification and claims.

Post-verification edits

ClickUp payload changes after verification trigger fraud flag.

Reward Categories

💵

Cash Bonus

📱

Airtime

🌐

Internet

🏖

Extra Leave

💻

Equipment

📚

Training

⭐

Performance

🎁

Gift Voucher

📋

Business Rules
Task, point, and reward policies
🔗

ClickUp Integration
Workspace setup & webhooks
⚙

API Reference
REST endpoints & RBAC
👤

Employee Guide
Self-service portal usage
👥

Supervisor Guide
Verification & team review
📝

SOPs
Standard operating procedures
🚀

Deployment Guide
Setup & operations

Business Rules (Proposal v1.0)

Compensation

Base salary	10,000 ETB
Performance incentive (max)	36,000 ETB
Maximum monthly total	46,000 ETB

Task Rules

All point-bearing work must be created in ClickUp before work starts.
Each task must include owner, reviewer, category, priority, business impact, and acceptance criteria.
Basic tasks are visible but carry zero points (mandatory, non-payable).
Minor, Major, and Complex tasks are eligible for points.
Completed tasks require evidence (docs, screenshots, reports, deployment records, tests).

Point Formula

final_points = base × priority × business_impact × quality × timeliness

ETB Conversion

ETB/pt = pool ÷ total_approved_points · Example: 36,000 ÷ 720 = 50 ETB/pt

Implementation

Phase 1 Pilot → Phase 2 Controlled teams → Phase 3 Organization-wide. See pilot-playbook.md in docs/merit/.

ClickUp Integration Guide

Workspace Structure

Space: HEARTS ICT Performance Pilot under workspace N4PCC.

Required Custom Fields

HEARTS Category (Basic, Minor, Major, Complex)
Base Points (0, 1, 2, 3, 5, 8, 13)
Urgency, Verification Status, Reward Eligible
Acceptance Criteria, Evidence Link, Reviewer

Webhook Endpoint

POST /api/v1/integrations/clickup/webhook

Verify HMAC X-Signature. Process async. Nightly reconciliation for missed events.

API Reference

Authentication

POST /api/v1/auth/login → Bearer token

Key Endpoints

GET /merit/tasks?mine=true — Employee tasks
GET /merit/points/wallet — Point wallet
POST /merit/tasks/:id/verify — Supervisor verification
POST /merit/claims — Submit reward claim
POST /merit/points/cycles/:id/close — Close cycle
GET /merit/analytics/leaderboard — Rankings

Roles

employee · supervisor · department_head · finance · management · admin

Employee Guide

Your Compensation

Base 10,000 ETB + performance points up to 36,000 ETB = max 46,000 ETB/month.

What To Do

Use ClickUp as the official task source.
Complete tasks with evidence before requesting review.
Track current, pending, approved, and deferred points in the dashboard.
Claim rewards only after cycle close when points are available.

What Not To Do

Do not claim unfinished or unverified work.
Do not duplicate claims or inflate task count.
Do not request points on Basic tasks.
Do not approve your own tasks.

Supervisor Guide

Daily Responsibilities

Review Verification Queue — pending tasks.
Confirm acceptance criteria before approving.
Return unclear work with specific feedback.
Approve first step of reward claims.

Weekly

Review team leaderboard and rework rate.
Calibrate task categories across the team.

Standard Operating Procedures

Workflow

Create → Assign → Execute → Evidence → Supervisor Review → Quality Eval → Point Approval → Calculation → Payment

SOP: Task Creation (Team Lead)

Create task in ClickUp with category, base points, priority, and business impact.
Assign employee, reviewer, acceptance criteria, and evidence expectations.
Save before employee starts work.

SOP: Cycle Close (Management)

Sync tasks from ClickUp; calculate points per approved formula.
Management approves points; set ETB/pt from 36,000 ETB pool.
Apply 36,000 ETB per-employee cap; defer excess if needed.
Lock cycle — transactions become immutable.

SOP: Payment (Finance)

Supervisor → Department Head → Finance approval chain.
Finance records payment reference.

Deployment Guide

Quick Start

docker compose up -d
npm install
npm run migrate && npm run seed
npm run dev

Ports

API: localhost:3001
Web: localhost:5173
PostgreSQL: localhost:5432

Demo Login

backend1@heartscare.et / password123

Employee Task, Reward & Performance Management

End-to-End Workflow

Architecture

ClickUp (N4PCC)

HEARTS Dashboard

PostgreSQL

Strategic Decisions

Implementation Plan

Compensation Structure

5-Phase Roadmap

Business Rules & ClickUp Setup

Integration & Database

Employee & Supervisor Dashboards

Claims & Rewards

Analytics & Optimization

ClickUp vs Linear

Task Point Categories

Go-Live Acceptance Criteria

✓ ClickUp sync via webhook + reconciliation

✓ Basic tasks visible, always 0 points

✓ Verified tasks only earn points

✓ Claim chain cannot be skipped

Architecture & Diagrams

14-Week Implementation Roadmap

M1 · Week 2

M2 · Week 5

M3 · Week 8

M4 · Week 11

M5 · Week 14

Budget (build)

End-to-End System Architecture

Data Flow — Task Sync & Point Cycle

Database Design (Entity Relationship)

Reward Claim Approval Workflow

Task Verification Workflow

Bonus Point Approval Workflow

Point Cycle Close Workflow

Dashboard UI Samples

Build reward claim API endpoint

Add patient data export filter

Rules, Regulations & Policy

Compensation Structure

Policy Principles

Outcome over volume

Transparency before work

Verification required

Sustainable pools

Immutable ledger

Separation of duties

Approval Structure (Proposal)

Dashboard Authority Matrix

Point Multipliers (Proposal v1.0)

Task Workflow

Bonus & Recognition

Penalties, Adjustments & Fraud Prevention

Missed deadline / poor quality

False claim

Duplicate claim

Self-approval

Post-verification edits

Reward Categories

Documentation Browser

Business Rules

ClickUp Integration

API Reference

Employee Guide

Supervisor Guide

SOPs

Deployment Guide

Business Rules (Proposal v1.0)

Compensation

Task Rules

Point Formula

ETB Conversion

Implementation

ClickUp Integration Guide

Workspace Structure

Required Custom Fields

Webhook Endpoint

API Reference