chore: bootstrap repo scaffolding (M0.1)

Bootstraps §1.2 scaffolding (README, CONTRIBUTING, CODEOWNERS, CHANGELOG, PR + issue templates, LICENSE, CI workflow, release workflow, commitlint, cliff, .editorconfig, .gitignore, .env.example) and ships a proprietary all-rights-reserved LICENSE naming both founders. Refs: M0.1
2026-05-18 19:15:38 +00:00
parent 02ea93944c
commit c6057bf23b
15 changed files with 629 additions and 1 deletions
@@ -1,3 +1,59 @@
 # seed-data

-Demo tenant fixtures per product.
+Demo tenant fixtures per product.
+
+> Part of the **Breakpilot Platform**. For the big picture see [`platform/docs`](https://gitea.meghsakha.com/platform/docs):
+> [Architecture](https://gitea.meghsakha.com/platform/docs/src/branch/main/PLATFORM_ARCHITECTURE.md) ·
+> [Infrastructure](https://gitea.meghsakha.com/platform/docs/src/branch/main/INFRASTRUCTURE.md) ·
+> [Product Integration Spec](https://gitea.meghsakha.com/platform/docs/src/branch/main/PRODUCT_INTEGRATION_SPEC.md) ·
+> [Implementation Plan](https://gitea.meghsakha.com/platform/docs/src/branch/main/IMPLEMENTATION_PLAN.md)
+
+## What this is
+
+Demo tenant fixtures per product. Scaffolded under milestone M13.1. See [`platform/docs`](https://gitea.meghsakha.com/platform/docs) for the full architecture context.
+
+**Plane:** Data
+**Owner:** @sharang
+**Status:** pre-alpha
+**Linked milestone:** [M13.1](https://gitea.meghsakha.com/platform/docs/src/branch/main/IMPLEMENTATION_PLAN.md)
+
+## Run locally
+
+```bash
+# prerequisites: see CONTRIBUTING.md for tooling once code lands
+make dev          # starts dependencies + this service on http://localhost:3000
+make test         # unit + integration
+make e2e          # only if this repo ships user-facing flows
+```
+
+Local secrets come from `.env.local` (gitignored). Template at `.env.example`.
+
+## Endpoints / surface
+
+{{For services: list the top-level routes or commands.
+For libraries: list the public API entry points.
+For IaC: list the make targets.}}
+
+## Deployment
+
+| Env   | URL                                  | How                                  |
+|---|---|---|
+| dev   | `http://localhost:3000`          | `make dev`                           |
+| stage | `https://seed-data.stage.yourplatform.com` | auto on merge to `main`         |
+| prod  | `https://seed-data.yourplatform.com`  | manual: tag `vX.Y.Z` + sign-off      |
+
+Rollback: `orca rollout undo seed-data --env={{env}}`.
+
+## Observability
+
+- Traces, logs, metrics: [SigNoz](https://signoz.meghsakha.com) — service name `seed-data`
+- Audit events: Tenant Registry `/audit` (Retraced-shape schema)
+- On-call: `oncall@yourplatform.com` · runbook at `platform/docs/runbooks/seed-data.md`
+
+## Contributing
+
+See [`CONTRIBUTING.md`](./CONTRIBUTING.md). TL;DR: branch from main, open a PR, 1 review + green CI, squash-merge.
+
+## License
+
+Proprietary — all rights reserved. Copyright (c) 2026 Sharang Parnerkar and Benjamin Boenisch. See [`LICENSE`](./LICENSE).