python-ddd-framework 0.7.3__py3-none-any.whl → 0.9.0__py3-none-any.whl

python_ddd_framework/settings/manager.py

@@ -1,32 +1,25 @@
-"""条件写入与提交后通知的 owner；读取解析由 SettingProvider 负责。"""
+"""条件写入的 owner；读取解析由 SettingProvider 负责，生效时机归业务。"""
 
 from __future__ import annotations
 
-import logging
-from typing import TYPE_CHECKING, Any, TypeVar, cast
+from typing import Any, TypeVar, cast
 from uuid import UUID
 
 from pydantic import ValidationError
 from pydantic_core import PydanticSerializationError
 
-from ..notifications import NotificationPayloadError, NotificationPublishStatus, Notifications
 from .catalog import SettingCatalog
-from .changes import SETTINGS_CHANGED, SettingChanged
 from .contracts import SettingDefinition
 from .errors import RuntimeSettingError
 from .provider import SettingProvider
 from .store import RuntimeSettingStore
-from .values import SettingSnapshot, SettingValueSource, SettingWriteOutcome, StoredSetting
-
-if TYPE_CHECKING:
-    from .refresh import SettingsRefreshRuntime
+from .values import SettingSnapshot, SettingValueSource, StoredSetting
 
 _T = TypeVar("_T")
-_LOGGER = logging.getLogger(__name__)
 
 
 class SettingManager:
-    __slots__ = ("_catalog", "_notifications", "_provider", "_refresh", "_store")
+    __slots__ = ("_catalog", "_provider", "_store")
 
     def __init__(
         self, catalog: SettingCatalog, provider: SettingProvider, store: RuntimeSettingStore
@@ -34,13 +27,11 @@ class SettingManager:
         self._catalog = catalog
         self._provider = provider
         self._store = store
-        self._refresh: SettingsRefreshRuntime | None = None
-        self._notifications: Notifications | None = None
 
     async def set_global(self, definition: SettingDefinition[_T], value: _T) -> _T:
         current = await self._provider.snapshot(definition)
         saved = await self.update(definition, value, expected_version=current.version)
-        return cast(_T, saved.snapshot.value)
+        return cast(_T, saved.value)
 
     async def reset_global(self, definition: SettingDefinition[Any]) -> None:
         current = await self._provider.snapshot(definition)
@@ -48,8 +39,8 @@ class SettingManager:
 
     async def update(
         self, definition: SettingDefinition[_T], value: _T, *, expected_version: UUID | None
-    ) -> SettingWriteOutcome[_T]:
-        self._catalog.require_owned(definition)
+    ) -> SettingSnapshot[_T]:
+        self._require_write(definition, operation="set")
         try:
             validated, serialized = definition._dump_json(value)
         except (TypeError, ValidationError, PydanticSerializationError):
@@ -60,30 +51,22 @@ class SettingManager:
             definition.name, serialized, expected_version=expected_version
         )
         # 返回本次已经提交的值，不在提交后重读，避免把另一次并发写入误报为本次结果。
-        snapshot = SettingSnapshot(
+        return SettingSnapshot(
             definition.name, validated, SettingValueSource.RUNTIME, saved.version
         )
-        return SettingWriteOutcome(snapshot, await self._committed(definition.name))
 
     async def reset(
         self, definition: SettingDefinition[_T], *, expected_version: UUID | None
-    ) -> SettingWriteOutcome[_T]:
-        self._catalog.require_owned(definition)
+    ) -> SettingSnapshot[_T]:
+        self._require_write(definition, operation="reset")
         # 默认值先校验，不能在物理删除已经提交之后再抛出配置校验失败。
         fallback = self._provider._resolve(definition, StoredSetting(None, expected_version))
         saved = await self._store.write(definition.name, None, expected_version=expected_version)
-        snapshot = SettingSnapshot(definition.name, fallback.value, fallback.source, saved.version)
-        return SettingWriteOutcome(snapshot, await self._committed(definition.name))
+        return SettingSnapshot(definition.name, fallback.value, fallback.source, saved.version)
 
-    async def _committed(self, name: str) -> NotificationPublishStatus:
-        # 本地刷新先入队；Redis 降级不会撤销短事务已经提交的结果。
-        if self._refresh is not None:
-            self._refresh.request_refresh(name)
-        if self._notifications is None:
-            return NotificationPublishStatus.NOT_CONFIGURED
-        try:
-            return await self._notifications.publish(SETTINGS_CHANGED, SettingChanged(name=name))
-        except NotificationPayloadError:
-            # 发布大小/编码限制是独立结果；不能把已提交的写入重新表现为保存失败。
-            _LOGGER.warning("Committed setting notification rejected for %s", name)
-            return NotificationPublishStatus.REJECTED
+    def _require_write(self, definition: SettingDefinition[Any], *, operation: str) -> None:
+        self._catalog.require_owned(definition)
+        if SettingValueSource.RUNTIME not in definition.allowed_sources:
+            raise RuntimeSettingError(
+                setting=definition.name, operation=operation, error_type="SourceNotAllowed"
+            )

