torus-api/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Commands

cargo build          # compile
cargo run            # run the server (reads .env automatically)
cargo test           # run all tests
cargo test <name>    # run a single test by name
cargo clippy         # lint
cargo fmt            # format

Architecture

Single-binary Actix Web API. Entry point is src/main.rs, which:

1. Loads .env via dotenvy at startup
2. Reads APP_ENV (development | production) and PORT from the environment
3. Binds to 127.0.0.1:<PORT> in development, example.com:<PORT> in production
4. Registers all routes on the HttpServer

Routes are registered as Actix handler functions decorated with #[get(...)] / #[post(...)] etc. and passed to App::new().service(...). As the API grows, handlers should be split into modules under src/ and re-exported for registration in main.

Environment

.env is read at runtime (not compile time). Required variables:

Variable	Values
APP_ENV	development or production
PORT	numeric port, e.g. 8000

Rules

1. Never run or offer to run the program