Activity Oversight & Approval Workflows - Likepersonsapp – Peer Mentor Activity Platform | Generated by Eircodex v3.0

Scope

high complexity extracted Admin Panel Confidence: 100%

6

Components

58

Shared

0

User Stories

Yes

Analyzed

Description

This feature gives Coordinators and Organization Administrators the ability to review, approve, or flag registered activities submitted by peer mentors within their scope. The oversight screen lists recent and pending activities with filtering by date, peer mentor, activity type, and status. Coordinators can drill into individual activity records to verify correctness, add notes, and approve or request corrections. For organizations that require coordinator sign-off before activities are included in Bufdir reports, this workflow provides the necessary approval gate. The feature also surfaces duplicate activity warnings detected by the system to help coordinators resolve conflicts before reporting.

User Flow

Activity Oversight & Approval Workflows user flow

Click to expand

Analysis

Business Value

Accurate activity reporting is the foundation of Bufdir grant compliance, and errors or duplicates in submitted activities can jeopardize funding for all four partner organizations. This oversight feature gives coordinators the tools to catch and correct issues before they propagate into official reports, reducing the risk of rejected Bufdir submissions. It also addresses the specific NHF concern about duplicate registrations when multiple coordinators log the same event, by providing a centralized review interface. For peer mentors, knowing that a human reviews their submissions creates accountability and encourages accurate reporting. This feature is essential for building organizational trust in the platform as a replacement for manual Excel-based processes.

Implementation Notes

The oversight screen is a server-rendered Next.js page with client-side filtering applied via query parameters passed to the /api/v1/admin/activities endpoint. Activity approval state is stored as an enum field on the activities table (pending, approved, flagged, rejected) with an audit trail in audit_logs. The approval action triggers a POST to /api/v1/admin/activities/{id}/approve, which validates coordinator scope and updates the record. Duplicate detection results (from the duplicate-activity-detection feature) are surfaced as warning badges on activity list items. Pagination is implemented server-side with cursor-based pagination for performance with large datasets. The Flutter mobile app does not include this oversight UI — it is admin-panel-only. Coordinators accessing via mobile use the mobile app's limited view; full oversight requires the admin panel.

Components (64)

User Interface (3)

ui Activity Filter Widget medium ui Activity Oversight Screen high ui Approval Workflow Screen high

Service Layer (1)

service Activity Oversight Service high

Data Layer (1)

data Activity Approval Repository medium

Infrastructure (1)

infrastructure Activity Approval API Routes medium

Shared Components

These components are reused across multiple features

User Interface (16)

ui Accessible Picker Widget medium Shared ui Speech Input Widget medium Shared ui Contact Card Widget low Shared ui Contact Search Bar Widget low Shared ui View Switcher Widget low Shared ui Activity Summary Widget low Shared ui Approval Status Badge Widget low Shared ui Bottom Navigation Bar Widget low Shared ui Duplicate Warning Badge Widget low Shared ui Receipt Viewer Widget medium Shared ui Benefit Breakdown Chart Widget medium Shared ui AppButton Widget medium Shared ui AppTextField Widget medium Shared ui Modal Navigation Helpers medium Shared ui Page Header Widget low Shared ui Sync Status Indicator Widget low Shared

Service Layer (13)

service Auth Service medium Shared service Role Guard Service medium Shared service Activity Service medium Shared service Role Guard Service low Shared service Contact Service medium Shared service Email Invitation Service medium Shared service Oversight Audit Log Service medium Shared service Reimbursement Approval Audit Logger low Shared service Context Management Service medium Shared service Statistics Service medium Shared service REST API Client high Shared service Accessibility Service high Shared service Encryption Service high Shared

Data Layer (9)

data Token Storage low Shared data Auth Token Repository medium Shared data Activity Repository medium Shared data Contact Repository Cache low Shared data Contact Repository medium Shared data Reimbursement Admin Repository medium Shared data Organization Repository high Shared data Local Cache Repository medium Shared data Audit Log Repository medium Shared

Infrastructure (20)

infrastructure JWT Infrastructure medium Shared infrastructure JWT Infrastructure low Shared infrastructure Auth Middleware medium Shared infrastructure Report API Middleware low Shared infrastructure Report Access Guard low Shared infrastructure Approval Audit Logger low Shared infrastructure End-to-End Encryption Infrastructure high Shared infrastructure Email Delivery Infrastructure low Shared infrastructure Invitation Token Infrastructure medium Shared infrastructure Signed URL Provider low Shared infrastructure Multi-Tenancy Infrastructure high Shared infrastructure Calculator Export Infrastructure medium Shared infrastructure Request & Response Interceptors high Shared infrastructure Design Token System medium Shared infrastructure Semantic Labels Infrastructure medium Shared infrastructure Connectivity Infrastructure low Shared infrastructure Local Database Infrastructure high Shared infrastructure Secure Storage Infrastructure medium Shared infrastructure Connection Pool Infrastructure medium Shared infrastructure Database Migration Infrastructure medium Shared

User Stories

No user stories have been generated for this feature yet.