Skip to content

Pages Reference

This document describes the purpose and function of each page in the Metricis portals.


Researcher Portal (portal/)

Global Pages

Page File Purpose
Login Login.tsx Authentication page for researcher credentials
Studies Studies.tsx Main landing page and dashboard. Lists all studies with stats, allows creating new studies with classification wizard

Study-Scoped Pages

Pages accessible when a study is selected.

Study Configuration

Page File Purpose
Study Detail StudyDetail.tsx View/edit study properties, manage batteries, consent forms, sites, arms, and rare pediatric configuration
Study Overview StudyOverview.tsx Dashboard view for a specific study showing key metrics, recent activity, and quick links
Study Events StudyEvents.tsx Manage visit windows (timepoints) within a study. Events define the assessment timeline for participants
Study Assistant StudyAssistant.tsx AI-powered configuration assistance. Document upload, protocol ingestion, battery config via ChangeSet review

Participants & Sessions

Page File Purpose
Participants Participants.tsx List, create, and manage study participants. Supports REDCap sync for managed studies
Participant Detail ParticipantDetail.tsx Comprehensive view of a single participant: demographics, sessions, scheduled visits, phenotype timeline
Assessment Sessions AssessmentSessions.tsx Monitor assessment session completion status, view details, track progress by participant
Assessment Queue AssessmentQueue.tsx EDC integration queue showing queued, in-progress, and completed assessments. Actions for delivery and reconciliation
Data Entry DataEntry.tsx CRF/form completion interface using SurveyJS. Shows pending forms by participant/visit

Scheduling

Page File Purpose
Schedules Schedules.tsx Manage visit windows, view upcoming/overdue scheduled visits, configure reminders

Analytics & Export

Page File Purpose
Reports Reports.tsx Study analytics and reporting with charts (enrollment trends, completion rates, site performance)
Export Export.tsx Download study data in various formats (CSV, JSON). Includes SDTM export and validation functionality
Monitor Compliance Dashboard MonitorComplianceDashboard.tsx Track protocol amendment compliance: consent re-execution status, version distribution, deviations
Page File Purpose
eConsent Designer EConsentDesigner.tsx Create/edit consent versions with sections, configure signature requirements (participant, LAR, witness, investigator), 21 CFR Part 11 compliant

Metadata Versioning

Page File Purpose
Metadata Versions MetadataVersions.tsx Manage study metadata versions for amendment tracking and audit trail

Forms Module (forms/)

A dedicated module for form/CRF management with its own layout and navigation.

Page File Purpose
Forms Layout FormsLayout.tsx Shell layout for forms module with sidebar navigation (Events, Library, Settings)
Events List EventsList.tsx List and manage study events/visits with associated forms
Study Forms StudyForms.tsx View and manage forms assigned to the current study
Form Library FormLibrary.tsx Browse template library, copy templates to study, preview forms via SurveyJS
Form Designer FormDesigner.tsx Visual form builder for creating/editing study-specific forms
Template Designer TemplateDesigner.tsx Create/edit reusable form templates for the library
Form Detail FormDetail.tsx View details of a specific form
Form Preview FormPreview.tsx Preview a form's appearance and behavior
Form Settings FormSettings.tsx Configure form-level settings

Admin Pages (admin/)

Global administration pages not scoped to a specific study.

Page File Purpose
Module Registry ModuleRegistry.tsx Browse all available assessment modules (cognitive tasks, questionnaires) with metadata
Batteries Batteries.tsx List and manage assessment batteries across studies
Battery Builder BatteryBuilder.tsx Drag-and-drop builder for composing batteries from modules
REDCap Config REDCapConfig.tsx Configure REDCap integration: API tokens, field mappings per battery, webhooks
Users Users.tsx User management for portal access
User Detail UserDetail.tsx View/edit individual user details and permissions
Audit Trail AuditTrail.tsx Searchable view of all audit events for compliance monitoring. Export functionality for regulatory inspections
Account Sessions AccountSessions.tsx View and manage active user sessions

Registry Pages

For patient registry management (separate from clinical studies).

Page File Purpose
Registries Registries.tsx List all patient registries with create functionality. Types: observational, trial-adjacent, platform, patient-initiated
Registry Overview RegistryOverview.tsx Dashboard view for a specific registry
Registry Participants RegistryParticipants.tsx Manage registry members
Registry Participant Detail RegistryParticipantDetail.tsx Individual registry participant profile
Cohort Detail CohortDetail.tsx View/manage a specific cohort within a registry
Registry Analytics RegistryAnalytics.tsx Analytics and reporting for registry data

Patient Portal (patient-portal/)

Mobile-first interface for patients and caregivers.

Authentication

Page File Purpose
Login Login.tsx Patient authentication (magic link entry)
Verify Link VerifyLink.tsx Magic link verification and session establishment

Main Pages

Page File Purpose
Home Home.tsx Landing page showing pending tasks, consent status, and quick actions
Tasks Tasks.tsx List of all assigned tasks (assessments, forms, etc.)
Task Detail TaskDetail.tsx View details of a specific task and launch it
Assessments Assessments.tsx View pending and completed cognitive assessments
Assessment Landing AssessmentLanding.tsx Pre-assessment instructions and launch screen
Page File Purpose
Consent Consent.tsx View consent documents and status
Consent Sign ConsentSign.tsx Sign consent forms with signature capture

Other

Page File Purpose
Schedule Schedule.tsx View upcoming visits and assessment schedule
Summary Summary.tsx Post-assessment summary and completion confirmation
Settings Settings.tsx Account settings, language preferences, notification preferences
Contact Contact.tsx Contact information for study team support

Route Patterns

Researcher Portal

/                          → Studies (dashboard)
/login                     → Login
/studies/:studyId          → StudyDetail
/studies/:studyId/overview → StudyOverview
/studies/:studyId/events   → StudyEvents
/studies/:studyId/participants → Participants
/studies/:studyId/participants/:participantId → ParticipantDetail
/studies/:studyId/sessions → AssessmentSessions
/studies/:studyId/reports  → Reports
/studies/:studyId/export   → Export
/forms/:studyId/events     → EventsList (forms module)
/forms/:studyId/library    → FormLibrary (forms module)
/admin/modules             → ModuleRegistry
/admin/batteries           → Batteries
/admin/audit               → AuditTrail
/registries                → Registries

Patient Portal

/                          → Home
/login                     → Login
/tasks                     → Tasks
/tasks/:taskId             → TaskDetail
/assessments               → Assessments
/consent                   → Consent
/schedule                  → Schedule
/settings                  → Settings