# State 010 Learning Guide

> For the complete documentation index, see [llms.txt](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/llms.txt).

## Position In Learning Graph

*   Previous state(s): [009-order-management-matcher](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-009-order-management-matcher.md)
*   Dotted-line parent(s): none
*   Next state(s): [011-tilt-kubernetes-dev-loop](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/docs/learning/state-011-tilt-kubernetes-dev-loop.md)

## Convergence Metadata

*   Convergence state: `no`
*   Convergence level: `none`
*   Lineage role: `canonical`
*   Nearest previous convergence: `none`
*   Nearest next convergence: `none`

## Rendered Code

*   Generated branch: [code/generated-state-010-kubernetes-runtime](https://github.com/finos/traderX/tree/code/generated-state-010-kubernetes-runtime)
*   Authoring branch (spec source): [main](https://github.com/finos/traderX/tree/main)

## Code Comparison With Previous State

*   Compare against `009-order-management-matcher`: [code/generated-state-009-order-management-matcher...code/generated-state-010-kubernetes-runtime](https://github.com/finos/traderX/compare/code%2Fgenerated-state-009-order-management-matcher...code%2Fgenerated-state-010-kubernetes-runtime)

## Plain-English Code Delta

*   **Added:** No new user-facing domain functionality.
*   **Changed:** Runtime substrate changes from Docker Compose to Kubernetes.
*   **Changed:** Browser/API entry remains single-origin (`http://localhost:8080`) through an NGINX edge proxy service.
*   **Removed:** No functional endpoints removed.
*   **Flow Impact:** F1 Place Trade: unchanged behavior; routed through Kubernetes edge proxy.
*   **Flow Impact:** F2 View Positions: unchanged behavior; data path unchanged.
*   **Flow Impact:** F3 Account/User lookups: unchanged behavior; cross-service validation unchanged.
*   **Flow Impact:** F4 Reference Data lookup: unchanged behavior; ticker validation unchanged.

## Run This State

```bash
./scripts/start-state-010-kubernetes-runtime-generated.sh
```

## Canonical Spec Links

*   State spec pack: [/specs/kubernetes-runtime](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime.md)
*   Architecture: [/specs/kubernetes-runtime/system/architecture](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/system/architecture.md)
*   Flows / topology: [/specs/kubernetes-runtime/system/runtime-topology](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/system/runtime-topology.md)
*   Research: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/research.md)
*   Data model: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/data-model.md)
*   Quickstart: [link](https://deploy-preview-472--lucky-concha-f3599f.netlify.app/specs/kubernetes-runtime/quickstart.md)