semantics

This commit is contained in:
2026-03-27 21:27:31 +03:00
parent d17f75a65d
commit e83879cf06
181 changed files with 9815 additions and 1612 deletions

View File

@@ -1,9 +1,9 @@
# [DEF:demo_data_service:Module]
# [DEF:DemoDataService:Module]
# @COMPLEXITY: 3
# @SEMANTICS: clean-release, demo-mode, namespace, isolation, repository
# @PURPOSE: Provide deterministic namespace helpers and isolated in-memory repository creation for demo and real modes.
# @LAYER: Domain
# @RELATION: DEPENDS_ON -> backend.src.services.clean_release.repository
# @RELATION: [DEPENDS_ON] ->[RepositoryRelations]
# @INVARIANT: Demo and real namespaces must never collide for generated physical identifiers.
from __future__ import annotations
@@ -20,6 +20,8 @@ def resolve_namespace(mode: str) -> str:
if normalized == "demo":
return "clean-release:demo"
return "clean-release:real"
# [/DEF:resolve_namespace:Function]
@@ -33,6 +35,8 @@ def build_namespaced_id(namespace: str, logical_id: str) -> str:
if not logical_id or not logical_id.strip():
raise ValueError("logical_id must be non-empty")
return f"{namespace}::{logical_id}"
# [/DEF:build_namespaced_id:Function]
@@ -45,6 +49,8 @@ def create_isolated_repository(mode: str) -> CleanReleaseRepository:
repository = CleanReleaseRepository()
setattr(repository, "namespace", namespace)
return repository
# [/DEF:create_isolated_repository:Function]
# [/DEF:backend.src.services.clean_release.demo_data_service:Module]
# [/DEF:DemoDataService:Module]