python_ddd_framework/settings/module.py

@@ -2,16 +2,17 @@
 
 from dishka import DEFAULT_COMPONENT, DependencyKey, Provider, Scope
 
+from ..authorization.module import AuthorizationModule
 from ..lifecycle import ConfigureContext
 from ..modularity import AppModule, ModuleRef
 from ..services.composition import (
     ServiceBindingContext,
     ServiceComposition,
-    ServiceDiscoveryContext,
 )
 from ..services.registration import RegistrationDecision, RegistrationKind
 from .binding import _provide_settings
-from .catalog import SettingCatalog, _build_setting_catalog, _contribute_setting_handler_defaults
+from .catalog import SettingCatalog, _build_setting_catalog
+from .errors import SettingDefinitionError
 from .store import RuntimeSettingStore
 
 
@@ -19,15 +20,10 @@ class SettingsModule(AppModule):
     catalog: SettingCatalog
 
     def configure(self, context: ConfigureContext) -> None:
-        self.catalog = _build_setting_catalog(context.modules, context.discoveries)
+        self.catalog = _build_setting_catalog(context.discoveries)
         if self.catalog.definitions:
             context.configure.section("settings")
-        context.services.add_composition(
-            ServiceComposition(discover=self._discover, bind=self._bind)
-        )
-
-    def _discover(self, context: ServiceDiscoveryContext) -> None:
-        _contribute_setting_handler_defaults(context.modules, context.services)
+        context.services.add_composition(ServiceComposition(bind=self._bind))
 
     def _bind(self, context: ServiceBindingContext) -> None:
         provider = Provider()
@@ -57,3 +53,19 @@ class SettingsManagementModule(AppModule):
         "python_ddd_framework.settings.application",
         "python_ddd_framework.settings.permissions",
     )
+
+    def configure(self, context: ConfigureContext) -> None:
+        context.services.add_composition(ServiceComposition(bind=self._bind))
+
+    def _bind(self, context: ServiceBindingContext) -> None:
+        # 全局 discovery 屏障后核对实际权限目录；只读 Settings 无需装配授权服务。
+        catalog = context.modules.instance(SettingsModule).catalog
+        permissions = context.modules.instance(AuthorizationModule).catalog
+        for definition in catalog.definitions:
+            for permission in (definition.read_permission, definition.write_permission):
+                if permission is not None and permission not in permissions:
+                    raise SettingDefinitionError(
+                        setting=definition.name,
+                        reason=f"permission {permission} is not defined",
+                        source=catalog.sources.get(definition.name),
+                    )

python_ddd_framework/settings/provider.py

@@ -43,7 +43,7 @@ class SettingProvider:
         self._catalog.require_owned(definition)
         stored = (
             await self._store.read(definition.name)
-            if self._store is not None
+            if self._store is not None and SettingValueSource.RUNTIME in definition.allowed_sources
             else StoredSetting(None, None)
         )
         return self._resolve(definition, stored)
@@ -56,11 +56,18 @@ class SettingProvider:
                 value = definition._validate_json(stored.value_json)
                 source = SettingValueSource.RUNTIME
             else:
-                configured = self._configuration.get_path(f"settings.{definition.name}", _MISSING)
+                configured = (
+                    self._configuration.get_path(f"settings.{definition.name}", _MISSING)
+                    if SettingValueSource.CONFIGURATION in definition.allowed_sources
+                    else _MISSING
+                )
                 if configured is not _MISSING:
                     value = definition._validate_python(configured)
                     source = SettingValueSource.CONFIGURATION
-                elif definition.has_default:
+                elif (
+                    definition.has_default
+                    and SettingValueSource.DEFINITION in definition.allowed_sources
+                ):
                     value = definition._default_value()
                     source = SettingValueSource.DEFINITION
                 else:

python_ddd_framework/settings/values.py

@@ -7,8 +7,6 @@ from enum import Enum
 from typing import Generic, TypeVar
 from uuid import UUID
 
-from ..notifications import NotificationPublishStatus
-
 _T = TypeVar("_T")
 
 
@@ -31,9 +29,3 @@ class SettingSnapshot(Generic[_T]):
     value: _T | None
     source: SettingValueSource
     version: UUID | None
-
-
-@dataclass(frozen=True, slots=True)
-class SettingWriteOutcome(Generic[_T]):
-    snapshot: SettingSnapshot[_T]
-    notification: NotificationPublishStatus

