# TSYS Developer Support Stack

A Docker Compose-based multi-service stack of FOSS applications that run locally on developer workstations to enhance productivity and quality of life.

## What It Does

Deploys 16 services across 4 categories via a single command:

| Category | Services |
|----------|----------|
| **Infrastructure** | Homepage (dashboard), Pi-hole (DNS), Dockhand (Docker management), Docker Socket Proxy |
| **Monitoring** | InfluxDB (time series), Grafana (visualization) |
| **Documentation** | Draw.io (diagramming), Kroki (diagrams as code) |
| **Developer Tools** | Atomic Tracker, ArchiveBox, Tube Archivist, Wakapi, MailHog, Atuin |

## Quick Start

```bash
cd demo
cp demo.env.template demo.env
./scripts/demo-stack.sh deploy
```

Access the dashboard at **http://localhost:4000**

Credentials: `admin` / `demo_password` (demo only)

## Requirements

- Docker Engine + Docker Compose
- 8GB RAM minimum
- 10GB disk space
- Linux (tested on Ubuntu)

## Documentation

| Document | Purpose |
|----------|---------|
| [demo/PRD.md](demo/PRD.md) | Product requirements (the source of truth) |
| [demo/README.md](demo/README.md) | Full deployment and service documentation |
| [demo/AGENTS.md](demo/AGENTS.md) | Development guidelines |
| [AGENTS.md](AGENTS.md) | Quick reference for contributors |

## Testing

```bash
# Unit tests (no Docker required)
bash demo/tests/unit/test_env_validation.sh

# Full test suite (requires running stack)
./demo/scripts/demo-test.sh full
```

## License

See [LICENSE](LICENSE).