Monorepo consolidation: workspace, shared types, transport plans, docker/swam assets

README.md

@@ -0,0 +1,38 @@
+# cloudlysis (monorepo)
+
+## Layout
+- Rust services (Cargo workspace): `aggregate/`, `gateway/`, `projection/`, `runner/`, `control/api/`, `shared/`
+- Control UI: `control/ui/`
+- Docker + Swarm + Compose: `docker/`, `docker-compose.yml`, `swarm/`, `observability/`
+- Transport plans:
+  - `TRANSPORT_DEVELOPMENT_PLAN.md`
+  - `GATEWAY_TRANSPORT_PLAN.md`
+  - `NATS_TRANSPORT_PLAN.md`
+
+## Quick Start (Docker Compose)
+
+```bash
+docker compose up -d --build
+```
+
+Full local stack with observability:
+
+```bash
+docker compose -f docker-compose.yml -f observability/docker-compose.yml up -d --build
+```
+
+## Commands
+- `make compose-up`, `make compose-down`
+- `make compose-up-observability`, `make compose-down-observability`
+- `make docker-build-all`
+- `make swarm-deploy-all`, `make swarm-rm-all`
+
+More details: `DOCKER.md`
+
+## Workspace Verification
+
+```bash
+cargo fmt --check
+cargo clippy --workspace --all-targets -- -D warnings
+cargo test --workspace
+```