Skip to content
Brian-dotcom-stackPublic

About

Virtual workspace and operations platform for care-sector teams featuring smart rota scheduling, attendance geofencing, HR workflows, and compliance.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

6 Commits

Folders and files

Repository files navigation

CareVerse πŸ₯

The Virtual Workspace & Operations Operating System for Modern Care Teams

An immersive, multi-tenant digital workplace engineered specifically for care homes, supported living, domiciliary care providers, and healthcare staffing agencies.

TypeScript React Vite Tailwind CSS Compliance Authentication

Live Demo β€’ Architecture Specs β€’ Database Schema β€’ Quick Start


πŸ“Œ Executive Summary

Social care operations are hindered by fragmented tooling: paper communication books, disconnected spreadsheet rotas, proxy clock-ins, missed compliance renewals, and exorbitant agency recruitment fees.

CareVerse replaces legacy, disparate workflows with an interactive virtual headquarters. Designed with a spatial layout inspired by high-productivity virtual office paradigms, CareVerse delivers real-time floor awareness, algorithmic shift optimization, anti-tamper biometric timekeeping, and continuous regulatory audit-readiness for healthcare standards (including UK Care Quality Commission & HIPAA guidelines).


πŸš€ Key Modules & Capabilities

1. 🏒 Virtual Workspace Hub (Spatial Digital HQ)

  • Interactive Floorplan: Spatial floor layout mapping physical operations into digital collaborative rooms (Admin Suite, HR Office, Managers Office, Staff Hub, Medication Room, and Training Room).
  • Live Staff Presence: Real-time staff tracking with visual indicators (At Desk, On Rounds, In Huddle, On Break, In Training, Off Duty).
  • Room Whiteboards & Handover Notes: Digital sticky-note boards per room for asynchronous handover briefings between shifts.
  • CQC Safe Staffing Telemetry: Live ratio analysis checking registered nurses, senior carers, and care practitioners against active resident occupancy.

2. πŸ“… Smart Rota Engine & Scheduling

  • Algorithmic Constraint Satisfaction: Auto-generates conflict-free rotas adhering to:
    • Maximum 48-hour working week limits (UK Working Time Directive).
    • Mandatory 11-hour rest intervals between shifts.
    • Required Level 3 Medication Administration certified staff quotas per wing.
  • Multi-Wing Scheduling: 7-day master roster and single-day breakdown filtering across specialized wings (Dementia Haven, Residential, Night Cover).
  • Instant Shift Broadcast & Claiming: Unfilled shift alerts broadcast directly to internal bank staff with one-click self-service claiming to curb costly agency spend.
  • Payroll Export: Instant CSV export formatted for payroll systems.

3. ⏱️ Attendance & Geofenced Timekeeping

  • Perimeter GPS Validation: Enforces clock-in/out within the care facility’s designated boundary (e.g., 250m geofence radius) with browser geolocation coordinates.
  • Visual Radar Sweep: Real-time radar visualization displaying on-site staff proximity.
  • IP & Network Authentication: Verifies clock-ins match verified facility Wi-Fi subnets to prevent remote buddy-punching.
  • Handover & Timesheet Sign-Off: Running duty timers with mandatory clinical handovers and manager sign-off workflows.

4. πŸ“‹ HR & Regulatory Compliance Suite

  • Comprehensive Staff Profiles: Centralized records covering job roles, contracted hours, hourly pay rates, and verified competencies.
  • DBS Expiry & Training Matrix: Automated 60-day renewal warnings for statutory Disclosure and Barring Service (DBS) checks and mandatory training.
  • Statutory Safeguarding Incident Log: Structured reporting for slips/falls, medication errors, challenging behaviour, and CQC Regulation 18 notifiable events.
  • Document Vault & Policy Signatures: End-to-end encrypted storage for facility certifications, with digital acknowledgements for handbooks and infection control policies.

5. πŸ“» Real-Time Comms & Spatial Intercom

  • Contextual Channels: Encrypted feeds for #shift-handovers, #urgent-coverage, #incident-response, and #general-announcements.
  • Urgent Broadcast System: High-priority alert dispatches triggering visual alert cues.
  • Virtual Intercom Audio: Interactive waveform visualizer simulating floor-wide intercom huddles between management and care practitioners.

