python-ddd-framework 0.7.0__tar.gz → 0.7.2__tar.gz

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-ddd-framework
-Version: 0.7.0
+Version: 0.7.2
 Summary: Modular DDD application framework with project CLI and bundled templates
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
@@ -304,6 +304,20 @@ The image uses `python -m host.main` without development reload. Runtime install
 
 New `ddd` modules contain the full responsibility directories and necessary composition, with no preset business code or tests. `basic` is unchanged. This affects subsequent generation only: upgrades do not delete or rewrite existing consumers' order code. Keep existing business contracts and data under their application owners. The former order implementation and its existing domain test now live in [the independent example](examples/order_management/README.md); its initializer uses the official CLI, requires a new destination, and is not bundled in the runtime wheel. No CLI parameter or dependency has been added.
 
+## HTTP lifecycle and global migration checks (0.7.1)
+
+- Health endpoints now read their Application from request-local access to the FastAPI instance state. Adapter rollback and lifespan cleanup release the binding; rejected duplicate or concurrent lifespan entry preserves the active lifespan's binding and readiness. Health URLs, responses and readiness semantics are unchanged.
+- Replace Owner filtering used solely to exclude empty ORM skeletons with one `await SqlAlchemyMigrator(application).check_current_heads()` call. Global checks and upgrades waive missing revisions only for ordinary ORM sources whose metadata and revision history are both empty. Sources with tables, historical revisions, migration-only declarations or extensions retain their checks, including unknown database history.
+- Keep the Host's startup orchestration and cleanup. Run the check while the Application is COMPOSED, before starting it; there is no automatic startup check or new configuration. Explicit module operations and first-revision authoring keep their existing behavior.
+
+See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
+
+## 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.
+
+Public APIs, DI scopes, authorization, validation, Unit of Work, exception and cancellation behavior are unchanged. No application-code, configuration or data migration is required. Follow the existing [upgrade procedure](#upgrading); validation evidence and performance limits are recorded in [release status](docs/status.md#当前发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)
@@ -546,7 +560,7 @@ Do not remove durable job payload versions merely because their Python APIs were
 <details>
 <summary>For maintainers: publishing a changed version</summary>
 
-Routine code and documentation commits may retain the current version. Pull requests to `main` run build, static checks, and short architecture/typing/release-intent checks with read-only permissions. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
+Routine code and documentation commits may retain the current version. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
 
 </details>
 

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/README.md

@@ -260,6 +260,20 @@ The image uses `python -m host.main` without development reload. Runtime install
 
 New `ddd` modules contain the full responsibility directories and necessary composition, with no preset business code or tests. `basic` is unchanged. This affects subsequent generation only: upgrades do not delete or rewrite existing consumers' order code. Keep existing business contracts and data under their application owners. The former order implementation and its existing domain test now live in [the independent example](examples/order_management/README.md); its initializer uses the official CLI, requires a new destination, and is not bundled in the runtime wheel. No CLI parameter or dependency has been added.
 
+## HTTP lifecycle and global migration checks (0.7.1)
+
+- Health endpoints now read their Application from request-local access to the FastAPI instance state. Adapter rollback and lifespan cleanup release the binding; rejected duplicate or concurrent lifespan entry preserves the active lifespan's binding and readiness. Health URLs, responses and readiness semantics are unchanged.
+- Replace Owner filtering used solely to exclude empty ORM skeletons with one `await SqlAlchemyMigrator(application).check_current_heads()` call. Global checks and upgrades waive missing revisions only for ordinary ORM sources whose metadata and revision history are both empty. Sources with tables, historical revisions, migration-only declarations or extensions retain their checks, including unknown database history.
+- Keep the Host's startup orchestration and cleanup. Run the check while the Application is COMPOSED, before starting it; there is no automatic startup check or new configuration. Explicit module operations and first-revision authoring keep their existing behavior.
+
+See the [migration guide](docs/development.md#数据库聚合与迁移) and [verification record](docs/status.md#http-回收与迁移来源判定未发布).
+
+## 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.
+
+Public APIs, DI scopes, authorization, validation, Unit of Work, exception and cancellation behavior are unchanged. No application-code, configuration or data migration is required. Follow the existing [upgrade procedure](#upgrading); validation evidence and performance limits are recorded in [release status](docs/status.md#当前发布).
+
 <a id="streaming-and-access-migration-07-unreleased"></a>
 
 ## Streaming and access migration (0.7)
@@ -502,7 +516,7 @@ Do not remove durable job payload versions merely because their Python APIs were
 <details>
 <summary>For maintainers: publishing a changed version</summary>
 
-Routine code and documentation commits may retain the current version. Pull requests to `main` run build, static checks, and short architecture/typing/release-intent checks with read-only permissions. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
+Routine code and documentation commits may retain the current version. Pushes to `main` run the full release gates, including locked, lowest-direct, and highest allowed dependency samples, but skip publication unless the version increased across the push; initial creation of `main` publishes its current version. Manual workflow runs validate only. A failed run may be retried, but a later same-version push does not resume publication: changed contents require another version bump. Follow [release operations](https://github.com/componet-architecture/python-ddd-framework/blob/main/docs/development.md#发布操作) for publisher setup and retry boundaries. Dependency samples and current API/type checks do not establish backward compatibility or a cross-version upgrade guarantee.
 
 </details>
 

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.0"
+version = "0.7.2"
 description = "Modular DDD application framework with project CLI and bundled templates"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "python-ddd-framework"
-version = "0.7.0"
+version = "0.7.2"
 description = "Modular DDD application framework with project CLI and bundled templates"
 readme = "README.md"
 license = "LicenseRef-Proprietary"

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/fastapi/adapter.py

@@ -15,7 +15,13 @@ from starlette.middleware import Middleware
 from ..application import Application
 from ..application_services import ApplicationServiceValidationError
 from ..authorization import PermissionDeniedError, UnauthenticatedError
-from ..errors import BusinessError, FrameworkError, ResourceConflictError, ResourceNotFoundError
+from ..errors import (
+    BusinessError,
+    FrameworkError,
+    InvalidApplicationStateError,
+    ResourceConflictError,
+    ResourceNotFoundError,
+)
 from ..lifecycle import ApplicationState
 from .contracts import RouterCatalog
 from .error_handlers import (
@@ -30,6 +36,7 @@ from .error_handlers import (
 )
 from .errors import FastApiAdapterError
 from .filters import ServiceFilter, _validate_filters
+from .health import _APPLICATION_STATE_ATTRIBUTE
 from .middleware import DiMiddleware, _compile_middlewares
 from .module import FastApiModule
 from .realtime.runtime import _FastApiRealtimeRuntime
@@ -174,6 +181,7 @@ class FastApiAdapter:
         app.state.python_ddd_framework_filters = self._filters
         app.state.python_ddd_framework_upload_limits = self._upload_limits
         app.state.dishka_container = self._application._container_for_integration()
+        setattr(app.state, _APPLICATION_STATE_ATTRIBUTE, self._application)
         app.user_middleware = [*middlewares, Middleware(_RequestTaskMiddleware)]
         app.add_middleware(_RequestContextMiddleware, application=self._application)
         _install_tracing(self._application, app)
@@ -191,17 +199,19 @@ class FastApiAdapter:
         try:
             self._validate_start_target(app)
         except BaseException:
-            if self._installed_app is app:
+            if self._installed_app is app and self._application.state is ApplicationState.COMPOSED:
                 try:
-                    if self._application.state is ApplicationState.COMPOSED:
-                        await self._application.stop()
+                    await self._application.stop()
                 finally:
-                    self._clear_container_bridge(app)
+                    self._clear_application_bridges(app)
             raise
         try:
             await self._application.start()
+        except InvalidApplicationStateError:
+            # Core 在取得转换 ownership 前拒绝重复/并发进入；不能撤销有效 lifespan 的桥。
+            raise
         except BaseException:
-            self._clear_container_bridge(app)
+            self._clear_application_bridges(app)
             raise
 
         try:
@@ -214,7 +224,7 @@ class FastApiAdapter:
                     await self._application.stop()
                 finally:
                     # Container 的 close 始终属于 Application；这里只撤销 Web 引用。
-                    self._clear_container_bridge(app)
+                    self._clear_application_bridges(app)
 
     def _validate_install_target(self, app: FastAPI) -> None:
         if not isinstance(app, FastAPI):
@@ -225,6 +235,8 @@ class FastApiAdapter:
             raise FastApiAdapterError("FastAPI instance already has a Python DDD Framework adapter")
         if hasattr(app.state, _DISHKA_CONTAINER_BRIDGE):
             raise FastApiAdapterError("FastAPI instance already has a Dishka container bridge")
+        if hasattr(app.state, _APPLICATION_STATE_ATTRIBUTE):
+            raise FastApiAdapterError("FastAPI instance already has an Application binding")
         if app.middleware_stack is not None:
             raise FastApiAdapterError("FastAPI middleware stack was already built before install")
         if self._application.state is not ApplicationState.COMPOSED:
@@ -239,6 +251,8 @@ class FastApiAdapter:
             )
         if getattr(app.state, _INSTALLATION_MARKER, None) != str(self._application.id):
             raise FastApiAdapterError("FastAPI installation marker changed before startup")
+        if getattr(app.state, _APPLICATION_STATE_ATTRIBUTE, None) is not self._application:
+            raise FastApiAdapterError("FastAPI Application binding changed before startup")
         if app.state.python_ddd_framework_filters != self._filters:
             raise FastApiAdapterError("HTTP filters changed after adapter installation")
         if tuple(app.user_middleware) != self._installed_middleware:
@@ -258,9 +272,10 @@ class FastApiAdapter:
             raise FastApiAdapterError("Dishka container bridge changed before startup")
 
     @staticmethod
-    def _clear_container_bridge(app: FastAPI) -> None:
-        if hasattr(app.state, _DISHKA_CONTAINER_BRIDGE):
-            delattr(app.state, _DISHKA_CONTAINER_BRIDGE)
+    def _clear_application_bridges(app: FastAPI) -> None:
+        for attribute in (_DISHKA_CONTAINER_BRIDGE, _APPLICATION_STATE_ATTRIBUTE):
+            if hasattr(app.state, attribute):
+                delattr(app.state, attribute)
 
     async def _shutdown_realtime(self) -> None:
         try:

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/fastapi/filters.py

@@ -87,7 +87,11 @@ async def _run_filters(
     context: ActionFilterContext,
     target: Callable[[], Awaitable[object]],
 ) -> object:
+    if not registrations:
+        return await target()
+
     async def invoke(index: int) -> object:
+        nonlocal invoke
         if index == len(registrations):
             return await target()
         instance = await container.get(registrations[index].filter_type)
@@ -97,7 +101,11 @@ async def _run_filters(
         finally:
             continuation.active = False
 
-    return await invoke(0)
+    try:
+        return await invoke(0)
+    finally:
+        # 保留原失效检查，只解除已结束 filter 链对请求执行状态的引用。
+        del invoke
 
 
 def _validate_filters(registrations: Sequence[ServiceFilter], container: AsyncContainer) -> None:

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/fastapi/health.py

@@ -2,10 +2,13 @@
 
 from __future__ import annotations
 
-from fastapi import APIRouter
+from fastapi import APIRouter, Request
 from starlette.responses import JSONResponse
 
 from ..application import Application
+from .errors import FastApiAdapterError
+
+_APPLICATION_STATE_ATTRIBUTE = "_python_ddd_framework_application"
 
 HEALTH_LIVE_PATH = "/health/live"
 HEALTH_READY_PATH = "/health/ready"
@@ -13,18 +16,24 @@ HEALTH_LIVE_OPERATION_ID = "python_ddd_framework_health_live"
 HEALTH_READY_OPERATION_ID = "python_ddd_framework_health_ready"
 
 
-def _create_health_router(application: Application) -> APIRouter:
-    router = APIRouter(tags=["health"])
+async def live() -> JSONResponse:
+    return JSONResponse(status_code=200, content={"status": "live"})
+
+
+async def ready(request: Request) -> JSONResponse:
+    # FastAPI 可长期缓存 callable；应用引用只在当前请求期间从实例状态取得。
+    application = getattr(request.app.state, _APPLICATION_STATE_ATTRIBUTE, None)
+    if not isinstance(application, Application):
+        raise FastApiAdapterError("FastAPI Application binding is unavailable")
+    is_ready = application.is_ready
+    return JSONResponse(
+        status_code=200 if is_ready else 503,
+        content={"status": "ready" if is_ready else "not_ready"},
+    )
 
-    async def live() -> JSONResponse:
-        return JSONResponse(status_code=200, content={"status": "live"})
 
-    async def ready() -> JSONResponse:
-        is_ready = application.is_ready
-        return JSONResponse(
-            status_code=200 if is_ready else 503,
-            content={"status": "ready" if is_ready else "not_ready"},
-        )
+def _create_health_router() -> APIRouter:
+    router = APIRouter(tags=["health"])
 
     router.add_api_route(
         HEALTH_LIVE_PATH,

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/fastapi/parameters.py

@@ -52,7 +52,8 @@ class _HttpParameterValidator:
         for name in self._validators:
             if name in actual:
                 arguments = _InvocationArguments((actual[name],), {})
-                arguments.mark_validated()
+                # HTTP Filter 会获得参数引用，始终保留独立于服务拦截链的改参快照。
+                arguments.mark_validated(capture_structure=True)
                 arguments.exposed = True
                 snapshots[name] = arguments
         return snapshots

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/fastapi/routing.py

@@ -135,7 +135,7 @@ def _build_route_plan(
             )
         )
 
-    health_router = _create_health_router(application)
+    health_router = _create_health_router()
     health_route_start = len(preview.routes)
     preview.include_router(health_router)
     health_candidates = _route_candidates(

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/callables.py

@@ -1,4 +1,4 @@
-"""调用签名的 DI 分类与原生注入包装；作用域创建仍归各运行入口。"""
+"""调用签名的 DI 分类与参数装配；实例解析和作用域仍归原生容器。"""
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ from types import MappingProxyType, SimpleNamespace
 from typing import Annotated, Any, TypeVar, get_args, get_origin, get_type_hints
 
 from dishka import AsyncContainer, BaseScope, DependencyKey
-from dishka.integrations.base import default_parse_dependency, wrap_injection
+from dishka.integrations.base import default_parse_dependency
 
 _R = TypeVar("_R")
 
@@ -124,22 +124,8 @@ class _CallablePlan:
         # 先验证全部业务实参，再解析任何依赖，避免错误调用触发 resource factory。
         bound = self.signature.bind(*args, **kwargs)
         bound.apply_defaults()
-
-        def parse(parameter: inspect.Parameter, hint: Any) -> DependencyKey | None:
-            return self.dependencies.get(parameter.name)
-
-        async def target(*args: object, **kwargs: object) -> _R:
-            return await function(*args, **kwargs)
-
-        # 原函数可能被多个 Application 共享；只给当前调用的 native wrapper 提供签名。
-        target.__signature__ = inspect.signature(function)  # type: ignore[attr-defined]
-        target.__annotations__ = {}
-        injected = wrap_injection(
-            func=target,
-            container_getter=lambda args, kwargs: container,
-            is_async=True,
-            parse_dependency=parse,
-        )
+        # 编译与执行之间可能改变签名元数据；无 DI 的快路径也保留原生边界检查。
+        signature = inspect.signature(function)
         # DI 参数从签名移除后位置会变化；普通业务参数按名称交给原函数。
         positional = tuple(
             bound.arguments[name]
@@ -151,7 +137,33 @@ class _CallablePlan:
             for name, value in bound.arguments.items()
             if self.signature.parameters[name].kind is not inspect.Parameter.POSITIONAL_ONLY
         }
-        return await injected(*positional, **named)
+        if not self.dependencies:
+            return await function(*positional, **named)
+
+        # 与原生注入一致，当前签名决定有效 DI 参数及解析顺序，分类仍来自编译计划。
+        dependencies = {
+            name: self.dependencies[name]
+            for name in signature.parameters
+            if name in self.dependencies
+        }
+        if dependencies:
+            # 保留原生注入剥离 DI 后的签名校验；畸形元数据须在资源获取前失败。
+            inspect.Signature(
+                parameters=[
+                    parameter.replace(annotation=Any)
+                    for name, parameter in signature.parameters.items()
+                    if name not in dependencies
+                ],
+                return_annotation=signature.return_annotation,
+            )
+            for name, dependency in dependencies.items():
+                # 原生常量直接提供值，不触发同 key 的 Provider；其余依赖仍由容器拥有。
+                named[name] = (
+                    dependency.get_const_value()
+                    if dependency.is_const()
+                    else await container.get(dependency.type_hint, dependency.component)
+                )
+        return await function(*positional, **named)
 
 
 async def _call_in_scope(

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/dispatcher.py

@@ -204,7 +204,8 @@ class _MethodDispatcher:
                         ),
                     ),
                 ) from None
-        arguments.mark_validated()
+        # 没有拦截器时参数不会被公开给扩展；有任一扩展就保留快照，覆盖后期首次改参。
+        arguments.mark_validated(capture_structure=any(pipeline.steps.values()))
 
     async def _write_audit(
         self,

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/execution.py

@@ -41,8 +41,13 @@ class _InterceptorPipeline:
         callback: Callable[[], Awaitable[object]],
     ) -> object:
         registrations = self.steps[stage]
+        # 空扩展链仍执行原阶段逻辑；不创建自引用的递归闭包，避免把回调
+        # 及其 scope 状态留到循环 GC 才释放。
+        if not registrations:
+            return await callback()
 
         async def proceed(index: int) -> object:
+            nonlocal proceed
             if index == len(registrations):
                 return await callback()
             interceptor = await container.get(registrations[index].interceptor)
@@ -52,7 +57,11 @@ class _InterceptorPipeline:
             finally:
                 invocation._close()
 
-        return await proceed(0)
+        try:
+            return await proceed(0)
+        finally:
+            # continuation 已失效；解除递归 cell，避免旧 invocation 继续持有执行回调。
+            del proceed
 
 
 @dataclass(slots=True)
@@ -80,12 +89,14 @@ class _InvocationArguments:
             or (self.exposed and self._structure([]) != self._validated_structure)
         )
 
-    def mark_validated(self) -> None:
+    def mark_validated(self, *, capture_structure: bool) -> None:
         # 只在验证成功后记录规范化结果；快照与调用共同归属当前 pipeline。
         self._validated_args = self.args
         self._validated_kwargs = dict(self.kwargs)
         self._validated_nodes = []
-        self._validated_structure = self._structure(self._validated_nodes)
+        self._validated_structure = (
+            self._structure(self._validated_nodes) if capture_structure else None
+        )
         # 不重置 exposed：早期扩展可能保留参数引用，并在后续阶段原地修改同一对象。
 
     def _structure(self, retained: list[object]) -> object:

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/interception.py

@@ -220,15 +220,24 @@ class _EntryInterceptionCatalog:
             )
 
         stages = tuple(
-            stage for stage in InterceptionStage if stage is not InterceptionStage.METHOD
+            stage
+            for stage in InterceptionStage
+            if stage is not InterceptionStage.METHOD and entry.steps[stage]
         )
+        if not stages:
+            return await boundary()
 
         async def run(index: int) -> object:
+            nonlocal run
             if index == len(stages):
                 return await boundary()
             return await pipeline.run(stages[index], container, lambda: run(index + 1))
 
-        return await run(0)
+        try:
+            return await run(0)
+        finally:
+            # 各阶段已退出；不让递归编排额外保留参数、scope 和事务边界回调。
+            del run
 
 
 async def _invoke_managed_entry(

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/managed_services.py

@@ -25,6 +25,7 @@ from ..unit_of_work.options import (
 )
 from .managed_proxy import _ManagedServiceProxy
 from .methods import (
+    _class_policy_fingerprint,
     _compile_method,
     _CompiledMethod,
     _policy_fingerprint,
@@ -42,25 +43,41 @@ def _managed_names(candidate: type[object]) -> tuple[str, ...]:
     )
     names: list[str] = []
     # 类级标记覆盖公开方法；显式方法标记即使位于非公开方法也必须接受形态校验。
-    members = {
-        name: value for base in reversed(candidate.__mro__) for name, value in vars(base).items()
-    }
-    public = _public_method_names(candidate, is_contract=False)
+    members: dict[str, object] = {}
+    for base in reversed(candidate.__mro__):
+        members.update(vars(base))
+    # 原生 object 成员不携带策略；按身份移除未覆盖项，保留用户声明及其顺序。
+    for name, value in vars(object).items():
+        if name in members and members[name] is value:
+            del members[name]
+    public = set(_public_method_names(candidate, is_contract=False)) if class_marked else set()
     for name, value in members.items():
-        targets = (
-            (value, value.__func__) if isinstance(value, (staticmethod, classmethod)) else (value,)
-        )
-        marked = any(hasattr(target, attribute) for target in targets for attribute in attributes)
-        if marked or (class_marked and name in public):
+        # 类标记已覆盖公开方法时，无需再逐属性判断该方法是否显式标记。
+        marked = name in public
+        if not marked:
+            targets = (
+                (value, value.__func__)
+                if isinstance(value, (staticmethod, classmethod))
+                else (value,)
+            )
+            marked = any(
+                hasattr(target, attribute) for target in targets for attribute in attributes
+            )
+        if marked:
             _require_async_instance_method(candidate, name, role="managed service")
             names.append(name)
     return tuple(names)
 
 
 def _assert_methods(candidate: type[object], methods: Mapping[str, _CompiledMethod]) -> None:
-    if tuple(methods) != _managed_names(candidate) or any(
+    names = _managed_names(candidate)
+    # 每次解析仍读取当前声明；同一类的策略只在本次同步核对内共用，
+    # 不跨请求缓存，后续类级/继承策略修改仍会与编译值发生差异。
+    class_policy = _class_policy_fingerprint(candidate)
+    if tuple(methods) != names or any(
         getattr(candidate, name) is not method.implementation_method
-        or _policy_fingerprint(candidate, method.implementation_method) != method.policy_fingerprint
+        or _policy_fingerprint(candidate, method.implementation_method, class_policy=class_policy)
+        != method.policy_fingerprint
         for name, method in methods.items()
     ):
         raise ApplicationServiceDefinitionError(

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/invocation/methods.py

@@ -3,9 +3,10 @@
 from __future__ import annotations
 
 import inspect
+import keyword
 from collections.abc import Awaitable, Callable, Mapping
 from dataclasses import dataclass, field, replace
-from types import MappingProxyType
+from types import FunctionType, MappingProxyType
 from typing import Any, cast, get_type_hints
 
 from pydantic import ConfigDict, TypeAdapter, validate_call
@@ -199,15 +200,36 @@ _POLICY_ATTRIBUTES = (
     _AUDITING_ATTRIBUTE,
 )
 
+_PolicyRows = tuple[tuple[object, ...], ...]
+_ClassPolicyFingerprint = tuple[bool, _PolicyRows]
 
-def _policy_fingerprint(implementation: type[object], method: object) -> tuple[object, ...]:
+
+def _policy_values(target: object) -> _PolicyRows:
+    namespace = vars(target)
+    if any(attribute in namespace for attribute in _POLICY_ATTRIBUTES):
+        return (tuple(namespace.get(attribute) for attribute in _POLICY_ATTRIBUTES),)
+    return ()
+
+
+def _class_policy_fingerprint(implementation: type[object]) -> _ClassPolicyFingerprint:
     return (
         issubclass(implementation, ValidationEnabled),
-        tuple(
-            tuple(vars(target).get(attribute) for attribute in _POLICY_ATTRIBUTES)
-            for target in (*implementation.__mro__, method)
-            if any(attribute in vars(target) for attribute in _POLICY_ATTRIBUTES)
-        ),
+        tuple(row for target in implementation.__mro__ for row in _policy_values(target)),
+    )
+
+
+def _policy_fingerprint(
+    implementation: type[object],
+    method: object,
+    *,
+    class_policy: _ClassPolicyFingerprint | None = None,
+) -> tuple[object, ...]:
+    validation, rows = (
+        _class_policy_fingerprint(implementation) if class_policy is None else class_policy
+    )
+    return (
+        validation,
+        (*rows, *_policy_values(method)),
     )
 
 
@@ -278,11 +300,7 @@ def _require_async_instance_method(
             symbol=symbol,
             reason=f"public {role} methods must use async def",
         )
-    parameters = tuple(inspect.signature(method).parameters.values())
-    if not parameters or parameters[0].kind not in (
-        inspect.Parameter.POSITIONAL_ONLY,
-        inspect.Parameter.POSITIONAL_OR_KEYWORD,
-    ):
+    if not _has_positional_receiver(method):
         # Catalog 与 HTTP generator 都会剥离 receiver；缺少首个位置参数时不能伪装成实例方法。
         raise ApplicationServiceDefinitionError(
             symbol=symbol,
@@ -291,6 +309,39 @@ def _require_async_instance_method(
     return cast(Callable[..., Awaitable[object]], method)
 
 
+def _has_positional_receiver(method: FunctionType) -> bool:
+    # 普通 Python 函数的位置参数由 code 直接声明；完整签名/类型仍在编译时解析。
+    # 包装、自定义签名和惰性注解沿用 inspect，不能从包装函数的 *args 推断 receiver。
+    code = method.__code__
+    count = code.co_argcount + code.co_kwonlyargcount
+    count += bool(code.co_flags & inspect.CO_VARARGS) + bool(code.co_flags & inspect.CO_VARKEYWORDS)
+    names = code.co_varnames[:count]
+    special = any(
+        hasattr(method, name)
+        for name in (
+            "__wrapped__",
+            "__signature__",
+            "__text_signature__",
+            "_partialmethod",
+            "__partialmethod__",
+            "__annotate__",
+        )
+    )
+    if (
+        special
+        or len(set(names)) != len(names)
+        or any(not name.isidentifier() or keyword.iskeyword(name) for name in names)
+        or len(method.__defaults__ or ()) > code.co_argcount
+    ):
+        # 手工替换 code 的非法参数及特殊声明仍由原生 Signature 报告，不能静默放行。
+        parameters = tuple(inspect.signature(method).parameters.values())
+        return bool(parameters) and parameters[0].kind in (
+            inspect.Parameter.POSITIONAL_ONLY,
+            inspect.Parameter.POSITIONAL_OR_KEYWORD,
+        )
+    return code.co_argcount > 0
+
+
 def _resolved_signature(
     method: Callable[..., Awaitable[object]],
 ) -> tuple[inspect.Signature, dict[str, object]]:

{python_ddd_framework-0.7.0 → python_ddd_framework-0.7.2}/src/python_ddd_framework/sqlalchemy/migration.py

@@ -332,6 +332,11 @@ def _validate_revision_graph(
     # walk_revisions 强制 Alembic 在任何 engine 创建前加载并校验组合 graph/depends_on。
     script = ScriptDirectory.from_config(config)
     revisions = tuple(script.walk_revisions())
+    empty_model_sources = {
+        (item.owner, item.registration.branch_label, item.migration_path)
+        for item in models.for_connection(connection_name)
+        if not item.registration.metadata.tables
+    }
     for source in migration_sources:
         if source.extension is not None:
             _validate_extension_prerequisites(models, connection_name, source, script)
@@ -341,7 +346,18 @@ def _validate_revision_graph(
             if Path(revision.path).resolve().parent == source.migration_path
         )
         if not owned_revisions:
-            if (owner is not None and source.owner != owner) or allow_empty:
+            # 仅全局操作豁免纯 ORM 骨架的缺失 revision；不跳过图或数据库 heads 检查。
+            # 同一 owner 可贡献多个来源，判定必须限定当前 connection 与具体分支/目录。
+            if (
+                (owner is not None and source.owner != owner)
+                or allow_empty
+                or (
+                    owner is None
+                    and source.extension is None
+                    and (source.owner, source.branch_label, source.migration_path)
+                    in empty_model_sources
+                )
+            ):
                 continue
             raise SqlAlchemyModelRegistrationError(
                 owner=str(source.owner),