@umacloud/knowledge 1.0.16 → 1.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/00-governance/governance-capabilities.md +1 -1
  2. package/00-governance/knowledge-map.md +4 -6
  3. package/ai/01-standards/app-runtime-model-configurable.md +76 -0
  4. package/ai/agent-evaluation-benchmark.md +4 -6
  5. package/ai/ai-agent-memory-context-management.md +4 -6
  6. package/ai/ai-cost-capacity-optimization-playbook.md +4 -6
  7. package/ai/ai-data-security-and-compliance-playbook.md +4 -6
  8. package/ai/ai-domain-index-and-checklist.md +4 -6
  9. package/ai/ai-governance-maturity-model.md +4 -6
  10. package/ai/ai-model-selection-and-routing-strategy.md +4 -6
  11. package/ai/ai-observability-and-oncall-runbook.md +4 -6
  12. package/ai/ai-rag-engineering-playbook.md +4 -6
  13. package/ai/ai-red-team-and-safety-evaluation.md +4 -6
  14. package/ai/ai-release-readiness-and-rollback-gate.md +4 -6
  15. package/ai/llm-agent-engineering-deep-dive.md +4 -6
  16. package/ai/prompt-and-tool-guardrails.md +4 -6
  17. package/architecture/02-playbooks/migration-playbook.md +0 -4
  18. package/architecture/02-playbooks/system-design-playbook.md +0 -4
  19. package/architecture/adr-template-and-examples.md +4 -6
  20. package/architecture/api-gateway-deep-dive.md +1 -1
  21. package/architecture/distributed-transactions.md +1 -1
  22. package/architecture/microservices-complete.md +1 -1
  23. package/architecture/service-governance.md +1 -1
  24. package/architecture/system-architecture-deep-dive.md +4 -6
  25. package/backend/01-standards/cjk-in-exports-and-documents.md +107 -0
  26. package/backend/01-standards/django-complete.md +2 -2
  27. package/backend/01-standards/nestjs-complete.md +23 -23
  28. package/cicd/cicd-blueprint-deep-dive.md +4 -6
  29. package/cloud-native/01-standards/container-security.md +0 -4
  30. package/cloud-native/01-standards/kubernetes-complete.md +0 -4
  31. package/cloud-native/02-playbooks/gitops-with-argocd.md +0 -4
  32. package/cloud-native/02-playbooks/k8s-troubleshooting-playbook.md +2 -6
  33. package/cloud-native/02-playbooks/multicloud-governance.md +0 -4
  34. package/cloud-native/02-playbooks/serverless-patterns.md +0 -4
  35. package/cloud-native/02-playbooks/service-mesh-playbook.md +0 -4
  36. package/cloud-native/03-checklists/container-security-checklist.md +0 -4
  37. package/cloud-native/03-checklists/k8s-production-readiness-checklist.md +0 -4
  38. package/cloud-native/04-antipatterns/container-antipatterns.md +0 -4
  39. package/cloud-native/04-antipatterns/k8s-antipatterns.md +0 -4
  40. package/cloud-native/05-cases/case-k8s-migration.md +0 -4
  41. package/cloud-native/05-cases/case-k8s-scaling.md +0 -4
  42. package/cloud-native/05-cases/case-k8s-security-incident.md +0 -4
  43. package/cloud-native/06-glossary/cloud-native-glossary.md +0 -4
  44. package/data/01-standards/elasticsearch-complete.md +2 -2
  45. package/data/01-standards/postgresql-complete.md +8 -8
  46. package/data/01-standards/redis-complete.md +11 -11
  47. package/data/data-governance-and-modeling-deep-dive.md +4 -6
  48. package/data-engineering/01-standards/kafka-complete.md +22 -22
  49. package/design/ui-full-lifecycle-cross-platform-playbook.md +1 -1
  50. package/design/ux-system-deep-dive.md +4 -6
  51. package/design-systems/00-craft-rules.md +1 -1
  52. package/design-systems/bold-geometric.md +1 -1
  53. package/design-systems/brutalist-bold.md +1 -1
  54. package/design-systems/editorial-clean.md +1 -1
  55. package/design-systems/glass-aurora.md +1 -1
  56. package/design-systems/modern-minimal.md +1 -1
  57. package/design-systems/premium-luxury.md +1 -1
  58. package/design-systems/soft-warm.md +1 -1
  59. package/design-systems/tech-utility.md +1 -1
  60. package/development/00-governance/document-template.md +3 -3
  61. package/development/01-standards/golang-complete.md +2 -2
  62. package/development/01-standards/python-design-patterns.md +2 -2
  63. package/development/01-standards/typescript-advanced-types.md +2 -2
  64. package/development/09-maturity/quarterly-audit-template.md +3 -5
  65. package/development/11-ui-excellence/ui-aesthetic-system.md +3 -5
  66. package/development/13-implementation-assets/knowledge-gates-execution.md +3 -5
  67. package/development/api-contract-and-versioning-guide.md +4 -6
  68. package/development/api-governance-complete.md +4 -6
  69. package/development/backend-engineering-complete.md +4 -6
  70. package/development/concurrency-reliability-complete.md +4 -6
  71. package/development/database-engineering-complete.md +4 -6
  72. package/development/engineering-effectiveness-complete.md +4 -6
  73. package/development/engineering-standards-deep-dive.md +4 -6
  74. package/development/frontend-engineering-complete.md +4 -6
  75. package/development/performance-capacity-complete.md +4 -6
  76. package/development/refactor-migration-complete.md +4 -6
  77. package/development/refactoring-and-techdebt-playbook.md +4 -6
  78. package/development/security-in-development-complete.md +4 -6
  79. package/devops/01-standards/docker-complete.md +2 -2
  80. package/devops/01-standards/terraform-complete.md +3 -3
  81. package/frontend/01-standards/i18n-and-localization.md +1 -1
  82. package/frontend/01-standards/react-hooks-complete.md +33 -33
  83. package/frontend/01-standards/vue3-complete.md +2 -2
  84. package/high-quality-engineering-playbook.md +4 -6
  85. package/incident/02-playbooks/chaos-engineering-playbook.md +0 -4
  86. package/incident/postmortem-and-response-deep-dive.md +4 -6
  87. package/mobile/01-standards/flutter-complete.md +2 -7
  88. package/mobile/01-standards/react-native-complete.md +2 -7
  89. package/mobile/02-playbooks/mobile-performance.md +2 -8
  90. package/mobile/03-checklists/mobile-release-checklist.md +2 -4
  91. package/mobile/04-antipatterns/mobile-antipatterns.md +2 -4
  92. package/operations/01-standards/prometheus-monitoring-complete.md +2 -2
  93. package/operations/aiops-anomaly-detection.md +4 -8
  94. package/operations/capacity-planning.md +4 -8
  95. package/operations/chaos-engineering.md +4 -8
  96. package/operations/incident-command-system.md +4 -6
  97. package/operations/observability-complete.md +4 -8
  98. package/operations/slo-sli-playbook.md +4 -8
  99. package/operations/sre-operations-deep-dive.md +4 -6
  100. package/package.json +1 -1
  101. package/product/feature-prioritization-framework.md +97 -35
  102. package/product/kpi-and-metric-tree.md +69 -26
  103. package/product/product-discovery-and-prd-deep-dive.md +4 -6
  104. package/security/01-standards/owasp-top10-complete.md +2 -2
  105. package/security/02-playbooks/incident-response-security-playbook.md +0 -4
  106. package/security/02-playbooks/penetration-testing-playbook.md +0 -4
  107. package/security/compliance-automation.md +1 -1
  108. package/security/container-security.md +1 -1
  109. package/security/devsecops-complete.md +1 -1
  110. package/security/sast-dast-sca.md +1 -1
  111. package/security/secrets-management.md +1 -1
  112. package/security/security-architecture-deep-dive.md +4 -6
  113. package/security/threat-modeling-stride-playbook.md +4 -6
  114. package/seed-templates/auth-system.md +1 -1
  115. package/seed-templates/blog-content.md +1 -1
  116. package/seed-templates/dashboard.md +1 -1
  117. package/seed-templates/docs-site.md +1 -1
  118. package/seed-templates/e-commerce.md +1 -1
  119. package/seed-templates/saas-landing.md +1 -1
  120. package/seed-templates/settings-page.md +1 -1
  121. package/testing/02-playbooks/e2e-testing-playbook.md +0 -4
  122. package/testing/risk-based-test-matrix.md +75 -25
  123. package/testing/testing-strategy-deep-dive.md +4 -6
