Healthcare

PSI Nest — HIPAA Practice Management

Context

Medical practices — particularly mental health professionals — needed a HIPAA-compliant practice management system that streamlined clinical workflows without sacrificing security. Existing options were prohibitively expensive, hard to use, or lacked the compliance guarantees required for handling Protected Health Information.

The Hard Part

HIPAA compliance had to be built into every layer rather than bolted on: PHI encryption, granular role-based access, and immutable audit logging with six-year retention are regulatory requirements, not features.

What I Built

  • Appointment scheduling with automated patient reminders
  • Secure patient portal for intake forms and messaging
  • Clinical note templates for common assessment types
  • Integrated billing with CMS-1500 claim generation
  • AES-256 encryption at rest, TLS 1.3 in transit, application-level encryption for PHI fields
  • Role-based access control across practice owner, clinician, front desk, and billing roles
  • Immutable audit log tracking every PHI access event for the six-year retention period

The Build

Why small practices were stuck

Practice management software for mental health professionals had three failure modes, and most products managed at least one. Some were prohibitively expensive, priced for organisations with a procurement department rather than a clinician with a caseload. Some were hard to use, built as though administration were the job rather than the tax on it. And some lacked the compliance guarantees required for handling protected health information at all.

The combination is what makes this a real problem rather than a crowded market. In a small practice the person doing the administration is usually the person delivering the care, so every minute spent on scheduling, intake, notes, or billing is a minute not spent with a patient. Software that is expensive competes with income; software that is slow competes with clinical time.

The third failure mode is the dangerous one, because it does not stay a software problem. When a compliant system is unpleasant enough to use, people route around it — a note kept somewhere more convenient, an intake form emailed rather than submitted, a reminder sent from a personal phone. The workaround is where the exposure actually happens, which means usability is not a competing concern to compliance. It is a precondition for it.

What "built in rather than bolted on" had to mean

HIPAA compliance had to be present at every layer instead of added afterwards, and three requirements in particular shaped the design rather than decorating it.

PHI encryption is not a single switch. It has to hold at rest, in transit, and — for the most sensitive fields — inside the application itself, which is a different proposition from the first two because it changes what the database can do with those values.

Granular role-based access follows from the principle that each role sees only what its work requires. A practice has genuinely different jobs in it, and treating "staff" as one permission level is the shortcut that makes every later access question unanswerable.

Immutable audit logging with six-year retention is the requirement that most constrains the architecture, because immutability and long retention pull in opposite directions from ordinary application design. Records that cannot be edited cannot be cleaned up, and six years of every access event is a volume you have to plan for at schema time rather than discover.

How the system is put together

Encryption runs at three depths. AES-256 at rest protects the stored data, TLS 1.3 protects it in transit, and application-level encryption on PHI fields protects it from anything that reaches the database directly. The third layer carries a real cost worth naming: an encrypted column cannot be searched or indexed in the ordinary way, so it has to be applied deliberately to the fields that warrant it rather than sprayed across the schema. Deciding which fields those are is a design decision, not a configuration one.

Access control spans four roles — practice owner, clinician, front desk, and billing — and the split is the point. Front desk needs the appointment calendar, not the clinical note attached to it. Billing needs the procedure and the claim, not the session content. Modelling those as distinct roles is what allows the system to answer "who could have seen this?" with something better than "anyone who was logged in".

The audit log records every PHI access event and cannot be rewritten. The important design consequence is that reads have to be instrumented, not just writes — most audit implementations capture changes, but in a clinical system the question that gets asked is who looked, and a mutation-only log cannot answer it. Retaining that for six years also means the log has to be queryable, since an immutable store nobody can search is evidence that cannot be produced.

The clinical surface is what makes any of it worth adopting. Appointment scheduling with automated patient reminders, a secure portal for intake forms and messaging, clinical note templates for common assessment types, and integrated billing that generates CMS-1500 claims — these are the reasons a practice opens the software each morning. Building them well is not separate from the compliance work; it is what keeps clinicians inside the system where the controls apply.

What the results actually demonstrate

A 40% reduction in administrative time is the figure that matters to the practice, because of who was doing that work. In a small clinic that time does not transfer to an admin team — it returns to the clinician, as either patient capacity or an earlier end to the day. It is also the number that proves the usability argument: an unpleasant system does not produce a reduction like that, it produces workarounds.

Passing an independent HIPAA security assessment is a different kind of result, and unusual in that it is binary. Its value is entirely in the word independent: the encryption, the role separation, and the audit trail were examined by someone with no stake in the answer, rather than asserted by the people who built them. In a domain where every vendor claims compliance, an outside assessment is the only version of that claim that means anything.

Six-year immutable audit retention sits alongside those two as the capability neither of them implies. It is the part that has to be right on the day it is needed — long after the build, in circumstances nobody plans for — which is exactly why it belonged in the architecture from the beginning rather than in a later release.

Measured Results

40%

reduction in administrative time

Passed

independent HIPAA security assessment

6-year

immutable audit retention

Tech Stack

NestJSTypeScriptReactNeon DBCoolify
PSI Nest — HIPAA Practice Management — interface screenshot
Visit app.psinest.com

More Case Studies

Have a similar project?

I would love to help you build something great. Let's discuss your requirements.