Duplicate Activity Detection - Likepersonsapp – Peer Mentor Activity Platform | Generated by Eircodex v3.0

Scope

medium complexity extracted Statistics & Reporting Confidence: 100%

4

Components

58

Shared

0

User Stories

Yes

Analyzed

Description

This feature detects and warns users when an activity being registered appears to be a duplicate of one already in the system. The detection logic checks for matching combinations of peer mentor, contact, date, and activity type, surfacing a clear warning before the user saves. This prevents double-counting in statistics and Bufdir reports, which is particularly important in NHF's multi-coordinator environment where the same group activity may be registered by several people independently. The warning is non-blocking — users can override it if the activity is genuinely distinct.

User Flow

Duplicate Activity Detection user flow

Click to expand

Analysis

Business Value

Duplicate activity registrations directly undermine the accuracy of statistics, coordinator reports, and Bufdir submissions, creating legal and financial risk for organizations that receive grant funding based on reported activity counts. NHF explicitly identified duplicate detection as a unique requirement given their complex structure of 12 national associations, 9 regions, and 1,400 local associations where the same group event can easily be reported by multiple coordinators. A false Bufdir report — even if unintentional — could jeopardize future funding. By proactively surfacing potential duplicates at registration time, this feature protects data integrity without blocking legitimate work, striking the right balance between data quality and usability for volunteers who may not be aware of parallel registrations.

Implementation Notes

Duplicate detection is implemented as a lightweight API check triggered client-side when the user reaches the summary step of the activity wizard, before final submission. The backend query checks the activities table for existing records matching the same peer_mentor_id, contact_id (if provided), activity_date (same day), and activity_type_id within the same local_association_id scope. A fuzzy window of ±1 day should be configurable. The Next.js API returns a boolean flag and optionally the conflicting activity ID for display. On the Flutter side, a non-blocking warning widget (DuplicateWarningWidget) appears inline in the wizard summary step with a clear explanation and two options: go back to edit, or confirm and save anyway. The check adds minimal latency and must not block the save path. All duplicate detections are logged for coordinator audit review.

Components (62)

User Interface (1)

ui Duplicate Warning Widget low

Service Layer (1)

service Duplicate Detection Service medium

Data Layer (1)

data Duplicate Audit Repository low

Infrastructure (1)

infrastructure Duplicate Check API Endpoint low

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.