UI Components

Service Components

Data Components

Infrastructure Components

Shared Components

Token Storage

Secure persistent storage for JWT access and refresh tokens using Flutter Secure Storage, backed by ...

shared low shared
JWT Infrastructure

Infrastructure layer responsible for JWT token parsing, validation, and expiry checks. Decodes acces...

shared medium shared
Auth Service

BLoC-based service that orchestrates the email and password authentication flow against the REST API...

shared medium shared
Auth Token Repository

Data access layer for persisting and retrieving authentication tokens, session records, and identity...

shared medium shared
JWT Infrastructure

Shared backend infrastructure for signing, verifying, and managing platform JWTs. Used by both BankI...

shared low shared
Auth Middleware

Next.js middleware layer that intercepts every API request and validates the JWT role claims server-...

shared medium shared
Role Guard Service

A Riverpod provider that reads the authenticated user's role and organization context from app state...

shared medium shared
Activity Repository

Data access layer for activity records supporting both online REST API writes and offline local SQLi...

shared medium shared
Contact Repository Cache

Read-only local cache of contact records enabling offline contact search within the wizard contact s...

shared low shared
Activity Service

Shared business logic service for creating, updating, and submitting activities. Used by both the si...

shared medium shared
Accessible Picker Widget

WCAG 2.2 AA compliant reusable picker widget providing 44×44px touch targets, keyboard-accessible nu...

shared medium shared
Speech Input Widget

Reusable Flutter widget that wraps any TextField with a microphone button, enabling peer mentors to ...

shared medium shared
Role Guard Service

Injects the authenticated user's role into query contexts to enforce data access boundaries. Shared ...

shared low shared
Contact Card Widget

Compact list-item card displaying a contact's name, role context, and last interaction summary. Meet...

shared low shared
Contact Search Bar Widget

Reusable search input widget that triggers real-time filtering across contacts and notes content. Im...

shared low shared
View Switcher Widget

Segmented control widget allowing users to toggle the contacts list between 'Contacts' and 'Peer Men...

shared low shared
Contact Repository

Data access layer for the contacts table, shared across Contact List & Search and Contact Detail & E...

shared medium shared
Contact Service

Business logic layer for contact CRUD operations, shared across the Contact List & Search and Contac...

shared medium shared
Activity Summary Widget

A reusable card widget that displays a single aggregated metric — such as total hours, total contact...

shared low shared
Report API Middleware

Next.js API route middleware that enforces role-scoped access control for all team report endpoints,...

shared low shared
Report Access Guard

Middleware that enforces role-based access control for all Bufdir report generation and export endpo...

shared low shared
Approval Audit Logger

Infrastructure component that writes structured audit log entries to audit_logs for every approval l...

shared low shared
Approval Status Badge Widget

Compact badge widget that renders the current approval status of a reimbursement claim with color co...

shared low shared
End-to-End Encryption Infrastructure

Implements the asymmetric key exchange and symmetric encryption layer used for assignment payloads. ...

shared high shared
Bottom Navigation Bar Widget

Persistent Material 3 NavigationBar shell widget wrapping all five tab destinations (Home, Contacts,...

shared low shared
Email Delivery Infrastructure

Adapter layer wrapping the transactional email provider (Resend or SendGrid) used for all outbound s...

shared low shared
Invitation Token Infrastructure

Generates and validates time-limited cryptographically signed tokens used in user invitation links. ...

shared medium shared
Email Invitation Service

Handles the composition and dispatch of user invitation emails via a transactional email provider su...

shared medium shared
Oversight Audit Log Service

Specialized service responsible for recording immutable audit trail entries whenever an approval act...

shared medium shared
Duplicate Warning Badge Widget

Inline badge component that surfaces duplicate activity detection results as visual warnings on acti...

shared low shared
Reimbursement Admin Repository

Data access layer optimized for the admin oversight use case, providing complex filtered and paginat...

shared medium shared
Signed URL Provider

Infrastructure utility that generates time-limited signed URLs for accessing receipt images stored i...

shared low shared
Reimbursement Approval Audit Logger

Service responsible for writing immutable audit log entries whenever a reimbursement is approved, re...

shared low shared
Receipt Viewer Widget

Overlay modal that displays receipt images fetched via signed URLs from object storage, preventing u...

shared medium shared
Organization Repository

Data access layer for the full organizational hierarchy including organizations, regions, and local ...

shared high shared
Multi-Tenancy Infrastructure

Application-level tenancy scoping layer that intercepts every incoming API request and attaches the ...

shared high shared
Context Management Service

Flutter BLoC-based service that stores and broadcasts the active association context throughout the ...

shared medium shared
Statistics Service

Shared service that provides aggregated activity and contact statistics for a given user and time ra...

shared medium shared
Calculator Export Infrastructure

Provides low-level utilities for generating image snapshots and PDF exports of the calculator result...

shared medium shared
Benefit Breakdown Chart Widget

Reusable Flutter widget that renders a visual chart of individual benefit categories using the fl_ch...

shared medium shared
Request & Response Interceptors

Flutter-side Dio/HTTP interceptor chain that transparently handles token refresh, retry logic, and e...

shared high shared
REST API Client

Centralized HTTP client for the Flutter mobile app that handles all communication with the Next.js b...

shared high shared
Design Token System

Single Dart constants file defining all visual design tokens for the application including colors, t...

shared medium shared
Semantic Labels Infrastructure

Infrastructure layer providing localized, organization-aware semantic label strings for all interact...

shared medium shared
Accessibility Service

Central service managing runtime accessibility state, screen reader detection, font scaling, and foc...

shared high shared
AppButton Widget

Accessible, reusable button widget used throughout the Flutter app. Enforces minimum 24x24 logical p...

shared medium shared
AppTextField Widget

Accessible text input widget enforcing WCAG 2.2 AA requirements for form fields across the entire ap...

shared medium shared
Modal Navigation Helpers

Widget utilities managing modal presentation, dismissal, and focus trapping to meet WCAG 2.2 focus m...

shared medium shared
Page Header Widget

Standardized page header widget providing consistent visual hierarchy, back navigation, and screen r...

shared low shared
Local Cache Repository

Provides read and write access to the local SQLite mirror of server-side data required for offline o...

shared medium shared
Connectivity Infrastructure

Monitors device network connectivity using the connectivity_plus Flutter package and exposes reactiv...

shared low shared
Local Database Infrastructure

Bootstraps and manages the on-device SQLite database using the drift (formerly moor) package for Flu...

shared high shared
Sync Status Indicator Widget

A persistent UI widget that communicates the current synchronization state to the user. Displays pen...

shared low shared
Audit Log Repository

Persists security-relevant events to a dedicated PostgreSQL audit_logs table with tamper-evident app...

shared medium shared
Secure Storage Infrastructure

Wraps flutter_secure_storage to provide hardware-backed secure storage delegating to iOS Keychain an...

shared medium shared
Encryption Service

Provides AES-256-GCM symmetric encryption for sensitive fields at rest. Wraps key derivation logic w...

shared high shared
Connection Pool Infrastructure

Manages a pool of PostgreSQL connections for the Next.js backend using node-postgres (pg). Configure...

shared medium shared
Database Migration Infrastructure

Manages versioned SQL schema migrations for the PostgreSQL database. Applies migration scripts in se...

shared medium shared