From 4aed276b8ba186276181ef7656199731fdf86465 Mon Sep 17 00:00:00 2001 From: MSuMshk <2039814060@qq.com> Date: Fri, 12 Dec 2025 09:21:10 +0800 Subject: [PATCH] =?UTF-8?q?docs:=E5=BE=85=E5=A4=84=E7=90=86=E6=B3=A8?= =?UTF-8?q?=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- MISSING_XML_DOCS.md | 101 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 MISSING_XML_DOCS.md diff --git a/MISSING_XML_DOCS.md b/MISSING_XML_DOCS.md new file mode 100644 index 0000000..5927194 --- /dev/null +++ b/MISSING_XML_DOCS.md @@ -0,0 +1,101 @@ +# 缺失 XML 文档注释清单（自动扫描） + +- 统计时间：执行脚本时基于仓库当前状态。 +- 范围：`src` 下 898 个 `.cs` 文件。 +- 发现未紧邻 `///` 文档注释的文件：93 个。 +- 分层分布：Application 64，Infrastructure 19，Core 6，Modules 4。 + +## 详细清单（路径:行号） +- src/Application/TakeoutSaaS.Application/App/Merchants/Dto/MerchantAuditLogDto.cs:13 +- src/Application/TakeoutSaaS.Application/App/Merchants/Dto/MerchantContractDto.cs:13 +- src/Application/TakeoutSaaS.Application/App/Merchants/Dto/MerchantDocumentDto.cs:13 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/AddMerchantDocumentCommandHandler.cs:25 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/CreateMerchantCategoryCommandHandler.cs:20 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/CreateMerchantContractCommandHandler.cs:25 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/DeleteMerchantCategoryCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/GetMerchantAuditLogsQueryHandler.cs:18 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/GetMerchantCategoriesQueryHandler.cs:16 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/GetMerchantContractsQueryHandler.cs:19 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/GetMerchantDetailQueryHandler.cs:19 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/GetMerchantDocumentsQueryHandler.cs:19 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/ListMerchantCategoriesQueryHandler.cs:17 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/ReorderMerchantCategoriesCommandHandler.cs:18 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/ReviewMerchantCommandHandler.cs:23 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/ReviewMerchantDocumentCommandHandler.cs:23 +- src/Application/TakeoutSaaS.Application/App/Merchants/Handlers/UpdateMerchantContractStatusCommandHandler.cs:23 +- src/Application/TakeoutSaaS.Application/App/Merchants/MerchantMapping.cs:11 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/CreateTenantAnnouncementCommandHandler.cs:17 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/CreateTenantBillingCommandHandler.cs:17 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/DeleteTenantAnnouncementCommandHandler.cs:13 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/GetTenantAnnouncementQueryHandler.cs:18 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/GetTenantBillQueryHandler.cs:14 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/MarkTenantAnnouncementReadCommandHandler.cs:19 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/MarkTenantBillingPaidCommandHandler.cs:15 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/MarkTenantNotificationReadCommandHandler.cs:14 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/SearchTenantAnnouncementsQueryHandler.cs:19 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/SearchTenantBillsQueryHandler.cs:15 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/SearchTenantNotificationsQueryHandler.cs:15 +- src/Application/TakeoutSaaS.Application/App/Tenants/Handlers/UpdateTenantAnnouncementCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/App/Tenants/TenantMapping.cs:11 +- src/Application/TakeoutSaaS.Application/Dictionary/Models/DictionaryGroupDto.cs:13 +- src/Application/TakeoutSaaS.Application/Dictionary/Models/DictionaryItemDto.cs:12 +- src/Application/TakeoutSaaS.Application/Dictionary/Services/DictionaryAppService.cs:23 +- src/Application/TakeoutSaaS.Application/Identity/Abstractions/IWeChatAuthService.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Commands/AssignUserRolesCommand.cs:10 +- src/Application/TakeoutSaaS.Application/Identity/Commands/BindRolePermissionsCommand.cs:10 +- src/Application/TakeoutSaaS.Application/Identity/Commands/CreateMenuCommand.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Commands/CreatePermissionCommand.cs:11 +- src/Application/TakeoutSaaS.Application/Identity/Commands/CreateRoleCommand.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Commands/DeleteMenuCommand.cs:10 +- src/Application/TakeoutSaaS.Application/Identity/Commands/DeletePermissionCommand.cs:10 +- src/Application/TakeoutSaaS.Application/Identity/Commands/DeleteRoleCommand.cs:10 +- src/Application/TakeoutSaaS.Application/Identity/Commands/UpdateMenuCommand.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Commands/UpdatePermissionCommand.cs:11 +- src/Application/TakeoutSaaS.Application/Identity/Commands/UpdateRoleCommand.cs:11 +- src/Application/TakeoutSaaS.Application/Identity/Contracts/AdminLoginRequest.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Contracts/RefreshTokenRequest.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Contracts/WeChatLoginRequest.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/AssignUserRolesCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/BindRolePermissionsCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/CreatePermissionCommandHandler.cs:18 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/CreateRoleCommandHandler.cs:20 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/DeletePermissionCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/DeleteRoleCommandHandler.cs:16 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/DeleteRoleTemplateCommandHandler.cs:13 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/MenuMapper.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/PermissionTreeQueryHandler.cs:17 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/SearchPermissionsQueryHandler.cs:18 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/SearchRolesQueryHandler.cs:18 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/UpdatePermissionCommandHandler.cs:17 +- src/Application/TakeoutSaaS.Application/Identity/Handlers/UpdateRoleCommandHandler.cs:17 +- src/Application/TakeoutSaaS.Application/Identity/Queries/SearchPermissionsQuery.cs:12 +- src/Application/TakeoutSaaS.Application/Identity/Queries/SearchRolesQuery.cs:17 +- src/Core/TakeoutSaaS.Shared.Web/Filters/ApiResponseResultFilter.cs:15 +- src/Core/TakeoutSaaS.Shared.Web/Filters/ValidateModelAttribute.cs:13 +- src/Core/TakeoutSaaS.Shared.Web/Middleware/CorrelationIdMiddleware.cs:18 +- src/Core/TakeoutSaaS.Shared.Web/Middleware/ExceptionHandlingMiddleware.cs:34 +- src/Core/TakeoutSaaS.Shared.Web/Middleware/RequestLoggingMiddleware.cs:13 +- src/Core/TakeoutSaaS.Shared.Web/Middleware/SecurityHeadersMiddleware.cs:10 +- src/Infrastructure/TakeoutSaaS.Infrastructure/App/Persistence/TakeoutAppDbContext.cs:39 +- src/Infrastructure/TakeoutSaaS.Infrastructure/App/Persistence/TakeoutAppDesignTimeDbContextFactory.cs:15 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Common/Persistence/DesignTime/DesignTimeDbContextFactoryBase.cs:30 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Common/Persistence/ModelBuilderCommentExtensions.cs:14 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Dictionary/Persistence/DictionaryDesignTimeDbContextFactory.cs:15 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Dictionary/Repositories/EfDictionaryRepository.cs:14 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Dictionary/Services/DistributedDictionaryCache.cs:18 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfIdentityUserRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfMiniUserRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfPermissionRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfRolePermissionRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfRoleRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfRoleTemplateRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/EfUserRoleRepository.cs:12 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/IdentityDataSeeder.cs:25 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Persistence/IdentityDesignTimeDbContextFactory.cs:15 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Services/RedisLoginRateLimiter.cs:17 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Services/RedisRefreshTokenStore.cs:19 +- src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Services/WeChatAuthService.cs:18 +- src/Modules/TakeoutSaaS.Module.Authorization/Attributes/PermissionAuthorizeAttribute.cs:12 +- src/Modules/TakeoutSaaS.Module.Authorization/Policies/PermissionAuthorizationHandler.cs:10 +- src/Modules/TakeoutSaaS.Module.Authorization/Policies/PermissionAuthorizationPolicyProvider.cs:11 +- src/Modules/TakeoutSaaS.Module.Tenancy/TenantContextAccessor.cs:31