ai-agent/README.md

# Agent Desk Server

Customer-service API server built with Go, Gin, GORM, and `github.com/mlogclub/simple`.

The frontend is an independent sibling project, normally located at `../agent-desk-web`.

## Development

```bash
cp config/config.example.yaml config/config.yaml
go mod download
make dev
```

The API listens on `http://127.0.0.1:8083` by default. Health check:

```text
GET http://127.0.0.1:8083/api/health
```

Set `server.frontendUrl` and `server.cors.allowedOrigins` in `config/config.yaml` to the frontend origin. Local defaults use `http://127.0.0.1:3000`.

## Commands

```bash
make dev
make build
make test
make generator
make enums FRONTEND_DIR=../agent-desk-web
```

`make enums` writes the backend-owned shared enums into the frontend project.

## Docker

```bash
docker build --target app -t agent-desk-server .
docker run --rm -p 8083:8083 agent-desk-server
```

The Docker image contains only the API service. Deploy the frontend separately.