diff --git a/COVER_SHEET.md b/COVER_SHEET.md new file mode 100644 index 0000000..26dbbd6 --- /dev/null +++ b/COVER_SHEET.md @@ -0,0 +1,95 @@ +# CBSGroup cover sheet + +CBSGroup presentation banner + +Prepared for the CBSGroup tenant workspace. + +## Executive summary + +CBSGroup is the tenant-facing payment surface for NovaBank, with CBS Group acting as the API receiver and middleware layer that connects the tenant entry points to Tingg. + +## Status chips + +| Chip | Meaning | +|---|---| +| `TENANT: CBSGroup` | Workspace identity | +| `TENANT ID: cbsgroup` | Canonical tenant slug | +| `PUBLIC HOST: cbsgroup.sankofa.nexus` | Public tenant hostname | +| `PAYMENT PATH: /tingg` | Subscription entry point | +| `MIDDLEWARE: /home/intlc/projects/tingg` | Shared Tingg integration repo | +| `EDGE: 76.53.10.43` | Dedicated public edge IP | + +## Badge row + +| Brand | Operations | Validation | Visuals | +|---|---|---|---| +| CBSGroup visual system | Tenant edge and deployment notes | Tingg smoke and validation wrapper | SVG sources, preview sheet, and presentation banner | + +## Operating model + +```mermaid +flowchart LR + NB["NovaBank"] + CBS["CBS Group
API receiver / middleware"] + TG["Tingg"] + ST["Settlement / treasury lane"] + + NB -->|payment intent| CBS + CBS -->|API request| TG + TG -. webhook callback .-> CBS + CBS -->|status propagation| NB + CBS -->|reconciliation| ST +``` + +### Roles + +- `NovaBank` initiates payment intent. +- `CBS Group` receives and brokers the payment API. +- `Tingg` processes the payment and returns webhook callbacks. +- Settlement and treasury remain outside the synchronous checkout path. + +## Workspace portfolio + +| Repository | Responsibility | Reading priority | +|---|---|---| +| `cbsgroup-brand-assets` | Brand system, SVG sources, and rendered exports | First for identity and presentation | +| `cbsgroup-e2e` | Tingg smoke, build, lint, and troubleshooting | First for proof and validation | +| `cbsgroup-ops` | Architecture, routing, deployment, incidents | First for operational control | + +## Visual board + +CBSGroup preview sheet + +CBSGroup mark + +## Canonical paths + +- Workspace root: `/home/intlc/projects/CBSGroup` +- Shared middleware: `/home/intlc/projects/tingg` +- Brand docs hub: `cbsgroup-brand-assets/docs/index.md` +- E2E docs hub: `cbsgroup-e2e/docs/index.md` +- Ops docs hub: `cbsgroup-ops/docs/index.md` + +## Validation posture + +- Live subscription surface: `https://cbsgroup.sankofa.nexus/tingg` +- Tingg test suite: required +- Tingg build: required +- Tingg lint: required +- Optional Prisma workflow: available for local setup + +## Recommended order + +1. Read this cover sheet. +2. Open the brand docs and preview sheet. +3. Review the ops architecture and edge routing. +4. Run the Tingg e2e smoke path. +5. Open the workspace instruction set for the detailed operating model. + +## Related hubs + +- [CBSGroup workspace README](README.md) +- [CBSGroup workspace docs index](../docs/index.md) +- [Brand docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-brand-assets/src/branch/main/docs/index.md) +- [E2E docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-e2e/src/branch/main/docs/index.md) +- [Ops docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-ops/src/branch/main/docs/index.md) diff --git a/README.md b/README.md index bce7663..58dec0e 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,22 @@ CBSGroup lockup -CBSGroup builds and operates payment-facing tenant surfaces and the middleware that connects them to Tingg. +CBSGroup is the tenant-facing payment surface for NovaBank, with CBS Group as the API receiver and middleware layer that connects the tenant entry points to Tingg. + +## Status chips + +| Chip | Meaning | +|---|---| +| `TENANT: CBSGroup` | Workspace identity | +| `HOST: cbsgroup.sankofa.nexus` | Public tenant hostname | +| `ENTRY: /tingg` | Subscription path | +| `MIDDLEWARE: Tingg` | Shared payment integration | +| `DOCS: ready` | Brand, ops, and e2e hubs linked | +| `VISUALS: expanded` | Banner, preview sheet, and repo visuals | ## What to read first +- [CBSGroup cover sheet](COVER_SHEET.md) - [Brand docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-brand-assets/src/branch/main/docs/index.md) - [Tingg e2e docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-e2e/src/branch/main/docs/index.md) - [Ops docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-ops/src/branch/main/docs/index.md) @@ -19,6 +31,15 @@ CBSGroup builds and operates payment-facing tenant surfaces and the middleware t | E2E | Tingg smoke, build, and validation wrapper | `cbsgroup-e2e` | | Ops | Edge, deployment, incident, and integration notes | `cbsgroup-ops` | +## Presentation board + +| Card | Content | +|---|---| +| Cover sheet | Formal executive summary and status chips | +| Visual system | Lockup, mark, banner, and preview sheet | +| Operating model | NovaBank -> CBS Group -> Tingg -> treasury | +| Proof path | Tingg e2e smoke and validation docs | + ## Visual front door CBSGroup presentation banner @@ -57,6 +78,8 @@ flowchart LR | Section | Purpose | |---|---| | Hero | Show the lockup and establish the tenant identity | +| Status chips | Surface the canonical tenant and workspace facts | +| Cover sheet | Present a formal executive summary | | Visual gallery | Show the preview sheet and asset family | | Repo map | Point directly to brand, e2e, and ops | | Flow model | Explain NovaBank -> CBS Group -> Tingg -> treasury | @@ -75,6 +98,7 @@ flowchart LR ## Navigation +- [CBSGroup cover sheet](COVER_SHEET.md) - [CBSGroup brand docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-brand-assets/src/branch/main/docs/index.md) - [CBSGroup e2e docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-e2e/src/branch/main/docs/index.md) - [CBSGroup ops docs hub](https://gitea.d-bis.org/CBSGroup/cbsgroup-ops/src/branch/main/docs/index.md)