Harden deployment env flows and surface external blockers
This commit is contained in:
35
docs/03-deployment/EXTERNAL_DEPENDENCY_BLOCKERS.md
Normal file
35
docs/03-deployment/EXTERNAL_DEPENDENCY_BLOCKERS.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# External Dependency Blockers
|
||||
|
||||
**Purpose:** Canonical list of delivery items that cannot be resolved by repo-only changes and must be satisfied by external implementation, deployment, or infrastructure provisioning.
|
||||
|
||||
## Current blockers
|
||||
|
||||
| Blocker ID | External dependency | Pass condition | Repo-side signal |
|
||||
|---|---|---|---|
|
||||
| `EXT-DBIS-CORE` | `dbis_core` deployment | `DBIS_CORE_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-CC-PAYMENT-ADAPTERS` | `cc-payment-adapters` implementation and hosting | `CC_PAYMENT_ADAPTERS_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-CC-AUDIT-LEDGER` | `cc-audit-ledger` implementation and hosting | `CC_AUDIT_LEDGER_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-CC-SHARED-EVENTS` | `cc-shared-events` implementation and hosting | `CC_SHARED_EVENTS_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-CC-SHARED-SCHEMAS` | `cc-shared-schemas` implementation and hosting | `CC_SHARED_SCHEMAS_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-FIN-GATEWAY` | FIN / Alliance Access gateway | `FIN_GATEWAY_URL` or `ALLIANCE_ACCESS_URL` is set and reachable | `scripts/verify/check-external-dependencies.sh` |
|
||||
| `EXT-CHAIN138-CI-RPC` | Chain 138 node reachable from CI runners | `CHAIN138_CI_RPC_URL` or `RPC_URL_138_PUBLIC` returns a block number | `scripts/verify/check-external-dependencies.sh` |
|
||||
|
||||
## How to check
|
||||
|
||||
Strict mode:
|
||||
|
||||
```bash
|
||||
bash scripts/verify/check-external-dependencies.sh
|
||||
```
|
||||
|
||||
Advisory mode:
|
||||
|
||||
```bash
|
||||
bash scripts/verify/check-external-dependencies.sh --advisory
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- These blockers are expected to remain unresolved until external systems are deployed or pointed at live instances.
|
||||
- Repo-side readiness scripts now surface these blockers explicitly instead of failing with generic env or connectivity errors.
|
||||
- `dbis_core` source exists in this workspace, but that does not satisfy `EXT-DBIS-CORE`; the blocker closes only when a live reachable instance exists.
|
||||
Reference in New Issue
Block a user