@@ -5,8 +5,8 @@ domain: backend
5
5
  category: 01-standards
6
6
  difficulty: intermediate
7
7
  tags: [backend, complete, nestjs, websocket, 依赖注入系统, 微服务, 快速开始, 数据库集成]
8
- quality_score: 70
9
- last_updated: 2026-06-15
8
+ quality_score: 90
9
+ last_updated: 2026-06-29
10
10
  ---
11
11
  # NestJS 完整指南
12
12
 
@@ -31,14 +31,14 @@ NestJS 是一个用于构建高效、可扩展 Node.js 服务端应用的渐进
31
31
 
32
32
  ### 何时选择 NestJS
33
33
 
34
- **大型团队协作**: 强约定 + 模块化架构减少代码风格分歧
35
- **微服务体系**: 内置 Transport 层,支持 Redis/Kafka/gRPC/NATS/MQTT
36
- **企业级后端**: 完善的认证/授权/缓存/队列/日志/健康检查生态
37
- **全栈 TypeScript**: 前后端共享类型定义,配合 Monorepo 高效开发
38
- **需要长期维护的系统**: 模块边界清晰,重构成本低
34
+ [推荐] **大型团队协作**: 强约定 + 模块化架构减少代码风格分歧
35
+ [推荐] **微服务体系**: 内置 Transport 层,支持 Redis/Kafka/gRPC/NATS/MQTT
36
+ [推荐] **企业级后端**: 完善的认证/授权/缓存/队列/日志/健康检查生态
37
+ [推荐] **全栈 TypeScript**: 前后端共享类型定义,配合 Monorepo 高效开发
38
+ [推荐] **需要长期维护的系统**: 模块边界清晰,重构成本低
39
39
 
