​
Council Portal

The Council Portal enables local authorities to review supplier social value evidence, manage compliance, and generate Social Value Act reports.

​
Dashboard Overview

The Council dashboard (/council) displays:
  • Pending Evidence: Submissions awaiting review
  • Supplier Insights: Performance across suppliers
  • Compliance Status: Framework scoring summary
  • Recent Activity: Latest reviews and decisions

​
Key Features

Evidence Review

Approve, reject, or request changes on supplier evidence

Supplier Management

Invite and track supplier organizations

Compliance Scoring

Social Value Act and TOMs framework assessment

Custom Branding

White-label the portal with council branding

​
Evidence Review

​
Review Queue

Navigate to /council/evidence to review pending submissions:
ColumnDescription
SupplierOrganization that submitted
Evidence TypeKindness, volunteer, donation, wellbeing
SubmittedDate of submission
Verification TierCurrent audit weight
StatusPending, Approved, Rejected, Changes Requested

​
Review Actions

1

Open Evidence

Click to view full details, attachments, and verification data
2

Assess Quality

Review against Social Value Act requirements
3

Make Decision

Approve, reject, or request additional information
4

Add Notes

Document your reasoning for audit trail

​
Review API

POST /api/council/evidence/{id}/review
{
  "decision": "approved" | "rejected" | "changes_requested",
  "notes": "Evidence meets TOMs requirements",
  "frameworkScores": {
    "socialValueAct": 85,
    "toms": 78
  }
}

​
Supplier Management

​
Inviting Suppliers

POST /api/council/suppliers/invite
{
  "email": "contact@supplier.com",
  "organizationName": "Supplier Ltd",
  "contractId": "CONTRACT-2025-001",
  "requiredFrameworks": ["socialValueAct", "toms"]
}

​
Supplier Insights

View aggregated data per supplier:
MetricDescription
Total EvidenceNumber of submissions
Approval RatePercentage approved
Avg TierAverage verification tier
Compliance ScoreFramework compliance %

​
Compliance Frameworks

​
Social Value Act

Score submissions against Social Value Act requirements:
AreaWeightMeasures
Economic30%Local jobs, apprenticeships
Social40%Community investment, volunteering
Environmental30%Carbon reduction, sustainability

​
TOMs Framework

Track National TOMs metrics:
CodeMetricUnit
NT1Local employmentFTE jobs
NT30Volunteering hoursHours
NT28Charitable giving£ value
NT31TrainingTraining hours

​
Custom Branding

Configure council branding: 
POST /api/council/branding/save
{
  "logo": "https://council.gov.uk/logo.png",
  "primaryColor": "#1e3a5f",
  "portalTitle": "Social Value Portal",
  "supportEmail": "support@council.gov.uk"
}

​
Reporting

Generate compliance reports:
ReportFormatFrequency
Supplier SummaryPDFOn-demand
Compliance DashboardWebReal-time
Annual ReviewPDFYearly
TOMs SummaryCSVQuarterly

​
API Endpoints

EndpointMethodDescription
/api/council/evidenceGETList pending evidence
/api/council/evidence/{id}/reviewPOSTReview evidence
/api/council/suppliersGETList suppliers
/api/council/suppliers/invitePOSTInvite supplier
/api/council/branding/savePOSTSave branding
All endpoints require authentication and CSRF protection for mutations.

​
Integration with Suppliers

When you invite a supplier:
  1. They receive an email invitation
  2. They sign up or link existing RippleCore account
  3. Their evidence submissions route to your review queue
  4. You can track their compliance in real-time