🏠 Overview › 🧩 Components ›🧩 Proxy Registration Service

Proxy Registration Service

Component Detail

Service Layer medium complexity mobilebackend
3
Dependencies
1
Dependents
3
Entities
0
Integrations

Description

Orchestrates the full lifecycle of a single proxy activity registration. Enforces coordinator role authorization, coordinates duplicate checking, writes the attributed activity record with separate registered_by and attributed_to fields, and emits results back to the UI via BLoC events.

Feature: Proxy & Bulk Activity Registration

proxy-registration-service

Responsibilities

  • Verify the acting user holds a coordinator or higher role
  • Invoke duplicate detection before committing any record
  • Persist activity with registered_by (coordinator) and attributed_to (peer mentor) fields
  • Emit success, duplicate-conflict, and error events to the BLoC

Interfaces

submitProxyActivity(ProxyActivityRequest request)
checkAuthorization(String userId)
handleDuplicateConflict(DuplicateConflict conflict)
overrideAndSubmit(ProxyActivityRequest request)
getProxyActivitiesForMentor(String mentorId)

Relationships

Dependencies (3)

Components this component depends on

data Proxy Activity Repository service Activity Attribution Service Shared service Proxy Duplicate Detection Service Shared

Dependents (1)

Components that depend on this component

service Proxy Registration BLoC

Related Data Entities (3)

Data entities managed by this component

Activity 25 fields core Peer Mentor 22 fields core User Role 13 fields core

API Contract

View full contract →
REST /api/v1/proxy-activities 6 endpoints
GET /api/v1/proxy-activities List proxy activities with optional filters
GET /api/v1/proxy-activities/:id Get a single proxy activity by ID
POST /api/v1/proxy-activities Create a proxy activity on behalf of a mentor (validateProxyPermission + buildProxyPayload internally)
PUT /api/v1/proxy-activities/:id Update a proxy activity
DELETE /api/v1/proxy-activities/:id Delete a proxy activity
POST /api/v1/proxy-activities/validate-permission Validate coordinator has proxy permission for a given mentor