Documentation Index
Fetch the complete documentation index at: https://grantmaster.dev/llms.txt
Use this file to discover all available pages before exploring further.
Engineering reference: See src/features/partnerships/partnerships.md and src/features/mission/mission.md for implementation details.
last_updated: 2026-02-22
Partnership & Gamification
| Status | Updated | Covered Files |
|---|
| 🟡 In Development | 2026-02-22 | src/features/relations/, src/features/partnerships/contracts.ts, src/routes/routeConfig.tsx (partnership routes) |
Overview
The Partnership & Gamification system manages external relationships (partner organizations, referrals, revenue sharing) and internal engagement mechanics (badges, achievement campaigns, activity streaks). Partnerships are managed through the Relations feature, while gamification elements are distributed across features.
Partnership System
Partnership Types
| Type | Description |
|---|
| Implementation Partner | Organizations co-implementing projects |
| Sub-grantee | Sub-award recipients receiving pass-through funding |
| Consortium Member | Members of multi-organization grant applications |
| Referral Partner | Organizations that refer clients/funders |
| Service Provider | Contracted service providers (consultants, vendors) |
Partnership Lifecycle
Referral Program
| Feature | Description |
|---|
| Referral tracking | Track which organization referred a funder or partner |
| Revenue sharing | Configurable percentage-based revenue sharing agreements |
| Attribution | Link grants and revenue back to referring partner |
| Reporting | Referral performance dashboards and payout summaries |
Gamification System
Badges & Achievements
| Badge Category | Examples |
|---|
| Compliance | ”100% Audit Ready”, “Zero Violations (90 days)“ |
| Productivity | ”Journal Streak (30 days)”, “Report Champion” |
| Collaboration | ”Team Player”, “Cross-Project Contributor” |
| Impact | ”Milestone Master”, “Target Achiever” |
| Onboarding | ”Profile Complete”, “First Expense Submitted” |
Campaign System
Campaigns are time-bounded gamification events that encourage specific behaviors:
interface GamificationCampaign {
id: string;
organizationId: string;
name: string;
description: string;
startDate: string;
endDate: string;
targetAction: string; // e.g. 'submit_journal', 'complete_training'
targetCount: number; // Actions needed to earn reward
reward: {
type: 'badge' | 'points' | 'recognition';
value: string;
};
participants: string[];
isActive: boolean;
}
Activity Streaks
Track consecutive-day engagement for key activities:
| Activity | Streak Metric |
|---|
| Journal entries | Consecutive days with time logged |
| Expense submissions | On-time submission streak |
| Report deadlines | Consecutive on-time report submissions |
| Platform login | Daily active usage streak |
Relations Feature
Directory: src/features/relations/
The Relations feature provides the foundation for partnership management:
| Capability | Description |
|---|
| Contact management | External contact profiles and history |
| Organization profiles | Partner organization details and agreements |
| Interaction logging | Meeting notes, calls, emails tracked |
| Document sharing | Shared documents with partner organizations |
| Activity timeline | Chronological relationship history |
Key Files Reference
| File | Purpose |
|---|
src/features/relations/ | Relationship and contact management feature |
src/features/partnerships/contracts.ts | Partnership type definitions |
src/routes/routeConfig.tsx | Partnership navigation routes |