6. πŸ“Š Operations & Quality Intelligence Dashboard

  • Performance Telemetry: Continuous tracking of 96.8% punctuality rates, safe staffing benchmarks, and agency cost savings.
  • Absence & Lateness Heatmap: 7-day variance visualizer mapping peak attendance friction across Morning, Afternoon, and Waking Night shifts.

πŸ›οΈ System Architecture

CareVerse is built as a cloud-native, modular web platform designed for multi-tenant isolation, high concurrency, and zero downtime.

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                          CAREVERSE CLIENT (SPA)                        β”‚
β”‚   React 18  β€’  TypeScript  β€’  Tailwind CSS  β€’  Lucide Icons  β€’  Vite   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                   β”‚ HTTPS / TLS 1.3 / WSS
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                           API GATEWAY / ROUTER                         β”‚
β”‚       Multi-Tenant Resolution  β€’  RBAC Middleware  β€’  Rate Limiting     β”‚
β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
       β”‚                           β”‚                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”
β”‚   CORE SCHEDULER    β”‚   β”‚  GEO-AUTHENTICATOR    β”‚   β”‚ COMPLIANCE ENGINEβ”‚
β”‚ Constraint Solver   β”‚   β”‚  WebAuthn / FIDO2     β”‚   β”‚ CQC Reg 18 Flags β”‚
β”‚ WTD & Rest Rules    β”‚   β”‚  GPS Haversine Engine β”‚   β”‚ DBS Renewal Cron β”‚
β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
       β”‚                           β”‚                               β”‚
β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”
β”‚                   PERSISTENCE LAYER (PostgreSQL)                       β”‚
β”‚    Row-Level Security (RLS)  β€’  Tenant Isolation  β€’  Immutable Audit   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Multi-Tenancy Model

CareVerse enforces strict logical tenant isolation. Each care agency or care home group operates inside a distinct tenant boundary:

  • Isolated rotas, shifts, staff directories, and timesheets.
  • Configurable geofence coordinates and organizational sector tags (Care Home, Supported Living, Domiciliary Care, Staffing Agency).
  • Zero cross-tenant data leakage.

Role-Based Access Control (RBAC)

Capability / Action Admin HR Manager Senior Carer Carer
Manage & Auto-Generate Rotas βœ… βœ… βœ… β€” β€”
Claim Open Broadcast Shifts βœ… β€” βœ… βœ… βœ…
Electronic Timesheet Sign-Off βœ… βœ… βœ… βœ… β€”
Log Statutory Safeguarding Incidents βœ… βœ… βœ… βœ… βœ…
Close CQC Investigation Reports βœ… βœ… βœ… β€” β€”
Access DBS Records & Passports βœ… βœ… β€” β€” β€”
Multi-Tenant Switcher βœ… β€” β€” β€” β€”

πŸ—„οΈ Relational Database Schema

CareVerse utilizes a relational architecture designed for ACID compliance and auditability. Below is the core schema definition (Prisma / PostgreSQL):

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

model Tenant {
  id                    String            @id @default(uuid())
  code                  String            @unique
  name                  String
  domain                String            @unique
  organizationType      String            // CARE_HOME, SUPPORTED_LIVING, DOMICILIARY, AGENCY
  planTier              String            @default("ENTERPRISE")
  geofenceRadiusMeters  Int               @default(250)
  latitude              Float
  longitude             Float
  createdAt             DateTime          @default(now())
  updatedAt             DateTime          @updatedAt

  users                 User[]
  shifts                Shift[]
  attendanceRecords     Attendance[]
  incidentReports       IncidentReport[]
  policies              PolicyDocument[]
  auditLogs             AuditLog[]
}

