JAG Probate

This repository contains the code for the Probate Management System for BC Gov

Project Structure

jag-probate/
├── api/                   # .NET 10 Web API
│   ├── Controllers/       # API Controllers
│   ├── Services/          # Business logic services
│   ├── Program.cs         # Application entry point
│   └── Startup.cs         # Service configuration
├── db/                    # .NET 10 Class Library - Data Layer
│   ├── Models/            # Entity models
│   └── Migrations/        # EF Core migrations
├── web/                   # Vue 3 Frontend
│   ├── src/               # Vue source code
│   ├── public/            # Static assets
│   └── vite.config.js     # Vite configuration
└── docker/                # Docker configuration
    ├── api/               # API Dockerfile
    ├── web/               # Web Dockerfile
    ├── docker-compose.yaml
    └── manage             # Build and run script

Prerequisites

• .NET 10 SDK
• Docker Desktop
• s2i (Source-to-Image) tool

Getting Started with Docker

1. Clone the repository

git clone <repository-url>
cd jag-probate

2. Build Docker images

cd docker
./manage build

3. Start the application

./manage start

Or for development with hot reload:

./manage debug

Refer to Running Application on Docker for more commands.

4. Access the application

• Web UI: http://localhost:8080
• API: http://localhost:5000
• Swagger UI: http://localhost:5000/swagger
• Health Check: http://localhost:5000/api/health

Database

The project uses PostgreSQL as the database. Entity Framework Core handles migrations automatically on startup.

API

Health Check

• GET /api/health - Check API health status

CHEFS (Common Hosted Form Service)

See docs/chefs.md for integration details, endpoint usage, and configuration.

Environment Variables

Copy docker/.env.template to docker/.env and customize as needed.

Troubleshooting

Port already in use

If port 5000 or 5432 is already in use:

./manage stop
docker ps -a  # Check for running containers

Database connection issues

Ensure PostgreSQL container is running:

docker ps
docker logs jag-probate-db-1

Build issues

Clean and rebuild:

./manage down
./manage build
./manage start

How to Contribute

If you would like to contribute, please see our CONTRIBUTING guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.