{python_ddd_framework-0.7.3.dist-info → python_ddd_framework-0.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ddd-framework
-Version: 0.7.3
+Version: 0.9.0
 Summary: Modular DDD application framework with project CLI and bundled templates
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -64,7 +64,7 @@ Python DDD Framework combines a module system with FastAPI, Dishka, Pydantic, SQ
 | HTTP APIs | Expose selected application services through FastAPI, or write explicit routers. Use OpenAPI, filters, file uploads, downloads, and streaming responses. |
 | Persistence and events | Use async SQLAlchemy repositories, explicit transaction boundaries, module-owned Alembic migrations, seed contributors, and local events before or after commit. |
 | Identity and permissions | Add JWT authentication, refresh sessions, users and roles, permission definitions, and authorization on service methods. |
-| Cache, settings, and locks | Use typed Redis caching, runtime settings with conditional updates and reset, settings refresh notifications, and explicit Redis-backed business locks. |
+| Cache, settings, and locks | Use typed Redis caching, global runtime settings with conditional updates and reset, and explicit Redis-backed business locks. |
 | Background execution | Enqueue durable PostgreSQL jobs with typed payloads, schedule recurring work, run periodic workers, and select in-process or managed subprocess execution. |
 | Real-time communication | Add authenticated WebSocket connections, typed messages, and targeted notifications to connected clients. |
 | Hosting and observability | Manage long-lived integrations with `HostedService`, coordinate shutdown, and use structured logging, correlation, OpenTelemetry tracing, and lifecycle health endpoints. |
@@ -273,6 +273,12 @@ Edit `backend/app.development.yaml` for local connections, identity settings, lo
 
 Generated credentials are for local development. Production configuration is supplied separately in `app.production.yaml`. See [configuration](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#定义-module-与配置) and [background and logging configuration](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#settings后台与日志).
 
+### Use global settings
+
+Declare a typed `SettingDefinition` and its scanned provider under the owning module's `domain/settings/`, then add `SettingsModule` to that module's dependencies. Inject `SettingProvider` to read values and `SettingManager` for conditional writes/reset. The generated Host already selects Settings persistence and management HTTP; apply its Settings migration before using the store for reads or writes.
+
+Values resolve from runtime override, Host configuration, then definition default. Reset clears an override and resumes fallback. Management provides list/read/update/reset with visibility, permissions, and version checks; business code decides when to use the value. Follow the [complete project recipe](docs/development.md#settings-策略与使用) or the generated project's **Global settings** guide for declarations, configuration, permissions, and request bodies. The minimal contract starts with 0.9.0; see [migration notes](#minimal-settings-migration-090).
+
 ### Run application tests
 
 After completing local database setup, run from `backend/`:
@@ -314,6 +320,24 @@ New `ddd` modules contain the full responsibility directories and necessary comp
 
 See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
 
+## Minimal Settings migration (0.9.0)
+
+Settings now owns only global definitions, reads, writes, and clearing overrides. Modules own definitions, the Host selects storage, and business code decides when and how to use the values. Source order, source restrictions, management permissions, typed JSON, independent transactions, UUID concurrency tokens, and reset version records remain unchanged. No dependency, database schema, or migration change is required.
+
+- Remove `SettingsRefreshModule`, `SettingsNotificationsModule`, `SettingHandlers`, `SettingHandlerDefinition`, and Settings refresh options from Host/module wiring. Remove settings observers and the dedicated `application/setting_handlers` directory. Read through `SettingProvider` where the business needs the value; the framework no longer coordinates application, polling, reconnect compensation, retries, or application status. Generic Notifications and HostedService remain available independently.
+- `SettingManager.update/reset` returns `SettingSnapshot[T]` directly: replace `result.snapshot.value/version` with `result.value/version`. `SettingWriteOutcome`, notification feedback, and handler/application status exports are removed.
+- HTTP update/reset returns the same `SettingView` shape as a read: `name`, `value`, `source`, and `version`. Replace `response.setting` with `response`; remove `saved`, `notification`, and `effect` handling. `SettingWriteResult` is removed. Success confirms persistence only, and stale versions still produce a conflict.
+
+Current rules and examples are in the [Settings contract](docs/architecture.md#typed-cache-与-settings) and [usage guide](docs/development.md#settings-策略与使用). Validation and remaining limits are recorded in [status](docs/status.md#settings-最小化未发布).
+
+## Settings policies (0.8.0)
+
+`SettingDefinition` now accepts `allowed_sources`, `management_access`, `read_permission`, and `write_permission`. Existing definitions retain their source order and management visibility. Generic update/reset now also require `settings.read`, in addition to `settings.write` and any declared per-setting permissions, because their responses contain the saved setting snapshot. Update roles that previously held only write permission.
+
+Before excluding `CONFIGURATION` for a setting, remove its entries from YAML, environment variables, dotenv, CLI, explicit configuration and module configuration defaults: composition rejects forbidden inputs even when another value masks them. `HIDDEN` and `READ_ONLY` restrict generic management; internal readers and dedicated application services can still use the existing Provider/Manager subject to source, type and version rules. Defining a per-setting permission does not grant it to existing users or roles; update grants through the application's authorization system. No database migration or dependency change is required for this extension.
+
+Version 0.8.0 includes these policies. Follow [Settings setup and usage](docs/development.md#settings-策略与使用) for definition discovery, permission declarations, internal Provider/Manager calls, and HTTP update/reset with version tokens. The [contract](docs/architecture.md#typed-cache-与-settings) owns the rules; [validation evidence](docs/status.md#settings-最小策略扩展) separates implementation results from the later read-only review.
+
 ## Invocation performance (0.7.2)
 
 Function calls avoid regenerating DI wrappers, empty extension chains skip unnecessary work, and completed filter/interceptor chains release execution references sooner. Managed declaration checks continue to detect dynamic method and policy changes.
@@ -343,7 +367,7 @@ Runnable examples: [HTTP generators](docs/development.md#http-生成器与持续
 Capability composition now uses the same `AppModule` model as customer modules. Existing applications must migrate their declarations together; there is no compatibility path.
 
 - Declare capability dependencies on the Module that uses them. Selecting a sibling provider in Host does not supply a missing business-module dependency. `ApplicationServicesModule` supplies the usual application-service capabilities; additional capabilities are explicit dependencies.
-- Wrap capability declarations with `NotificationDefinitions`, `HostedServices`, `BackgroundWorkers`, `BackgroundSchedules`, or `SettingHandlers` from their owning packages. Use native service registration for providers and `ServiceComposition` for capability discovery and final binding. Keep provider selection in Host.
+- Wrap capability declarations with `NotificationDefinitions`, `HostedServices`, `BackgroundWorkers`, or `BackgroundSchedules` from their owning packages. Use native service registration for providers and `ServiceComposition` for capability discovery and final binding. Keep provider selection in Host.
 - Replace Application invocation methods with `invoke(application, Service.method, ...)`, `invoke_as(application, user, ...)`, `call(application, function, ...)`, and `call_as(application, user, ...)`. Register interception with `add_interceptor(context, ...)` and events with `subscribe_local_event(context, ...)`. Import these functions from `python_ddd_framework`.
 - Read capability catalogs from their Module instance through `application.modules.instance(ModuleType)` or the catalog's DI binding. Generic service diagnostics remain in `application.service_catalog`; readiness is `application.is_ready`.
 - `DataSeedContributor`, `DataSeeder`, and `DataSeedError` belong to `python_ddd_framework.seeding` and remain available from the root package. Domain Modules with contributors depend on `DataSeedingModule`; remove `@application_service` from contributors. Seed is no longer an ApplicationService or part of its catalog. Explicit seed commands retain contributor ordering, per-item UoW, module dependency selection, failure reporting, and cleanup.

{python_ddd_framework-0.7.3.dist-info → python_ddd_framework-0.9.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-python_ddd_framework/__init__.py,sha256=UUsi5Ye8kGFX3zp7nC7QW87VEhfSCWy3_u_dcZ5qUgI,15416
+python_ddd_framework/__init__.py,sha256=TuNv1DOY2PLAvwzWzj_j0zSoJmofjjkdOQdqY18SDwI,15402
 python_ddd_framework/application/__init__.py,sha256=RPe_lkegIRim7GcBnXyevOg5KM7bfUIO9YGsqcA0lXk,184
 python_ddd_framework/application/build_spec.py,sha256=Udj1JIgP2oBMCUezmzWzOdjFYBCEE8OxwHSEaDqrMMo,1030
 python_ddd_framework/application/builder.py,sha256=d0vc1D5HvG_aJI5lPQydr-ha0OTNviWlplxlyP99qDs,8080
@@ -89,7 +89,7 @@ python_ddd_framework/configuration/environment_source.py,sha256=5DFYpLyOXpCkYT4W
 python_ddd_framework/configuration/immutability.py,sha256=TRB2caTQtoDUA1bcQt9bPWBl-7u45f5vO30sRJQnKkc,5672
 python_ddd_framework/configuration/input_shape.py,sha256=T97z95F2PQkvNN0PV5Iz1s19UvX1CZGvyV7Ojo7cRLY,2438
 python_ddd_framework/configuration/merge.py,sha256=VE6vtvcyQu8rQaqGAQs23JQmhJFneq6cWd1SZCow1Bk,3702
-python_ddd_framework/configuration/root.py,sha256=aF2ideF_Hz6N3cY_W1kvZDQRe1JGv8SeIC3-bxpYMrQ,7919
+python_ddd_framework/configuration/root.py,sha256=-xmDLRHJWOpLUVKa7i-QABsrp5kCrTtefunvdhGkgvc,8068
 python_ddd_framework/configuration/sources.py,sha256=Xd7Sxk0umHS7h5SRq08NSWGhLmJ3lHVP6tyzmh1F7AA,19233
 python_ddd_framework/configuration/values.py,sha256=4S8Ae2CRRekA9ge0ZxoMJcdJn3XqnF06E6DOaAZZuHc,14591
 python_ddd_framework/configuration/yaml_source.py,sha256=hZhKftmip6rRQUwqQBfTi_d-UYthUqWPbL5dQUvb89Q,2016
@@ -107,7 +107,7 @@ python_ddd_framework/developer_kit/templates/basic/{{cookiecutter.module_name}}/
 python_ddd_framework/developer_kit/templates/basic/{{cookiecutter.module_name}}/services/__init__.py.jinja,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_ddd_framework/developer_kit/templates/basic/{{cookiecutter.module_name}}/services/default_conversion_service.py.jinja,sha256=YIYXqDycBVoUlLCwwUZ2tcyUk2fKSu-20mI00u5QUhc,342
 python_ddd_framework/developer_kit/templates/module/cookiecutter.json,sha256=edD_zSqmFuOKvMZyxmFFabAavBQJk0tbGO4YrnsgZN0,60
-python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/README.md,sha256=bojfHi_8PIPSeJheOdS6hSIaG2LrXDwmqymnwm0ZPDs,5674
+python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/README.md,sha256=nbPgBhWynTZaK6vojFyxf2ARSYAzw6xCsNzAqUtulNo,6537
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/__init__.py.jinja,sha256=byPOI4PKtQDi5IQa9tzZZEVYy5zGx9PJdBzPrgcxm64,89
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/__init__.py.jinja,sha256=pm9_TqjN20deRELpopxK412O3mra0OZ6QdesPdcsaRU,90
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/background_jobs/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
@@ -120,7 +120,6 @@ python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/module.py.jinja,sha256=qGmq1ggBmxGY2B8H8gB8tEY-uxMuWpyr60l0ZAouho8,1950
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/options/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/services/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
-python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/setting_handlers/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application_contracts/__init__.py.jinja,sha256=grSDmU4IKdRYZsqi56aEVvsgx92AYF2k3jlDzANqra4,51
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application_contracts/inputs/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application_contracts/integration_services/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
@@ -158,8 +157,8 @@ python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/sqlalchemy/repositories/__init__.py.jinja,sha256=VdqphDwvoB9nhl5Q9vHpSnmMWwDUlDp_YckRkionwWw,46
 python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/tests/__init__.py.jinja,sha256=Kbig4VsdpmVUDHx5SLPf7ZZM6S5ftVmzBxBAJIjwvng,40
 python_ddd_framework/developer_kit/templates/project/cookiecutter.json,sha256=vmN799k9eRHAEGeYt8uUjPsusbblvgpNIsXVOsXUno4,314
-python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/AGENTS.md,sha256=u4fnjZJgqmIGf2CI9yYNRsfDLFktvGvuOVm2M-DQmKs,13059
-python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/README.md,sha256=i65NyuY-MXu1eZ3M_Ob5hFpcqCSd8hzc3iYr3Cn27g4,11146
+python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/AGENTS.md,sha256=MVG6FbJckCZYwq-V33AZpH7RCvcv2tKaaN5VcaIzJ6M,13432
+python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/README.md,sha256=y_Xg7rKtj6I8U2ChoLj57C5jz75gk2BdqD8F-ZH8IfI,11874
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/.dockerignore,sha256=TG053vIzikxG8h53vCcU_s5wcr7p4GEKwsedbrRrSOo,71
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/.gitignore,sha256=OF6nwgb-RiP8EAXc5osbk3bsOEYkk0JaV99v3FcglTU,66
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/.python-version,sha256=lN0hZ-3c-Wk_uFRrQasUfy9YJrXrdvSzYKhuHeXIXbY,34
@@ -170,11 +169,11 @@ python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/pyproject.toml.jinja,sha256=zZ-kDjgfOYo4g35VLoctEEoyvlZm9fEB2ddHW30JzUs,932
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/src/host/__init__.py.jinja,sha256=RfLT7dqPnSotCDorSp6Taz9jBYOmepu6De_wZNelWZ8,74
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/src/host/main.py.jinja,sha256=SPxJ86SW1dx-BuoWITWifq-6NseoxnVMLTufcFFsxF4,1996
-python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/src/host/module.py.jinja,sha256=6j63muRR7tQmYIFso-egk8L5_Zw57I61ijWR8SDpw5U,3235
+python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/src/host/module.py.jinja,sha256=qpM0L69ek8-SXQpJoZ-NkPyfGGIGTRrB1xtrmzpxZF8,3004
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/tests/conftest.py.jinja,sha256=I_SlSxioBsCFNJLM52iM-neYBJR71qOUn7C4dI9t-7I,149
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/backend/tests/host/test_http.py.jinja,sha256=pmiz6k0oWWrPeW_rVG2Ynibg4j3yuKvgvYFc0K7J_no,2766
-python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/docs/architecture.md,sha256=qU6lE4iwhTUDCY3OvtSgNYw99k8JGaOsyrmdaFt_Py4,26920
-python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/docs/development.md,sha256=hEn_ucr8NmZnEp80TyAYB1IoLMWUoh9Hk8wCBzCizDM,53182
+python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/docs/architecture.md,sha256=VINiboJya5Ae6wn0UL7pHK-IXX7OIKfI0jbWaOL0F9U,27842
+python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/docs/development.md,sha256=V44TFV5BU5dhCautVc8D41h2-QhKgyCk69X3d-dWZgk,57556
 python_ddd_framework/developer_kit/templates/project/{{cookiecutter.project_name}}/scripts/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 python_ddd_framework/developer_kit/wiring.py,sha256=80ZhxpGXK6NP3b_BTTc1kt3oIU21MU70cT9kgm8ZgAE,7835
 python_ddd_framework/diagnostics/__init__.py,sha256=HdgzjQqMJ_SUGKJc5EcQ5PL1rM4GcTeem-L0q1r7vjQ,455
@@ -390,25 +389,19 @@ python_ddd_framework/services/registration.py,sha256=AsvhVv_szq8TcaXdUMvOY6fNNp8
 python_ddd_framework/services/relocation.py,sha256=oMel_8RPFtPHDE9KrUepzx1nJpiug0EaNK7RWEKZFC0,3763
 python_ddd_framework/services/repository.py,sha256=jjjCmpcz4deAZmDNSM44WlDmh9msFO53qN116CHdBSM,1686
 python_ddd_framework/services/runtime.py,sha256=57G5jNjOiexpSqTCogdI18u5xeEK2YglztNqDtFcsZI,9300
-python_ddd_framework/settings/__init__.py,sha256=5Ikxnl_nT9l_WDuqW916hsvVlO9t_vCjR9OIvvJR8lI,1034
-python_ddd_framework/settings/application.py,sha256=9J7Q74Vr6QXJ2ddWU7-MFpwdjUXW-ZGI1Py_R93mAsM,3775
-python_ddd_framework/settings/binding.py,sha256=1a-AzTLwCTU6zQ85rYBJrQE63_b7BwFf9UWbMhOfJrQ,962
-python_ddd_framework/settings/catalog.py,sha256=fqVeFr3DuJWrNUfIuIwfivVhuCobQpWe32EmRieuUVE,4880
-python_ddd_framework/settings/changes.py,sha256=zpHhCJY83s-KIs7NkjQAmIxzY7cJfT8FD4A08gF9NfE,367
-python_ddd_framework/settings/contracts.py,sha256=E70lLiFC5G7XoEpmf3rsoW5BnPhzajm-eri0vzn0xuY,4428
-python_ddd_framework/settings/declarations.py,sha256=FeFrgw6fAdjX6bGaajjnO2tsrfxEvKW6sZrRfTAxCEs,526
+python_ddd_framework/settings/__init__.py,sha256=EYm9Ek57X2o1edniVeKn150uKFgSrHF7onKUncGRQnc,867
+python_ddd_framework/settings/application.py,sha256=QMouHpNJUxkmkQ3kRHSxtZ4ssDAsRZitYWiWADuGCH4,5444
+python_ddd_framework/settings/binding.py,sha256=_wDIsKe-p6WuKaQB9NvhbxCm9aYbiN95m7erJS35T8Y,1621
+python_ddd_framework/settings/catalog.py,sha256=IkfZTd2PGUOMTyW7koQEdIXqPdiiPYlNmoTyfxPF4P0,2452
+python_ddd_framework/settings/contracts.py,sha256=v_Wn7kr3_JQYH-rXeusR_YWvtwR3RT_KxQqnvVD7uZI,6899
 python_ddd_framework/settings/definition_discovery.py,sha256=zHN3-coqzdEb--mecv00v7ifWzzCfJRZ-BrFcdVx4u4,3002
 python_ddd_framework/settings/definitions.py,sha256=hkWO0dqOoBmd7pKv-cUsCZaEU0AeUEULVLW1Rl8uwdQ,1687
 python_ddd_framework/settings/errors.py,sha256=ZcU1nMB44_Rq9Wl5bw83s3Y066LxSLrFqOW_gG6ViS4,836
-python_ddd_framework/settings/handlers.py,sha256=A0GWDKRXASlCoWm_Wduul0thAv4xW4SG305KXd6wY-4,1369
-python_ddd_framework/settings/management.py,sha256=dJhyZYfNA5Qsup9yt2dKOrIwGq3OnNkDxskJniBV3BI,1656
-python_ddd_framework/settings/manager.py,sha256=wjqhRCmtF_B-ETRZOTl3izRTzVJb7ebk3qLOMqFDdRE,4181
-python_ddd_framework/settings/module.py,sha256=8c9c4pIpzn3XB8xkJqW4AhKkuUS-HYxwfS4px7VeP1Q,2314
-python_ddd_framework/settings/notifications.py,sha256=tVSXjhhJWhkMcOakSmeOfXT1X02Hcx2xRU8Whr8rSig,1700
+python_ddd_framework/settings/management.py,sha256=sfibyZzhrsYg8FwPZCz_mDw6UEBtnP9HJaVu2O8PMmc,1298
+python_ddd_framework/settings/manager.py,sha256=0jc7dQxGgKY-vc3rzVrPevHPZ6BY7y4APaxGd74kKlk,3164
+python_ddd_framework/settings/module.py,sha256=jnCyeiFAnQB2q3Zeyx-HN9xmHbpGouUrfB3K3gJ8ekE,3061
 python_ddd_framework/settings/permissions.py,sha256=2nPyZOZ9G-4mSCIqwNI0C9WUBhP0ZwqNjljP3XZD3PE,553
-python_ddd_framework/settings/provider.py,sha256=plT4x6UjBGn9B6-OmZYKswdto3NrE6Ib1lsyc1VUKoA,2871
-python_ddd_framework/settings/refresh.py,sha256=jYYqEdTU4cOXyHmdMEdw_94qybp4bzVPRdrM6WF8q6k,5413
-python_ddd_framework/settings/refresh_module.py,sha256=wDxWau4oZCtBiMO6TDXZFbZRcKTiYaTFGWPjZnaFNug,2225
+python_ddd_framework/settings/provider.py,sha256=AvMrdWML_wbbJEqNb9IH8_OcUUX8QbdEpxw4GDibdA4,3216
 python_ddd_framework/settings/sqlalchemy/__init__.py,sha256=G-S-sSsxwfjZxr0mVAyXUBG0SIxC3ZCMtrdpMsZ14YM,158
 python_ddd_framework/settings/sqlalchemy/migrations/0001_settings.py,sha256=wx_GcxijY-43V9DoNNzdvfwg8d5oYWkmeWSe23xtXLA,1045
 python_ddd_framework/settings/sqlalchemy/migrations/0002_physical_delete.py,sha256=JtPmESosI_SIe4ijFuBFX7zvcgsnk-7dtjULipdC6NU,982
@@ -418,7 +411,7 @@ python_ddd_framework/settings/sqlalchemy/models.py,sha256=qKbRHhdm0uDPUUtLgeVeFv
 python_ddd_framework/settings/sqlalchemy/module.py,sha256=NbvxE40aSW1aWf7CbU3GRPN_WrvsQgUXp05hAAoDtcE,1212
 python_ddd_framework/settings/sqlalchemy/store.py,sha256=I9yRtpZBzNEYG0NANFAgVvVTY0_Qnl5JinXf00ebQwE,3597
 python_ddd_framework/settings/store.py,sha256=3tdF-0l0owUdWuNEd0K8OfbXncI38hx0pD6anU5GdmA,442
-python_ddd_framework/settings/values.py,sha256=KMRZDQu2FRNXDIdJwGVgHn656Hc5qRY2WQGjbBxfhO4,898
+python_ddd_framework/settings/values.py,sha256=smw2jLySVP6aKefqmkOqHp8z9pjc2nGfEofE6uGzMZY,687
 python_ddd_framework/sqlalchemy/__init__.py,sha256=DP6PAJHevoc1i-n9ma8_2CAiPmAvWoN7opqRYzHR4Sg,2054
 python_ddd_framework/sqlalchemy/alembic_runtime/__init__.py,sha256=r-ZHMiEhca5M2xv3plW9U3fHfzt5lVQeDohEFqrTuv0,82
 python_ddd_framework/sqlalchemy/alembic_runtime/env.py,sha256=ArKiDG9n5JOPQG44oSrJUd3o96zyY-b2PPkGysFy674,1389
@@ -452,9 +445,9 @@ python_ddd_framework/unit_of_work/module.py,sha256=EjsUtCG7w56NmLU_xqBRiwJ65Mw5h
 python_ddd_framework/unit_of_work/options.py,sha256=AVcEmwwn39qvj8PLQetBeGzdU_eblABGuNLDIQU5tyI,3365
 python_ddd_framework/validation/__init__.py,sha256=nTN_BgIXMLHeUtMgSj2hpisWc1_sk6UWTapk30oh1us,100
 python_ddd_framework/validation/models.py,sha256=Ydz5ZYgqYMPZEXi9A3DA6beN5lD9AcMaImnxDf1aRXs,1737
-python_ddd_framework-0.7.3.dist-info/licenses/LICENSE,sha256=2sSWLZdtk4EhG2GlwpksXzmyux-G6Qiov0D27lE_bqw,805
-python_ddd_framework-0.7.3.dist-info/licenses/src/python_ddd_framework/background_jobs/pgqueuer/UPSTREAM_LICENSE.txt,sha256=0lCGUd5Pke2Up1Kqn1kRnHcwLlBz60E8xvR7WL4k_kE,1066
-python_ddd_framework-0.7.3.dist-info/WHEEL,sha256=si2p8vW03RnhyBnhWl4tj-ObJa78SpE-c9HsEtblGR0,80
-python_ddd_framework-0.7.3.dist-info/entry_points.txt,sha256=CMy4XBD8IKGUfHwe0YBmHmSJtjfnA3yyDHqsMZCLsc8,447
-python_ddd_framework-0.7.3.dist-info/METADATA,sha256=5FcVFcHFz-KN3-ify5NyNpNODv-o-U38hLv5GrpCRX4,67271
-python_ddd_framework-0.7.3.dist-info/RECORD,,
+python_ddd_framework-0.9.0.dist-info/licenses/LICENSE,sha256=2sSWLZdtk4EhG2GlwpksXzmyux-G6Qiov0D27lE_bqw,805
+python_ddd_framework-0.9.0.dist-info/licenses/src/python_ddd_framework/background_jobs/pgqueuer/UPSTREAM_LICENSE.txt,sha256=0lCGUd5Pke2Up1Kqn1kRnHcwLlBz60E8xvR7WL4k_kE,1066
+python_ddd_framework-0.9.0.dist-info/WHEEL,sha256=si2p8vW03RnhyBnhWl4tj-ObJa78SpE-c9HsEtblGR0,80
+python_ddd_framework-0.9.0.dist-info/entry_points.txt,sha256=CMy4XBD8IKGUfHwe0YBmHmSJtjfnA3yyDHqsMZCLsc8,447
+python_ddd_framework-0.9.0.dist-info/METADATA,sha256=hk9U10YzJOgUMz5XK2ZTFvqjAwrhoBquHOzoMXqJQgI,71605
+python_ddd_framework-0.9.0.dist-info/RECORD,,

python_ddd_framework/developer_kit/templates/module/{{cookiecutter.module_name}}/application/setting_handlers/__init__.py.jinja

@@ -1 +0,0 @@
-"""所属能力的实现或契约。"""

python_ddd_framework/settings/changes.py

@@ -1,14 +0,0 @@
-"""Settings 变更只通知标识，数据库仍是有效值的唯一权威。"""
-
-from pydantic import BaseModel, ConfigDict
-
-from ..notifications import NotificationDefinition
-
-
-class SettingChanged(BaseModel):
-    model_config = ConfigDict(frozen=True, extra="forbid")
-
-    name: str
-
-
-SETTINGS_CHANGED = NotificationDefinition("settings.changed", SettingChanged)

python_ddd_framework/settings/declarations.py

@@ -1,18 +0,0 @@
-"""Settings handler 的关系声明；实例和生命周期仍由原生 DI 管理。"""
-
-from dataclasses import dataclass
-from typing import Any
-
-from ..modularity import AppModule, ModuleDeclaration
-from .handlers import SettingHandlerDefinition
-
-
-@dataclass(frozen=True, slots=True)
-class SettingHandlers(ModuleDeclaration):
-    definitions: tuple[SettingHandlerDefinition[Any], ...]
-
-    @property
-    def required_module(self) -> type[AppModule]:
-        from .module import SettingsModule
-
-        return SettingsModule

python_ddd_framework/settings/handlers.py

@@ -1,43 +0,0 @@
-"""长期组件的 typed 应用契约；执行上下文由组件自身负责。"""
-
-from __future__ import annotations
-
-import inspect
-from dataclasses import dataclass
-from typing import Generic, Protocol, TypeVar
-
-from .contracts import SettingDefinition
-from .errors import SettingDefinitionError
-from .values import SettingSnapshot
-
-_T = TypeVar("_T")
-
-
-class SettingHandler(Protocol[_T]):
-    async def apply(self, snapshot: SettingSnapshot[_T]) -> None: ...
-
-
-@dataclass(frozen=True, slots=True)
-class SettingHandlerDefinition(Generic[_T]):
-    setting: SettingDefinition[_T]
-    handler_type: type[SettingHandler[_T]]
-
-    def __post_init__(self) -> None:
-        if not isinstance(self.setting, SettingDefinition):
-            raise SettingDefinitionError(setting="handler", reason="setting must be a definition")
-        if (
-            not isinstance(self.handler_type, type)
-            or inspect.isabstract(self.handler_type)
-            or not inspect.iscoroutinefunction(getattr(self.handler_type, "apply", None))
-        ):
-            raise SettingDefinitionError(
-                setting=self.setting.name, reason="handler must have an async apply method"
-            )
-
-
-@dataclass(frozen=True, slots=True)
-class SettingApplicationStatus:
-    setting: str
-    handler: str
-    last_applied: SettingSnapshot[object] | None
-    error_type: str | None

python_ddd_framework/settings/notifications.py

@@ -1,41 +0,0 @@
-"""Settings 是通用通知的使用方，重连和漏消息的补偿由 Settings 自身拥有。"""
-
-from __future__ import annotations
-
-from contextlib import AsyncExitStack
-
-from ..lifecycle import PreInitializeContext, ShutdownContext
-from ..modularity import AppModule
-from ..notifications import Notifications
-from ..notifications.declarations import NotificationDefinitions
-from ..notifications.module import NotificationsModule
-from .changes import SETTINGS_CHANGED, SettingChanged
-from .manager import SettingManager
-from .refresh import SettingsRefreshRuntime
-from .refresh_module import SettingsRefreshModule
-
-
-class SettingsNotificationsModule(AppModule):
-    dependencies = (SettingsRefreshModule, NotificationsModule)
-    notification_definitions = NotificationDefinitions((SETTINGS_CHANGED,))
-
-    def __init__(self) -> None:
-        self._subscriptions = AsyncExitStack()
-
-    async def pre_initialize(self, context: PreInitializeContext) -> None:
-        refresh = await context.container.get(SettingsRefreshRuntime)
-        notifications = await context.container.get(Notifications)
-        settings = await context.container.get(SettingManager)
-
-        async def changed(message: SettingChanged) -> None:
-            refresh.request_refresh(message.name)
-
-        await self._subscriptions.enter_async_context(
-            notifications.subscribe(SETTINGS_CHANGED, changed, on_reconnect=refresh.request_refresh)
-        )
-        settings._notifications = notifications
-
-    async def shutdown(self, context: ShutdownContext) -> None:
-        settings = await context.container.get(SettingManager)
-        settings._notifications = None
-        await self._subscriptions.aclose()