model User {
  id                    String            @id @default(uuid())
  tenantId              String
  tenant                Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
  email                 String            @unique
  name                  String
  role                  String            // ADMIN, HR, MANAGER, SENIOR_CARER, CARER
  jobTitle              String
  department            String
  contractedHours       Int               @default(37)
  hourlyRate            Decimal           @db.Decimal(10, 2)
  dbsCertificateNumber  String
  dbsExpiryDate         DateTime
  dbsStatus             String            // VALID, EXPIRING_SOON, EXPIRED
  biometricKeyHandle    String?           // FIDO2 WebAuthn credential ID
  createdAt             DateTime          @default(now())

  assignedShifts        Shift[]           @relation("AssignedStaff")
  attendanceRecords     Attendance[]
  reportedIncidents     IncidentReport[]  @relation("IncidentReporter")
  signedPolicies        PolicySignature[]

  @@index([tenantId, role])
}

model Shift {
  id                    String            @id @default(uuid())
  tenantId              String
  tenant                Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
  date                  DateTime
  startTime             String
  endTime               String
  unitOrWing            String
  status                String            // OPEN, ASSIGNED, COMPLETED, CANCELLED
  requiresMedCert       Boolean           @default(false)
  assignedStaffId       String?
  assignedStaff         User?             @relation("AssignedStaff", fields: [assignedStaffId], references: [id])
  isOpenBroadcast       Boolean           @default(false)

  @@index([tenantId, date])
}

model Attendance {
  id                    String            @id @default(uuid())
  tenantId              String
  tenant                Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
  userId                String
  user                  User              @relation(fields: [userId], references: [id])
  date                  DateTime
  clockInTime           DateTime
  clockOutTime          DateTime?
  distanceMeters        Int
  ipAddress             String
  biometricVerified     Boolean           @default(true)
  status                String            // ACTIVE, COMPLETED, LATE, PENDING_APPROVAL, APPROVED
  approvedBy            String?
}

model IncidentReport {
  id                    String            @id @default(uuid())
  tenantId              String
  tenant                Tenant            @relation(fields: [tenantId], references: [id], onDelete: Cascade)
  referenceNumber       String            @unique
  title                 String
  category              String            // FALL, MED_ERROR, SAFEGUARDING, NEAR_MISS, BEHAVIOURAL
  severity              String            // LOW, MEDIUM, HIGH, CRITICAL
  cqcNotifiable         Boolean           @default(false)
  description           String
  actionsTaken          String
  status                String            // LOGGED, UNDER_INVESTIGATION, REMEDIATED
  reporterId            String
  reporter              User              @relation("IncidentReporter", fields: [reporterId], references: [id])
  createdAt             DateTime          @default(now())
}

πŸ”’ Security, Governance & Regulatory Compliance

  • UK GDPR & Data Protection Act 2018: Strict data minimization, individual rights execution, and pseudonymized audit trails.
  • Caldicott Principles: Resident and service-user identifiable data is safeguarded by role access barriers.
  • HIPAA Security Rule: AES-256 encryption for data at rest, TLS 1.3 in transit, and immutable access logging.
  • FIDO2 / WebAuthn Biometrics: Hardware security key authentication eliminating credential-sharing risks.
  • Offline Resiliency: Client-side state caching with a synchronous queue for intermittent connectivity in care home dead zones.
  • Internationalization: Full interface localization supporting English, Spanish, French, Polish, and Tagalog.

πŸ› οΈ Quick Start

Prerequisites

  • Node.js: v18.0.0 or later
  • npm or pnpm

Installation

# 1. Clone repository
git clone https://github.com/your-username/careverse.git

# 2. Navigate to project directory
cd careverse

# 3. Install dependencies
npm install

# 4. Start local development server
npm run dev

The application will be accessible at http://localhost:3000.

Building for Production

# Compile and build production assets
npm run build

# Run linter and type-checks
npm run lint

🚒 Deployment

Deploying to Vercel

CareVerse is optimized for seamless deployment to Vercel or any static edge infrastructure:

npm i -g vercel
vercel --prod

Deploying via Docker / Cloud Run

FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

πŸ“„ License

Distributed under the Apache-2.0 License. See LICENSE for details.


Engineered with dedication for frontline care workers, managers, and directors shaping modern social care.

About

Virtual workspace and operations platform for care-sector teams featuring smart rota scheduling, attendance geofencing, HR workflows, and compliance.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages