@umacloud/knowledge 1.0.16 → 1.0.18
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.
- package/00-governance/governance-capabilities.md +1 -1
- package/00-governance/knowledge-map.md +4 -6
- package/ai/01-standards/app-runtime-model-configurable.md +76 -0
- package/ai/agent-evaluation-benchmark.md +4 -6
- package/ai/ai-agent-memory-context-management.md +4 -6
- package/ai/ai-cost-capacity-optimization-playbook.md +4 -6
- package/ai/ai-data-security-and-compliance-playbook.md +4 -6
- package/ai/ai-domain-index-and-checklist.md +4 -6
- package/ai/ai-governance-maturity-model.md +4 -6
- package/ai/ai-model-selection-and-routing-strategy.md +4 -6
- package/ai/ai-observability-and-oncall-runbook.md +4 -6
- package/ai/ai-rag-engineering-playbook.md +4 -6
- package/ai/ai-red-team-and-safety-evaluation.md +4 -6
- package/ai/ai-release-readiness-and-rollback-gate.md +4 -6
- package/ai/llm-agent-engineering-deep-dive.md +4 -6
- package/ai/prompt-and-tool-guardrails.md +4 -6
- package/architecture/02-playbooks/migration-playbook.md +0 -4
- package/architecture/02-playbooks/system-design-playbook.md +0 -4
- package/architecture/adr-template-and-examples.md +4 -6
- package/architecture/api-gateway-deep-dive.md +1 -1
- package/architecture/distributed-transactions.md +1 -1
- package/architecture/microservices-complete.md +1 -1
- package/architecture/service-governance.md +1 -1
- package/architecture/system-architecture-deep-dive.md +4 -6
- package/backend/01-standards/cjk-in-exports-and-documents.md +107 -0
- package/backend/01-standards/django-complete.md +2 -2
- package/backend/01-standards/nestjs-complete.md +23 -23
- package/cicd/cicd-blueprint-deep-dive.md +4 -6
- package/cloud-native/01-standards/container-security.md +0 -4
- package/cloud-native/01-standards/kubernetes-complete.md +0 -4
- package/cloud-native/02-playbooks/gitops-with-argocd.md +0 -4
- package/cloud-native/02-playbooks/k8s-troubleshooting-playbook.md +2 -6
- package/cloud-native/02-playbooks/multicloud-governance.md +0 -4
- package/cloud-native/02-playbooks/serverless-patterns.md +0 -4
- package/cloud-native/02-playbooks/service-mesh-playbook.md +0 -4
- package/cloud-native/03-checklists/container-security-checklist.md +0 -4
- package/cloud-native/03-checklists/k8s-production-readiness-checklist.md +0 -4
- package/cloud-native/04-antipatterns/container-antipatterns.md +0 -4
- package/cloud-native/04-antipatterns/k8s-antipatterns.md +0 -4
- package/cloud-native/05-cases/case-k8s-migration.md +0 -4
- package/cloud-native/05-cases/case-k8s-scaling.md +0 -4
- package/cloud-native/05-cases/case-k8s-security-incident.md +0 -4
- package/cloud-native/06-glossary/cloud-native-glossary.md +0 -4
- package/data/01-standards/elasticsearch-complete.md +2 -2
- package/data/01-standards/postgresql-complete.md +8 -8
- package/data/01-standards/redis-complete.md +11 -11
- package/data/data-governance-and-modeling-deep-dive.md +4 -6
- package/data-engineering/01-standards/kafka-complete.md +22 -22
- package/design/ui-full-lifecycle-cross-platform-playbook.md +1 -1
- package/design/ux-system-deep-dive.md +4 -6
- package/design-systems/00-craft-rules.md +1 -1
- package/design-systems/bold-geometric.md +1 -1
- package/design-systems/brutalist-bold.md +1 -1
- package/design-systems/editorial-clean.md +1 -1
- package/design-systems/glass-aurora.md +1 -1
- package/design-systems/modern-minimal.md +1 -1
- package/design-systems/premium-luxury.md +1 -1
- package/design-systems/soft-warm.md +1 -1
- package/design-systems/tech-utility.md +1 -1
- package/development/00-governance/document-template.md +3 -3
- package/development/01-standards/golang-complete.md +2 -2
- package/development/01-standards/python-design-patterns.md +2 -2
- package/development/01-standards/typescript-advanced-types.md +2 -2
- package/development/09-maturity/quarterly-audit-template.md +3 -5
- package/development/11-ui-excellence/ui-aesthetic-system.md +3 -5
- package/development/13-implementation-assets/knowledge-gates-execution.md +3 -5
- package/development/api-contract-and-versioning-guide.md +4 -6
- package/development/api-governance-complete.md +4 -6
- package/development/backend-engineering-complete.md +4 -6
- package/development/concurrency-reliability-complete.md +4 -6
- package/development/database-engineering-complete.md +4 -6
- package/development/engineering-effectiveness-complete.md +4 -6
- package/development/engineering-standards-deep-dive.md +4 -6
- package/development/frontend-engineering-complete.md +4 -6
- package/development/performance-capacity-complete.md +4 -6
- package/development/refactor-migration-complete.md +4 -6
- package/development/refactoring-and-techdebt-playbook.md +4 -6
- package/development/security-in-development-complete.md +4 -6
- package/devops/01-standards/docker-complete.md +2 -2
- package/devops/01-standards/terraform-complete.md +3 -3
- package/frontend/01-standards/i18n-and-localization.md +1 -1
- package/frontend/01-standards/react-hooks-complete.md +33 -33
- package/frontend/01-standards/vue3-complete.md +2 -2
- package/high-quality-engineering-playbook.md +4 -6
- package/incident/02-playbooks/chaos-engineering-playbook.md +0 -4
- package/incident/postmortem-and-response-deep-dive.md +4 -6
- package/mobile/01-standards/flutter-complete.md +2 -7
- package/mobile/01-standards/react-native-complete.md +2 -7
- package/mobile/02-playbooks/mobile-performance.md +2 -8
- package/mobile/03-checklists/mobile-release-checklist.md +2 -4
- package/mobile/04-antipatterns/mobile-antipatterns.md +2 -4
- package/operations/01-standards/prometheus-monitoring-complete.md +2 -2
- package/operations/aiops-anomaly-detection.md +4 -8
- package/operations/capacity-planning.md +4 -8
- package/operations/chaos-engineering.md +4 -8
- package/operations/incident-command-system.md +4 -6
- package/operations/observability-complete.md +4 -8
- package/operations/slo-sli-playbook.md +4 -8
- package/operations/sre-operations-deep-dive.md +4 -6
- package/package.json +1 -1
- package/product/feature-prioritization-framework.md +97 -35
- package/product/kpi-and-metric-tree.md +69 -26
- package/product/product-discovery-and-prd-deep-dive.md +4 -6
- package/security/01-standards/owasp-top10-complete.md +2 -2
- package/security/02-playbooks/incident-response-security-playbook.md +0 -4
- package/security/02-playbooks/penetration-testing-playbook.md +0 -4
- package/security/compliance-automation.md +1 -1
- package/security/container-security.md +1 -1
- package/security/devsecops-complete.md +1 -1
- package/security/sast-dast-sca.md +1 -1
- package/security/secrets-management.md +1 -1
- package/security/security-architecture-deep-dive.md +4 -6
- package/security/threat-modeling-stride-playbook.md +4 -6
- package/seed-templates/auth-system.md +1 -1
- package/seed-templates/blog-content.md +1 -1
- package/seed-templates/dashboard.md +1 -1
- package/seed-templates/docs-site.md +1 -1
- package/seed-templates/e-commerce.md +1 -1
- package/seed-templates/saas-landing.md +1 -1
- package/seed-templates/settings-page.md +1 -1
- package/testing/02-playbooks/e2e-testing-playbook.md +0 -4
- package/testing/risk-based-test-matrix.md +75 -25
- 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:
|
|
9
|
-
last_updated: 2026-06-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
34
|
+
[推荐] **大型团队协作**: 强约定 + 模块化架构减少代码风格分歧
|
|
35
|
+
[推荐] **微服务体系**: 内置 Transport 层,支持 Redis/Kafka/gRPC/NATS/MQTT
|
|
36
|
+
[推荐] **企业级后端**: 完善的认证/授权/缓存/队列/日志/健康检查生态
|
|
37
|
+
[推荐] **全栈 TypeScript**: 前后端共享类型定义,配合 Monorepo 高效开发
|
|
38
|
+
[推荐] **需要长期维护的系统**: 模块边界清晰,重构成本低
|
|
39
39
|
|
|
40
|
-
|
|
41
|
-
|
|
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
|
-
//
|
|
1981
|
+
// [避免] 错误:A 和 B 互相注入,其中一个会是 undefined
|
|
1982
1982
|
@Injectable()
|
|
1983
1983
|
export class ServiceA {
|
|
1984
1984
|
constructor(private serviceB: ServiceB) {} // 可能是 undefined
|
|
1985
1985
|
}
|
|
1986
1986
|
|
|
1987
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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
|
-
//
|
|
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:
|
|
3
|
+
title: CI/CD 环节深度知识库
|
|
4
4
|
domain: cicd
|
|
5
|
-
category:
|
|
5
|
+
category: 01-standards
|
|
6
6
|
difficulty: intermediate
|
|
7
|
-
tags: [
|
|
7
|
+
tags: [cicd, 流水线, pipeline, 持续集成, 持续交付, 发布, devops]
|
|
8
8
|
quality_score: 70
|
|
9
9
|
last_updated: 2026-06-15
|
|
10
10
|
---
|
|
11
|
-
#
|
|
12
|
-
|
|
13
|
-
## CI/CD 环节深度知识库
|
|
11
|
+
# CI/CD 环节深度知识库
|
|
14
12
|
|
|
15
13
|
### 目标
|
|
16
14
|
- 让每次发布都具备可重复、可审计、可回滚能力。
|
|
@@ -1,20 +1,16 @@
|
|
|
1
1
|
---
|
|
2
2
|
title: Kubernetes 故障排查作战手册
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
last_updated: 2026-
|
|
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:
|
|
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
|
|
|
@@ -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:
|
|
9
|
-
last_updated: 2026-06-
|
|
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:
|
|
9
|
-
last_updated: 2026-06-
|
|
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 文档存储 |
|
|
25
|
-
| 地理信息系统 |
|
|
26
|
-
| 全文搜索 |
|
|
27
|
-
| 大规模 OLAP |
|
|
28
|
-
| 时序数据 |
|
|
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:
|
|
9
|
-
last_updated: 2026-06-
|
|
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
|
-
#
|
|
1423
|
-
#
|
|
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
|
-
#
|
|
1448
|
+
# [避免] pickle(安全风险 + 不可跨语言)
|
|
1449
1449
|
r.set("data", pickle.dumps(obj))
|
|
1450
1450
|
|
|
1451
|
-
#
|
|
1451
|
+
# [推荐] JSON(安全 + 可跨语言)
|
|
1452
1452
|
r.set("data", json.dumps(obj))
|
|
1453
1453
|
|
|
1454
|
-
#
|
|
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") #
|
|
1461
|
-
r.set("key", "new_value", keepttl=True) #
|
|
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:
|
|
3
|
+
title: 数据环节深度知识库
|
|
4
4
|
domain: data
|
|
5
|
-
category:
|
|
5
|
+
category: 01-standards
|
|
6
6
|
difficulty: intermediate
|
|
7
|
-
tags: [
|
|
7
|
+
tags: [数据治理, data-governance, 数据建模, modeling, 数据质量, 元数据, data]
|
|
8
8
|
quality_score: 70
|
|
9
9
|
last_updated: 2026-06-15
|
|
10
10
|
---
|
|
11
|
-
#
|
|
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:
|
|
9
|
-
last_updated: 2026-06-
|
|
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
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
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
|
-
|
|
1344
|
-
|
|
1345
|
-
|
|
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
|
-
|
|
1361
|
-
|
|
1362
|
-
|
|
1363
|
-
|
|
1364
|
-
|
|
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
|
-
|
|
1385
|
-
|
|
1386
|
-
|
|
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:
|
|
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:
|
|
3
|
+
title: 设计环节深度知识库
|
|
4
4
|
domain: design
|
|
5
|
-
category:
|
|
5
|
+
category: 01-standards
|
|
6
6
|
difficulty: intermediate
|
|
7
|
-
tags: [
|
|
7
|
+
tags: [ux, 用户体验, 交互设计, 设计流程, 可用性, design]
|
|
8
8
|
quality_score: 70
|
|
9
9
|
last_updated: 2026-06-15
|
|
10
10
|
---
|
|
11
|
-
#
|
|
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:
|
|
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: brutalist-bold
|
|
3
3
|
title: Brutalist Bold
|
|
4
4
|
domain: design-systems
|
|
5
|
-
category:
|
|
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: glass-aurora
|
|
3
3
|
title: Glass Aurora
|
|
4
4
|
domain: design-systems
|
|
5
|
-
category:
|
|
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: premium-luxury
|
|
3
3
|
title: Premium Luxury
|
|
4
4
|
domain: design-systems
|
|
5
|
-
category:
|
|
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
|