wanwu/wwjcloud-nest-v1
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(lang): unify external terminology from i18n to lang in readiness and v1 guide

Browse Source
This commit is contained in:
wanwujie
2025-10-20 08:39:59 +08:00
parent f3edfd0407
commit 5fafaa9135
3 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
wwjcloud-nest-v1/docs/V1-GUIDE.md
View File

@@ -19,7 +19,7 @@
- 指标暴露：`GET /api/metrics`（`PROMETHEUS_ENABLED=true`），含 `http_requests_total`、`ai_events_total` 等。 - 指标暴露：`GET /api/metrics`（`PROMETHEUS_ENABLED=true`），含 `http_requests_total`、`ai_events_total` 等。
- 弹性策略：`ResilienceService` 支持重试/超时/断路器，`HttpClientService.getWithFallback` 已集成。 - 弹性策略：`ResilienceService` 支持重试/超时/断路器，`HttpClientService.getWithFallback` 已集成。
- DI 导入规范：Boot 层提供与导出，业务按类型消费，不重复定义令牌/别名。 - DI 导入规范：Boot 层提供与导出，业务按类型消费，不重复定义令牌/别名。
- I18N：`BootLangModule`（底层为 `BootI18nModule`）全局导入，`apps/api/src/lang` 存放多语言资源，拦截器/过滤器使用 i18n 翻译。 - Lang：`BootLangModule`（底层为 `BootI18nModule`）全局导入，`apps/api/src/lang` 存放多语言资源，拦截器/过滤器使用 i18n 翻译。
## AI 自愈系统（恢复与守卫） ## AI 自愈系统（恢复与守卫）
- 控制器与路由（受 `RateLimitGuard`，开发期可 `@Public()`）： - 控制器与路由（受 `RateLimitGuard`，开发期可 `@Public()`）：
@@ -50,7 +50,7 @@
- `AUTH_ENABLED`、`RBAC_ENABLED`：鉴权与权限控制。 - `AUTH_ENABLED`、`RBAC_ENABLED`：鉴权与权限控制。
- 队列驱动：`QUEUE_DRIVER=memory|redis|kafka`；Redis：`REDIS_ENABLED/REDIS_*`；Kafka：`KAFKA_ENABLED/KAFKA_*`。 - 队列驱动：`QUEUE_DRIVER=memory|redis|kafka`；Redis：`REDIS_ENABLED/REDIS_*`；Kafka：`KAFKA_ENABLED/KAFKA_*`。
- 弹性与外部请求：`HTTP_CLIENT_TIMEOUT_MS`、`RESILIENCE_*`（重试/超时/断路器）。 - 弹性与外部请求：`HTTP_CLIENT_TIMEOUT_MS`、`RESILIENCE_*`（重试/超时/断路器）。
- I18N：`OTEL/语言`无强制依赖；语言资源位于 `apps/api/src/lang`。 - Lang：`OTEL/语言`无强制依赖；语言资源位于 `apps/api/src/lang`。
## 自动 PHP 脚本迁移工具 ## 自动 PHP 脚本迁移工具
- 位置：`tools-v1/php-tools/` 与 `tools-v1/scripts/`。 - 位置：`tools-v1/php-tools/` 与 `tools-v1/scripts/`。

2
wwjcloud-nest-v1/docs/V11-AI-READINESS.md
View File

@@ -36,7 +36,7 @@
- `cache`：`CacheReadyService` 在 Redis 禁用时回退为 `ready`，启用时根据 `PING` 成功与否上报状态。 - `cache`：`CacheReadyService` 在 Redis 禁用时回退为 `ready`，启用时根据 `PING` 成功与否上报状态。
- `auth/rbac`：`AuthReadyService` 基于 `AUTH_ENABLED` 与 `RBAC_ENABLED` 分别上报 `ready/unavailable`。 - `auth/rbac`：`AuthReadyService` 基于 `AUTH_ENABLED` 与 `RBAC_ENABLED` 分别上报 `ready/unavailable`。
- `queue`：`QueueReadyService` 依据 `QUEUE_ENABLED` 与驱动类型（`bullmq/kafka` → `ready`，未知 → `unavailable`）。 - `queue`：`QueueReadyService` 依据 `QUEUE_ENABLED` 与驱动类型（`bullmq/kafka` → `ready`，未知 → `unavailable`）。
- `i18n`、`metrics`：分别在初始化时根据语言目录存在与 `PROMETHEUS_ENABLED` 开关上报状态。 - `lang`、`metrics`：分别在初始化时根据语言目录存在与 `PROMETHEUS_ENABLED` 开关上报状态。
## 测试覆盖 ## 测试覆盖
- 位置：`src/ai-layer/*.spec.ts`、`src/boot-layer/*.spec.ts` - 位置：`src/ai-layer/*.spec.ts`、`src/boot-layer/*.spec.ts`

2
wwjcloud-nest-v1/docs/V11-BOOT-READINESS.md
View File

@@ -13,7 +13,7 @@
- Metrics 就绪上报 - Metrics 就绪上报
- 文件：`libs/wwjcloud-boot/src/infra/metrics/metrics.service.ts` - 文件：`libs/wwjcloud-boot/src/infra/metrics/metrics.service.ts`
- 变更：注入 `EventBus`，实现 `onModuleInit()`，根据 `PROMETHEUS_ENABLED` 上报 `ready/unavailable`。 - 变更：注入 `EventBus`，实现 `onModuleInit()`，根据 `PROMETHEUS_ENABLED` 上报 `ready/unavailable`。
- I18n 就绪上报 - Lang 就绪上报
- 文件：`libs/wwjcloud-boot/src/infra/lang/lang-ready.service.ts`（新增） - 文件：`libs/wwjcloud-boot/src/infra/lang/lang-ready.service.ts`（新增）
- 变更：在 `onModuleInit()` 检查语言目录 `apps/api/src/lang` 是否存在，上报 `ready/unavailable`。 - 变更：在 `onModuleInit()` 检查语言目录 `apps/api/src/lang` 是否存在，上报 `ready/unavailable`。
- 注册：`libs/wwjcloud-boot/src/infra/lang/boot-i18n.module.ts` 中新增 `providers: [LangReadyService]`。 - 注册：`libs/wwjcloud-boot/src/infra/lang/boot-i18n.module.ts` 中新增 `providers: [LangReadyService]`。