40
- **简单 API / 原型验证**: 过度工程化,Express/Fastify 更轻便
41
- **极致性能场景**: 框架层带来一定开销,考虑 Fastify 或 Go
40
+ [避免] **简单 API / 原型验证**: 过度工程化,Express/Fastify 更轻便
41
+ [避免] **极致性能场景**: 框架层带来一定开销,考虑 Fastify 或 Go
42
42
 
43
43
  ---
44
44
 
@@ -1978,13 +1978,13 @@ export class AppModule {}
1978
1978
  ### 1. 循环依赖导致 undefined
1979
1979
 
1980
1980
  ```typescript
1981
- // 错误:A 和 B 互相注入,其中一个会是 undefined
1981
+ // [避免] 错误:A 和 B 互相注入,其中一个会是 undefined
1982
1982
  @Injectable()
1983
1983
  export class ServiceA {
1984
1984
  constructor(private serviceB: ServiceB) {} // 可能是 undefined
1985
1985
  }
1986
1986
 
1987
- // 解决:使用 forwardRef 或提取公共逻辑
1987
+ // [推荐] 解决:使用 forwardRef 或提取公共逻辑
1988
1988
  @Injectable()
1989
1989
  export class ServiceA {
1990
1990
  constructor(
@@ -1996,11 +1996,11 @@ export class ServiceA {
1996
1996
  ### 2. 请求作用域的性能问题
1997
1997
 
1998
1998
  ```typescript
1999
- // 不当:对所有服务使用请求作用域
1999
+ // [避免] 不当:对所有服务使用请求作用域
2000
2000
  @Injectable({ scope: Scope.REQUEST })
2001
2001
  export class HeavyService {} // 每次请求都创建新实例
2002
2002
 
2003
- // 正确:仅在确实需要请求上下文的服务上使用
2003
+ // [推荐] 正确:仅在确实需要请求上下文的服务上使用
2004
2004
  @Injectable()
