# bgaldino/rlm-base-dev architecture

> Architecture diagram of the GitHub repository bgaldino/rlm-base-dev, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bgaldino/rlm-base-dev
- Repository: https://github.com/bgaldino/rlm-base-dev

## Overview

Revenue Cloud Skills Library combines agent-oriented implementation knowledge with tools for configuring and maintaining Salesforce Revenue Cloud orgs. The principal workflow is to select a capability, follow its guidance, then run tools against an authenticated org to deploy, load data, configure features, activate them, and verify the result. The map highlights the build manager, transaction-data harness, Context Service tooling, pricing-rule tools, and selected product capabilities documented in the README. Edges are limited to README statements and relationships shown in the supplied source index or excerpts; unsampled feature implementations are represented without speculative call chains.

Main entry points: [`scripts/build_harness/tui/runner.py`](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/runner.py) (Build runner), [`scripts/context_service/_apply.py`](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_apply.py) (Context plan application), [`scripts/build_harness/tui/app.py`](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/app.py) (Build manager UI), [`scripts/context_service/instance/query_context_instance.py`](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/instance/query_context_instance.py) (Context instance query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Knowledge and guidance"]
  node_skills["Capability guidance"]
end

subgraph group_build["Org build workflow"]
  node_build_harness_ui["Build manager UI<br/>[app.py]"]
  node_build_runner["Build runner<br/>[runner.py]"]
  node_build_config["Build configuration<br/>[config.py]"]
  node_build_io["Run files and serialization<br/>[io.py]"]
end

subgraph group_domain["Domain configuration tools"]
  node_context_task["Context Service task"]
  node_context_apply["Context plan application<br/>[_apply.py]"]
  node_context_payload["Context payload logic<br/>[_payload.py]"]
  node_context_client["Context API client<br/>[_client.py]"]
  node_context_query["Context instance query"]
  node_context_runtime["Context runtime<br/>[_runtime.py]"]
  node_decision_tools["Decision table tools"]
  node_expression_tools["Expression set tools"]
end

subgraph group_data["Data and integration"]
  node_txn_runner["Transaction data harness<br/>[runner.py]"]
  node_txn_handler["Invoice ingestion handler"]
end

subgraph group_product["Product capabilities"]
  node_docgen["Document generation tools"]
  node_ux_tools["UX assembly tools<br/>[ux_tool.py]"]
  node_billing_ui["Billing user interface<br/>[rlmBsgOverview.js]"]
  node_collections_ui["Collections interface"]
end

node_engineer(("Engineer or agent"))
node_salesforce[("Salesforce org")]

node_engineer -->|"selects guidance"| node_skills
node_skills -->|"guides tasks"| node_engineer
node_engineer -->|"starts build"| node_build_harness_ui
node_build_harness_ui -->|"starts runner"| node_build_runner
node_build_runner -->|"loads configuration"| node_build_config
node_build_harness_ui -->|"writes run output"| node_build_io
node_build_runner -->|"prepares org"| node_salesforce
node_build_runner -->|"deploys and configures"| node_salesforce
node_context_task -->|"applies plans"| node_context_apply
node_context_apply -->|"resolves payloads"| node_context_payload
node_context_apply -->|"sends API requests"| node_context_client
node_context_apply -->|"mutates definitions"| node_salesforce
node_context_query -->|"queries instances"| node_context_client
node_context_query -->|"uses runtime"| node_context_runtime
node_decision_tools -->|"manages tables"| node_salesforce
node_expression_tools -->|"manages expressions"| node_salesforce
node_txn_runner -.->|"dispatches scenarios"| node_txn_handler
node_txn_handler -->|"ingests invoices"| node_salesforce
node_docgen -->|"generates documents"| node_salesforce
node_ux_tools -->|"assembles UX"| node_salesforce
node_billing_ui -.->|"presents billing data"| node_salesforce
node_collections_ui -.->|"supports collections"| node_salesforce

click node_build_harness_ui "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/app.py"
click node_build_runner "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/runner.py"
click node_build_config "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/harness/config.py"
click node_build_io "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/harness/io.py"
click node_context_task "https://github.com/bgaldino/rlm-base-dev/blob/main/tasks/rlm_context_service.py"
click node_context_apply "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_apply.py"
click node_context_payload "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_payload.py"
click node_context_client "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_client.py"
click node_context_query "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/instance/query_context_instance.py"
click node_context_runtime "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_runtime.py"
click node_decision_tools "https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/decision_tables"
click node_expression_tools "https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/expression_sets"
click node_txn_runner "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/txn_data_harness/runner.py"
click node_txn_handler "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/txn_data_harness/handlers/invoice_ingestion.py"
click node_docgen "https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/docgen"
click node_ux_tools "https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/ux/ux_tool.py"
click node_billing_ui "https://github.com/bgaldino/rlm-base-dev/blob/main/unpackaged/post_billing_ui/lwc/rlmBsgOverview/rlmBsgOverview.js"
click node_collections_ui "https://github.com/bgaldino/rlm-base-dev/blob/main/unpackaged/post_billing_ui/lwc/rlmCollectionsConsole/rlmCollectionsConsole.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skills toneBlue
class node_build_harness_ui,node_build_runner,node_build_config,node_build_io,node_salesforce toneAmber
class node_context_task,node_context_apply,node_context_payload,node_context_client,node_context_query,node_context_runtime,node_decision_tools,node_expression_tools toneMint
class node_txn_runner,node_txn_handler toneRose
class node_docgen,node_ux_tools,node_billing_ui,node_collections_ui,node_engineer toneIndigo
```

## Components

### Knowledge and guidance

- **Capability guidance**

### Org build workflow

- [Build manager UI](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/app.py): `scripts/build_harness/tui/app.py`
- [Build runner](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/tui/runner.py): `scripts/build_harness/tui/runner.py`
- [Build configuration](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/harness/config.py): `scripts/build_harness/harness/config.py`
- [Run files and serialization](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/build_harness/harness/io.py): `scripts/build_harness/harness/io.py`

### Domain configuration tools

- [Context Service task](https://github.com/bgaldino/rlm-base-dev/blob/main/tasks/rlm_context_service.py): `tasks/rlm_context_service.py`
- [Context plan application](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_apply.py): `scripts/context_service/_apply.py`
- [Context payload logic](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_payload.py): `scripts/context_service/_payload.py`
- [Context API client](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_client.py): `scripts/context_service/_client.py`
- [Context instance query](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/instance/query_context_instance.py): `scripts/context_service/instance/query_context_instance.py`
- [Context runtime](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/context_service/_runtime.py): `scripts/context_service/_runtime.py`
- [Decision table tools](https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/decision_tables): `scripts/decision_tables`
- [Expression set tools](https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/expression_sets): `scripts/expression_sets`

### Data and integration

- [Transaction data harness](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/txn_data_harness/runner.py): `scripts/txn_data_harness/runner.py`
- [Invoice ingestion handler](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/txn_data_harness/handlers/invoice_ingestion.py): `scripts/txn_data_harness/handlers/invoice_ingestion.py`

### Product capabilities

- [Document generation tools](https://github.com/bgaldino/rlm-base-dev/tree/main/scripts/docgen): `scripts/docgen`
- [UX assembly tools](https://github.com/bgaldino/rlm-base-dev/blob/main/scripts/ux/ux_tool.py): `scripts/ux/ux_tool.py`
- [Billing user interface](https://github.com/bgaldino/rlm-base-dev/blob/main/unpackaged/post_billing_ui/lwc/rlmBsgOverview/rlmBsgOverview.js): `unpackaged/post_billing_ui/lwc/rlmBsgOverview/rlmBsgOverview.js`
- [Collections interface](https://github.com/bgaldino/rlm-base-dev/blob/main/unpackaged/post_billing_ui/lwc/rlmCollectionsConsole/rlmCollectionsConsole.js): `unpackaged/post_billing_ui/lwc/rlmCollectionsConsole/rlmCollectionsConsole.js`

### Other components

- **Engineer or agent**
- **Salesforce org**

## Connections

- Engineer or agent → Capability guidance: selects guidance
- Capability guidance → Engineer or agent: guides tasks
- Engineer or agent → Build manager UI: starts build
- Build manager UI → Build runner: starts runner (evidence: `scripts/build_harness/tui/app.py`)
- Build runner → Build configuration: loads configuration (evidence: `scripts/build_harness/tui/runner.py`)
- Build manager UI → Run files and serialization: writes run output (evidence: `scripts/build_harness/tui/app.py`)
- Build runner → Salesforce org: prepares org
- Build runner → Salesforce org: deploys and configures
- Context Service task → Context plan application: applies plans (evidence: `tasks/rlm_context_service.py`)
- Context plan application → Context payload logic: resolves payloads (evidence: `scripts/context_service/_apply.py`)
- Context plan application → Context API client: sends API requests (evidence: `scripts/context_service/_apply.py`)
- Context plan application → Salesforce org: mutates definitions (evidence: `scripts/context_service/_apply.py`)
- Context instance query → Context API client: queries instances (evidence: `scripts/context_service/instance/query_context_instance.py`)
- Context instance query → Context runtime: uses runtime (evidence: `scripts/context_service/instance/query_context_instance.py`)
- Decision table tools → Salesforce org: manages tables
- Expression set tools → Salesforce org: manages expressions
- Transaction data harness → Invoice ingestion handler: dispatches scenarios (evidence: `scripts/txn_data_harness/handlers/invoice_ingestion.py`)
- Invoice ingestion handler → Salesforce org: ingests invoices (evidence: `scripts/txn_data_harness/handlers/invoice_ingestion.py`)
- Document generation tools → Salesforce org: generates documents
- UX assembly tools → Salesforce org: assembles UX
- Billing user interface → Salesforce org: presents billing data
- Collections interface → Salesforce org: supports collections
