Home

Project Architecture & System Summary

Overview: Hope Cope Heal (HCH) Portal

This project is a full-stack behavioral-health operations platform built as a Nuxt 4 single codebase. It manages the end-to-end lifecycle of clinical care, from prospective client intake to active telehealth sessions and audited clinical documentation.

Core Technology Stack

• Framework: Nuxt 4.4 (Vue 3, Nitro, Vite)
• Database: SQLite with Prisma ORM (Multi-file schema support)
• Auth: Better Auth (Email OTP passwordless login)
• UI/UX: @nuxt/ui, Tailwind CSS, TipTap (Rich Text Editor), FullCalendar
• Integrations: Nodemailer (SMTP), Video Conferencing, File System (PDF Uploads)

System Connections

The application connects three distinct user experiences:

1. Client Portal: A task-based experience where status (Prospective, Waitlist, Active, Archived) dictates what forms and data are accessible.
2. Clinician Workspace: A caseload-scoped view for managing assigned clients, writing notes, and managing calendars.
3. Admin Command: A clinic-wide governance layer for metrics, final note approvals, and system auditing.