acs/CLAUDE.md

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:

{ "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.