# ACS Project Rules

## Deployment Target

ACS must follow the AI DEV deployment guide in `docs/AIdev.md`.

- Deploy as a Node.js application.
- Use port `3000`.
- Use the `DATABASE_URL` supplied by `.project-env` / AI DEV.
- Do not depend on a self-managed PostgreSQL container for AI DEV deployment.
- Keep `.project-env` and `.env` out of git.
- Build and deploy through the root `Dockerfile`.

## Current Migration Direction

- The legacy Spring Boot backend remains only as a behavior reference until Node parity is complete.
- The React frontend should be preserved where possible.
- Keep the existing `/api` contract and response envelope stable:

```json
{ "code": 200, "message": "OK", "data": {} }
```

## Required Checks

- `npm run typecheck`
- `npm run build`
- `npm run db:check` in the AI DEV project folder where `.project-env` is loaded
- `curl 127.0.0.1:3000/healthz`
- `curl 127.0.0.1:3000/db`

`npm run minio:check` and `/s3` intentionally report skipped because ACS currently does not use S3/MinIO storage.