Skip to main content

Baseline Fidelity Profile

This profile captures the technical implementation shape that generation should preserve for baseline parity.

Component Stack Profile​

ComponentLanguageFrameworkBuild ToolDefault PortContract
databaseJavaH2 server + scriptsGradle18082none
reference-dataTypeScriptNestJSnpm18085contracts/reference-data/openapi.yaml
trade-feedJavaScriptNode + Socket.IOnpm18086none
people-serviceC#ASP.NET Coredotnet18089contracts/people-service/openapi.yaml
account-serviceJavaSpring BootGradle18088contracts/account-service/openapi.yaml
position-serviceJavaSpring BootGradle18090contracts/position-service/openapi.yaml
trade-processorJavaSpring BootGradle18091contracts/trade-processor/openapi.yaml
trade-serviceJavaSpring BootGradle18092contracts/trade-service/openapi.yaml
web-front-end-angularTypeScriptAngularnpm18093none

Runtime Dependency and Env Fidelity​

Generation must preserve:

  • startup order: database -> reference-data -> trade-feed -> people-service -> account-service -> position-service -> trade-processor -> trade-service -> web-front-end-angular
  • required env wiring from component manifests (ports, service hosts/urls, database credentials, feed endpoints)
  • CORS allowlist behavior for pre-ingress browser calls

Closeness Validation Policy​

Use semantic compare harness:

bash pipeline/speckit/compare-all-component-generation.sh HEAD --allow-differences

Expected result policy:

  • blocked categories: source-code, runtime-config, api-contract
  • conditional categories: build-tooling, deployment-runtime, seed-data, branding-assets
  • allowed categories by default: docs-spec only

Any blocked-category difference requires either:

  1. spec + plan + tasks updates that justify the change, and
  2. updated acceptance evidence proving compatibility intent.