Core Modules

RippleCore captures social impact through four interconnected evidence modules. Each module is designed for the 30-second rule - any user action completes in under 30 seconds.

The 4-Pillar Evidence System

5-Tier Verification System

Every piece of evidence is assigned a verification tier that determines its audit weight for compliance reporting:
TierLevelAudit WeightDescription
1System Verified100%Automated validation (GPS, QR, system checks)
2Manager Approved90%Manager verification and sign-off
3Peer Confirmed70%Peer acknowledgment or witness confirmation
4Photo Evidence50%Media uploaded as supporting evidence
5Self-Reported30%User entry without additional verification
Higher verification tiers provide stronger evidence for ESG compliance audits. The system automatically upgrades verification levels when additional proof is provided.

Multi-Modal Input

RippleCore supports multiple input methods to maximize participation:
Record audio descriptions that are transcribed automatically. Perfect for on-the-go logging while volunteering or during recognition moments.
Capture images as supporting evidence. Photos automatically upgrade verification tier from Self-Reported (30%) to Photo Evidence (50%).
Scan QR codes at volunteer locations for System Verified (100%) check-ins. Includes automatic time tracking and location verification.
Automatic location verification when within geofenced areas. Provides 100% audit weight without manual intervention.

Module Integration

All modules share common infrastructure:

Shared Database Schema

// All evidence records include these common fields
interface EvidenceBase {
  id: string;
  userId: string;
  organizationId: string;        // Multi-tenant isolation
  verificationTier: 1 | 2 | 3 | 4 | 5;
  createdAt: Date;
  updatedAt: Date;
}

Email Notifications

Each module sends contextual email notifications via the @repo/email package:
ModuleNotifications
KindnessRecognition received, sent, milestone achieved
VolunteerSignup confirmation, check-in, hours logged, verification approved
DonationsReceipt confirmation, tax receipt, milestone achieved, company match
WellbeingSurvey invitation, completion, crisis alert, resources

Compliance Mapping

Evidence from all modules maps to major ESG frameworks:

B-Corp

Community scores, worker wellbeing

CSRD/ESRS

S1-S4 social standards

UN SDGs

All 17 goals mapped

Social Value Act

TOMs framework outcomes

Section 172

Stakeholder consideration

GRI Standards

Global reporting metrics

Module Packages

Each module is implemented as a separate workspace package:
// Kindness module
import { createKindness, getKindnessStats } from "@repo/kindness";

// Volunteer module
import { createOpportunity, checkIn, logHours } from "@repo/volunteer";

// Donations module
import { createDonation, processMatch, generateReceipt } from "@repo/donation";

// Wellbeing module
import { createSurvey, submitResponse, analyzeResults } from "@repo/wellbeing";

Milestones & Gamification

RippleCore celebrates user achievements with automatic milestone tracking:

Kindness Milestones

ActsAchievement
1First Ripple
5Getting Started
10Making Waves
25Kindness Champion
50Impact Leader
100Ripple Master

Donation Milestones

AmountAchievement
£50First Gift
£100Generous Giver
£250Philanthropist
£500Change Maker
£1,000Major Donor
£2,500Impact Champion

Next Steps