# SentryAgent.ai AgentIdP — DevOps Documentation

Operational reference for engineers who deploy, configure, and maintain the AgentIdP infrastructure.

## System Overview

SentryAgent.ai AgentIdP is a Node.js REST API backed by PostgreSQL and Redis. It runs as a single stateless application process. All state lives in PostgreSQL (durable) and Redis (ephemeral cache and rate limiting).

**Stack:**
- **Runtime**: Node.js 18+ (TypeScript, compiled to JS)
- **Application**: Express 4.18 on port 3000
- **Database**: PostgreSQL 14+ (primary data store)
- **Cache**: Redis 7+ (token revocation, rate limiting, monthly token counters)

## Documentation

| Document | What it covers |
|----------|----------------|
| [Architecture](architecture.md) | Components, ports, data flow, Redis key patterns |
| [Environment Variables](environment-variables.md) | Every env var — required, optional, format, examples |
| [Database](database.md) | Schema (4 tables), migrations, how to apply and verify |
| [Local Development](local-development.md) | docker-compose setup, startup, health checks |
| [Security](security.md) | JWT key generation and rotation, CORS, secret storage |
| [Operations](operations.md) | Startup order, graceful shutdown, log interpretation, troubleshooting |

## Quick Reference — Ports

| Service | Port |
|---------|------|
| AgentIdP app | 3000 |
| PostgreSQL | 5432 |
| Redis | 6379 |

## Quick Reference — npm Scripts

| Script | Purpose |
|--------|---------|
| `npm run dev` | Run from TypeScript source (development) |
| `npm run build` | Compile TypeScript to `dist/` |
| `npm start` | Run compiled output from `dist/` (production) |
| `npm run db:migrate` | Apply pending database migrations |
| `npm test` | Run all tests |
| `npm run test:unit` | Unit tests only |

## Developer Documentation

For API usage (registering agents, getting tokens, calling endpoints) — see [`docs/developers/`](../developers/README.md).