Configuration, graph and documentation

Every service carries enough generated metadata to connect runtime behavior back to the architecture.

When to use

Use this reference when generating, reviewing or operating a Service Architect project.

Behavior

config/config.yaml contains the generated runtime configuration shape and defaults.
config/overrides.yaml is the preserved environment/project override layer.
graph/<service>.generated.yaml is the service-level topology snapshot.
graph/<project>.generated.yaml is the complete project topology snapshot.
docs contains generated domain and endpoint documentation derived from graph types and descriptions.
Runtime status endpoints use the same graph identity for topology visualization.

Configuration and documentation files

Generated and preserved metadata found at project and service scope.

PathOwnershipDescription

<service>/config/config.yamlManaged

Runtime defaults and graph-derived connector/endpoint settings.

<service>/config/overrides.yamlPreserved

Environment-specific values and feature enablement.

<service>/config/docker_overrides.yamlManaged

Container-specific TypeScript endpoint addresses and runtime values.

<service>/config/config_vars.yamlManaged

C++ variable expansion values.

<service>/static_config.yamlManaged

userver static component configuration.

<service>/graph/*.generated.yamlGenerated

Service topology snapshot.

graph/*.generated.yamlGenerated

Complete project topology snapshot.

<service>/docs/*.mdGenerated initially

Type, stream and endpoint documentation associated with the service.

README.mdPreserved

Workspace or component quickstart and public command summary.

spec/User owned

Implementation tasks, rules, prompts and progress outside generator ownership.

Runtime configuration layers

config/config.yaml       # generated defaults
config/overrides.yaml    # project/environment overrides
environment variables   # deployment overrides
Kubernetes ConfigMap     # rendered non-secret settings
Kubernetes Secret        # operator-owned credentials