← Back to Home

PsychWorks Report Generation Tool

PsychWorks is a custom-built report generation system created in collaboration with Fort Worth PsychWorks, a neuropsychological assessment clinic. The system was designed to address inefficiencies in their existing workflow, which required psychologists to manually fill out assessment tables, transcribe scores, and write narrative summaries for each patient. This process was not only time-consuming but also prone to inconsistency and redundant effort.

The platform automates this workflow by allowing clinicians to build and manage assessment templates, input scores, and instantly generate professional-grade reports that incorporate pre-written narratives tied to the data. PsychWorks saves time, improves accuracy, and ensures consistency across reports while keeping everything compliant with privacy requirements.

Presenting PsychWorks at the TCU Senior Research SymposiumPresenting PsychWorks at the TCU Senior Research Symposium

Technical Overview

PsychWorks was developed using modern web technologies. The frontend is built with React using the Next.js framework and styled with TailwindCSS. We used TypeScript for static typing and reliability, and Supabase for user authentication and cloud-hosted PostgreSQL storage. The application was deployed using Vercel, which allowed for seamless CI/CD integration through GitHub.

PsychWorks Technical Stack DiagramSystem architecture and technology stack for PsychWorks

Frontend

  • Next.js
  • React
  • TypeScript
  • TailwindCSS

Backend

  • Supabase
  • PostgreSQL
  • Authentication
  • Role-based Access

Deployment

  • Vercel
  • GitHub CI/CD
  • Automated Deployments
  • Environment Management

Design & Prototyping

Before beginning development, we created a comprehensive Figma prototype to design the user interface and map out the user experience. The prototype included detailed mockups of all key features including template management, assessment creation, and report generation workflows. This design-first approach allowed us to ensure a intuitive and efficient user experience tailored to the needs of clinical psychologists.

View the Figma PrototypeInteractive Figma prototype showing the complete UI/UX design process

Key Functionality

Template Management

Psychologists can build and manage assessment templates, selecting areas of measurement, test types, and narrative options. These templates can be reused for different patients, ensuring consistency across reports.

Real-time Report Generation

The system automatically generates appropriate narrative summaries as scores are entered, with a live preview that updates instantly. Reports can be downloaded in DOCX format for recordkeeping.

Security & Compliance

Built-in security features include automatic session timeouts, role-based access control, and audit logging. The system maintains compliance with privacy requirements while ensuring data security.

System Walkthrough

Assessment Creation

This video demonstrates how clinicians can create new assessment table templates, selecting between behavioral or cognitive test types. The process includes defining domains/subtests, score types (StS, ScS, T, Z), and percentile graphing fields. Each assessment template can be customized with unique names, descriptions, and measurement criteria while ensuring compliance with psychiatric guidelines.

Template Creation

Watch how clinicians can build comprehensive report templates by combining multiple assessment table templates. The video shows the process of creating a new report template, including naming conventions, adding assessment tables, and structuring the final report format. This feature ensures consistency across all clinical reports while maintaining flexibility for different assessment types.

Report Generation

This video showcases the automated report generation process, where the system calculates percentiles based on input scores and generates professional-grade reports. The demonstration includes data validation, automatic narrative generation through intelligent text substitution from assessment tables, and the ability to review and edit reports before finalizing. The system ensures HIPAA compliance while providing a streamlined workflow for clinicians. Note: Due to patient confidentiality and company ownership of the reports, the final output is not shown in this demonstration.

Deployment & Reliability

The application is hosted on Vercel, providing scalable, low-maintenance deployment. We implemented automated deployment pipelines integrated with GitHub for rapid feature deployment and bug fixes. The system includes autosave features, audit logs, and safeguards against data loss, ensuring stability and reliability during peak usage.

Project Impact

  • Significantly reduced report generation time
  • Improved consistency across all clinical reports
  • Enhanced data security and privacy compliance
  • Streamlined workflow for clinicians
  • Reduced manual data entry errors

If you'd like to learn more about this project or see the code, please contact me directly or check out the link below.

View the PsychWorks Project on the TCU Senior Design Website