Multi-Stakeholder Portals

RippleCore serves five distinct user groups through a unified platform with role-based portals.

User Ecosystem

Employees

Log kindness, volunteer hours, donations; track personal impact

Companies

Manage organizations, view compliance reports, monitor engagement

Charities

Create opportunities, verify volunteer hours, build partnerships

Councils

Review supplier evidence, manage Social Value Act compliance

Consultants

Manage client portfolios, generate custom reports, white-label services

Portal Architecture

Each stakeholder portal provides dedicated functionality:

Portal	Purpose	Key Features
Charity	Partner management	Opportunity creation, hour verification, donations
Council	Supplier oversight	Evidence review, compliance scoring, supplier management
Consultant	Client services	Portfolio management, reporting, theme customization

Role-Based Access

RippleCore implements five core roles:

type Role = "admin" | "owner" | "member" | "viewer" | "guest";

Role	Dashboard	Evidence	Portals	Admin
Admin	✅ Full	✅ All	✅ All	✅ Yes
Owner	✅ Full	✅ All	✅ All	❌ No
Member	✅ Own	✅ Own	❌ Limited	❌ No
Viewer	✅ Read	✅ Read	❌ No	❌ No
Guest	❌ No	❌ No	❌ No	❌ No

Authentication

All portals use Better Auth with organization plugin:

Session-based authentication with 8-hour expiry
Multi-tenant isolation via organizationId
OAuth support for Google and GitHub
SSO ready for enterprise deployments

import { auth } from "@/lib/auth";

// Get current session
const session = await auth.api.getSession({ headers: await headers() });

// Check organization access
const organizationId = session?.session?.activeOrganizationId;
if (!organizationId) {
  throw new UnauthorizedError("No active organization");
}

Portal Routes

Each portal has its own route namespace:

Portal	Route Prefix	Dashboard
Charity	`/charity/*`	`/charity`
Council	`/council/*`	`/council`
Consultant	`/consultant/*`	`/consultant`

API Endpoints by Portal

Portal	Endpoints	Rate Limit
Charity	11 routes	AUTHENTICATED + HEAVY
Council	5 routes	AUTHENTICATED + HEAVY
Consultant	7 routes	AUTHENTICATED + HEAVY

Common Features

All portals share:

Custom Branding

Upload logos, configure colors, and apply custom themes. Council and Charity portals can fully white-label the experience.

Dashboard Analytics

Real-time metrics, trend charts, and comparative insights relevant to each stakeholder type.

Email Notifications

Configurable notifications for invitations, verifications, milestones, and activity summaries.

Bulk Operations

Process multiple items at once - up to 50 verifications, invitations, or exports per batch.

Integration Patterns

Charity Integration

Charities connect with companies to:

Receive volunteer hour submissions
Verify and approve recorded hours
Track donation flows
Create volunteer opportunities

Council Integration

Councils connect with suppliers to:

Review social value evidence
Score compliance against frameworks
Request additional documentation
Generate compliance reports

Consultant Integration

Consultants connect with clients to:

Aggregate impact data across organizations
Generate branded reports
Provide benchmarking insights
Manage multiple client portals

Next Steps

Charity Portal

Partner management and verification workflows

Council Portal

Supplier oversight and compliance

Consultant Portal

Client portfolio and reporting

Get Started

Core Modules

Portals

Portals Overview

Multi-Stakeholder Portals

User Ecosystem

Employees

Companies

Charities

Councils

Consultants

Portal Architecture

Role-Based Access

Authentication

Portal Routes

API Endpoints by Portal

Common Features

Integration Patterns

Charity Integration

Council Integration

Consultant Integration

Next Steps

Charity Portal

Council Portal

Consultant Portal

​Multi-Stakeholder Portals

​User Ecosystem

Employees

Companies

Charities

Councils

Consultants

​Portal Architecture

​Role-Based Access

​Authentication

​Portal Routes

​API Endpoints by Portal

​Common Features

​Integration Patterns

​Charity Integration

​Council Integration

​Consultant Integration

​Next Steps

Charity Portal

Council Portal

Consultant Portal

Multi-Stakeholder Portals

User Ecosystem

Portal Architecture

Role-Based Access

Authentication

Portal Routes

API Endpoints by Portal

Common Features

Integration Patterns

Charity Integration

Council Integration

Consultant Integration

Next Steps