2005
2005
  export class HeavyService {
2006
2006
  doWork(requestContext: RequestContext) {
@@ -2012,14 +2012,14 @@ export class HeavyService {
2012
2012
  ### 3. 忘记导出 Provider
2013
2013
 
2014
2014
  ```typescript
2015
- // 错误:其他模块无法注入 UsersService
2015
+ // [避免] 错误:其他模块无法注入 UsersService
2016
2016
  @Module({
2017
2017
  providers: [UsersService],
2018
2018
  // 缺少 exports
2019
2019
  })
2020
2020
  export class UsersModule {}
2021
2021
 
2022
- // 正确
2022
+ // [推荐] 正确
2023
2023
  @Module({
2024
2024
  providers: [UsersService],
2025
2025
  exports: [UsersService],
@@ -2030,7 +2030,7 @@ export class UsersModule {}
2030
2030
  ### 4. 异步初始化陷阱
2031
2031
 
2032
2032
  ```typescript
2033
- // 错误:同步 forRoot 中使用异步操作
2033
+ // [避免] 错误:同步 forRoot 中使用异步操作
2034
2034
  @Module({})
2035
2035
  export class DatabaseModule {
2036
2036
  static forRoot() {
@@ -2044,7 +2044,7 @@ export class DatabaseModule {
2044
2044
  }
2045
2045
  }
2046
2046
 
2047
- // 正确:使用 useFactory + async
2047
+ // [推荐] 正确:使用 useFactory + async
2048
2048
  @Module({})
2049
2049
  export class DatabaseModule {
2050
2050
  static forRoot(): DynamicModule {
@@ -2065,13 +2065,13 @@ export class DatabaseModule {
2065
2065
  ### 5. 测试中未正确清理
2066
2066
 
2067
2067
  ```typescript
2068
- // 错误:测试间共享状态导致随机失败
2068
+ // [避免] 错误:测试间共享状态导致随机失败
2069
2069
  describe('Service', () => {
2070
2070
  let app: INestApplication;
2071
2071
  beforeAll(async () => { app = /* ... */ });
2072
2072
  // 测试完没有关闭
2073
2073
 
2074
- // 正确:每次清理
2074
+ // [推荐] 正确:每次清理
2075
2075
  afterAll(async () => {
2076
2076
  await app.close();
2077
2077
  });
@@ -2081,11 +2081,11 @@ describe('Service', () => {
2081
2081
  ### 6. ValidationPipe 未配置 whitelist
2082
2082
 
2083
2083
  ```typescript
2084
- // 危险:客户端可注入任意属性
2084
+ // [避免] 危险:客户端可注入任意属性
2085
2085
  app.useGlobalPipes(new ValidationPipe());
2086
2086
  // POST { name: "Alice", isAdmin: true } -> isAdmin 会被传入 DTO
2087
2087
 
2088
- // 安全:只保留 DTO 中定义的属性
2088
+ // [推荐] 安全:只保留 DTO 中定义的属性
2089
2089
  app.useGlobalPipes(new ValidationPipe({
2090
2090
  whitelist: true,
2091
2091
  forbidNonWhitelisted: true,
@@ -2095,12 +2095,12 @@ app.useGlobalPipes(new ValidationPipe({
2095
2095
  ### 7. 生产环境 synchronize: true
2096
2096
 
2097
2097
  ```typescript
2098
- // 灾难性:自动同步会删除数据列
2098
+ // [避免] 灾难性:自动同步会删除数据列
2099
2099
  TypeOrmModule.forRoot({
2100
2100
  synchronize: true, // 绝对不能在生产环境开启
2101
2101
  });
2102
2102
 
2103
- // 正确:使用迁移管理数据库变更
2103
+ // [推荐] 正确:使用迁移管理数据库变更
2104
2104
  TypeOrmModule.forRoot({
2105
2105
  synchronize: false,
2106
2106
  migrations: ['dist/migrations/*.js'],
@@ -1,16 +1,14 @@
1
1
  ---
2
2
  id: cicd-blueprint-deep-dive
3
- title: cicd-blueprint-deep-dive
3
+ title: CI/CD 环节深度知识库
4
4
  domain: cicd
5
- category: cicd-blueprint-deep-dive.md
5
+ category: 01-standards
6
6
  difficulty: intermediate
7
- tags: [blueprint, cicd, deep, dive, 环节深度知识库]
7
+ tags: [cicd, 流水线, pipeline, 持续集成, 持续交付, 发布, devops]
8
8
  quality_score: 70
9
9
  last_updated: 2026-06-15
10
10
  ---
11
- # cicd-blueprint-deep-dive
12
-
13
- ## CI/CD 环节深度知识库
11
+ # CI/CD 环节深度知识库
14
12
 
15
13
  ### 目标
16
14
  - 让每次发布都具备可重复、可审计、可回滚能力。
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 容器安全标准
14
- # 功能:容器安全完整标准
15
- # 作用:为容器镜像、运行时、编排提供安全规范
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # Kubernetes 完整标准
14
- # 功能:Kubernetes 完整开发与运维标准
15
- # 作用:为 K8s 集群管理、应用部署、安全治理提供统一规范
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # GitOps ArgoCD 作战手册
14
- # 功能:GitOps 与 ArgoCD 实施作战手册
15
- # 作用:指导使用 ArgoCD 实现声明式持续部署
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -1,20 +1,16 @@
1
1
  ---
2
2
  title: Kubernetes 故障排查作战手册
3
3
  version: 1.0.0
4
- last_updated: 2026-03-28
4
+ last_updated: 2026-06-29
5
5
  owner: platform-team
6
6
  tags: [kubernetes, troubleshooting, diagnostics, pod, network, storage, node]
7
7
  status: production
8
8
  domain: cloud-native
9
9
  difficulty: intermediate
10
- quality_score: 70
10
+ quality_score: 91
11
11
  ---
12
12
 
13
13
  # Kubernetes 故障排查作战手册
14
- # 功能:Kubernetes 全场景故障排查作战手册
15
- # 作用:指导 K8s 集群各类故障的诊断、根因分析与修复
16
- # 创建时间:2026-03-28
17
- # 最后修改:2026-03-28
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 多云治理作战手册
14
- # 功能:多云环境治理作战手册
15
- # 作用:指导多云架构的统一管理、成本优化和风险控制
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # Serverless 模式作战手册
14
- # 功能:Serverless 架构模式作战手册
15
- # 作用:指导 Knative、云函数等 Serverless 实践
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 服务网格作战手册
14
- # 功能:服务网格实施与运维作战手册
15
- # 作用:指导 Istio/Linkerd 服务网格的部署、配置和运维
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 目标
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 容器安全检查清单
14
- # 功能:容器安全全面检查清单
15
- # 作用:确保容器镜像和运行时满足安全标准
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 概述
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # Kubernetes 生产就绪检查清单
14
- # 功能:Kubernetes 生产环境部署前检查清单
15
- # 作用:确保应用具备生产环境运行条件
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 概述
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 容器反模式库
14
- # 功能:容器常见反模式识别与修正
15
- # 作用:帮助团队避免容器化常见错误
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 反模式分类
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # Kubernetes 反模式库
14
- # 功能:Kubernetes 常见反模式识别与修正
15
- # 作用:帮助团队避免常见错误,建立正确实践
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 反模式分类
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 案例:Kubernetes 迁移
14
- # 功能:Kubernetes 迁移实战案例
15
- # 作用:分享传统应用到 Kubernetes 的迁移经验
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 背景
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 案例:Kubernetes 扩展
14
- # 功能:Kubernetes 自动扩展实战案例
15
- # 作用:分享 K8s 弹性伸缩的实践经验
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 背景
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 案例:Kubernetes 安全事件
14
- # 功能:Kubernetes 安全事件响应实战案例
15
- # 作用:分享 K8s 安全事件的处理经验
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## 背景
20
16
 
@@ -11,10 +11,6 @@ quality_score: 70
11
11
  ---
12
12
 
13
13
  # 云原生词汇表
14
- # 功能:云原生核心术语定义
15
- # 作用:统一术语理解,便于沟通和学习
16
- # 创建时间:2025-03-20
17
- # 最后修改:2025-03-20
18
14
 
19
15
  ## A
20
16
 
@@ -5,8 +5,8 @@ domain: data
5
5
  category: 01-standards
6
6
  difficulty: intermediate
7
7
  tags: [complete, data, elasticsearch, mapping, 性能优化, 查询, 核心概念, 概述]
8
- quality_score: 70
9
- last_updated: 2026-06-15
8
+ quality_score: 90
9
+ last_updated: 2026-06-29
10
10
  ---
11
11
  # Elasticsearch 数据领域完整指南
12
12
 
@@ -5,8 +5,8 @@ domain: data
5
5
  category: 01-standards
6
6
  difficulty: intermediate
7
7
  tags: [complete, data, postgresql, 备份与恢复, 安全, 数据建模, 查询优化, 核心概念]
8
- quality_score: 70
9
- last_updated: 2026-06-15
8
+ quality_score: 92
9
+ last_updated: 2026-06-29
10
10
  ---
11
11
  # PostgreSQL 数据工程完整指南
12
12
 
@@ -20,12 +20,12 @@ PostgreSQL 是世界上最先进的开源关系型数据库管理系统,具备
20
20
 
21
21
  | 场景 | 推荐度 | 说明 |
22
22
  |------|--------|------|
23
- | OLTP 业务系统 | ★★★★★ | 事务完整性、行级锁、外键约束 |
24
- | JSONB 文档存储 | ★★★★☆ | 替代部分 MongoDB 场景 |
25
- | 地理信息系统 | ★★★★★ | PostGIS 扩展 |
26
- | 全文搜索 | ★★★★☆ | tsvector/tsquery,中小规模可替代 ES |
27
- | 大规模 OLAP | ★★★☆☆ | 需配合 Citus / TimescaleDB 或分区表 |
28
- | 时序数据 | ★★★★☆ | TimescaleDB 扩展 |
23
+ | OLTP 业务系统 | 5/5 | 事务完整性、行级锁、外键约束 |
24
+ | JSONB 文档存储 | 4/5 | 替代部分 MongoDB 场景 |
25
+ | 地理信息系统 | 5/5 | PostGIS 扩展 |
26
+ | 全文搜索 | 4/5 | tsvector/tsquery,中小规模可替代 ES |
27
+ | 大规模 OLAP | 3/5 | 需配合 Citus / TimescaleDB 或分区表 |
28
+ | 时序数据 | 4/5 | TimescaleDB 扩展 |
29
29
 
30
30
  ### 1.2 版本选择
31
31
 
@@ -5,8 +5,8 @@ domain: data
5
5
  category: 01-standards
6
6
  difficulty: intermediate
7
7
  tags: [complete, data, redis, 分布式锁, 持久化, 核心数据结构, 概述, 消息队列]
8
- quality_score: 70
9
- last_updated: 2026-06-15
8
+ quality_score: 89
9
+ last_updated: 2026-06-29
10
10
  ---
11
11
  # Redis 数据领域完整指南
12
12
 
@@ -1419,8 +1419,8 @@ def check_fragmentation():
1419
1419
 
1420
1420
  ```python
1421
1421
  # 1. KEYS 命令(生产禁用,用 SCAN 替代)
1422
- # KEYS user:* # O(N) 全量扫描,阻塞
1423
- # SCAN 0 MATCH user:* COUNT 100
1422
+ # [避免] KEYS user:* # O(N) 全量扫描,阻塞
1423
+ # [推荐] SCAN 0 MATCH user:* COUNT 100
1424
1424
 
1425
1425
  def scan_keys(pattern: str, count: int = 100):
1426
1426
  """安全扫描 key"""
@@ -1434,10 +1434,10 @@ def scan_keys(pattern: str, count: int = 100):
1434
1434
  return keys
1435
1435
 
1436
1436
  # 2. 连接泄漏(务必使用连接池)
1437
- #
1437
+ # [避免]
1438
1438
  r = redis.Redis(host="localhost") # 每次新建连接
1439
1439
 
1440
- #
1440
+ # [推荐]
1441
1441
  pool = redis.ConnectionPool(host="localhost", port=6379, max_connections=50)
1442
1442
  r = redis.Redis(connection_pool=pool)
1443
1443
 
@@ -1445,20 +1445,20 @@ r = redis.Redis(connection_pool=pool)
1445
1445
  import json
1446
1446
  import pickle
1447
1447
 
1448
- # pickle(安全风险 + 不可跨语言)
1448
+ # [避免] pickle(安全风险 + 不可跨语言)
1449
1449
  r.set("data", pickle.dumps(obj))
1450
1450
 
1451
- # JSON(安全 + 可跨语言)
1451
+ # [推荐] JSON(安全 + 可跨语言)
1452
1452
  r.set("data", json.dumps(obj))
1453
1453
 
1454
- # msgpack(更紧凑)
1454
+ # [推荐] msgpack(更紧凑)
1455
1455
  import msgpack
1456
1456
  r.set("data", msgpack.packb(obj))
1457
1457
 
1458
1458
  # 4. 过期时间丢失
1459
1459
  r.set("key", "value", ex=3600)
1460
- r.set("key", "new_value") # ⚠️ TTL 被清除!
1461
- r.set("key", "new_value", keepttl=True) # 保留 TTL (Redis 6.0+)
1460
+ r.set("key", "new_value") # [注意] TTL 被清除!
1461
+ r.set("key", "new_value", keepttl=True) # [推荐] 保留 TTL (Redis 6.0+)
1462
1462
  ```
1463
1463
 
1464
1464
  ---
@@ -1,16 +1,14 @@
1
1
  ---
2
2
  id: data-governance-and-modeling-deep-dive
3
- title: data-governance-and-modeling-deep-dive
3
+ title: 数据环节深度知识库
4
4
  domain: data
5
- category: data-governance-and-modeling-deep-dive.md
5
+ category: 01-standards
6
6
  difficulty: intermediate
7
- tags: [and, data, deep, dive, governance, modeling, 数据环节深度知识库]
7
+ tags: [数据治理, data-governance, 数据建模, modeling, 数据质量, 元数据, data]
8
8
  quality_score: 70
9
9
  last_updated: 2026-06-15
10
10
  ---
11
- # data-governance-and-modeling-deep-dive
12
-
13
- ## 数据环节深度知识库
11
+ # 数据环节深度知识库
14
12
 
15
13
  ### 目标
16
14
  - 构建从数据采集、建模、质量、消费到治理的闭环体系。
@@ -5,8 +5,8 @@ domain: data-engineering
5
5
  category: 01-standards
6
6
  difficulty: intermediate
7
7
  tags: [complete, connect, data-engineering, kafka, schema管理, streams, 核心概念, 概述]
8
- quality_score: 70
9
- last_updated: 2026-06-15
8
+ quality_score: 90
9
+ last_updated: 2026-06-29
10
10
  ---
11
11
  # Apache Kafka完整指南
12
12
 
@@ -672,12 +672,12 @@ message OrderEvent {
672
672
  └──────────────────┴──────────────────────────────────────────┘
673
673
 
674
674
  安全的Schema演进操作:
675
- 添加带默认值的字段(BACKWARD兼容)
676
- 删除带默认值的字段(FORWARD兼容)
677
- 添加可选字段(FULL兼容)
678
- 删除必需字段(破坏BACKWARD)
679
- 修改字段类型(破坏所有兼容性)
680
- 重命名字段(破坏所有兼容性)
675
+ [推荐] 添加带默认值的字段(BACKWARD兼容)
676
+ [推荐] 删除带默认值的字段(FORWARD兼容)
677
+ [推荐] 添加可选字段(FULL兼容)
678
+ [避免] 删除必需字段(破坏BACKWARD)
679
+ [避免] 修改字段类型(破坏所有兼容性)
680
+ [避免] 重命名字段(破坏所有兼容性)
681
681
  ```
682
682
 
683
683
  ```bash
@@ -1339,11 +1339,11 @@ kafka-reassign-partitions.sh --bootstrap-server localhost:9092 \
1339
1339
  4. 检查下游依赖(DB/缓存/HTTP)的响应时间
1340
1340
 
1341
1341
  解决方案:
1342
- 增加消费者实例(不超过分区数)
1343
- 减小max.poll.records, 增大max.poll.interval.ms
1344
- 异步处理: poll后放入本地队列, 多线程处理
1345
- 优化下游调用(批量写DB/连接池/缓存)
1346
- 盲目增加分区数(需要同时增加消费者才有效)
1342
+ [推荐] 增加消费者实例(不超过分区数)
1343
+ [推荐] 减小max.poll.records, 增大max.poll.interval.ms
1344
+ [推荐] 异步处理: poll后放入本地队列, 多线程处理
1345
+ [推荐] 优化下游调用(批量写DB/连接池/缓存)
1346
+ [避免] 盲目增加分区数(需要同时增加消费者才有效)
1347
1347
  ```
1348
1348
 
1349
1349
  ### 2. Rebalance风暴
@@ -1357,11 +1357,11 @@ kafka-reassign-partitions.sh --bootstrap-server localhost:9092 \
1357
1357
  - GC暂停超过session.timeout.ms
1358
1358
 
1359
1359
  解决方案:
1360
- 使用CooperativeStickyAssignor(增量Rebalance)
1361
- 增大session.timeout.ms(30-60s)
1362
- 增大max.poll.interval.ms(5-10min)
1363
- 减小max.poll.records, 确保处理时间可控
1364
- 设置group.instance.id启用静态成员(避免重启触发Rebalance)
1360
+ [推荐] 使用CooperativeStickyAssignor(增量Rebalance)
1361
+ [推荐] 增大session.timeout.ms(30-60s)
1362
+ [推荐] 增大max.poll.interval.ms(5-10min)
1363
+ [推荐] 减小max.poll.records, 确保处理时间可控
1364
+ [推荐] 设置group.instance.id启用静态成员(避免重启触发Rebalance)
1365
1365
 
1366
1366
  # 静态成员配置(Kafka 2.3+)
1367
1367
  group.instance.id=consumer-host-1 # 每个实例唯一
@@ -1381,10 +1381,10 @@ session.timeout.ms=60000 # 可以设更长(静态成员离开不立即
1381
1381
  - 生产者内存增加(每分区一个RecordBatch缓冲)
1382
1382
 
1383
1383
  建议:
1384
- 单集群分区总数 < 200,000(KRaft模式可更多)
1385
- 单Broker分区数 < 4,000
1386
- 根据实际吞吐需求规划, 预留20-30%余量
1387
- 不要盲目设置大量分区(分区数只增不减)
1384
+ [推荐] 单集群分区总数 < 200,000(KRaft模式可更多)
1385
+ [推荐] 单Broker分区数 < 4,000
1386
+ [推荐] 根据实际吞吐需求规划, 预留20-30%余量
1387
+ [避免] 不要盲目设置大量分区(分区数只增不减)
1388
1388
  ```
1389
1389
 
1390
1390
  ### 4. 消息丢失
@@ -2,7 +2,7 @@
2
2
  id: ui-full-lifecycle-cross-platform-playbook
3
3
  title: UI 全生命周期跨平台设计手册(商业级)
4
4
  domain: design
5
- category: ui-full-lifecycle-cross-platform-playbook.md
5
+ category: 02-playbooks
6
6
  difficulty: intermediate
7
7
  tags: [cross, design, full, lifecycle, platform, playbook, token, 官方优先来源]
8
8
  quality_score: 70
@@ -1,16 +1,14 @@
1
1
  ---
2
2
  id: ux-system-deep-dive
3
- title: ux-system-deep-dive
3
+ title: 设计环节深度知识库
4
4
  domain: design
5
- category: ux-system-deep-dive.md
5
+ category: 01-standards
6
6
  difficulty: intermediate
7
- tags: [deep, design, dive, system, 设计环节深度知识库]
7
+ tags: [ux, 用户体验, 交互设计, 设计流程, 可用性, design]
8
8
  quality_score: 70
9
9
  last_updated: 2026-06-15
10
10
  ---
11
- # ux-system-deep-dive
12
-
13
- ## 设计环节深度知识库
11
+ # 设计环节深度知识库
14
12
 
15
13
  ### 目标
16
14
  - 建立可扩展、可复用、可验证的交互与视觉规范体系。
@@ -2,7 +2,7 @@
2
2
  id: 00-craft-rules
3
3
  title: Craft Rules — Universal Visual Quality Standards
4
4
  domain: design-systems
5
- category: 00-craft-rules.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [auto-checked, cardinal, catch, craft, design-systems, governance, reviewer, rules]
8
8
  quality_score: 70
@@ -2,7 +2,7 @@
2
2
  id: bold-geometric
3
3
  title: Bold Geometric
4
4
  domain: design-systems
5
- category: bold-geometric.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [bold, color, component, design-systems, geometric, layout, palette, patterns]
8
8
  quality_score: 70
@@ -2,7 +2,7 @@
2
2
  id: brutalist-bold
3
3
  title: Brutalist Bold
4
4
  domain: design-systems
5
- category: brutalist-bold.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [brutalist, swiss, editorial, mono, high-contrast, oversized-type, design-systems, palette, patterns]
8
8
  quality_score: 72
@@ -2,7 +2,7 @@
2
2
  id: editorial-clean
3
3
  title: Editorial Clean
4
4
  domain: design-systems
5
- category: editorial-clean.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [clean, color, component, design-systems, editorial, motion, palette, patterns]
8
8
  quality_score: 70
@@ -2,7 +2,7 @@
2
2
  id: glass-aurora
3
3
  title: Glass Aurora
4
4
  domain: design-systems
5
- category: glass-aurora.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [glassmorphism, aurora, frosted, depth, ai, modern, gradient-controlled, design-systems, palette, patterns]
8
8
  quality_score: 72
@@ -2,7 +2,7 @@
2
2
  id: modern-minimal
3
3
  title: Modern Minimal
4
4
  domain: design-systems
5
- category: modern-minimal.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [borders, color, component, design-systems, minimal, modern, palette, patterns]
8
8
  quality_score: 70
@@ -2,7 +2,7 @@
2
2
  id: premium-luxury
3
3
  title: Premium Luxury
4
4
  domain: design-systems
5
- category: premium-luxury.md
5
+ category: design-systems
6
6
  difficulty: intermediate
7
7
  tags: [luxury, premium, refined, elegant, serif, dark, single-accent, generous-space, design-systems, palette, patterns]
8
8
  quality_score: 72