@umacloud/knowledge 1.0.1

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 (418) hide show
  1. package/00-governance/governance-capabilities.md +557 -0
  2. package/00-governance/knowledge-map.md +39 -0
  3. package/00-governance/maintenance-policy.md +76 -0
  4. package/00-governance/review-checklist.md +81 -0
  5. package/README.md +13 -0
  6. package/ai/01-standards/agent-development-complete.md +691 -0
  7. package/ai/01-standards/llm-application-complete.md +488 -0
  8. package/ai/01-standards/mlops-complete.md +798 -0
  9. package/ai/01-standards/prompt-engineering-complete.md +646 -0
  10. package/ai/01-standards/rag-architecture-complete.md +649 -0
  11. package/ai/02-playbooks/llm-evaluation-playbook.md +847 -0
  12. package/ai/03-checklists/ai-project-checklist.md +215 -0
  13. package/ai/04-antipatterns/ai-antipatterns.md +661 -0
  14. package/ai/05-cases/case-rag-production.md +147 -0
  15. package/ai/06-glossary/ai-glossary.md +162 -0
  16. package/ai/agent-evaluation-benchmark.md +53 -0
  17. package/ai/ai-agent-memory-context-management.md +41 -0
  18. package/ai/ai-cost-capacity-optimization-playbook.md +42 -0
  19. package/ai/ai-data-security-and-compliance-playbook.md +37 -0
  20. package/ai/ai-domain-index-and-checklist.md +40 -0
  21. package/ai/ai-governance-maturity-model.md +50 -0
  22. package/ai/ai-model-selection-and-routing-strategy.md +47 -0
  23. package/ai/ai-observability-and-oncall-runbook.md +52 -0
  24. package/ai/ai-rag-engineering-playbook.md +42 -0
  25. package/ai/ai-red-team-and-safety-evaluation.md +42 -0
  26. package/ai/ai-release-readiness-and-rollback-gate.md +42 -0
  27. package/ai/llm-agent-engineering-deep-dive.md +57 -0
  28. package/ai/prompt-and-tool-guardrails.md +52 -0
  29. package/api/01-standards/enterprise-api-standards.md +198 -0
  30. package/api/01-standards/rest-api-design-guide.md +63 -0
  31. package/api/02-playbooks/api-pagination-playbook.md +93 -0
  32. package/api/02-playbooks/graphql-production-playbook.md +176 -0
  33. package/api/03-checklists/api-review-checklist.md +55 -0
  34. package/api/04-antipatterns/api-antipatterns.md +112 -0
  35. package/architecture/01-standards/api-gateway-patterns.md +496 -0
  36. package/architecture/01-standards/cloud-native-patterns.md +644 -0
  37. package/architecture/01-standards/distributed-systems-patterns.md +591 -0
  38. package/architecture/01-standards/event-driven-architecture.md +595 -0
  39. package/architecture/01-standards/microservices-patterns-complete.md +968 -0
  40. package/architecture/01-standards/microservices-patterns.md +495 -0
  41. package/architecture/01-standards/system-design-interview.md +664 -0
  42. package/architecture/02-playbooks/microservices-patterns-playbook.md +137 -0
  43. package/architecture/02-playbooks/migration-playbook.md +780 -0
  44. package/architecture/02-playbooks/system-design-playbook.md +779 -0
  45. package/architecture/03-checklists/architecture-decision-checklist.md +297 -0
  46. package/architecture/04-antipatterns/architecture-antipatterns.md +417 -0
  47. package/architecture/05-cases/case-netflix-microservices.md +413 -0
  48. package/architecture/06-glossary/architecture-glossary.md +164 -0
  49. package/architecture/adr-template-and-examples.md +38 -0
  50. package/architecture/api-gateway-deep-dive.md +1291 -0
  51. package/architecture/configuration-management.md +1162 -0
  52. package/architecture/distributed-transactions.md +1220 -0
  53. package/architecture/microservices-complete.md +735 -0
  54. package/architecture/resilience-and-disaster-patterns.md +37 -0
  55. package/architecture/service-governance.md +1198 -0
  56. package/architecture/system-architecture-deep-dive.md +37 -0
  57. package/backend/01-standards/analytics-and-growth.md +65 -0
  58. package/backend/01-standards/api-and-error-conventions.md +120 -0
  59. package/backend/01-standards/application-layering-and-packaging.md +160 -0
  60. package/backend/01-standards/auth-implementation.md +104 -0
  61. package/backend/01-standards/backend-framework-idioms.md +74 -0
  62. package/backend/01-standards/background-jobs-and-async.md +66 -0
  63. package/backend/01-standards/caching-strategies-complete.md +390 -0
  64. package/backend/01-standards/config-and-observability.md +77 -0
  65. package/backend/01-standards/data-modeling-and-persistence.md +94 -0
  66. package/backend/01-standards/django-complete.md +1765 -0
  67. package/backend/01-standards/email-and-notifications.md +64 -0
  68. package/backend/01-standards/fastapi-complete.md +925 -0
  69. package/backend/01-standards/file-upload-and-storage.md +66 -0
  70. package/backend/01-standards/graphql-api-complete.md +416 -0
  71. package/backend/01-standards/llm-application-standard.md +78 -0
  72. package/backend/01-standards/message-queue-patterns.md +379 -0
  73. package/backend/01-standards/microservices-and-distributed.md +78 -0
  74. package/backend/01-standards/nestjs-complete.md +2167 -0
  75. package/backend/01-standards/payment-integration.md +80 -0
  76. package/backend/01-standards/rate-limiting-complete.md +451 -0
  77. package/backend/01-standards/realtime-and-websocket.md +65 -0
  78. package/backend/01-standards/search-and-filtering.md +64 -0
  79. package/backend/01-standards/spring-boot-complete.md +445 -0
  80. package/backend/02-playbooks/api-design-playbook.md +718 -0
  81. package/backend/02-playbooks/email-send-playbook.md +130 -0
  82. package/backend/02-playbooks/file-upload-s3-playbook.md +153 -0
  83. package/backend/02-playbooks/typescript-enterprise-playbook.md +133 -0
  84. package/backend/02-playbooks/websocket-realtime-playbook.md +154 -0
  85. package/backend/03-checklists/api-launch-checklist.md +189 -0
  86. package/backend/04-antipatterns/backend-antipatterns.md +1051 -0
  87. package/blockchain/01-standards/blockchain-basics.md +557 -0
  88. package/blockchain/01-standards/smart-contract-development.md +1315 -0
  89. package/cicd/01-standards/deployment-and-delivery-standard.md +96 -0
  90. package/cicd/01-standards/github-actions-complete.md +473 -0
  91. package/cicd/01-standards/release-and-store-submission.md +75 -0
  92. package/cicd/02-playbooks/cicd-pipeline-playbook.md +144 -0
  93. package/cicd/02-playbooks/release-management-playbook.md +605 -0
  94. package/cicd/03-checklists/pipeline-security-checklist.md +168 -0
  95. package/cicd/04-antipatterns/cicd-antipatterns.md +589 -0
  96. package/cicd/05-cases/case-deployment-automation.md +221 -0
  97. package/cicd/05-cases/case-gitops-transformation.md +212 -0
  98. package/cicd/06-glossary/cicd-glossary.md +114 -0
  99. package/cicd/cicd-blueprint-deep-dive.md +38 -0
  100. package/cicd/release-readiness-gate.md +37 -0
  101. package/cloud-native/01-standards/container-security.md +741 -0
  102. package/cloud-native/01-standards/kubernetes-complete.md +812 -0
  103. package/cloud-native/02-playbooks/api-gateway-playbook.md +155 -0
  104. package/cloud-native/02-playbooks/gitops-with-argocd.md +760 -0
  105. package/cloud-native/02-playbooks/k8s-troubleshooting-playbook.md +1942 -0
  106. package/cloud-native/02-playbooks/message-queue-playbook.md +129 -0
  107. package/cloud-native/02-playbooks/multicloud-governance.md +726 -0
  108. package/cloud-native/02-playbooks/serverless-patterns.md +788 -0
  109. package/cloud-native/02-playbooks/service-mesh-playbook.md +612 -0
  110. package/cloud-native/02-playbooks/terraform-iac-playbook.md +143 -0
  111. package/cloud-native/03-checklists/container-security-checklist.md +431 -0
  112. package/cloud-native/03-checklists/k8s-production-readiness-checklist.md +460 -0
  113. package/cloud-native/04-antipatterns/container-antipatterns.md +660 -0
  114. package/cloud-native/04-antipatterns/k8s-antipatterns.md +743 -0
  115. package/cloud-native/05-cases/case-k8s-migration.md +478 -0
  116. package/cloud-native/05-cases/case-k8s-scaling.md +642 -0
  117. package/cloud-native/05-cases/case-k8s-security-incident.md +397 -0
  118. package/cloud-native/06-glossary/cloud-native-glossary.md +337 -0
  119. package/cross-platform/01-standards/cross-platform-frameworks.md +83 -0
  120. package/cross-platform/01-standards/platform-selection-and-architecture.md +77 -0
  121. package/data/01-standards/elasticsearch-complete.md +2098 -0
  122. package/data/01-standards/postgresql-complete.md +1613 -0
  123. package/data/01-standards/redis-complete.md +1527 -0
  124. package/data/02-playbooks/database-optimization-playbook.md +403 -0
  125. package/data/02-playbooks/elasticsearch-production-playbook.md +132 -0
  126. package/data/03-checklists/database-launch-checklist.md +187 -0
  127. package/data/04-antipatterns/database-antipatterns.md +873 -0
  128. package/data/05-cases/case-database-migration.md +310 -0
  129. package/data/06-glossary/database-glossary.md +440 -0
  130. package/data/data-governance-and-modeling-deep-dive.md +39 -0
  131. package/data-engineering/01-standards/airflow-complete.md +523 -0
  132. package/data-engineering/01-standards/kafka-complete.md +1521 -0
  133. package/data-engineering/02-playbooks/spark-etl-playbook.md +496 -0
  134. package/data-engineering/03-checklists/pipeline-launch-checklist.md +194 -0
  135. package/data-engineering/04-antipatterns/data-pipeline-antipatterns.md +684 -0
  136. package/data-engineering/05-cases/case-real-time-pipeline.md +355 -0
  137. package/data-engineering/06-glossary/data-engineering-glossary.md +429 -0
  138. package/database/01-standards/database-schema-standards.md +147 -0
  139. package/database/02-playbooks/postgresql-optimization-quick.md +52 -0
  140. package/database/02-playbooks/postgresql-performance-optimization.md +58 -0
  141. package/database/02-playbooks/postgresql-production-playbook.md +146 -0
  142. package/database/02-playbooks/redis-caching-playbook.md +117 -0
  143. package/database/03-checklists/database-review-checklist.md +50 -0
  144. package/database/04-antipatterns/database-antipatterns.md +112 -0
  145. package/design/01-standards/ui-design-system-complete.md +423 -0
  146. package/design/02-playbooks/design-handoff-playbook.md +254 -0
  147. package/design/02-playbooks/design-review-playbook.md +388 -0
  148. package/design/03-checklists/design-review-checklist.md +246 -0
  149. package/design/04-antipatterns/design-antipatterns.md +378 -0
  150. package/design/05-cases/case-design-system-adoption.md +328 -0
  151. package/design/06-glossary/design-glossary.md +329 -0
  152. package/design/ui-full-lifecycle-cross-platform-playbook.md +571 -0
  153. package/design/ux-system-deep-dive.md +38 -0
  154. package/design-systems/00-craft-rules.md +71 -0
  155. package/design-systems/aesthetic-families.md +43 -0
  156. package/design-systems/anti-ai-slop.md +162 -0
  157. package/design-systems/bold-geometric.md +120 -0
  158. package/design-systems/brutalist-bold.md +103 -0
  159. package/design-systems/editorial-clean.md +109 -0
  160. package/design-systems/glass-aurora.md +108 -0
  161. package/design-systems/modern-minimal.md +145 -0
  162. package/design-systems/premium-luxury.md +106 -0
  163. package/design-systems/product-type-design-map.md +48 -0
  164. package/design-systems/soft-warm.md +123 -0
  165. package/design-systems/tech-utility.md +113 -0
  166. package/desktop/01-standards/desktop-app-standard.md +72 -0
  167. package/desktop/01-standards/desktop-design.md +71 -0
  168. package/development/00-governance/document-template.md +41 -0
  169. package/development/01-standards/api-versioning-strategies.md +432 -0
  170. package/development/01-standards/authentication-patterns-complete.md +479 -0
  171. package/development/01-standards/css-architecture-complete.md +550 -0
  172. package/development/01-standards/database-migration-strategies.md +484 -0
  173. package/development/01-standards/elasticsearch-complete.md +347 -0
  174. package/development/01-standards/git-complete.md +371 -0
  175. package/development/01-standards/golang-complete.md +1565 -0
  176. package/development/01-standards/graphql-complete.md +298 -0
  177. package/development/01-standards/javascript-bundlers-complete.md +469 -0
  178. package/development/01-standards/javascript-typescript-complete.md +528 -0
  179. package/development/01-standards/jest-complete.md +275 -0
  180. package/development/01-standards/linux-complete.md +234 -0
  181. package/development/01-standards/logging-observability-complete.md +526 -0
  182. package/development/01-standards/microservices-communication.md +502 -0
  183. package/development/01-standards/mongodb-complete.md +406 -0
  184. package/development/01-standards/oauth2-complete.md +285 -0
  185. package/development/01-standards/performance-optimization-complete.md +289 -0
  186. package/development/01-standards/playwright-complete.md +247 -0
  187. package/development/01-standards/postgresql-complete.md +456 -0
  188. package/development/01-standards/pytest-complete.md +340 -0
  189. package/development/01-standards/python-async-programming.md +902 -0
  190. package/development/01-standards/python-complete.md +956 -0
  191. package/development/01-standards/python-decorators-complete.md +799 -0
  192. package/development/01-standards/python-design-patterns.md +2854 -0
  193. package/development/01-standards/python-packaging-distribution.md +420 -0
  194. package/development/01-standards/python-testing-strategies.md +607 -0
  195. package/development/01-standards/python-web-frameworks-comparison.md +471 -0
  196. package/development/01-standards/redis-complete.md +317 -0
  197. package/development/01-standards/rest-api-complete.md +316 -0
  198. package/development/01-standards/rust-complete.md +578 -0
  199. package/development/01-standards/typescript-advanced-types.md +1513 -0
  200. package/development/01-standards/web-security-complete.md +292 -0
  201. package/development/02-playbooks/api-design-playbook.md +810 -0
  202. package/development/02-playbooks/database-migration-playbook.md +580 -0
  203. package/development/02-playbooks/debugging-playbook.md +692 -0
  204. package/development/02-playbooks/feature-delivery-playbook.md +430 -0
  205. package/development/02-playbooks/incident-hotfix-playbook.md +387 -0
  206. package/development/02-playbooks/performance-optimization-playbook.md +531 -0
  207. package/development/02-playbooks/performance-tuning-playbook.md +652 -0
  208. package/development/02-playbooks/refactor-playbook.md +403 -0
  209. package/development/02-playbooks/release-playbook.md +469 -0
  210. package/development/03-checklists/architecture-review-checklist.md +168 -0
  211. package/development/03-checklists/data-migration-checklist.md +157 -0
  212. package/development/03-checklists/oncall-handover-checklist.md +173 -0
  213. package/development/03-checklists/pr-checklist.md +158 -0
  214. package/development/03-checklists/production-readiness-checklist.md +190 -0
  215. package/development/03-checklists/release-readiness-checklist.md +154 -0
  216. package/development/03-checklists/security-review-checklist.md +182 -0
  217. package/development/04-antipatterns/api-antipatterns.md +657 -0
  218. package/development/04-antipatterns/architecture-antipatterns.md +686 -0
  219. package/development/04-antipatterns/backend-antipatterns.md +648 -0
  220. package/development/04-antipatterns/cicd-antipatterns.md +540 -0
  221. package/development/04-antipatterns/code-smell-antipatterns.md +571 -0
  222. package/development/04-antipatterns/data-antipatterns.md +658 -0
  223. package/development/04-antipatterns/database-antipatterns.md +578 -0
  224. package/development/04-antipatterns/frontend-antipatterns.md +635 -0
  225. package/development/04-antipatterns/reliability-antipatterns.md +700 -0
  226. package/development/04-antipatterns/security-antipatterns.md +747 -0
  227. package/development/05-cases/case-api-version-migration.md +428 -0
  228. package/development/05-cases/case-authorization-hardening.md +383 -0
  229. package/development/05-cases/case-bluegreen-rollback.md +466 -0
  230. package/development/05-cases/case-cache-snowball-protection.md +485 -0
  231. package/development/05-cases/case-ci-cd-pipeline.md +544 -0
  232. package/development/05-cases/case-database-scaling.md +500 -0
  233. package/development/05-cases/case-db-hotspot-optimization.md +487 -0
  234. package/development/05-cases/case-incident-mttr-reduction.md +563 -0
  235. package/development/05-cases/case-microservice-migration.md +375 -0
  236. package/development/05-cases/case-performance-optimization.md +406 -0
  237. package/development/05-cases/case-security-incident-response.md +345 -0
  238. package/development/06-glossary/full-stack-glossary.md +166 -0
  239. package/development/09-maturity/quarterly-audit-template.md +35 -0
  240. package/development/11-ui-excellence/ui-aesthetic-system.md +41 -0
  241. package/development/11-ui-excellence/ui-engineering-excellence.md +435 -0
  242. package/development/12-scenarios/development-scenarios-guide.md +565 -0
  243. package/development/13-implementation-assets/implementation-toolkit.md +282 -0
  244. package/development/13-implementation-assets/knowledge-gates-execution.md +43 -0
  245. package/development/14-full-lifecycle/software-lifecycle-gates.md +511 -0
  246. package/development/15-lifecycle-templates/project-templates-collection.md +791 -0
  247. package/development/api-contract-and-versioning-guide.md +36 -0
  248. package/development/api-governance-complete.md +43 -0
  249. package/development/backend-engineering-complete.md +43 -0
  250. package/development/code-review-quality-complete.md +43 -0
  251. package/development/concurrency-reliability-complete.md +43 -0
  252. package/development/database-engineering-complete.md +43 -0
  253. package/development/engineering-effectiveness-complete.md +43 -0
  254. package/development/engineering-standards-deep-dive.md +38 -0
  255. package/development/frontend-engineering-complete.md +43 -0
  256. package/development/performance-capacity-complete.md +43 -0
  257. package/development/refactor-migration-complete.md +42 -0
  258. package/development/refactoring-and-techdebt-playbook.md +37 -0
  259. package/development/security-in-development-complete.md +43 -0
  260. package/devops/01-standards/cicd-pipeline-complete.md +262 -0
  261. package/devops/01-standards/docker-complete.md +1490 -0
  262. package/devops/01-standards/github-actions-complete.md +337 -0
  263. package/devops/01-standards/kubernetes-complete.md +638 -0
  264. package/devops/01-standards/terraform-complete.md +2117 -0
  265. package/devops/02-playbooks/docker-compose-playbook.md +233 -0
  266. package/devops/02-playbooks/docker-k8s-production-playbook.md +186 -0
  267. package/devops/02-playbooks/docker-production-playbook.md +952 -0
  268. package/edge-iot/01-standards/edge-iot-complete.md +473 -0
  269. package/experts/architect/api-design.md +178 -0
  270. package/experts/architect/methodology.md +124 -0
  271. package/experts/architect/security.md +75 -0
  272. package/experts/backend-lead/methodology.md +216 -0
  273. package/experts/devops/methodology.md +160 -0
  274. package/experts/frontend-lead/methodology.md +178 -0
  275. package/experts/product-manager/industry/ecommerce.md +43 -0
  276. package/experts/product-manager/industry/saas.md +40 -0
  277. package/experts/product-manager/methodology.md +97 -0
  278. package/experts/qa-lead/methodology.md +123 -0
  279. package/experts/qa-lead/test-strategy.md +128 -0
  280. package/experts/uiux-designer/methodology.md +125 -0
  281. package/frontend/01-standards/accessibility-complete.md +532 -0
  282. package/frontend/01-standards/accessibility-standard.md +74 -0
  283. package/frontend/01-standards/admin-dashboard-and-crud.md +72 -0
  284. package/frontend/01-standards/design-tokens-complete.md +444 -0
  285. package/frontend/01-standards/forms-and-validation.md +77 -0
  286. package/frontend/01-standards/frontend-architecture-and-layering.md +119 -0
  287. package/frontend/01-standards/i18n-and-localization.md +65 -0
  288. package/frontend/01-standards/nextjs-complete.md +451 -0
  289. package/frontend/01-standards/react-complete.md +713 -0
  290. package/frontend/01-standards/react-hooks-complete-guide.md +1100 -0
  291. package/frontend/01-standards/react-hooks-complete.md +1171 -0
  292. package/frontend/01-standards/seo-and-web-vitals.md +77 -0
  293. package/frontend/01-standards/state-management-complete.md +444 -0
  294. package/frontend/01-standards/vue-complete.md +499 -0
  295. package/frontend/01-standards/vue3-complete.md +2002 -0
  296. package/frontend/01-standards/web-framework-best-practices.md +64 -0
  297. package/frontend/01-standards/web-performance-complete.md +495 -0
  298. package/frontend/02-playbooks/accessibility-a11y-playbook.md +161 -0
  299. package/frontend/02-playbooks/frontend-performance-playbook.md +707 -0
  300. package/frontend/02-playbooks/i18n-internationalization-playbook.md +120 -0
  301. package/frontend/02-playbooks/performance-optimization-playbook.md +163 -0
  302. package/frontend/02-playbooks/react-nextjs-production-playbook.md +167 -0
  303. package/frontend/02-playbooks/react-state-management-playbook.md +173 -0
  304. package/frontend/03-checklists/component-quality-checklist.md +166 -0
  305. package/frontend/03-checklists/frontend-launch-checklist.md +299 -0
  306. package/frontend/04-antipatterns/frontend-antipatterns.md +886 -0
  307. package/frontend/05-cases/case-performance-optimization.md +274 -0
  308. package/harmony/01-standards/harmonyos-arkts-standard.md +75 -0
  309. package/harmony/01-standards/harmonyos-design.md +65 -0
  310. package/high-quality-engineering-playbook.md +54 -0
  311. package/incident/01-standards/incident-response-complete.md +303 -0
  312. package/incident/02-playbooks/chaos-engineering-playbook.md +883 -0
  313. package/incident/02-playbooks/postmortem-playbook.md +398 -0
  314. package/incident/03-checklists/incident-readiness-checklist.md +181 -0
  315. package/incident/04-antipatterns/incident-antipatterns.md +490 -0
  316. package/incident/05-cases/case-cascade-failure.md +176 -0
  317. package/incident/06-glossary/incident-glossary.md +114 -0
  318. package/incident/postmortem-and-response-deep-dive.md +39 -0
  319. package/industries/ecommerce/ecommerce-complete.md +631 -0
  320. package/industries/education/education-complete.md +555 -0
  321. package/industries/fintech/fintech-complete.md +501 -0
  322. package/industries/gaming/gaming-complete.md +587 -0
  323. package/industries/healthcare/healthcare-complete.md +452 -0
  324. package/low-code/01-standards/low-code-complete.md +944 -0
  325. package/miniprogram/01-standards/ai-common-mistakes.md +61 -0
  326. package/miniprogram/01-standards/miniprogram-custom-navbar-capsule.md +77 -0
  327. package/miniprogram/01-standards/miniprogram-design.md +61 -0
  328. package/miniprogram/01-standards/miniprogram-standard.md +81 -0
  329. package/mobile/01-standards/android-material-design.md +70 -0
  330. package/mobile/01-standards/flutter-complete.md +384 -0
  331. package/mobile/01-standards/ios-design-hig.md +78 -0
  332. package/mobile/01-standards/mobile-app-standard.md +85 -0
  333. package/mobile/01-standards/react-native-complete.md +352 -0
  334. package/mobile/02-playbooks/mobile-cross-platform-playbook.md +175 -0
  335. package/mobile/02-playbooks/mobile-performance.md +473 -0
  336. package/mobile/03-checklists/mobile-release-checklist.md +234 -0
  337. package/mobile/04-antipatterns/mobile-antipatterns.md +798 -0
  338. package/mobile/05-cases/case-app-performance.md +500 -0
  339. package/mobile/05-cases/case-app-startup-optimization.md +218 -0
  340. package/mobile/06-glossary/mobile-glossary.md +484 -0
  341. package/observability/01-standards/observability-standards.md +103 -0
  342. package/observability/02-playbooks/prometheus-grafana-playbook.md +135 -0
  343. package/observability/02-playbooks/structured-logging-playbook.md +73 -0
  344. package/observability/03-checklists/observability-checklist.md +54 -0
  345. package/observability/04-antipatterns/observability-antipatterns.md +106 -0
  346. package/operations/01-standards/prometheus-monitoring-complete.md +1578 -0
  347. package/operations/02-playbooks/capacity-planning-playbook.md +620 -0
  348. package/operations/03-checklists/production-launch-checklist.md +365 -0
  349. package/operations/04-antipatterns/operations-antipatterns.md +664 -0
  350. package/operations/05-cases/case-sre-practices.md +581 -0
  351. package/operations/06-glossary/operations-glossary.md +120 -0
  352. package/operations/aiops-anomaly-detection.md +758 -0
  353. package/operations/capacity-planning.md +1061 -0
  354. package/operations/chaos-engineering.md +659 -0
  355. package/operations/incident-command-system.md +38 -0
  356. package/operations/observability-complete.md +442 -0
  357. package/operations/slo-sli-playbook.md +517 -0
  358. package/operations/sre-operations-deep-dive.md +39 -0
  359. package/package.json +8 -0
  360. package/performance/01-standards/performance-and-scalability.md +80 -0
  361. package/performance/01-standards/performance-standards.md +156 -0
  362. package/performance/02-playbooks/query-optimization-playbook.md +103 -0
  363. package/performance/03-checklists/performance-checklist.md +56 -0
  364. package/performance/04-antipatterns/performance-antipatterns.md +146 -0
  365. package/product/01-standards/product-management-complete.md +285 -0
  366. package/product/02-playbooks/feature-launch-playbook.md +207 -0
  367. package/product/02-playbooks/user-research-playbook.md +532 -0
  368. package/product/03-checklists/feature-launch-checklist.md +275 -0
  369. package/product/04-antipatterns/product-antipatterns.md +355 -0
  370. package/product/05-cases/case-mvp-to-scale.md +384 -0
  371. package/product/06-glossary/product-glossary.md +462 -0
  372. package/product/feature-prioritization-framework.md +40 -0
  373. package/product/kpi-and-metric-tree.md +37 -0
  374. package/product/product-discovery-and-prd-deep-dive.md +41 -0
  375. package/quantum/01-standards/quantum-complete.md +1186 -0
  376. package/security/01-standards/api-security-complete.md +511 -0
  377. package/security/01-standards/container-runtime-security.md +574 -0
  378. package/security/01-standards/data-protection-gdpr.md +543 -0
  379. package/security/01-standards/owasp-top10-complete.md +1890 -0
  380. package/security/01-standards/secure-coding-baseline.md +90 -0
  381. package/security/01-standards/supply-chain-security.md +441 -0
  382. package/security/01-standards/web-security-checklist.md +108 -0
  383. package/security/01-standards/zero-trust-architecture.md +521 -0
  384. package/security/02-playbooks/auth-sso-playbook.md +166 -0
  385. package/security/02-playbooks/incident-response-security-playbook.md +588 -0
  386. package/security/02-playbooks/owasp-api-security-playbook.md +129 -0
  387. package/security/02-playbooks/payment-integration-playbook.md +119 -0
  388. package/security/02-playbooks/penetration-testing-playbook.md +517 -0
  389. package/security/03-checklists/security-audit-checklist.md +356 -0
  390. package/security/04-antipatterns/security-coding-antipatterns.md +580 -0
  391. package/security/05-cases/case-log4shell-incident.md +537 -0
  392. package/security/05-cases/case-major-breaches.md +468 -0
  393. package/security/06-glossary/security-glossary.md +212 -0
  394. package/security/compliance-automation.md +993 -0
  395. package/security/container-security.md +680 -0
  396. package/security/devsecops-complete.md +426 -0
  397. package/security/sast-dast-sca.md +775 -0
  398. package/security/secrets-management.md +594 -0
  399. package/security/security-architecture-deep-dive.md +37 -0
  400. package/security/threat-modeling-stride-playbook.md +40 -0
  401. package/seed-templates/auth-system.md +59 -0
  402. package/seed-templates/blog-content.md +94 -0
  403. package/seed-templates/dashboard.md +89 -0
  404. package/seed-templates/docs-site.md +73 -0
  405. package/seed-templates/e-commerce.md +50 -0
  406. package/seed-templates/saas-landing.md +92 -0
  407. package/seed-templates/settings-page.md +51 -0
  408. package/testing/01-standards/test-strategy-and-layering.md +83 -0
  409. package/testing/01-standards/testing-strategy-complete.md +422 -0
  410. package/testing/01-standards/unit-testing-best-practices.md +118 -0
  411. package/testing/02-playbooks/e2e-testing-playbook.md +988 -0
  412. package/testing/02-playbooks/testing-strategy-playbook.md +126 -0
  413. package/testing/03-checklists/test-strategy-checklist.md +208 -0
  414. package/testing/04-antipatterns/testing-antipatterns.md +718 -0
  415. package/testing/05-cases/case-testing-transformation.md +300 -0
  416. package/testing/06-glossary/testing-glossary.md +110 -0
  417. package/testing/risk-based-test-matrix.md +36 -0
  418. package/testing/testing-strategy-deep-dive.md +37 -0
