@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
@@ -0,0 +1,426 @@
1
+ ---
2
+ id: devsecops-complete
3
+ title: DevSecOps 完整实践指南
4
+ domain: security
5
+ category: devsecops-complete.md
6
+ difficulty: intermediate
7
+ tags: [complete, devsecops, security, 安全工具链, 安全度量指标, 实施路径, 常见反模式, 最佳实践]
8
+ quality_score: 70
9
+ last_updated: 2026-06-15
10
+ ---
11
+ # DevSecOps 完整实践指南
12
+
13
+ ## 概述
14
+ DevSecOps 将安全性深度集成到 DevOps 流程中,实现安全左移(Shift Left),确保每个阶段都内置安全控制,而非事后补救。
15
+
16
+ ## 核心原则
17
+
18
+ ### 1. 安全左移(Shift Left Security)
19
+ - **设计阶段**: 威胁建模、安全架构评审
20
+ - **开发阶段**: 安全编码规范、SAST 扫描
21
+ - **测试阶段**: DAST、依赖扫描、渗透测试
22
+ - **部署阶段**: 容器安全、IaC 扫描、配置检查
23
+ - **运行阶段**: RASP、CSPM、实时监控
24
+
25
+ ### 2. 安全即代码(Security as Code)
26
+ - 策略定义代码化
27
+ - 安全测试自动化
28
+ - 配置管理版本化
29
+ - 合规检查可追溯
30
+
31
+ ### 3. 人人负责安全
32
+ - 开发者: 编写安全代码
33
+ - 运维: 安全配置和部署
34
+ - 安全团队: 提供工具和指导
35
+ - 产品: 安全需求纳入规划
36
+
37
+ ## DevSecOps 流水线
38
+
39
+ ### Phase 1: 计划与设计(Plan & Design)
40
+
41
+ #### 威胁建模
42
+ ```
43
+ STRIDE 方法论:
44
+ - Spoofing(欺骗): 认证机制
45
+ - Tampering(篡改): 完整性保护
46
+ - Repudiation(抵赖): 审计日志
47
+ - Information Disclosure(信息泄露): 加密和访问控制
48
+ - Denial of Service(拒绝服务): 限流和容错
49
+ - Elevation of Privilege(权限提升): 授权检查
50
+ ```
51
+
52
+ #### 安全需求
53
+ - 业务功能安全需求
54
+ - 合规性需求(GDPR, SOC2, PCI-DSS)
55
+ - 安全基线要求
56
+ - 隐私保护要求
57
+
58
+ #### 安全架构评审
59
+ - 认证授权方案
60
+ - 数据流向和加密
61
+ - 网络架构和隔离
62
+ - 第三方依赖风险评估
63
+
64
+ ### Phase 2: 编码(Coding)
65
+
66
+ #### 安全编码规范
67
+ ```
68
+ 通用原则:
69
+ 1. 输入验证: 白名单校验、参数化查询
70
+ 2. 输出编码: 防止 XSS、注入攻击
71
+ 3. 认证授权: 最小权限、会话管理
72
+ 4. 错误处理: 不泄露敏感信息
73
+ 5. 日志记录: 审计追踪、异常告警
74
+ ```
75
+
76
+ #### SAST 工具集成
77
+ ```yaml
78
+ # GitLab CI 示例
79
+ sast:
80
+ stage: test
81
+ script:
82
+ - semgrep --config=auto --json > sast-report.json
83
+ artifacts:
84
+ reports:
85
+ sast: sast-report.json
86
+ ```
87
+
88
+ #### 预提交检查
89
+ ```bash
90
+ # Git Hooks 示例
91
+ #!/bin/bash
92
+ # 检测敏感信息
93
+ git diff --cached --name-only | xargs grep -E "password|secret|api_key" && exit 1
94
+
95
+ # 运行 lint 和静态分析
96
+ npm run lint && npm run security-check
97
+ ```
98
+
99
+ ### Phase 3: 构建(Build)
100
+
101
+ #### 依赖扫描(SCA)
102
+ ```yaml
103
+ # 依赖扫描配置
104
+ dependency_scanning:
105
+ stage: build
106
+ script:
107
+ - npm audit --json > npm-audit.json
108
+ - trivy fs --severity HIGH,CRITICAL .
109
+ artifacts:
110
+ reports:
111
+ dependency_scanning: npm-audit.json
112
+ ```
113
+
114
+ #### 软件物料清单(SBOM)
115
+ ```bash
116
+ # 生成 SBOM
117
+ syft packages dir:. -o spdx-json > sbom.spdx.json
118
+ grype sbom:sbom.spdx.json --fail-on high
119
+ ```
120
+
121
+ #### 构建安全
122
+ - 使用可信基础镜像
123
+ - 最小化镜像层数
124
+ - 不在镜像中存储密钥
125
+ - 签名验证构建产物
126
+
127
+ ### Phase 4: 测试(Testing)
128
+
129
+ #### DAST 动态扫描
130
+ ```yaml
131
+ # OWASP ZAP 集成
132
+ dast:
133
+ stage: test
134
+ script:
135
+ - zap-baseline.py -t $TARGET_URL -r dast-report.html
136
+ artifacts:
137
+ reports:
138
+ dast: dast-report.html
139
+ ```
140
+
141
+ #### 容器安全扫描
142
+ ```bash
143
+ # Trivy 容器扫描
144
+ trivy image --severity HIGH,CRITICAL \
145
+ --ignore-unfixed \
146
+ --exit-code 1 \
147
+ myapp:latest
148
+ ```
149
+
150
+ #### IaC 安全扫描
151
+ ```bash
152
+ # Terraform 安全检查
153
+ checkov -d terraform/ --check CKV_AWS_*,CKV_GCP_*
154
+
155
+ # Kubernetes 清单检查
156
+ kubeconftest --policy opa/ kubernetes/
157
+ ```
158
+
159
+ #### 渗透测试
160
+ - 认证绕过测试
161
+ - 权限提升测试
162
+ - 注入攻击测试
163
+ - 业务逻辑漏洞测试
164
+
165
+ ### Phase 5: 部署(Deploy)
166
+
167
+ #### 密钥管理
168
+ ```yaml
169
+ # HashiCorp Vault 集成
170
+ vault:
171
+ stage: deploy
172
+ script:
173
+ - vault kv get -field=password secret/myapp > /dev/null
174
+ - export DB_PASSWORD=$(vault kv get -field=db_password secret/myapp)
175
+ ```
176
+
177
+ #### 部署门禁
178
+ ```yaml
179
+ # 质量门禁检查
180
+ deploy_gate:
181
+ stage: deploy
182
+ script:
183
+ - |
184
+ if [ "$(jq '.vulnerabilities | length' sast-report.json)" -gt 0 ]; then
185
+ echo "存在 SAST 漏洞,禁止部署"
186
+ exit 1
187
+ fi
188
+ - |
189
+ if [ "$(jq '.vulnerabilities | length' dast-report.json)" -gt 0 ]; then
190
+ echo "存在 DAST 漏洞,禁止部署"
191
+ exit 1
192
+ fi
193
+ ```
194
+
195
+ #### 运行时配置检查
196
+ ```yaml
197
+ # Kubernetes 安全策略
198
+ apiVersion: policy/v1beta1
199
+ kind: PodSecurityPolicy
200
+ metadata:
201
+ name: restricted
202
+ spec:
203
+ privileged: false
204
+ runAsUser:
205
+ rule: MustRunAsNonRoot
206
+ seLinux:
207
+ rule: RunAsAny
208
+ fsGroup:
209
+ rule: RunAsAny
210
+ ```
211
+
212
+ ### Phase 6: 运行(Runtime)
213
+
214
+ #### RASP 运行时保护
215
+ ```java
216
+ // OpenRASP 示例
217
+ rasp:
218
+ plugin:
219
+ - name: sql_injection
220
+ enable: true
221
+ action: block
222
+ - name: xss_filter
223
+ enable: true
224
+ action: block
225
+ ```
226
+
227
+ #### 安全监控
228
+ ```yaml
229
+ # Falco 运行时安全
230
+ - rule: Unexpected TCP Connection
231
+ desc: 检测异常 TCP 连接
232
+ condition: >
233
+ fd.typechar = 4 and proc.name != "nginx"
234
+ output: >
235
+ 异常网络连接 (user=%user.name command=%proc.cmdline)
236
+ priority: WARNING
237
+ ```
238
+
239
+ #### CSPM 云安全态势管理
240
+ ```bash
241
+ # Prowler AWS 安全检查
242
+ prowler aws --checks-groups extras --severity high critical
243
+ ```
244
+
245
+ ## 安全工具链
246
+
247
+ ### SAST 工具
248
+ | 工具 | 语言 | 特点 |
249
+ |------|------|------|
250
+ | Semgrep | 多语言 | 自定义规则、快速 |
251
+ | SonarQube | 多语言 | 集成度高、质量门禁 |
252
+ | Bandit | Python | 轻量级、专注 Python |
253
+ | ESLint Security | JavaScript | 前端安全检查 |
254
+
255
+ ### DAST 工具
256
+ | 工具 | 特点 | 适用场景 |
257
+ |------|------|----------|
258
+ | OWASP ZAP | 开源免费、功能全面 | Web 应用 |
259
+ | Burp Suite | 专业级、功能强大 | 渗透测试 |
260
+ | Nuclei | 快速扫描、模板化 | 漏洞验证 |
261
+ | SQLMap | SQL 注入专用 | 数据库安全 |
262
+
263
+ ### SCA 工具
264
+ | 工具 | 特点 | 数据库 |
265
+ |------|------|--------|
266
+ | Dependabot | GitHub 原生、自动化 | GitHub Advisory |
267
+ | Snyk | 实时更新、修复建议 | Snyk Intel |
268
+ | Trivy | 全栈扫描、快速 | 多源数据库 |
269
+ | Grype | 容器优先、SBOM 支持 | Anchore DB |
270
+
271
+ ### 容器安全
272
+ | 工具 | 特点 | 用途 |
273
+ |------|------|------|
274
+ | Trivy | 全面扫描、CI 友好 | 镜像扫描 |
275
+ | Clair | API 驱动、可扩展 | 镜像仓库集成 |
276
+ | Anchore | 策略引擎、合规检查 | 企业级扫描 |
277
+ | Falco | 运行时监控、规则灵活 | 运行时保护 |
278
+
279
+ ## 实施路径
280
+
281
+ ### Level 1: 基础建设(1-3 个月)
282
+ - [ ] 建立 CI/CD 流水线
283
+ - [ ] 集成 SAST 工具
284
+ - [ ] 依赖扫描自动化
285
+ - [ ] 基础镜像管理
286
+ - [ ] 密钥管理方案
287
+
288
+ ### Level 2: 深化集成(3-6 个月)
289
+ - [ ] DAST 自动化扫描
290
+ - [ ] 容器安全扫描
291
+ - [ ] IaC 安全检查
292
+ - [ ] 威胁建模流程
293
+ - [ ] 安全门禁机制
294
+
295
+ ### Level 3: 持续优化(6-12 个月)
296
+ - [ ] RASP 部署
297
+ - [ ] CSPM 监控
298
+ - [ ] 安全编排(SOAR)
299
+ - [ ] 红蓝对抗演练
300
+ - [ ] 安全度量体系
301
+
302
+ ## 安全度量指标
303
+
304
+ ### 开发阶段
305
+ - SAST 覆盖率: >= 95%
306
+ - 代码扫描频率: 每次提交
307
+ - 高危漏洞修复时间: <= 7 天
308
+ - 安全编码培训完成率: 100%
309
+
310
+ ### 测试阶段
311
+ - DAST 覆盖率: >= 80%
312
+ - 依赖扫描覆盖率: 100%
313
+ - 渗透测试频率: 每季度
314
+ - 漏洞修复验证率: 100%
315
+
316
+ ### 部署阶段
317
+ - 部署门禁覆盖率: 100%
318
+ - 密钥轮换频率: <= 90 天
319
+ - 容器镜像扫描率: 100%
320
+ - IaC 扫描覆盖率: 100%
321
+
322
+ ### 运行阶段
323
+ - RASP 部署覆盖率: >= 80%
324
+ - 安全事件响应时间: <= 1 小时
325
+ - CSPM 合规评分: >= 90 分
326
+ - 安全审计频率: 每月
327
+
328
+ ## 常见反模式
329
+
330
+ ### 1. 安全瓶颈
331
+ **问题**: 安全团队成为瓶颈,延迟发布
332
+ **解决**:
333
+ - 自动化安全测试
334
+ - 赋能开发团队
335
+ - 并行化安全检查
336
+ - 风险分级处理
337
+
338
+ ### 2. 扫描疲劳
339
+ **问题**: 大量误报,团队忽视漏洞
340
+ **解决**:
341
+ - 优化规则精度
342
+ - 建立白名单机制
343
+ - 优先级排序
344
+ - 定期校准工具
345
+
346
+ ### 3. 工具孤岛
347
+ **问题**: 工具分散,缺乏集成
348
+ **解决**:
349
+ - 统一安全平台
350
+ - 标准化报告格式
351
+ - 集成到 DevOps 平台
352
+ - 单一视图仪表板
353
+
354
+ ### 4. 一次性检查
355
+ **问题**: 只在上线前扫描,无持续监控
356
+ **解决**:
357
+ - 持续扫描机制
358
+ - 运行时保护
359
+ - 定期重新评估
360
+ - 监控和告警
361
+
362
+ ## 最佳实践
363
+
364
+ ### 1. 渐进式实施
365
+ - 优先集成高价值工具
366
+ - 从阻塞型门禁开始
367
+ - 逐步提升覆盖范围
368
+ - 持续优化流程
369
+
370
+ ### 2. 开发者友好
371
+ - 快速反馈(< 10 分钟)
372
+ - 清晰的修复指引
373
+ - IDE 集成插件
374
+ - 自助式修复工具
375
+
376
+ ### 3. 自动化优先
377
+ - 减少人工干预
378
+ - 策略即代码
379
+ - 自动修复建议
380
+ - 自愈能力
381
+
382
+ ### 4. 可视化度量
383
+ - 实时安全仪表板
384
+ - 趋势分析
385
+ - 对比报告
386
+ - 合规证据
387
+
388
+ ## 企业级实施案例
389
+
390
+ ### 金融行业
391
+ ```yaml
392
+ 要求:
393
+ - PCI-DSS 合规
394
+ - 数据加密传输存储
395
+ - 严格的访问控制
396
+ - 审计日志保留 7 年
397
+
398
+ 实施:
399
+ 1. 数据库加密(TDE)
400
+ 2. 密钥管理(Vault)
401
+ 3. 网络隔离(VPC)
402
+ 4. WAF 防护
403
+ 5. 定期渗透测试
404
+ ```
405
+
406
+ ### SaaS 平台
407
+ ```yaml
408
+ 要求:
409
+ - SOC2 Type II 认证
410
+ - 多租户隔离
411
+ - 数据主权
412
+ - 高可用性
413
+
414
+ 实施:
415
+ 1. 租户数据隔离
416
+ 2. 细粒度权限控制
417
+ 3. 数据备份和恢复
418
+ 4. 灾难恢复方案
419
+ 5. 安全审计和报告
420
+ ```
421
+
422
+ ## 参考资料
423
+ - [OWASP DevSecOps Guideline](https://owasp.org/www-project-devsecops-guideline/)
424
+ - [NIST Secure Software Development Framework](https://csrc.nist.gov/publications/detail/sp/800-218/final)
425
+ - [CIS Docker Benchmark](https://www.cisecurity.org/benchmark/docker)
426
+ - [Kubernetes Security Best Practices](https://kubernetes.io/docs/concepts/security/)