Files
smom-dbis-138/docs/04-configuration/FORGE_CANONICAL_REGISTRY.md
defiQUG 2b72242eb6
Some checks failed
CI/CD Pipeline / Solidity Contracts (push) Failing after 1m35s
CI/CD Pipeline / Security Scanning (push) Successful in 2m46s
CI/CD Pipeline / Lint and Format (push) Failing after 53s
CI/CD Pipeline / Terraform Validation (push) Failing after 31s
CI/CD Pipeline / Kubernetes Validation (push) Successful in 30s
Deploy ChainID 138 / Deploy ChainID 138 (push) Failing after 50s
HYBX OMNL TypeScript & anchor / token-aggregation build + reconcile artifact (push) Failing after 36s
Validation / validate-genesis (push) Successful in 32s
Validation / validate-terraform (push) Failing after 31s
Validation / validate-kubernetes (push) Failing after 14s
Validation / validate-smart-contracts (push) Failing after 16s
Validation / validate-security (push) Failing after 1m38s
Validation / validate-documentation (push) Failing after 26s
Verify Deployment / Verify Deployment (push) Failing after 1m0s
refactor(omnl-portal): retire Ali naming in docs and LXC sync path
Redirect legacy ALI_* docs to Zardasht canonical workflow, delegate sync-ali
to proxmox zardasht:banking-portal:sync, and align host config with
/srv/zardasht-portal deploy root.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-01 10:12:27 -07:00

67 lines
2.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Forge canonical registry — Gitea `d-bis`
Single source of truth for which repositories Zardasht and operators use. **Do not** treat GitHub mirrors or ad-hoc “banking portal” repos as canonical.
## Canonical repositories
| Repo | Gitea remote | Path on `dev-bis-zardasht` | Role |
|------|--------------|----------------------------|------|
| **`proxmox`** | `https://gitea.d-bis.org/d-bis/proxmox.git` | `/srv/projects/proxmox` | Operator / orchestration — manifests, LXC map, NPM, deploy orchestration |
| **`smom-dbis-138`** | `https://gitea.d-bis.org/d-bis/smom-dbis-138.git` | `~/smom-dbis-138` | **Banking app source of truth** — all OMNL portal code |
Optional: `proxmox` may vendor `smom-dbis-138` as a git submodule at `proxmox/smom-dbis-138`. Pick **one** primary workspace for app edits (`~/smom-dbis-138` recommended) and stay consistent.
## Branch policy
| Repo | Branch | Notes |
|------|--------|-------|
| `smom-dbis-138` | `main` | Production banking stack |
| `proxmox` | `master` | Operator scripts, LXC sync, infra docs |
## What lives where
### `smom-dbis-138` (banking app monorepo)
```
smom-dbis-138/
├── frontend-dapp/ # Vite SPA → :3002 (dev) / :3000 (LXC edge)
├── services/
│ ├── settlement-middleware/ # /settlement/* → :3011
│ ├── dbis-exchange/ # /exchange/* → :3012
│ └── token-aggregation/ # /api/v1/* → :3000
├── packages/
│ ├── integration-foundation/
│ └── settlement-core/
├── config/ # omnl-*.json, production configs
├── deploy/nginx/ # omnl-domains.conf (dev nginx)
└── scripts/deployment/
├── deploy-omnl-bank-production.sh
├── deploy-omnl-domains.sh
├── deploy-omnl-banking-portal-pct.sh
├── sync-ali-omnl-banking-portal-lxcs.sh # deprecated → proxmox zardasht:banking-portal:sync
└── start-omnl-banking-portal.sh
```
### `proxmox` (ops)
- LXC CTID map (58205828)
- NPMplus proxy hosts (9 public FQDNs → LAN)
- Cloudflare / DNS runbooks
- `pnpm zardasht:hospitallers:handoff`, `pnpm zardasht:banking-portal:sync`, `pnpm zardasht:dev-banking:tunnel`
## Public surface
Nine FQDNs (see `config/omnl-production-domains.v1.json`) — **one stack**, deployed to each banking LXC at `/srv/zardasht-portal` (legacy `/srv/ali-portal` symlink). No per-FQDN git repos.
## Credentials
- Gitea user: **`ali`** (legacy technical id; display name **Zardasht**)
- Env split:
- `proxmox/.env` — Proxmox, NPM, Cloudflare, Gitea tokens
- `smom-dbis-138/.env``PRIVATE_KEY`, `RPC_URL_138`, OMNL API keys
## Related docs
- [ZARDASHT_GITEA_TWO_REPO_WORKFLOW.md](./ZARDASHT_GITEA_TWO_REPO_WORKFLOW.md)
- Proxmox: `docs/04-configuration/ZARDASHT_REMOTE_OPERATOR_ONBOARDING.md`