TPT Open Source

tpt-court

TypeScript

Open-source court case management system built with Next.js, Fastify, and Prisma. Manage cases, hearings, parties, documents, payments, and notifications — with role-based access for judges, clerks, lawyers, and public e-filing.

0 stars0 forks0 watchersMIT License
case-managementcourt-managemente-filingfastifylegal-technextjsopen-sourceprismatypescript
View on GitHubLive Demo

Languages

TypeScript97.9%Shell0.8%PowerShell0.7%JavaScript0.3%CSS0.2%Dockerfile0.0%Batchfile0.0%
README

TPT Court

Open-source court ERP platform for judges, lawyers, clerks, and the public. Manage cases, documents, hearings, and payments with ease.

Architecture

tpt-court/
├── apps/
│   ├── api/          # Fastify REST API + Socket.io
│   ├── web/          # Next.js 15 web application
│   └── desktop/      # Electron desktop wrapper
├── packages/
│   ├── database/     # Prisma ORM, schema, seed
│   ├── types/        # Shared TypeScript types
│   └── ui/           # Shared UI components (React + Tailwind)
├── docker/           # Docker Compose + Dockerfiles
└── turbo.json        # Turborepo configuration

Quick Start

Prerequisites

  • Node.js >= 20
  • pnpm >= 9
  • PostgreSQL 16
  • Redis 7 (optional, for Socket.io)

Setup

# Clone and install
git clone <repo-url>
cd tpt-court
pnpm install

# Setup database
cp apps/api/.env.example apps/api/.env
# Edit apps/api/.env with your DATABASE_URL
pnpm db:generate
pnpm db:push
pnpm db:seed

# Start development
pnpm dev

# API: http://localhost:3001
# Web: http://localhost:3000

Seed Data

The seed script creates:

  • A demo court (Central District Court, code: MAIN)
  • Admin user: admin@court.example / Admin1234!
  • Judge user: judge@court.example / Judge1234!
  • Clerk user: clerk@court.example / Clerk1234!
  • Lawyer user: lawyer@court.example / Lawyer1234!
  • Sample case with parties and hearing

Environment Variables

API (apps/api/.env)

| Variable | Description | Default | |---|---|---| | PORT | Server port | 3001 | | DATABASE_URL | PostgreSQL connection string | Required | | JWT_SECRET | JWT signing secret | Required | | CORS_ORIGIN | Allowed CORS origins | http://localhost:3000 | | STRIPE_SECRET_KEY | Stripe secret key | Optional | | STRIPE_WEBHOOK_SECRET | Stripe webhook secret | Optional | | UPLOADS_DIR | File upload directory | ./uploads |

Web (apps/web/.env)

| Variable | Description | Default | |---|---|---| | NEXT_PUBLIC_API_URL | API base URL | http://localhost:3001/api | | NEXT_PUBLIC_SOCKET_URL | Socket.io URL | http://localhost:3001 | | NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY | Stripe publishable key | Optional |

API Routes

Auth

  • POST /api/auth/register — Register new user
  • POST /api/auth/login — Login
  • POST /api/auth/logout — Logout
  • GET /api/auth/me — Current user

Public

  • GET /api/public/cases — Search public cases
  • GET /api/public/cases/:caseNumber — Public case detail

Cases (authenticated)

  • GET /api/cases — List cases
  • POST /api/cases — Create case (Clerk/Admin/Judge)
  • GET /api/cases/:id — Case detail
  • PUT /api/cases/:id — Update case
  • DELETE /api/cases/:id — Delete case (Admin)
  • POST /api/cases/:id/parties — Add party
  • DELETE /api/cases/:id/parties/:partyId — Remove party

Documents (authenticated)

  • GET /api/documents/list/:caseId — List documents
  • POST /api/documents/upload — Upload document
  • GET /api/documents/download/:id — Download document

Hearings (authenticated)

  • GET /api/hearings — Calendar view (Judge/Clerk/Admin)
  • GET /api/hearings/case/:caseId — Case hearings
  • POST /api/hearings — Create hearing
  • PUT /api/hearings/:id — Update hearing
  • DELETE /api/hearings/:id — Delete hearing

Notifications (authenticated)

  • GET /api/notifications — List notifications
  • PATCH /api/notifications/:id/read — Mark read
  • PATCH /api/notifications/read-all — Mark all read

Payments (authenticated)

  • GET /api/payments — List payments
  • POST /api/payments/create-intent — Create Stripe PaymentIntent
  • POST /api/payments/webhook — Stripe webhook

Users (authenticated)

  • GET /api/users — List users (Admin)
  • GET /api/users/me — Profile
  • PUT /api/users/me — Update profile
  • GET /api/users/:id — User detail (Admin)
  • PUT /api/users/:id — Admin update user

Docker Deployment

# Copy environment
cp docker/.env.example docker/.env
# Edit docker/.env

# Start services
cd docker
docker compose up -d

# Run migrations
docker compose exec api npx prisma db push
docker compose exec api npx prisma db seed

Tech Stack

  • Backend: Fastify, Prisma, Socket.io, Stripe, Zod
  • Frontend: Next.js 15, React 19, Tailwind CSS, Socket.io Client
  • Database: PostgreSQL
  • Desktop: Electron
  • Monorepo: Turborepo, pnpm workspaces

License

MIT