package/frontend/02-playbooks/i18n-internationalization-playbook.md ADDED
@@ -0,0 +1,120 @@
1
+ ---
2
+ id: i18n-internationalization-playbook
3
+ title: 国际化（i18n）实战手册
4
+ domain: frontend
5
+ category: 02-playbooks
6
+ difficulty: advanced
7
+ tags: [i18n, internationalization, l10n, localization, react-intl, next-intl, rtl, icu, translation, multilingual, enterprise]
8
+ quality_score: 93
9
+ maintainer: frontend-team@umadev.com
10
+ last_updated: 2026-06-15
11
+ ---
12
+
13
+ # 国际化（i18n）实战手册
14
+
15
+ ## 核心概念
16
+
17
+ - **i18n**（internationalization）：代码架构上支持多语言（不硬编码字符串）
18
+ - **l10n**（localization）：翻译适配到具体语言/地区
19
+ - **RTL**（Right-to-Left）：阿拉伯语/希伯来语从右到左的布局
20
+
21
+ ## React/Next.js 实现
22
+
23
+ ### next-intl（Next.js App Router 推荐）
24
+ ```typescript
25
+ // messages/en.json
26
+ { "HomePage": { "title": "Welcome", "greeting": "Hello, {name}!" } }
27
+ // messages/zh.json
28
+ { "HomePage": { "title": "欢迎", "greeting": "你好，{name}！" } }
29
+
30
+ // 组件中使用
31
+ import { useTranslations } from 'next-intl';
32
+ function HomePage({ name }: { name: string }) {
33
+ const t = useTranslations('HomePage');
34
+ return (
35
+ <>
36
+ <h1>{t('title')}</h1>
37
+ <p>{t('greeting', { name })}</p> {/* ICU MessageFormat 插值 */}
38
+ </>
39
+ );
40
+ }
41
+ ```
42
+
43
+ ### react-intl（纯 React）
44
+ ```tsx
45
+ import { FormattedMessage, IntlProvider } from 'react-intl';
46
+
47
+ <IntlProvider locale="zh" messages={zhMessages}>
48
+ <FormattedMessage id="greeting" values={{ name: "张三" }} />
49
+ </IntlProvider>
50
+ ```
51
+
52
+ ## ICU MessageFormat（翻译标准）
53
+
54
+ ```json
55
+ // 简单插值
56
+ "greeting": "Hello, {name}"
57
+
58
+ // 复数（不同语言复数规则不同！）
59
+ "items": "{count, plural, =0 {No items} one {# item} other {# items}}"
60
+ // 中文不区分单复数 → "其他" 分支
61
+ // 阿拉伯语有 6 种复数形式！
62
+
63
+ // 选择（性别等）
64
+ "pronoun": "{gender, select, male {he} female {she} other {they}}"
65
+
66
+ // 日期/数字（本地化格式）
67
+ "price": "{amount, number, ::currency USD}"
68
+ "date": "{date, date, ::yyyyMMdd}"
69
+ ```
70
+
71
+ ## RTL（从右到左）支持
72
+
73
+ ```css
74
+ /* ✅ 用逻辑属性（不用 left/right） */
75
+ .card {
76
+ margin-inline-start: 16px; /* LTR: left, RTL: right */
77
+ padding-inline-end: 24px; /* LTR: right, RTL: left */
78
+ text-align: start; /* LTR: left, RTL: right */
79
+ inset-inline-start: 0; /* 替代 left: 0 */
80
+ }
81
+
82
+ /* ❌ 用物理属性（RTL 下布局错乱） */
83
+ .card {
84
+ margin-left: 16px; /* RTL 下应该是 right */
85
+ }
86
+
87
+ /* 方向切换 */
88
+ [dir="rtl"] .icon-arrow { transform: scaleX(-1); } /* 箭头翻转 */
89
+ ```
90
+
91
+ ```tsx
92
+ // Next.js 设置方向
93
+ <html lang="ar" dir="rtl">
94
+ ```
95
+
96
+ ## 日期/时间/数字本地化
97
+
98
+ ```typescript
99
+ // ✅ 用 Intl API（浏览器原生，无需库）
100
+ new Intl.DateTimeFormat('zh-CN', { dateStyle: 'full' })
101
+ .format(new Date()); // "2024年6月15日星期六"
102
+
103
+ new Intl.NumberFormat('de-DE', { style: 'currency', currency: 'EUR' })
104
+ .format(99.5); // "99,50 €"
105
+
106
+ new Intl.NumberFormat('en-US').format(1000000); // "1,000,000"
107
+ new Intl.NumberFormat('de-DE').format(1000000); // "1.000.000"
108
+ ```
109
+
110
+ ## 生产检查清单
111
+ - [ ] 所有用户可见字符串走翻译文件（无硬编码）
112
+ - [ ] ICU MessageFormat 处理插值/复数/性别
113
+ - [ ] 日期/时间/数字用 Intl API（不用手写格式）
114
+ - [ ] RTL 布局用逻辑 CSS 属性（inline-start/end）
115
+ - [ ] 语言切换不刷新页面（动态加载 locale 消息）
116
+ - [ ] 翻译文件按页面/功能拆分（不一个巨型 JSON）
117
+ - [ ] 翻译 key 命名规范（`PageName.elementName`）
118
+ - [ ] 缺失翻译有 fallback（不显示 key 本身）
119
+ - [ ] SEO 的 hreflang 标签（多语言 URL）
120
+ - [ ] 输入法支持（IME composition 不打断）
package/frontend/02-playbooks/performance-optimization-playbook.md ADDED
@@ -0,0 +1,163 @@
1
+ ---
2
+ id: performance-optimization-playbook
3
+ title: 前端性能优化实战剧本
4
+ domain: frontend
5
+ category: 02-playbooks
6
+ difficulty: advanced
7
+ tags: [frontend, performance, optimization]
8
+ quality_score: 91
9
+ maintainer: frontend-team@umadev.com
10
+ last_updated: 2026-03-29
11
+ ---
12
+
13
+ # 前端性能优化实战剧本
14
+
15
+ ## 场景 1: Web Vitals 优化
16
+
17
+ ### 目标指标
18
+ - LCP (Largest Contentful Paint): < 2.5s
19
+ - FID (First Input Delay): < 100ms
20
+ - CLS (Cumulative Layout Shift): < 0.1
21
+
22
+ ### 优化 LCP
23
+
24
+ ```html
25
+ <!-- 1. 预加载关键资源 -->
26
+ <link rel="preload" href="critical.css" as="style">
27
+ <link rel="preload" href="hero.webp" as="image">
28
+
29
+ <!-- 2. 内联关键 CSS -->
30
+ <style>
31
+ .hero { background: url(hero.webp); }
32
+ </style>
33
+
34
+ <!-- 3. 延迟非关键资源 -->
35
+ <link rel="preload" href="analytics.js" as="script" onload="this.onload=null">
36
+ ```
37
+
38
+ ### 优化 FID
39
+
40
+ ```javascript
41
+ // 1. 代码分割
42
+ import('./heavy-module.js').then(module => {
43
+ module.init();
44
+ });
45
+
46
+ // 2. 预连接关键域名
47
+ <link rel="preconnect" href="https://api.example.com">
48
+ <link rel="dns-prefetch" href="https://cdn.example.com">
49
+
50
+ // 3. 减少 JavaScript 阻塞
51
+ <script defer src="analytics.js"></script>
52
+ ```
53
+
54
+ ### 优化 CLS
55
+
56
+ ```css
57
+ /* 1. 预留图片空间 */
58
+ .image-container {
59
+ aspect-ratio: 16 / 9;
60
+ background: #f0f0f0;
61
+ }
62
+
63
+ /* 2. 避免动态注入内容 */
64
+ .ad-slot {
65
+ min-height: 250px;
66
+ }
67
+
68
+ /* 3. 使用 transform 动画 */
69
+ @keyframes slide {
70
+ from { transform: translateX(0); }
71
+ to { transform: translateX(100px); }
72
+ }
73
+ ```
74
+
75
+ ## 场景 2: JavaScript 性能优化
76
+
77
+ ### 代码分割策略
78
+ ```javascript
79
+ // 1. 路由级分割
80
+ const HomePage = lazy(() => import('./Home'));
81
+ const AboutPage = lazy(() => import('./About'));
82
+
83
+ // 2. 组件级分割
84
+ const HeavyChart = lazy(() => import('./Chart'));
85
+
86
+ // 3. 第三方库分割
87
+ import('lodash/debounce').then(debounce => {
88
+ window.addEventListener('resize', debounce(handler, 300));
89
+ });
90
+ ```
91
+
92
+ ### 防抖和节流
93
+ ```javascript
94
+ // 防抖: 延迟执行
95
+ function debounce(fn, delay) {
96
+ let timeoutId;
97
+ return (...args) => {
98
+ clearTimeout(timeoutId);
99
+ timeoutId = setTimeout(() => fn(...args), delay);
100
+ };
101
+ }
102
+
103
+ // 节流: 定期执行
104
+ function throttle(fn, limit) {
105
+ let inThrottle;
106
+ return (...args) => {
107
+ if (!inThrottle) {
108
+ fn(...args);
109
+ inThrottle = true;
110
+ setTimeout(() => inThrottle = false, limit);
111
+ }
112
+ };
113
+ }
114
+
115
+ // 应用
116
+ const handleScroll = throttle(() => {
117
+ console.log('Scroll event');
118
+ }, 200);
119
+ ```
120
+
121
+ ## 场景 3: 资源优化
122
+
123
+ ### 图片优化
124
+ ```html
125
+ <!-- 1. 响应式图片 -->
126
+ <picture>
127
+ <source media="(min-width: 800px)" srcset="hero-large.webp">
128
+ <source media="(min-width: 400px)" srcset="hero-medium.webp">
129
+ <img src="hero-small.webp" alt="Hero" loading="lazy">
130
+ </picture>
131
+
132
+ <!-- 2. 懒加载 -->
133
+ <img src="image.webp" loading="lazy" alt="Lazy loaded">
134
+
135
+ <!-- 3. WebP 格式 -->
136
+ <picture>
137
+ <source srcset="image.webp" type="image/webp">
138
+ <source srcset="image.jpg" type="image/jpeg">
139
+ <img src="image.jpg" alt="Fallback">
140
+ </picture>
141
+ ```
142
+
143
+ ### 缓存策略
144
+ ```javascript
145
+ // Service Worker 缓存
146
+ self.addEventListener('fetch', event => {
147
+ event.respondWith(
148
+ caches.match(event.request)
149
+ .then(response => {
150
+ if (response) {
151
+ return response;
152
+ }
153
+ return fetch(event.request)
154
+ .then(response => {
155
+ return caches.open('dynamic').then(cache => {
156
+ cache.put(event.request, response.clone());
157
+ return response;
158
+ });
159
+ });
160
+ })
161
+ );
162
+ });
163
+ ```
package/frontend/02-playbooks/react-nextjs-production-playbook.md ADDED
@@ -0,0 +1,167 @@
1
+ ---
2
+ id: react-nextjs-production-playbook
3
+ title: React/Next.js 生产级实战手册
4
+ domain: frontend
5
+ category: 02-playbooks
6
+ difficulty: advanced
7
+ tags: [frontend, react, nextjs, server-components, performance, ssr, streaming, suspense, code-splitting, bundle, rsc]
8
+ quality_score: 93
9
+ maintainer: frontend-team@umadev.com
10
+ last_updated: 2026-06-14
11
+ ---
12
+
13
+ # React/Next.js 生产级实战手册
14
+
15
+ > 基于 [Next.js 官方 Production Checklist](https://nextjs.org/docs/app/guides/production-checklist) + [Next.js 14 性能优化](https://dev.to/hijazi313/nextjs-14-performance-optimization-modern-approaches-for-production-applications-3n65)
16
+
17
+ ## Server Components vs Client Components
18
+
19
+ ### 默认用 Server Components
20
+ ```tsx
21
+ // ✅ 默认就是 Server Component（零客户端 JS）
22
+ // 数据在服务端获取，HTML 直传浏览器
23
+ async function ProductList() {
24
+ const products = await fetch('/api/products').then(r => r.json());
25
+ return products.map(p => <ProductCard key={p.id} {...p} />);
26
+ }
27
+
28
+ // ✅ 只在需要交互时标 "use client"
29
+ "use client";
30
+ import { useState } from 'react';
31
+ function AddToCart({ productId }: { productId: string }) {
32
+ const [count, setCount] = useState(0);
33
+ return <button onClick={() => setCount(count + 1)}>Add ({count})</button>;
34
+ }
35
+ ```
36
+
37
+ ### 何时用哪种
38
+ | 场景 | 选择 | 原因 |
39
+ |------|------|------|
40
+ | 静态内容/列表展示 | Server Component | 零 JS，SEO 友好 |
41
+ | 数据获取 | Server Component | 服务端并行获取 |
42
+ | 事件处理/状态 | Client Component | 需要 useState/useEffect |
43
+ | 浏览器 API | Client Component | window/localStorage |
44
+
45
+ ## 性能优化模式
46
+
47
+ ### 1. Streaming + Suspense
48
+ ```tsx
49
+ // ✅ 流式渲染——页面立刻显示，数据部分加载后填充
50
+ export default function Page() {
51
+ return (
52
+ <>
53
+ <Header /> {/* 立刻渲染 */}
54
+ <Suspense fallback={<Skeleton />}>
55
+ <SlowDashboard /> {/* 数据加载完后填充 */}
56
+ </Suspense>
57
+ <Suspense fallback={<Skeleton />}>
58
+ <Comments /> {/* 独立加载 */}
59
+ </Suspense>
60
+ </>
61
+ );
62
+ }
63
+ ```
64
+
65
+ ### 2. 路由级代码分割
66
+ ```tsx
67
+ // ✅ 按路由自动分割（Next.js App Router 内置）
68
+ // 每个页面/布局自动是独立 chunk
69
+ // 只有访问该路由时才加载
70
+
71
+ // 手动动态导入（重型组件）
72
+ import dynamic from 'next/dynamic';
73
+ const CodeEditor = dynamic(() => import('./CodeEditor'), {
74
+ loading: () => <Skeleton />,
75
+ ssr: false, // 只在客户端加载
76
+ });
77
+ ```
78
+
79
+ ### 3. 图片优化
80
+ ```tsx
81
+ import Image from 'next/image';
82
+
83
+ // ✅ 自动：AVIF/WebP 转换 + 响应式 + 懒加载 + 防布局偏移
84
+ <Image
85
+ src="/hero.jpg"
86
+ alt="Hero"
87
+ width={1200}
88
+ height={600}
89
+ priority // 首屏图片优先加载（LCP）
90
+ sizes="(max-width: 768px) 100vw, 50vw"
91
+ />
92
+ ```
93
+
94
+ ### 4. 字体优化
95
+ ```tsx
96
+ import { Inter } from 'next/font/google';
97
+ // ✅ 自动 self-host + font-display: swap + 子集化
98
+ const inter = Inter({ subsets: ['latin'], display: 'swap' });
99
+ // 用 <html className={inter.className}>
100
+ ```
101
+
102
+ ## Bundle 大小控制
103
+
104
+ ```tsx
105
+ // ❌ 全量导入（bundle 膨胀）
106
+ import _ from 'lodash'; // 70KB
107
+ import * as Icons from 'lucide'; // 全部图标！
108
+
109
+ // ✅ 按需导入
110
+ import debounce from 'lodash/debounce'; // 1KB
111
+ import { Search, Menu } from 'lucide-react'; // 只引两个
112
+ ```
113
+
114
+ | 资源 | 预算 |
115
+ |------|------|
116
+ | First Load JS | < 150KB (gzip) |
117
+ | 单页 JS | < 50KB |
118
+ | CSS | < 30KB |
119
+
120
+ ## 数据获取最佳实践
121
+
122
+ ```tsx
123
+ // ✅ Server Component 内直接 fetch（自动缓存 + 去重）
124
+ async function Products() {
125
+ const res = await fetch('/api/products', { next: { revalidate: 60 } });
126
+ // revalidate=60: 60 秒 ISR（增量静态重新生成）
127
+ return <ProductGrid products={await res.json()} />;
128
+ }
129
+
130
+ // ✅ 并行获取（消除瀑布）
131
+ async function Dashboard() {
132
+ const [stats, orders, users] = await Promise.all([
133
+ fetch('/api/stats'),
134
+ fetch('/api/orders'),
135
+ fetch('/api/users'),
136
+ ]);
137
+ // 三个请求并行，不是串行
138
+ }
139
+ ```
140
+
141
+ ## 常见陷阱
142
+
143
+ ### 1. Server Component 传函数给 Client Component
144
+ ```tsx
145
+ // ❌ Server Component 不能传函数到 Client Component
146
+ <ClientList onClick={handleClick} /> // 报错！
147
+
148
+ // ✅ 传数据，交互在 Client Component 内部处理
149
+ <ClientList items={items} /> // ClientList 内部定义 onClick
150
+ ```
151
+
152
+ ### 2. 过度使用 "use client"
153
+ ```tsx
154
+ // ❌ 整个页面标 "use client"（放弃 SSR 优势）
155
+ "use client";
156
+ export default function Page() { /* 全客户端渲染 */ }
157
+
158
+ // ✅ 只在叶子组件标 "use client"
159
+ export default function Page() { // Server Component
160
+ return (
161
+ <div>
162
+ <StaticContent /> {/* Server */}
163
+ <InteractiveWidget /> {/* Client Component */}
164
+ </div>
165
+ );
166
+ }
167
+ ```
package/frontend/02-playbooks/react-state-management-playbook.md ADDED
@@ -0,0 +1,173 @@
1
+ ---
2
+ id: react-state-management-playbook
3
+ title: React 状态管理实战手册（2025）
4
+ domain: frontend
5
+ category: 02-playbooks
6
+ difficulty: advanced
7
+ tags: [react, state-management, zustand, redux, redux-toolkit, jotai, context, state, frontend, enterprise]
8
+ quality_score: 93
9
+ maintainer: frontend-team@umadev.com
10
+ last_updated: 2026-06-15
11
+ ---
12
+
13
+ # React 状态管理实战手册（2025）
14
+
15
+ > 基于 [State Management in 2025](https://dev.to/hijazi313/state-management-in-2025-when-to-use-context-redux-zustand-or-jotai-2d2k) + [Makers Den 2025 Guide](https://makersden.io/blog/react-state-management-in-2025) + [Reddit 2025 共识](https://www.reddit.com/r/react/comments/1neu4wc/)
16
+
17
+ ## 选型决策树
18
+
19
+ ```
20
+ 状态类型？
21
+ ├── 服务端数据（API 响应）→ React Query / SWR（不是 Redux！）
22
+ ├── URL 状态（筛选/分页）→ URL params / searchParams
23
+ ├── 表单状态 → React Hook Form / Zod
24
+ ├── 局部 UI 状态 → useState / useReducer
25
+ └── 全局客户端状态
26
+ ├── 简单（< 10 个状态）→ Zustand
27
+ ├── 复杂（大量交互/时间旅行）→ Redux Toolkit
28
+ ├── 细粒度派生 → Jotai
29
+ └── 状态机 → XState
30
+ ```
31
+
32
+ ## Zustand（推荐默认选择）
33
+
34
+ ```typescript
35
+ import { create } from 'zustand';
36
+ import { devtools, persist } from 'zustand/middleware';
37
+
38
+ interface CartStore {
39
+ items: CartItem[];
40
+ addItem: (item: CartItem) => void;
41
+ removeItem: (id: string) => void;
42
+ clear: () => void;
43
+ total: () => number;
44
+ }
45
+
46
+ // ✅ 无 Provider、无 boilerplate、性能好
47
+ export const useCart = create<CartStore>()(
48
+ devtools( // Redux DevTools 支持
49
+ persist( // localStorage 持久化
50
+ (set, get) => ({
51
+ items: [],
52
+ addItem: (item) => set((s) => ({ items: [...s.items, item] })),
53
+ removeItem: (id) => set((s) => ({ items: s.items.filter(i => i.id !== id) })),
54
+ clear: () => set({ items: [] }),
55
+ total: () => get().items.reduce((sum, i) => sum + i.price * i.qty, 0),
56
+ }),
57
+ { name: 'cart-storage' }
58
+ )
59
+ )
60
+ );
61
+
62
+ // 组件中用——只订阅需要的字段（性能优化）
63
+ function CartTotal() {
64
+ const total = useCart((s) => s.items.reduce((sum, i) => sum + i.price * i.qty, 0));
65
+ return <span>${total.toFixed(2)}</span>;
66
+ }
67
+ ```
68
+
69
+ ## Redux Toolkit（复杂应用）
70
+
71
+ ```typescript
72
+ import { createSlice, configureStore, createAsyncThunk } from '@reduxjs/toolkit';
73
+
74
+ // Slice（比旧版 Redux 少 80% boilerplate）
75
+ const orderSlice = createSlice({
76
+ name: 'orders',
77
+ initialState: { items: [], loading: false, error: null },
78
+ reducers: {
79
+ clearOrders: (state) => { state.items = []; },
80
+ },
81
+ extraReducers: (builder) => {
82
+ builder
83
+ .addCase(fetchOrders.pending, (state) => { state.loading = true; })
84
+ .addCase(fetchOrders.fulfilled, (state, action) => {
85
+ state.loading = false;
86
+ state.items = action.payload;
87
+ })
88
+ .addCase(fetchOrders.rejected, (state, action) => {
89
+ state.loading = false;
90
+ state.error = action.error.message;
91
+ });
92
+ },
93
+ });
94
+
95
+ // Async thunk
96
+ export const fetchOrders = createAsyncThunk('orders/fetch', async () => {
97
+ return await api.get('/api/orders');
98
+ });
99
+
100
+ // Store
101
+ const store = configureStore({
102
+ reducer: { orders: orderSlice.reducer },
103
+ });
104
+ ```
105
+
106
+ ## Jotai（细粒度原子状态）
107
+
108
+ ```typescript
109
+ import { atom, useAtom } from 'jotai';
110
+
111
+ // ✅ 原子化——每个状态独立，精准更新
112
+ const filterAtom = atom('all');
113
+ const todosAtom = atom<Todo[]>([]);
114
+ const filteredTodosAtom = atom((get) => {
115
+ const filter = get(filterAtom);
116
+ const todos = get(todosAtom);
117
+ if (filter === 'active') return todos.filter(t => !t.done);
118
+ if (filter === 'done') return todos.filter(t => t.done);
119
+ return todos;
120
+ });
121
+
122
+ // 组件只订阅派生的原子
123
+ function TodoList() {
124
+ const [todos] = useAtom(filteredTodosAtom);
125
+ return todos.map(t => <TodoItem key={t.id} todo={t} />);
126
+ }
127
+ ```
128
+
129
+ ## 服务端状态：React Query（不要用 Redux 管 API 数据！）
130
+
131
+ ```typescript
132
+ import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
133
+
134
+ // ✅ React Query 管 API 数据（缓存/重试/失效/乐观更新）
135
+ function useOrders() {
136
+ return useQuery({
137
+ queryKey: ['orders'],
138
+ queryFn: () => api.get('/api/orders'),
139
+ staleTime: 60000, // 1 分钟内不重新请求
140
+ });
141
+ }
142
+
143
+ function useCreateOrder() {
144
+ const qc = useQueryClient();
145
+ return useMutation({
146
+ mutationFn: (data) => api.post('/api/orders', data),
147
+ onSuccess: () => qc.invalidateQueries({ queryKey: ['orders'] }), // 自动刷新列表
148
+ });
149
+ }
150
+ ```
151
+
152
+ ## 状态反模式
153
+
154
+ ```tsx
155
+ // ❌ 把 API 响应放 Redux（React Query 做得更好）
156
+ // ❌ 把 URL 筛选放全局状态（URL params 更可分享/可书签）
157
+ // ❌ Context 放高频更新数据（所有消费者重渲染）
158
+ // ❌ 所有状态都全局化（能局部就局部）
159
+
160
+ // ✅ 服务端数据 → React Query
161
+ // ✅ URL 状态 → useSearchParams
162
+ // ✅ 全局 UI 状态 → Zustand
163
+ // ✅ 局部状态 → useState
164
+ ```
165
+
166
+ ## 生产检查清单
167
+ - [ ] 服务端数据用 React Query/SWR（不用 Redux）
168
+ - [ ] URL 状态在 URL（可分享/可书签）
169
+ - [ ] 全局状态用 Zustand（默认）或 RTK（复杂）
170
+ - [ ] Context 只用于低频更新（theme/locale）
171
+ - [ ] 状态选择器精准（避免全量重渲染）
172
+ - [ ] 持久化关键状态（购物车/偏好）
173
+ - [ ] DevTools 可调试（Redux DevTools 兼容）