ChronoCCG/chrono.tasks/Docker.md

Chrono CCG - Project Guide

This project is a hosted Blazor WebAssembly application with a PostgreSQL database for persisting agent notes.

Prerequisites

• Docker Desktop: Required for the recommended containerized setup.
• .NET 10 SDK: Required if you want to build or run the project locally without Docker.

1. Running with Docker (Recommended)

The easiest way to get everything running (App + PostgreSQL) is using Docker Compose.

1. Open a terminal in the project root (Chrono/).
2. Run the following command:

   docker-compose up --build
   

3. Access the Application:
   • Web Interface: http://localhost:8080
   • API Endpoint: http://localhost:8080/api/notes

The database will be automatically initialized and migrations will be applied on startup.

2. Running Locally (Development)

If you need to run the app directly (e.g., for faster debugging):

1. Start a PostgreSQL database. You can use the one from docker-compose if you want:

   docker-compose up db
   

2. Verify Connection String: Server/appsettings.Development.json is pre-configured to point to localhost.
3. Run the Server project:

   cd Server
   dotnet run --launch-profile https
   

4. The app will be served at the URL shown in the terminal (e.g., https://localhost:7266).

3. Running Tests

To verify the core domain logic:

dotnet test

4. Key Features

• Agent Notes: In the "Cards" gallery, select an Agent to see the "Personal Note" field. Changes are auto-saved to the PostgreSQL database when you click away from the text area.
• Auto-Migrations: The Server project automatically handles database schema updates on startup.
• Dockerized Architecture: Complete orchestration of the web server and database.