Files
TSYSDevStack-SupportStack-L…/README.md
reachableceo 25f7a6cd75 feat(demo): migrate 5 SelfStack services to demo stack (16→24 services)
Add Reactive Resume, Metrics, Kiwix, Resume Matcher, and Apple Health
from the earlier SelfStack project. Rewrite Apple Health collector to
use InfluxDB v2 with proper error handling. Update all tests, scripts,
Homepage config, env template, and documentation for the expanded stack.

New services:
- Reactive Resume (4016) + Postgres/Minio/Chrome companions
- Metrics (4021) - GitHub metrics visualization
- Kiwix (4022) - offline wiki reader
- Resume Matcher (4023) - AI resume screening
- Apple Health (4024) - health data collector → InfluxDB v2

Also adds git policy to AGENTS.md: always commit and push automatically.

💘 Generated with Crush

Assisted-by: GLM-5.1 via Crush <crush@charm.land>
2026-05-08 12:28:56 -05:00

58 lines
1.7 KiB
Markdown

# 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 24 services across 6 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), Metrics (GitHub metrics), Apple Health (health data) |
| **Documentation** | Draw.io (diagramming), Kroki (diagrams as code), Kiwix (offline wiki) |
| **Developer Tools** | Atomic Tracker, ArchiveBox, Tube Archivist, Wakapi, MailHog, Atuin |
| **Productivity** | Reactive Resume (resume builder), Resume Matcher (AI resume screening) |
## 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).