# Car Service Database

PostgreSQL database and web dashboard for a car service workshop, managed with Docker Compose.

## Start

```powershell
docker compose up -d
```

Open the web dashboard at [http://localhost:3000](http://localhost:3000).

The dashboard's **Service records** view supports adding, listing, and editing service records with service date, VIN, license plate number, car mileage, customer, technician, complaint, and status. Adding a record creates the linked customer, vehicle, technician, and service order in one transaction.

The **Accounts** view supports reading, adding, editing, and deleting users with `read`, `add`, and `delete` rights. A default `admin` account is created automatically, and the last administrator cannot be deleted. These permissions are currently stored as staff access profiles; login/session enforcement can be added when authentication is required.

Check that the database is ready:

```powershell
docker compose ps
docker compose exec car-service-db pg_isready -U car_service_app -d car_service
```

Connect with `psql` inside the container:

```powershell
docker compose exec car-service-db psql -U car_service_app -d car_service
```

The default connection values are:

- Host: `localhost`
- Port: `5432`
- Database: `car_service`
- User: `car_service_app`
- Password: `change-me-in-production`

To use different values, create a `.env` file next to `docker-compose.yml`:

```dotenv
POSTGRES_DB=car_service
POSTGRES_USER=car_service_app
POSTGRES_PASSWORD=use-a-strong-password
POSTGRES_PORT=5432
```

The schema is loaded from `init.sql` the first time the named volume is created. To recreate the database from scratch, including all data:

```powershell
docker compose down -v
docker compose up -d
```

Do not use the default password in production. Restrict the published port or place the database on a private Docker network when an application is added.