bloody murder.... ship or bust here we go...

This commit is contained in:
2025-11-05 15:53:19 -06:00
parent d27cf46606
commit 35b96b0e90
1810 changed files with 39 additions and 213819 deletions

View File

@@ -1,55 +0,0 @@
# 🛟 SupportStack
The SupportStack delivers a curated demo environment for customer support tooling. It bundles Dockerized services, environment settings, automation scripts, and a growing library of collaboration notes.
---
## Stack Snapshot
| Component | Purpose | Path |
|-----------|---------|------|
| Control Script | Orchestrates start/stop/update/test flows for the demo stack. | [`output/code/TSYSDevStack-SupportStack-Demo-Control.sh`](output/code/TSYSDevStack-SupportStack-Demo-Control.sh) |
| Environment Settings | Centralized `.env` style configuration consumed by scripts and compose files. | [`output/TSYSDevStack-SupportStack-Demo-Settings`](output/TSYSDevStack-SupportStack-Demo-Settings) |
| Docker Compose Bundles | Service definitions for docker-socket-proxy, homepage, WakaAPI, and MailHog. | [`output/docker-compose/`](output/docker-compose) |
| Service Config | Homepage/WakaAPI configuration mounted into containers. | [`output/config/`](output/config) |
| Tests | Shell-based smoke, unit, and discovery tests for stack services. | [`output/tests/`](output/tests) |
| Docs & Vendor Research | Reference material and curated vendor lists. | [`output/docs/`](output/docs) |
| Collaboration Notes | Product direction, prompts, and status updates. | [`collab/`](collab) |
---
## 🚀 Quick Start
1. Export or edit variables in `output/TSYSDevStack-SupportStack-Demo-Settings`.
2. Use the control script to manage the stack:
```bash
./output/code/TSYSDevStack-SupportStack-Demo-Control.sh start
./output/code/TSYSDevStack-SupportStack-Demo-Control.sh test
./output/code/TSYSDevStack-SupportStack-Demo-Control.sh stop
```
3. Review `output/tests/` for additional validation scripts.
> The stack expects Docker access and creates the shared network `tsysdevstack-supportstack-demo-network` if it does not exist.
---
## 🧭 Working Agreement
- **Stacks stay in sync.** When you add or modify automation, update both the relevant stack README and any linked prompts/docs.
- **Collab vs Output.** Use `collab/` for planning and prompts, keep runnable artifacts under `output/`.
- **Document forward.** New workflows should land alongside tests and a short entry in the appropriate README table.
- **AI Agent Coordination.** Use Qwen agents for documentation updates, code changes, and maintaining consistency across stacks.
---
## 🤖 AI Agent
This stack is maintained by **SupportBot**, an AI agent focused on SupportStack operations.
---
## Collaboration Notes
- Keep demo automation in `output/` and exploratory material in `collab/`.
- When adding a new service, update both the compose files and the test suite to maintain coverage.
- Synchronize documentation changes with any updates to automation or configuration—future contributors rely on the README table as the source of truth.
---
## 📄 License
See [LICENSE](../LICENSE) for full terms. Contributions are welcome—open a discussion in the relevant stack's `collab/` area to kick things off.