@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,775 @@
1
+ ---
2
+ id: sast-dast-sca
3
+ title: SAST/DAST/SCA 完整指南
4
+ domain: security
5
+ category: sast-dast-sca.md
6
+ difficulty: intermediate
7
+ tags: [dast, sast, sca, security, 三者对比, 动态应用安全测试, 报告和度量, 概述]
8
+ quality_score: 70
9
+ last_updated: 2026-06-15
10
+ ---
11
+ # SAST/DAST/SCA 完整指南
12
+
13
+ ## 概述
14
+ SAST(静态应用安全测试)、DAST(动态应用安全测试)和 SCA(软件成分分析)是应用安全的三大核心测试方法,覆盖代码、运行时和依赖的安全检查。
15
+
16
+ ## 三者对比
17
+
18
+ | 维度 | SAST | DAST | SCA |
19
+ |------|------|------|-----|
20
+ | 测试阶段 | 编码/构建 | 运行时 | 构建/部署 |
21
+ | 扫描对象 | 源代码 | 运行应用 | 第三方依赖 |
22
+ | 检测类型 | 代码漏洞 | 运行时漏洞 | 依赖漏洞 |
23
+ | 误报率 | 中-高 | 低 | 低 |
24
+ | 修复成本 | 低 | 高 | 中 |
25
+ | 自动化程度 | 高 | 中 | 高 |
26
+
27
+ ## SAST - 静态应用安全测试
28
+
29
+ ### 工作原理
30
+ ```
31
+ 源代码 -> 词法分析 -> 语法树(AST) -> 数据流分析 -> 污点追踪 -> 漏洞报告
32
+ ```
33
+
34
+ ### 支持的漏洞类型
35
+ ```yaml
36
+ 输入验证:
37
+ - SQL 注入
38
+ - XSS(跨站脚本)
39
+ - 命令注入
40
+ - LDAP 注入
41
+ - XPath 注入
42
+
43
+ 认证授权:
44
+ - 硬编码密码
45
+ - 弱加密算法
46
+ - 不安全的随机数
47
+ - Session 管理缺陷
48
+
49
+ 配置安全:
50
+ - 不安全的配置
51
+ - 敏感信息泄露
52
+ - 调试信息暴露
53
+ - 不安全的默认值
54
+
55
+ 并发安全:
56
+ - 竞态条件
57
+ - 死锁风险
58
+ - 资源泄露
59
+ ```
60
+
61
+ ### 工具选型
62
+
63
+ #### Semgrep(推荐)
64
+ ```yaml
65
+ # .semgrepignore
66
+ node_modules/
67
+ dist/
68
+ build/
69
+ *.min.js
70
+
71
+ # semgrep.yaml
72
+ rules:
73
+ - id: sql-injection
74
+ patterns:
75
+ - pattern: |
76
+ cursor.execute($QUERY, ...)
77
+ - pattern-not: |
78
+ cursor.execute("...", ...)
79
+ message: 检测到 SQL 注入风险
80
+ severity: ERROR
81
+ languages: [python]
82
+ ```
83
+
84
+ ```bash
85
+ # 运行 Semgrep
86
+ semgrep --config=auto --json --output=semgrep-report.json
87
+
88
+ # 使用自定义规则
89
+ semgrep --config=semgrep.yaml --severity ERROR
90
+ ```
91
+
92
+ #### SonarQube
93
+ ```yaml
94
+ # sonar-project.properties
95
+ sonar.projectKey=myapp
96
+ sonar.sources=src/
97
+ sonar.tests=tests/
98
+ sonar.exclusions=**/*.test.js,**/*.spec.js
99
+ sonar.javascript.lcov.reportPaths=coverage/lcov.info
100
+ sonar.security.hotspots.review=true
101
+ sonar.qualitygate.wait=true
102
+ ```
103
+
104
+ ```bash
105
+ # 运行 SonarQube 扫描
106
+ sonar-scanner \
107
+ -Dsonar.host.url=http://sonarqube:9000 \
108
+ -Dsonar.login=$SONAR_TOKEN
109
+ ```
110
+
111
+ #### Bandit(Python)
112
+ ```bash
113
+ # 安装
114
+ pip install bandit
115
+
116
+ # 扫描
117
+ bandit -r src/ -f json -o bandit-report.json
118
+
119
+ # 仅报告高危
120
+ bandit -r src/ -ll -ii
121
+ ```
122
+
123
+ #### ESLint Security(JavaScript)
124
+ ```javascript
125
+ // .eslintrc.js
126
+ module.exports = {
127
+ plugins: ['security'],
128
+ extends: ['plugin:security/recommended'],
129
+ rules: {
130
+ 'security/detect-eval-with-expression': 'error',
131
+ 'security/detect-non-literal-fs-filename': 'warn',
132
+ 'security/detect-unsafe-regex': 'error'
133
+ }
134
+ };
135
+ ```
136
+
137
+ ### SAST 最佳实践
138
+
139
+ #### 1. 增量扫描
140
+ ```yaml
141
+ # GitLab CI 增量扫描
142
+ sast:
143
+ script:
144
+ - |
145
+ CHANGED_FILES=$(git diff --name-only $CI_COMMIT_BEFORE_SHA $CI_COMMIT_SHA | grep '\.py$')
146
+ if [ -n "$CHANGED_FILES" ]; then
147
+ bandit -r $CHANGED_FILES -f json -o bandit-report.json
148
+ fi
149
+ ```
150
+
151
+ #### 2. 误报处理
152
+ ```python
153
+ # Python 示例 - 抑制误报
154
+ password = os.getenv('DB_PASSWORD') # nosec: B105 # 从环境变量读取,非硬编码
155
+
156
+ # 或使用配置文件
157
+ # .bandit
158
+ [bandit]
159
+ exclude_dirs = ["/tests/", "/migrations/"]
160
+ skips = ["B101", "B601"]
161
+ ```
162
+
163
+ #### 3. 质量门禁
164
+ ```yaml
165
+ # GitLab CI
166
+ sast_gate:
167
+ script:
168
+ - |
169
+ HIGH_VULNS=$(jq '.vulnerabilities | map(select(.severity == "HIGH")) | length' sast-report.json)
170
+ CRITICAL_VULNS=$(jq '.vulnerabilities | map(select(.severity == "CRITICAL")) | length' sast-report.json)
171
+
172
+ if [ "$HIGH_VULNS" -gt 0 ] || [ "$CRITICAL_VULNS" -gt 0 ]; then
173
+ echo "发现 $CRITICAL_VULNS 个严重漏洞和 $HIGH_VULNS 个高危漏洞"
174
+ exit 1
175
+ fi
176
+ ```
177
+
178
+ #### 4. IDE 集成
179
+ ```json
180
+ // VS Code settings.json
181
+ {
182
+ "semgrep.trace.server": "verbose",
183
+ "semgrep.path": "/usr/local/bin/semgrep",
184
+ "sonarlint.ls.javaHome": "/usr/lib/jvm/java-17",
185
+ "sonarlint.rules": {
186
+ "javascript:S2077": "error",
187
+ "python:S5146": "error"
188
+ }
189
+ }
190
+ ```
191
+
192
+ ## DAST - 动态应用安全测试
193
+
194
+ ### 工作原理
195
+ ```
196
+ HTTP 请求 -> 爬虫 -> 漏洞扫描 -> Payload 注入 -> 响应分析 -> 漏洞报告
197
+ ```
198
+
199
+ ### 支持的漏洞类型
200
+ ```yaml
201
+ 注入攻击:
202
+ - SQL 注入
203
+ - 命令注入
204
+ - XPath 注入
205
+ - NoSQL 注入
206
+
207
+ 客户端攻击:
208
+ - XSS(反射型、存储型)
209
+ - CSRF
210
+ - 点击劫持
211
+ - 开放重定向
212
+
213
+ 认证会话:
214
+ - 弱密码策略
215
+ - 会话固定
216
+ - 认证绕过
217
+ - 权限提升
218
+
219
+ 配置安全:
220
+ - 不安全的 HTTP 方法
221
+ - 敏感信息泄露
222
+ - 缺少安全头
223
+ - CORS 配置错误
224
+ ```
225
+
226
+ ### 工具选型
227
+
228
+ #### OWASP ZAP(推荐)
229
+ ```yaml
230
+ # ZAP 自动化配置
231
+ environments:
232
+ - name: production
233
+ urls:
234
+ - https://api.example.com
235
+
236
+ scanners:
237
+ - name: sql_injection
238
+ enabled: true
239
+ strength: high
240
+ threshold: medium
241
+
242
+ - name: xss
243
+ enabled: true
244
+ strength: high
245
+ threshold: medium
246
+
247
+ authentication:
248
+ type: bearer
249
+ token: ${AUTH_TOKEN}
250
+
251
+ report:
252
+ format: json
253
+ output: zap-report.json
254
+ ```
255
+
256
+ ```bash
257
+ # 命令行扫描
258
+ zap-baseline.py \
259
+ -t https://api.example.com \
260
+ -r zap-report.html \
261
+ --hook=/zap/scripts/auth_hook.py
262
+
263
+ # 全量扫描
264
+ zap-full-scan.py \
265
+ -t https://api.example.com \
266
+ -r zap-report.html \
267
+ -d \
268
+ -a \
269
+ -l PASS
270
+ ```
271
+
272
+ #### Burp Suite
273
+ ```python
274
+ # Burp Suite REST API
275
+ import requests
276
+
277
+ # 启动扫描
278
+ response = requests.post(
279
+ 'http://burp:8080/api/v0.1/scan',
280
+ json={
281
+ 'urls': ['https://api.example.com'],
282
+ 'scope': {
283
+ 'include': ['https://api.example.com/.*']
284
+ }
285
+ }
286
+ )
287
+
288
+ scan_id = response.json()['scan_id']
289
+
290
+ # 获取结果
291
+ issues = requests.get(f'http://burp:8080/api/v0.1/scan/{scan_id}').json()
292
+ ```
293
+
294
+ #### Nuclei
295
+ ```yaml
296
+ # nuclei-templates/http/vulnerabilities/sql-injection.yaml
297
+ id: sql-injection-generic
298
+ info:
299
+ name: SQL Injection Detection
300
+ severity: high
301
+
302
+ http:
303
+ - method: GET
304
+ path:
305
+ - "{{BaseURL}}/search?q=test'"
306
+ matchers:
307
+ - type: regex
308
+ regex:
309
+ - "SQL syntax.*MySQL"
310
+ - "Warning.*pg_.*"
311
+ - "ORA-01756"
312
+ ```
313
+
314
+ ```bash
315
+ # 运行 Nuclei 扫描
316
+ nuclei -u https://api.example.com -t cves/ -severity critical,high -o nuclei-report.txt
317
+ ```
318
+
319
+ ### DAST 最佳实践
320
+
321
+ #### 1. 认证扫描
322
+ ```python
323
+ # ZAP 认证脚本
324
+ from zapv2 import ZAPv2
325
+
326
+ zap = ZAPv2(apikey='zap-api-key')
327
+
328
+ # 配置认证
329
+ zap.authentication.set_authentication_method(
330
+ contextid=1,
331
+ authmethodname='formBasedAuthentication',
332
+ authmethodconfigparams='loginUrl=https://example.com/login loginRequestData=username={%username%}&password={%password%}'
333
+ )
334
+
335
+ # 配置用户
336
+ zap.users.new_user(contextid=1, username='testuser')
337
+ zap.users.set_authentication_credentials(
338
+ contextid=1,
339
+ userid=1,
340
+ authcredentialsconfigparams='username=testuser&password=testpass'
341
+ )
342
+
343
+ # 启用用户
344
+ zap.users.set_user_enabled(contextid=1, userid=1, enabled=True)
345
+ ```
346
+
347
+ #### 2. API 扫描
348
+ ```yaml
349
+ # OpenAPI 规范扫描
350
+ openapi_scan:
351
+ target: https://api.example.com
352
+ spec: openapi.yaml
353
+ auth:
354
+ type: bearer
355
+ token: ${API_TOKEN}
356
+
357
+ scan_config:
358
+ inject_payloads:
359
+ - "' OR '1'='1"
360
+ - "<script>alert(1)</script>"
361
+ - "../../../../etc/passwd"
362
+ ```
363
+
364
+ #### 3. 排除路径
365
+ ```yaml
366
+ # ZAP 排除配置
367
+ zap.b
368
+ -t https://api.example.com \
369
+ -r report.html \
370
+ --exclude=".*logout.*" \
371
+ --exclude=".*delete.*"
372
+ ```
373
+
374
+ #### 4. 报告分级
375
+ ```yaml
376
+ # 质量门禁
377
+ dast_gate:
378
+ script:
379
+ - |
380
+ HIGH_VULNS=$(jq '.site[0].alerts[] | select(.riskdesc | startswith("High")) | .riskdesc' zap-report.json | wc -l)
381
+
382
+ if [ "$HIGH_VULNS" -gt 0 ]; then
383
+ echo "发现 $HIGH_VULNS 个高危漏洞,禁止部署"
384
+ exit 1
385
+ fi
386
+ ```
387
+
388
+ ## SCA - 软件成分分析
389
+
390
+ ### 工作原理
391
+ ```
392
+ 依赖清单 -> 解析依赖树 -> 漏洞数据库匹配 -> 许可证检查 -> 风险报告
393
+ ```
394
+
395
+ ### 支持的检查类型
396
+ ```yaml
397
+ 漏洞检测:
398
+ - CVE 漏洞
399
+ - 依赖版本漏洞
400
+ - 传递依赖漏洞
401
+ - 已知恶意包
402
+
403
+ 许可证合规:
404
+ - GPL 许可证冲突
405
+ - 商业许可证
406
+ - 弃用许可证
407
+ - 许可证兼容性
408
+
409
+ 代码质量:
410
+ - 弃用包
411
+ - 维护状态
412
+ - 下载量
413
+ - 社区活跃度
414
+ ```
415
+
416
+ ### 工具选型
417
+
418
+ #### Snyk(推荐)
419
+ ```yaml
420
+ # .snyk
421
+ version: v1.13.0
422
+ ignore:
423
+ CVE-2021-44228:
424
+ - "*":
425
+ reason: 已应用补丁
426
+ expires: 2025-12-31
427
+ patch:
428
+ CVE-2021-23456:
429
+ - lodash:
430
+ patched: "4.17.21"
431
+ ```
432
+
433
+ ```bash
434
+ # 运行 Snyk 扫描
435
+ snyk test --severity-threshold=high --json > snyk-report.json
436
+
437
+ # 监控项目
438
+ snyk monitor --org=myorg
439
+
440
+ # 自动修复
441
+ snyk fix
442
+ ```
443
+
444
+ #### Trivy
445
+ ```bash
446
+ # 扫描文件系统
447
+ trivy fs --severity HIGH,CRITICAL --ignore-unfixed .
448
+
449
+ # 扫描镜像
450
+ trivy image --severity HIGH,CRITICAL myapp:latest
451
+
452
+ # 生成 SBOM
453
+ trivy fs --format spdx-json --output sbom.spdx.json .
454
+
455
+ # SBOM 漏洞扫描
456
+ trivy sbom sbom.spdx.json --severity HIGH,CRITICAL
457
+ ```
458
+
459
+ #### Dependabot
460
+ ```yaml
461
+ # .github/dependabot.yml
462
+ version: 2
463
+ updates:
464
+ - package-ecosystem: "npm"
465
+ directory: "/"
466
+ schedule:
467
+ interval: "daily"
468
+ open-pull-requests-limit: 10
469
+ reviewers:
470
+ - "myorg/security-team"
471
+ labels:
472
+ - "security"
473
+ - "dependencies"
474
+ commit-message:
475
+ prefix: "fix"
476
+ include: "scope"
477
+
478
+ - package-ecosystem: "docker"
479
+ directory: "/"
480
+ schedule:
481
+ interval: "weekly"
482
+ ```
483
+
484
+ #### Grype
485
+ ```bash
486
+ # 扫描目录
487
+ grype dir:. --fail-on high
488
+
489
+ # 扫描 SBOM
490
+ grype sbom:sbom.json --output json > grype-report.json
491
+
492
+ # 仅显示已修复漏洞
493
+ grype dir:. --only-fixed
494
+ ```
495
+
496
+ ### SCA 最佳实践
497
+
498
+ #### 1. 锁定依赖版本
499
+ ```json
500
+ // package.json
501
+ {
502
+ "dependencies": {
503
+ "lodash": "4.17.21", // 精确版本
504
+ "express": "~4.18.2", // 补丁版本
505
+ "mongoose": "^7.0.0" // 次版本
506
+ },
507
+ "devDependencies": {
508
+ "typescript": "5.3.3"
509
+ }
510
+ }
511
+
512
+ // package-lock.json 或 yarn.lock 必须提交
513
+ ```
514
+
515
+ #### 2. 私有仓库镜像
516
+ ```bash
517
+ # 使用镜像仓库
518
+ npm config set registry https://registry.npmmirror.com
519
+
520
+ # 或使用 .npmrc
521
+ registry=https://registry.npmmirror.com
522
+ ```
523
+
524
+ #### 3. 持续监控
525
+ ```yaml
526
+ # GitLab CI
527
+ dependency_scanning:
528
+ stage: test
529
+ script:
530
+ - npm audit --json > npm-audit.json
531
+ artifacts:
532
+ reports:
533
+ dependency_scanning: npm-audit.json
534
+ rules:
535
+ - if: $CI_PIPELINE_SOURCE == "schedule" # 定期扫描
536
+ - if: $CI_COMMIT_BRANCH == "main"
537
+ ```
538
+
539
+ #### 4. 修复策略
540
+ ```yaml
541
+ # 修复优先级
542
+ priority_matrix:
543
+ critical:
544
+ max_age: 7 days
545
+ auto_pr: true
546
+ block_deploy: true
547
+
548
+ high:
549
+ max_age: 30 days
550
+ auto_pr: true
551
+ block_deploy: false
552
+
553
+ medium:
554
+ max_age: 90 days
555
+ auto_pr: false
556
+ block_deploy: false
557
+
558
+ low:
559
+ max_age: 180 days
560
+ auto_pr: false
561
+ block_deploy: false
562
+ ```
563
+
564
+ ## 集成到 CI/CD
565
+
566
+ ### 完整流水线示例
567
+ ```yaml
568
+ # GitLab CI 完整安全流水线
569
+ stages:
570
+ - test
571
+ - scan
572
+ - gate
573
+ - deploy
574
+
575
+ # SAST 扫描
576
+ sast:
577
+ stage: test
578
+ image: returntocorp/semgrep:latest
579
+ script:
580
+ - semgrep --config=auto --json --output=semgrep-report.json
581
+ artifacts:
582
+ reports:
583
+ sast: semgrep-report.json
584
+
585
+ # SCA 扫描
586
+ dependency_scanning:
587
+ stage: test
588
+ image: aquasec/trivy:latest
589
+ script:
590
+ - trivy fs --format json --output=trivy-report.json --severity HIGH,CRITICAL .
591
+ artifacts:
592
+ reports:
593
+ dependency_scanning: trivy-report.json
594
+
595
+ # DAST 扫描
596
+ dast:
597
+ stage: scan
598
+ image: zaproxy/zap-baseline:latest
599
+ script:
600
+ - zap-baseline.py -t $TARGET_URL -r zap-report.html -j
601
+ artifacts:
602
+ reports:
603
+ dast: zap-report.html
604
+ only:
605
+ - main
606
+
607
+ # 质量门禁
608
+ security_gate:
609
+ stage: gate
610
+ script:
611
+ - |
612
+ # 检查 SAST
613
+ SAST_HIGH=$(jq '.vulnerabilities | map(select(.severity == "HIGH" or .severity == "CRITICAL")) | length' semgrep-report.json)
614
+
615
+ # 检查 SCA
616
+ SCA_HIGH=$(jq '.Results[] | select(.Vulnerabilities != null) | .Vulnerabilities | length' trivy-report.json)
617
+
618
+ # 检查 DAST
619
+ DAST_HIGH=$(grep -c 'riskcode="3"' zap-report.html || echo 0)
620
+
621
+ # 决策
622
+ if [ "$SAST_HIGH" -gt 0 ] || [ "$SCA_HIGH" -gt 0 ] || [ "$DAST_HIGH" -gt 0 ]; then
623
+ echo "安全门禁失败"
624
+ echo "SAST 高危: $SAST_HIGH"
625
+ echo "SCA 高危: $SCA_HIGH"
626
+ echo "DAST 高危: $DAST_HIGH"
627
+ exit 1
628
+ fi
629
+ only:
630
+ - main
631
+
632
+ deploy:
633
+ stage: deploy
634
+ script:
635
+ - kubectl apply -f k8s/
636
+ only:
637
+ - main
638
+ ```
639
+
640
+ ## 漏洞修复流程
641
+
642
+ ### 1. 漏洞分级
643
+ ```yaml
644
+ 严重程度:
645
+ CRITICAL:
646
+ cvss: 9.0 - 10.0
647
+ response_time: 24 hours
648
+ block_deploy: true
649
+
650
+ HIGH:
651
+ cvss: 7.0 - 8.9
652
+ response_time: 7 days
653
+ block_deploy: true
654
+
655
+ MEDIUM:
656
+ cvss: 4.0 - 6.9
657
+ response_time: 30 days
658
+ block_deploy: false
659
+
660
+ LOW:
661
+ cvss: 0.1 - 3.9
662
+ response_time: 90 days
663
+ block_deploy: false
664
+ ```
665
+
666
+ ### 2. 修复 SLA
667
+ ```yaml
668
+ sla:
669
+ critical:
670
+ acknowledgment: 4 hours
671
+ fix_development: 24 hours
672
+ fix_production: 48 hours
673
+
674
+ high:
675
+ acknowledgment: 24 hours
676
+ fix_development: 7 days
677
+ fix_production: 14 days
678
+
679
+ medium:
680
+ acknowledgment: 72 hours
681
+ fix_development: 30 days
682
+ fix_production: 60 days
683
+
684
+ low:
685
+ acknowledgment: 1 week
686
+ fix_development: 90 days
687
+ fix_production: 180 days
688
+ ```
689
+
690
+ ### 3. 例外管理
691
+ ```yaml
692
+ # .vulnerability-exceptions.yaml
693
+ exceptions:
694
+ - id: CVE-2021-44228
695
+ reason: 已应用 WAF 规则缓解
696
+ expires: 2025-06-30
697
+ approved_by: security-team
698
+ mitigation: WAF 规则 #1234
699
+ risk_accepted: true
700
+
701
+ - id: CVE-2023-12345
702
+ reason: 依赖暂无修复版本
703
+ expires: 2025-03-31
704
+ approved_by: cto
705
+ mitigation: 网络隔离
706
+ risk_accepted: true
707
+ ```
708
+
709
+ ## 报告和度量
710
+
711
+ ### 关键指标
712
+ ```yaml
713
+ sast_metrics:
714
+ - coverage: 95% # 代码覆盖率
715
+ - scan_frequency: per_commit
716
+ - false_positive_rate: < 10%
717
+ - mttr_high: 7 days
718
+ - mttr_critical: 24 hours
719
+
720
+ dast_metrics:
721
+ - coverage: 80% # 应用覆盖率
722
+ - scan_frequency: weekly
723
+ - authenticated_scan: 100%
724
+ - mttr_high: 14 days
725
+ - mttr_critical: 48 hours
726
+
727
+ sca_metrics:
728
+ - coverage: 100% # 依赖覆盖率
729
+ - scan_frequency: daily
730
+ - sbom_availability: 100%
731
+ - license_compliance: 100%
732
+ - mttr_high: 7 days
733
+ - mttr_critical: 48 hours
734
+ ```
735
+
736
+ ### 仪表板
737
+ ```yaml
738
+ # Grafana Dashboard
739
+ panels:
740
+ - title: 漏洞趋势
741
+ type: graph
742
+ targets:
743
+ - expr: sum(vulnerabilities_total{severity="critical"})
744
+
745
+ - title: 修复时间
746
+ type: stat
747
+ targets:
748
+ - expr: avg(vulnerability_mttr_hours{severity="high"})
749
+
750
+ - title: 扫描覆盖率
751
+ type: gauge
752
+ targets:
753
+ - expr: (sum(scanned_repos) / sum(total_repos)) * 100
754
+ ```
755
+
756
+ ## 实施检查清单
757
+
758
+ - [ ] SAST 工具集成到 CI
759
+ - [ ] SCA 依赖扫描自动化
760
+ - [ ] DAST 定期扫描计划
761
+ - [ ] 质量门禁配置
762
+ - [ ] 漏洞修复流程
763
+ - [ ] 例外管理流程
764
+ - [ ] 报告和度量
765
+ - [ ] 安全培训
766
+ - [ ] 定期审查和优化
767
+ - [ ] SBOM 生成
768
+ - [ ] 依赖锁定
769
+ - [ ] IDE 插件部署
770
+
771
+ ## 参考资料
772
+ - [OWASP Source Code Analysis](https://owasp.org/www-community/Source_Code_Analysis_Tools)
773
+ - [OWASP Web Security Testing Guide](https://owasp.org/www-project-web-security-testing-guide/)
774
+ - [OWASP Dependency-Check](https://owasp.org/www-project-dependency-check/)
775
+ - [NIST National Vulnerability Database](https://nvd.nist.gov/)