@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.
- package/00-governance/governance-capabilities.md +557 -0
- package/00-governance/knowledge-map.md +39 -0
- package/00-governance/maintenance-policy.md +76 -0
- package/00-governance/review-checklist.md +81 -0
- package/README.md +13 -0
- package/ai/01-standards/agent-development-complete.md +691 -0
- package/ai/01-standards/llm-application-complete.md +488 -0
- package/ai/01-standards/mlops-complete.md +798 -0
- package/ai/01-standards/prompt-engineering-complete.md +646 -0
- package/ai/01-standards/rag-architecture-complete.md +649 -0
- package/ai/02-playbooks/llm-evaluation-playbook.md +847 -0
- package/ai/03-checklists/ai-project-checklist.md +215 -0
- package/ai/04-antipatterns/ai-antipatterns.md +661 -0
- package/ai/05-cases/case-rag-production.md +147 -0
- package/ai/06-glossary/ai-glossary.md +162 -0
- package/ai/agent-evaluation-benchmark.md +53 -0
- package/ai/ai-agent-memory-context-management.md +41 -0
- package/ai/ai-cost-capacity-optimization-playbook.md +42 -0
- package/ai/ai-data-security-and-compliance-playbook.md +37 -0
- package/ai/ai-domain-index-and-checklist.md +40 -0
- package/ai/ai-governance-maturity-model.md +50 -0
- package/ai/ai-model-selection-and-routing-strategy.md +47 -0
- package/ai/ai-observability-and-oncall-runbook.md +52 -0
- package/ai/ai-rag-engineering-playbook.md +42 -0
- package/ai/ai-red-team-and-safety-evaluation.md +42 -0
- package/ai/ai-release-readiness-and-rollback-gate.md +42 -0
- package/ai/llm-agent-engineering-deep-dive.md +57 -0
- package/ai/prompt-and-tool-guardrails.md +52 -0
- package/api/01-standards/enterprise-api-standards.md +198 -0
- package/api/01-standards/rest-api-design-guide.md +63 -0
- package/api/02-playbooks/api-pagination-playbook.md +93 -0
- package/api/02-playbooks/graphql-production-playbook.md +176 -0
- package/api/03-checklists/api-review-checklist.md +55 -0
- package/api/04-antipatterns/api-antipatterns.md +112 -0
- package/architecture/01-standards/api-gateway-patterns.md +496 -0
- package/architecture/01-standards/cloud-native-patterns.md +644 -0
- package/architecture/01-standards/distributed-systems-patterns.md +591 -0
- package/architecture/01-standards/event-driven-architecture.md +595 -0
- package/architecture/01-standards/microservices-patterns-complete.md +968 -0
- package/architecture/01-standards/microservices-patterns.md +495 -0
- package/architecture/01-standards/system-design-interview.md +664 -0
- package/architecture/02-playbooks/microservices-patterns-playbook.md +137 -0
- package/architecture/02-playbooks/migration-playbook.md +780 -0
- package/architecture/02-playbooks/system-design-playbook.md +779 -0
- package/architecture/03-checklists/architecture-decision-checklist.md +297 -0
- package/architecture/04-antipatterns/architecture-antipatterns.md +417 -0
- package/architecture/05-cases/case-netflix-microservices.md +413 -0
- package/architecture/06-glossary/architecture-glossary.md +164 -0
- package/architecture/adr-template-and-examples.md +38 -0
- package/architecture/api-gateway-deep-dive.md +1291 -0
- package/architecture/configuration-management.md +1162 -0
- package/architecture/distributed-transactions.md +1220 -0
- package/architecture/microservices-complete.md +735 -0
- package/architecture/resilience-and-disaster-patterns.md +37 -0
- package/architecture/service-governance.md +1198 -0
- package/architecture/system-architecture-deep-dive.md +37 -0
- package/backend/01-standards/analytics-and-growth.md +65 -0
- package/backend/01-standards/api-and-error-conventions.md +120 -0
- package/backend/01-standards/application-layering-and-packaging.md +160 -0
- package/backend/01-standards/auth-implementation.md +104 -0
- package/backend/01-standards/backend-framework-idioms.md +74 -0
- package/backend/01-standards/background-jobs-and-async.md +66 -0
- package/backend/01-standards/caching-strategies-complete.md +390 -0
- package/backend/01-standards/config-and-observability.md +77 -0
- package/backend/01-standards/data-modeling-and-persistence.md +94 -0
- package/backend/01-standards/django-complete.md +1765 -0
- package/backend/01-standards/email-and-notifications.md +64 -0
- package/backend/01-standards/fastapi-complete.md +925 -0
- package/backend/01-standards/file-upload-and-storage.md +66 -0
- package/backend/01-standards/graphql-api-complete.md +416 -0
- package/backend/01-standards/llm-application-standard.md +78 -0
- package/backend/01-standards/message-queue-patterns.md +379 -0
- package/backend/01-standards/microservices-and-distributed.md +78 -0
- package/backend/01-standards/nestjs-complete.md +2167 -0
- package/backend/01-standards/payment-integration.md +80 -0
- package/backend/01-standards/rate-limiting-complete.md +451 -0
- package/backend/01-standards/realtime-and-websocket.md +65 -0
- package/backend/01-standards/search-and-filtering.md +64 -0
- package/backend/01-standards/spring-boot-complete.md +445 -0
- package/backend/02-playbooks/api-design-playbook.md +718 -0
- package/backend/02-playbooks/email-send-playbook.md +130 -0
- package/backend/02-playbooks/file-upload-s3-playbook.md +153 -0
- package/backend/02-playbooks/typescript-enterprise-playbook.md +133 -0
- package/backend/02-playbooks/websocket-realtime-playbook.md +154 -0
- package/backend/03-checklists/api-launch-checklist.md +189 -0
- package/backend/04-antipatterns/backend-antipatterns.md +1051 -0
- package/blockchain/01-standards/blockchain-basics.md +557 -0
- package/blockchain/01-standards/smart-contract-development.md +1315 -0
- package/cicd/01-standards/deployment-and-delivery-standard.md +96 -0
- package/cicd/01-standards/github-actions-complete.md +473 -0
- package/cicd/01-standards/release-and-store-submission.md +75 -0
- package/cicd/02-playbooks/cicd-pipeline-playbook.md +144 -0
- package/cicd/02-playbooks/release-management-playbook.md +605 -0
- package/cicd/03-checklists/pipeline-security-checklist.md +168 -0
- package/cicd/04-antipatterns/cicd-antipatterns.md +589 -0
- package/cicd/05-cases/case-deployment-automation.md +221 -0
- package/cicd/05-cases/case-gitops-transformation.md +212 -0
- package/cicd/06-glossary/cicd-glossary.md +114 -0
- package/cicd/cicd-blueprint-deep-dive.md +38 -0
- package/cicd/release-readiness-gate.md +37 -0
- package/cloud-native/01-standards/container-security.md +741 -0
- package/cloud-native/01-standards/kubernetes-complete.md +812 -0
- package/cloud-native/02-playbooks/api-gateway-playbook.md +155 -0
- package/cloud-native/02-playbooks/gitops-with-argocd.md +760 -0
- package/cloud-native/02-playbooks/k8s-troubleshooting-playbook.md +1942 -0
- package/cloud-native/02-playbooks/message-queue-playbook.md +129 -0
- package/cloud-native/02-playbooks/multicloud-governance.md +726 -0
- package/cloud-native/02-playbooks/serverless-patterns.md +788 -0
- package/cloud-native/02-playbooks/service-mesh-playbook.md +612 -0
- package/cloud-native/02-playbooks/terraform-iac-playbook.md +143 -0
- package/cloud-native/03-checklists/container-security-checklist.md +431 -0
- package/cloud-native/03-checklists/k8s-production-readiness-checklist.md +460 -0
- package/cloud-native/04-antipatterns/container-antipatterns.md +660 -0
- package/cloud-native/04-antipatterns/k8s-antipatterns.md +743 -0
- package/cloud-native/05-cases/case-k8s-migration.md +478 -0
- package/cloud-native/05-cases/case-k8s-scaling.md +642 -0
- package/cloud-native/05-cases/case-k8s-security-incident.md +397 -0
- package/cloud-native/06-glossary/cloud-native-glossary.md +337 -0
- package/cross-platform/01-standards/cross-platform-frameworks.md +83 -0
- package/cross-platform/01-standards/platform-selection-and-architecture.md +77 -0
- package/data/01-standards/elasticsearch-complete.md +2098 -0
- package/data/01-standards/postgresql-complete.md +1613 -0
- package/data/01-standards/redis-complete.md +1527 -0
- package/data/02-playbooks/database-optimization-playbook.md +403 -0
- package/data/02-playbooks/elasticsearch-production-playbook.md +132 -0
- package/data/03-checklists/database-launch-checklist.md +187 -0
- package/data/04-antipatterns/database-antipatterns.md +873 -0
- package/data/05-cases/case-database-migration.md +310 -0
- package/data/06-glossary/database-glossary.md +440 -0
- package/data/data-governance-and-modeling-deep-dive.md +39 -0
- package/data-engineering/01-standards/airflow-complete.md +523 -0
- package/data-engineering/01-standards/kafka-complete.md +1521 -0
- package/data-engineering/02-playbooks/spark-etl-playbook.md +496 -0
- package/data-engineering/03-checklists/pipeline-launch-checklist.md +194 -0
- package/data-engineering/04-antipatterns/data-pipeline-antipatterns.md +684 -0
- package/data-engineering/05-cases/case-real-time-pipeline.md +355 -0
- package/data-engineering/06-glossary/data-engineering-glossary.md +429 -0
- package/database/01-standards/database-schema-standards.md +147 -0
- package/database/02-playbooks/postgresql-optimization-quick.md +52 -0
- package/database/02-playbooks/postgresql-performance-optimization.md +58 -0
- package/database/02-playbooks/postgresql-production-playbook.md +146 -0
- package/database/02-playbooks/redis-caching-playbook.md +117 -0
- package/database/03-checklists/database-review-checklist.md +50 -0
- package/database/04-antipatterns/database-antipatterns.md +112 -0
- package/design/01-standards/ui-design-system-complete.md +423 -0
- package/design/02-playbooks/design-handoff-playbook.md +254 -0
- package/design/02-playbooks/design-review-playbook.md +388 -0
- package/design/03-checklists/design-review-checklist.md +246 -0
- package/design/04-antipatterns/design-antipatterns.md +378 -0
- package/design/05-cases/case-design-system-adoption.md +328 -0
- package/design/06-glossary/design-glossary.md +329 -0
- package/design/ui-full-lifecycle-cross-platform-playbook.md +571 -0
- package/design/ux-system-deep-dive.md +38 -0
- package/design-systems/00-craft-rules.md +71 -0
- package/design-systems/aesthetic-families.md +43 -0
- package/design-systems/anti-ai-slop.md +162 -0
- package/design-systems/bold-geometric.md +120 -0
- package/design-systems/brutalist-bold.md +103 -0
- package/design-systems/editorial-clean.md +109 -0
- package/design-systems/glass-aurora.md +108 -0
- package/design-systems/modern-minimal.md +145 -0
- package/design-systems/premium-luxury.md +106 -0
- package/design-systems/product-type-design-map.md +48 -0
- package/design-systems/soft-warm.md +123 -0
- package/design-systems/tech-utility.md +113 -0
- package/desktop/01-standards/desktop-app-standard.md +72 -0
- package/desktop/01-standards/desktop-design.md +71 -0
- package/development/00-governance/document-template.md +41 -0
- package/development/01-standards/api-versioning-strategies.md +432 -0
- package/development/01-standards/authentication-patterns-complete.md +479 -0
- package/development/01-standards/css-architecture-complete.md +550 -0
- package/development/01-standards/database-migration-strategies.md +484 -0
- package/development/01-standards/elasticsearch-complete.md +347 -0
- package/development/01-standards/git-complete.md +371 -0
- package/development/01-standards/golang-complete.md +1565 -0
- package/development/01-standards/graphql-complete.md +298 -0
- package/development/01-standards/javascript-bundlers-complete.md +469 -0
- package/development/01-standards/javascript-typescript-complete.md +528 -0
- package/development/01-standards/jest-complete.md +275 -0
- package/development/01-standards/linux-complete.md +234 -0
- package/development/01-standards/logging-observability-complete.md +526 -0
- package/development/01-standards/microservices-communication.md +502 -0
- package/development/01-standards/mongodb-complete.md +406 -0
- package/development/01-standards/oauth2-complete.md +285 -0
- package/development/01-standards/performance-optimization-complete.md +289 -0
- package/development/01-standards/playwright-complete.md +247 -0
- package/development/01-standards/postgresql-complete.md +456 -0
- package/development/01-standards/pytest-complete.md +340 -0
- package/development/01-standards/python-async-programming.md +902 -0
- package/development/01-standards/python-complete.md +956 -0
- package/development/01-standards/python-decorators-complete.md +799 -0
- package/development/01-standards/python-design-patterns.md +2854 -0
- package/development/01-standards/python-packaging-distribution.md +420 -0
- package/development/01-standards/python-testing-strategies.md +607 -0
- package/development/01-standards/python-web-frameworks-comparison.md +471 -0
- package/development/01-standards/redis-complete.md +317 -0
- package/development/01-standards/rest-api-complete.md +316 -0
- package/development/01-standards/rust-complete.md +578 -0
- package/development/01-standards/typescript-advanced-types.md +1513 -0
- package/development/01-standards/web-security-complete.md +292 -0
- package/development/02-playbooks/api-design-playbook.md +810 -0
- package/development/02-playbooks/database-migration-playbook.md +580 -0
- package/development/02-playbooks/debugging-playbook.md +692 -0
- package/development/02-playbooks/feature-delivery-playbook.md +430 -0
- package/development/02-playbooks/incident-hotfix-playbook.md +387 -0
- package/development/02-playbooks/performance-optimization-playbook.md +531 -0
- package/development/02-playbooks/performance-tuning-playbook.md +652 -0
- package/development/02-playbooks/refactor-playbook.md +403 -0
- package/development/02-playbooks/release-playbook.md +469 -0
- package/development/03-checklists/architecture-review-checklist.md +168 -0
- package/development/03-checklists/data-migration-checklist.md +157 -0
- package/development/03-checklists/oncall-handover-checklist.md +173 -0
- package/development/03-checklists/pr-checklist.md +158 -0
- package/development/03-checklists/production-readiness-checklist.md +190 -0
- package/development/03-checklists/release-readiness-checklist.md +154 -0
- package/development/03-checklists/security-review-checklist.md +182 -0
- package/development/04-antipatterns/api-antipatterns.md +657 -0
- package/development/04-antipatterns/architecture-antipatterns.md +686 -0
- package/development/04-antipatterns/backend-antipatterns.md +648 -0
- package/development/04-antipatterns/cicd-antipatterns.md +540 -0
- package/development/04-antipatterns/code-smell-antipatterns.md +571 -0
- package/development/04-antipatterns/data-antipatterns.md +658 -0
- package/development/04-antipatterns/database-antipatterns.md +578 -0
- package/development/04-antipatterns/frontend-antipatterns.md +635 -0
- package/development/04-antipatterns/reliability-antipatterns.md +700 -0
- package/development/04-antipatterns/security-antipatterns.md +747 -0
- package/development/05-cases/case-api-version-migration.md +428 -0
- package/development/05-cases/case-authorization-hardening.md +383 -0
- package/development/05-cases/case-bluegreen-rollback.md +466 -0
- package/development/05-cases/case-cache-snowball-protection.md +485 -0
- package/development/05-cases/case-ci-cd-pipeline.md +544 -0
- package/development/05-cases/case-database-scaling.md +500 -0
- package/development/05-cases/case-db-hotspot-optimization.md +487 -0
- package/development/05-cases/case-incident-mttr-reduction.md +563 -0
- package/development/05-cases/case-microservice-migration.md +375 -0
- package/development/05-cases/case-performance-optimization.md +406 -0
- package/development/05-cases/case-security-incident-response.md +345 -0
- package/development/06-glossary/full-stack-glossary.md +166 -0
- package/development/09-maturity/quarterly-audit-template.md +35 -0
- package/development/11-ui-excellence/ui-aesthetic-system.md +41 -0
- package/development/11-ui-excellence/ui-engineering-excellence.md +435 -0
- package/development/12-scenarios/development-scenarios-guide.md +565 -0
- package/development/13-implementation-assets/implementation-toolkit.md +282 -0
- package/development/13-implementation-assets/knowledge-gates-execution.md +43 -0
- package/development/14-full-lifecycle/software-lifecycle-gates.md +511 -0
- package/development/15-lifecycle-templates/project-templates-collection.md +791 -0
- package/development/api-contract-and-versioning-guide.md +36 -0
- package/development/api-governance-complete.md +43 -0
- package/development/backend-engineering-complete.md +43 -0
- package/development/code-review-quality-complete.md +43 -0
- package/development/concurrency-reliability-complete.md +43 -0
- package/development/database-engineering-complete.md +43 -0
- package/development/engineering-effectiveness-complete.md +43 -0
- package/development/engineering-standards-deep-dive.md +38 -0
- package/development/frontend-engineering-complete.md +43 -0
- package/development/performance-capacity-complete.md +43 -0
- package/development/refactor-migration-complete.md +42 -0
- package/development/refactoring-and-techdebt-playbook.md +37 -0
- package/development/security-in-development-complete.md +43 -0
- package/devops/01-standards/cicd-pipeline-complete.md +262 -0
- package/devops/01-standards/docker-complete.md +1490 -0
- package/devops/01-standards/github-actions-complete.md +337 -0
- package/devops/01-standards/kubernetes-complete.md +638 -0
- package/devops/01-standards/terraform-complete.md +2117 -0
- package/devops/02-playbooks/docker-compose-playbook.md +233 -0
- package/devops/02-playbooks/docker-k8s-production-playbook.md +186 -0
- package/devops/02-playbooks/docker-production-playbook.md +952 -0
- package/edge-iot/01-standards/edge-iot-complete.md +473 -0
- package/experts/architect/api-design.md +178 -0
- package/experts/architect/methodology.md +124 -0
- package/experts/architect/security.md +75 -0
- package/experts/backend-lead/methodology.md +216 -0
- package/experts/devops/methodology.md +160 -0
- package/experts/frontend-lead/methodology.md +178 -0
- package/experts/product-manager/industry/ecommerce.md +43 -0
- package/experts/product-manager/industry/saas.md +40 -0
- package/experts/product-manager/methodology.md +97 -0
- package/experts/qa-lead/methodology.md +123 -0
- package/experts/qa-lead/test-strategy.md +128 -0
- package/experts/uiux-designer/methodology.md +125 -0
- package/frontend/01-standards/accessibility-complete.md +532 -0
- package/frontend/01-standards/accessibility-standard.md +74 -0
- package/frontend/01-standards/admin-dashboard-and-crud.md +72 -0
- package/frontend/01-standards/design-tokens-complete.md +444 -0
- package/frontend/01-standards/forms-and-validation.md +77 -0
- package/frontend/01-standards/frontend-architecture-and-layering.md +119 -0
- package/frontend/01-standards/i18n-and-localization.md +65 -0
- package/frontend/01-standards/nextjs-complete.md +451 -0
- package/frontend/01-standards/react-complete.md +713 -0
- package/frontend/01-standards/react-hooks-complete-guide.md +1100 -0
- package/frontend/01-standards/react-hooks-complete.md +1171 -0
- package/frontend/01-standards/seo-and-web-vitals.md +77 -0
- package/frontend/01-standards/state-management-complete.md +444 -0
- package/frontend/01-standards/vue-complete.md +499 -0
- package/frontend/01-standards/vue3-complete.md +2002 -0
- package/frontend/01-standards/web-framework-best-practices.md +64 -0
- package/frontend/01-standards/web-performance-complete.md +495 -0
- package/frontend/02-playbooks/accessibility-a11y-playbook.md +161 -0
- package/frontend/02-playbooks/frontend-performance-playbook.md +707 -0
- package/frontend/02-playbooks/i18n-internationalization-playbook.md +120 -0
- package/frontend/02-playbooks/performance-optimization-playbook.md +163 -0
- package/frontend/02-playbooks/react-nextjs-production-playbook.md +167 -0
- package/frontend/02-playbooks/react-state-management-playbook.md +173 -0
- package/frontend/03-checklists/component-quality-checklist.md +166 -0
- package/frontend/03-checklists/frontend-launch-checklist.md +299 -0
- package/frontend/04-antipatterns/frontend-antipatterns.md +886 -0
- package/frontend/05-cases/case-performance-optimization.md +274 -0
- package/harmony/01-standards/harmonyos-arkts-standard.md +75 -0
- package/harmony/01-standards/harmonyos-design.md +65 -0
- package/high-quality-engineering-playbook.md +54 -0
- package/incident/01-standards/incident-response-complete.md +303 -0
- package/incident/02-playbooks/chaos-engineering-playbook.md +883 -0
- package/incident/02-playbooks/postmortem-playbook.md +398 -0
- package/incident/03-checklists/incident-readiness-checklist.md +181 -0
- package/incident/04-antipatterns/incident-antipatterns.md +490 -0
- package/incident/05-cases/case-cascade-failure.md +176 -0
- package/incident/06-glossary/incident-glossary.md +114 -0
- package/incident/postmortem-and-response-deep-dive.md +39 -0
- package/industries/ecommerce/ecommerce-complete.md +631 -0
- package/industries/education/education-complete.md +555 -0
- package/industries/fintech/fintech-complete.md +501 -0
- package/industries/gaming/gaming-complete.md +587 -0
- package/industries/healthcare/healthcare-complete.md +452 -0
- package/low-code/01-standards/low-code-complete.md +944 -0
- package/miniprogram/01-standards/ai-common-mistakes.md +61 -0
- package/miniprogram/01-standards/miniprogram-custom-navbar-capsule.md +77 -0
- package/miniprogram/01-standards/miniprogram-design.md +61 -0
- package/miniprogram/01-standards/miniprogram-standard.md +81 -0
- package/mobile/01-standards/android-material-design.md +70 -0
- package/mobile/01-standards/flutter-complete.md +384 -0
- package/mobile/01-standards/ios-design-hig.md +78 -0
- package/mobile/01-standards/mobile-app-standard.md +85 -0
- package/mobile/01-standards/react-native-complete.md +352 -0
- package/mobile/02-playbooks/mobile-cross-platform-playbook.md +175 -0
- package/mobile/02-playbooks/mobile-performance.md +473 -0
- package/mobile/03-checklists/mobile-release-checklist.md +234 -0
- package/mobile/04-antipatterns/mobile-antipatterns.md +798 -0
- package/mobile/05-cases/case-app-performance.md +500 -0
- package/mobile/05-cases/case-app-startup-optimization.md +218 -0
- package/mobile/06-glossary/mobile-glossary.md +484 -0
- package/observability/01-standards/observability-standards.md +103 -0
- package/observability/02-playbooks/prometheus-grafana-playbook.md +135 -0
- package/observability/02-playbooks/structured-logging-playbook.md +73 -0
- package/observability/03-checklists/observability-checklist.md +54 -0
- package/observability/04-antipatterns/observability-antipatterns.md +106 -0
- package/operations/01-standards/prometheus-monitoring-complete.md +1578 -0
- package/operations/02-playbooks/capacity-planning-playbook.md +620 -0
- package/operations/03-checklists/production-launch-checklist.md +365 -0
- package/operations/04-antipatterns/operations-antipatterns.md +664 -0
- package/operations/05-cases/case-sre-practices.md +581 -0
- package/operations/06-glossary/operations-glossary.md +120 -0
- package/operations/aiops-anomaly-detection.md +758 -0
- package/operations/capacity-planning.md +1061 -0
- package/operations/chaos-engineering.md +659 -0
- package/operations/incident-command-system.md +38 -0
- package/operations/observability-complete.md +442 -0
- package/operations/slo-sli-playbook.md +517 -0
- package/operations/sre-operations-deep-dive.md +39 -0
- package/package.json +8 -0
- package/performance/01-standards/performance-and-scalability.md +80 -0
- package/performance/01-standards/performance-standards.md +156 -0
- package/performance/02-playbooks/query-optimization-playbook.md +103 -0
- package/performance/03-checklists/performance-checklist.md +56 -0
- package/performance/04-antipatterns/performance-antipatterns.md +146 -0
- package/product/01-standards/product-management-complete.md +285 -0
- package/product/02-playbooks/feature-launch-playbook.md +207 -0
- package/product/02-playbooks/user-research-playbook.md +532 -0
- package/product/03-checklists/feature-launch-checklist.md +275 -0
- package/product/04-antipatterns/product-antipatterns.md +355 -0
- package/product/05-cases/case-mvp-to-scale.md +384 -0
- package/product/06-glossary/product-glossary.md +462 -0
- package/product/feature-prioritization-framework.md +40 -0
- package/product/kpi-and-metric-tree.md +37 -0
- package/product/product-discovery-and-prd-deep-dive.md +41 -0
- package/quantum/01-standards/quantum-complete.md +1186 -0
- package/security/01-standards/api-security-complete.md +511 -0
- package/security/01-standards/container-runtime-security.md +574 -0
- package/security/01-standards/data-protection-gdpr.md +543 -0
- package/security/01-standards/owasp-top10-complete.md +1890 -0
- package/security/01-standards/secure-coding-baseline.md +90 -0
- package/security/01-standards/supply-chain-security.md +441 -0
- package/security/01-standards/web-security-checklist.md +108 -0
- package/security/01-standards/zero-trust-architecture.md +521 -0
- package/security/02-playbooks/auth-sso-playbook.md +166 -0
- package/security/02-playbooks/incident-response-security-playbook.md +588 -0
- package/security/02-playbooks/owasp-api-security-playbook.md +129 -0
- package/security/02-playbooks/payment-integration-playbook.md +119 -0
- package/security/02-playbooks/penetration-testing-playbook.md +517 -0
- package/security/03-checklists/security-audit-checklist.md +356 -0
- package/security/04-antipatterns/security-coding-antipatterns.md +580 -0
- package/security/05-cases/case-log4shell-incident.md +537 -0
- package/security/05-cases/case-major-breaches.md +468 -0
- package/security/06-glossary/security-glossary.md +212 -0
- package/security/compliance-automation.md +993 -0
- package/security/container-security.md +680 -0
- package/security/devsecops-complete.md +426 -0
- package/security/sast-dast-sca.md +775 -0
- package/security/secrets-management.md +594 -0
- package/security/security-architecture-deep-dive.md +37 -0
- package/security/threat-modeling-stride-playbook.md +40 -0
- package/seed-templates/auth-system.md +59 -0
- package/seed-templates/blog-content.md +94 -0
- package/seed-templates/dashboard.md +89 -0
- package/seed-templates/docs-site.md +73 -0
- package/seed-templates/e-commerce.md +50 -0
- package/seed-templates/saas-landing.md +92 -0
- package/seed-templates/settings-page.md +51 -0
- package/testing/01-standards/test-strategy-and-layering.md +83 -0
- package/testing/01-standards/testing-strategy-complete.md +422 -0
- package/testing/01-standards/unit-testing-best-practices.md +118 -0
- package/testing/02-playbooks/e2e-testing-playbook.md +988 -0
- package/testing/02-playbooks/testing-strategy-playbook.md +126 -0
- package/testing/03-checklists/test-strategy-checklist.md +208 -0
- package/testing/04-antipatterns/testing-antipatterns.md +718 -0
- package/testing/05-cases/case-testing-transformation.md +300 -0
- package/testing/06-glossary/testing-glossary.md +110 -0
- package/testing/risk-based-test-matrix.md +36 -0
- package/testing/testing-strategy-deep-dive.md +37 -0
|
@@ -0,0 +1,565 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: development-scenarios-guide
|
|
3
|
+
title: Development Scenarios Guide - Comprehensive Decision Reference
|
|
4
|
+
domain: development
|
|
5
|
+
category: 12-scenarios
|
|
6
|
+
difficulty: intermediate
|
|
7
|
+
tags: [consumer, development, enterprise, framework, growth, guide, multi-tenant, pack]
|
|
8
|
+
quality_score: 70
|
|
9
|
+
last_updated: 2026-06-15
|
|
10
|
+
---
|
|
11
|
+
# Development Scenarios Guide - Comprehensive Decision Reference
|
|
12
|
+
|
|
13
|
+
> Consolidated reference covering 8 business scenario packs (B2B, B2C, Multi-tenant SaaS, Internationalization, Mobile Superapp, AI Application, Fintech Regulated, E-commerce Peak) plus scenario selection methodology.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 1. Scenario Selection Framework
|
|
18
|
+
|
|
19
|
+
### 1.1 Decision Tree
|
|
20
|
+
|
|
21
|
+
Before selecting scenario packs, answer these gate questions:
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
START
|
|
25
|
+
|
|
|
26
|
+
+-- Is the product enterprise-facing (B2B)?
|
|
27
|
+
| YES -> Apply B2B Scenario Pack
|
|
28
|
+
| NO -> Is it consumer growth-focused?
|
|
29
|
+
| YES -> Apply B2C Growth Scenario Pack
|
|
30
|
+
|
|
|
31
|
+
+-- Does the product require tenant isolation?
|
|
32
|
+
| YES -> Apply Multi-Tenant SaaS Scenario Pack
|
|
33
|
+
|
|
|
34
|
+
+-- Does the product serve multiple regions / languages?
|
|
35
|
+
| YES -> Apply Internationalization Scenario Pack
|
|
36
|
+
|
|
|
37
|
+
+-- Is the primary experience a mobile app?
|
|
38
|
+
| YES -> Apply Mobile Superapp Scenario Pack
|
|
39
|
+
|
|
|
40
|
+
+-- Does the product include AI / ML generation or inference?
|
|
41
|
+
| YES -> Apply AI Application Scenario Pack
|
|
42
|
+
|
|
|
43
|
+
+-- Is the product subject to financial regulation?
|
|
44
|
+
| YES -> Apply Fintech Regulated Scenario Pack
|
|
45
|
+
|
|
|
46
|
+
+-- Does the product face peak-traffic events (promotions, flash sales)?
|
|
47
|
+
YES -> Apply E-commerce Peak Scenario Pack
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Multiple packs can be stacked. For example, a B2B SaaS product serving international clients would apply: B2B + Multi-Tenant SaaS + Internationalization.
|
|
51
|
+
|
|
52
|
+
### 1.2 Selection Checklist
|
|
53
|
+
|
|
54
|
+
Before proceeding with development, confirm:
|
|
55
|
+
|
|
56
|
+
- [ ] The current business objective is identified (efficiency, growth, compliance, or stability).
|
|
57
|
+
- [ ] Multi-tenant isolation and billing requirements are assessed.
|
|
58
|
+
- [ ] Multi-region language and timezone requirements are assessed.
|
|
59
|
+
- [ ] Mobile-primary closed-loop and offline requirements are assessed.
|
|
60
|
+
- [ ] AI generation capability and safety boundary requirements are assessed.
|
|
61
|
+
- [ ] Peak traffic and promotional risk are assessed.
|
|
62
|
+
- [ ] Audit, traceability, and non-repudiation compliance requirements are assessed.
|
|
63
|
+
- [ ] All matched scenario packs are activated and their five asset types are populated.
|
|
64
|
+
|
|
65
|
+
### 1.3 Five Asset Types Per Scenario
|
|
66
|
+
|
|
67
|
+
Every scenario pack must contain these five asset categories:
|
|
68
|
+
|
|
69
|
+
| Asset Type | Purpose | Example |
|
|
70
|
+
|-----------|---------|---------|
|
|
71
|
+
| Standard | Non-negotiable rules for the domain | "Tenant isolation must cover DB, cache, and object storage" |
|
|
72
|
+
| Playbook | Step-by-step operational procedures | "New tenant provisioning and initialization steps" |
|
|
73
|
+
| Checklist | Pre-launch verification items | "Cross-tenant access prevention check" |
|
|
74
|
+
| Anti-Pattern | Known failure modes to avoid | "Cache keys without tenant dimension" |
|
|
75
|
+
| Case Study | Real-world implementation reference | "Single-DB multi-tenant to sharded evolution" |
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## 2. B2B Enterprise Development Scenario Pack
|
|
80
|
+
|
|
81
|
+
### 2.1 Standards
|
|
82
|
+
|
|
83
|
+
- **Organizational Model**: Organization, role, and permission models must be designed with explicit layering (org -> team -> role -> permission).
|
|
84
|
+
- **Approval Workflows**: Approval flows must support configurable nodes, conditional branching, and full audit trail.
|
|
85
|
+
- **Data Isolation**: Customer data must be logically or physically isolated; cross-customer data access is a P0 defect.
|
|
86
|
+
- **Audit Trail**: Every state-changing operation must be logged with actor, timestamp, old value, new value, and IP.
|
|
87
|
+
- **SLA Commitments**: Enterprise customers expect contractual SLA; system must measure and report availability per tenant.
|
|
88
|
+
|
|
89
|
+
### 2.2 Playbook
|
|
90
|
+
|
|
91
|
+
**Enterprise SSO Integration**
|
|
92
|
+
1. Confirm identity provider (SAML 2.0, OIDC, or LDAP).
|
|
93
|
+
2. Register application in the customer's IdP; exchange metadata.
|
|
94
|
+
3. Implement attribute mapping (groups -> roles).
|
|
95
|
+
4. Test login flow with at least 3 role combinations.
|
|
96
|
+
5. Enable JIT (Just-In-Time) provisioning or require pre-provisioning.
|
|
97
|
+
6. Document logout flow and session timeout behavior.
|
|
98
|
+
|
|
99
|
+
**Custom Capability Boundary Management**
|
|
100
|
+
1. Define the extensibility surface: what can be customized vs. what is locked.
|
|
101
|
+
2. Use feature flags or configuration layers -- never branch the main codebase per customer.
|
|
102
|
+
3. Document customization contracts with versioning.
|
|
103
|
+
4. Customer-specific logic must be deployed without blocking trunk releases.
|
|
104
|
+
|
|
105
|
+
### 2.3 Checklist
|
|
106
|
+
|
|
107
|
+
- [ ] Pre-launch permission isolation verified for large enterprise tenants.
|
|
108
|
+
- [ ] Audit log completeness verified (actor, action, target, timestamp, result).
|
|
109
|
+
- [ ] Approval flow edge cases tested (timeout, rejection, delegation, escalation).
|
|
110
|
+
- [ ] SSO integration tested with customer's staging IdP.
|
|
111
|
+
- [ ] Data export / portability capability verified (contractual requirement in many B2B deals).
|
|
112
|
+
- [ ] Rate limiting and quota management per organization configured.
|
|
113
|
+
|
|
114
|
+
### 2.4 Anti-Patterns
|
|
115
|
+
|
|
116
|
+
| Anti-Pattern | Impact | Remedy |
|
|
117
|
+
|-------------|--------|--------|
|
|
118
|
+
| Hardcoding customer customizations in trunk | Merge conflicts, regression risk, unmaintainable | Use configuration layer or plugin architecture |
|
|
119
|
+
| Temporary scripts for long-term permission policies | Security drift, audit failure | Implement policy-as-code with version control |
|
|
120
|
+
| Single admin role for all operations | Excessive privilege, compliance violation | Implement RBAC with least-privilege principle |
|
|
121
|
+
| No data export capability | Customer lock-in complaints, contract risk | Build export API from day one |
|
|
122
|
+
|
|
123
|
+
### 2.5 Case Studies
|
|
124
|
+
|
|
125
|
+
**Multi-Level Approval Procurement Platform**
|
|
126
|
+
- Challenge: 5-level approval chain with conditional routing and delegation.
|
|
127
|
+
- Solution: Workflow engine with configurable rules, timeout auto-escalation, and full audit trail.
|
|
128
|
+
- Result: Approval cycle reduced from 5 days to 1.5 days; audit pass rate 100%.
|
|
129
|
+
|
|
130
|
+
**Enterprise Tenant Onboarding with Historical Data Migration**
|
|
131
|
+
- Challenge: Migrating 2M records from legacy system with schema differences.
|
|
132
|
+
- Solution: ETL pipeline with validation gates, rollback checkpoints, and reconciliation reports.
|
|
133
|
+
- Result: Zero data loss; migration completed in 4-hour maintenance window.
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## 3. B2C Consumer Growth Scenario Pack
|
|
138
|
+
|
|
139
|
+
### 3.1 Standards
|
|
140
|
+
|
|
141
|
+
- **Conversion Funnel Tracking**: Event tracking must be consistent across the entire funnel (impression -> click -> action -> conversion -> retention).
|
|
142
|
+
- **High-Concurrency Protection**: Promotional events must have rate limiting, circuit breaking, and graceful degradation strategies.
|
|
143
|
+
- **Experiment Infrastructure**: A/B testing must support clean segmentation, statistical significance validation, and safe rollback.
|
|
144
|
+
- **Retention Metrics**: Beyond acquisition, the system must track D1/D7/D30 retention and support cohort analysis.
|
|
145
|
+
|
|
146
|
+
### 3.2 Playbook
|
|
147
|
+
|
|
148
|
+
**A/B Experiment Launch & Rollback**
|
|
149
|
+
1. Define hypothesis, primary metric, and guardrail metrics.
|
|
150
|
+
2. Calculate required sample size for statistical significance.
|
|
151
|
+
3. Implement feature flag with random user assignment (sticky bucketing).
|
|
152
|
+
4. Launch to 5% traffic; monitor guardrail metrics for 24 hours.
|
|
153
|
+
5. Ramp to target percentage if guardrails hold.
|
|
154
|
+
6. Run until significance reached; document and ship winner.
|
|
155
|
+
7. Rollback: flip feature flag; verify metrics within 1 hour.
|
|
156
|
+
|
|
157
|
+
**Promotional Traffic Protection**
|
|
158
|
+
1. Pre-event: capacity test at 2x expected peak; identify bottlenecks.
|
|
159
|
+
2. Configure tiered rate limiting (API gateway -> service -> database).
|
|
160
|
+
3. Prepare degradation switches for non-critical features (recommendations, reviews).
|
|
161
|
+
4. Event day: dedicated war room with real-time dashboards.
|
|
162
|
+
5. Post-event: analyze actual vs. predicted traffic; update capacity model.
|
|
163
|
+
|
|
164
|
+
### 3.3 Checklist
|
|
165
|
+
|
|
166
|
+
- [ ] Pre-promotion capacity stress test completed at 2x expected peak.
|
|
167
|
+
- [ ] Payment success rate and timeout metrics baselined.
|
|
168
|
+
- [ ] Funnel tracking verified end-to-end (no missing events).
|
|
169
|
+
- [ ] Degradation switches tested and documented.
|
|
170
|
+
- [ ] A/B experiment cleanup: remove losing variants within 1 sprint.
|
|
171
|
+
- [ ] Retention tracking configured for post-campaign cohorts.
|
|
172
|
+
|
|
173
|
+
### 3.4 Anti-Patterns
|
|
174
|
+
|
|
175
|
+
| Anti-Pattern | Impact | Remedy |
|
|
176
|
+
|-------------|--------|--------|
|
|
177
|
+
| Tracking only impressions, ignoring retention | Misleading growth metrics | Implement full-funnel tracking including D7/D30 retention |
|
|
178
|
+
| Promotional rules scattered across frontend and backend | Inconsistency, customer complaints | Centralize promotion rules in a single service |
|
|
179
|
+
| No experiment cleanup | Technical debt, conflicting flags | Enforce experiment TTL and automated cleanup |
|
|
180
|
+
| Launching at 100% without ramp | Undetected regressions at scale | Always start at 5% with guardrail monitoring |
|
|
181
|
+
|
|
182
|
+
### 3.5 Case Studies
|
|
183
|
+
|
|
184
|
+
**Flash Sale Concurrency Protection Overhaul**
|
|
185
|
+
- Challenge: Previous flash sale crashed at 50K QPS due to database hot-spot.
|
|
186
|
+
- Solution: Redis-based inventory pre-deduction + async order creation + database batch write.
|
|
187
|
+
- Result: Sustained 200K QPS with zero oversell; error rate < 0.01%.
|
|
188
|
+
|
|
189
|
+
**Recommendation A/B Experiment Driving Conversion**
|
|
190
|
+
- Challenge: Recommendation module showed low CTR.
|
|
191
|
+
- Solution: Personalized ranking model with A/B framework; tested 3 variants.
|
|
192
|
+
- Result: Winner variant increased CTR by 23% and order conversion by 8%.
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
## 4. Multi-Tenant SaaS Scenario Pack
|
|
197
|
+
|
|
198
|
+
### 4.1 Standards
|
|
199
|
+
|
|
200
|
+
- **Tenant Isolation**: Must cover all data layers -- database (row-level or schema-level or DB-level), cache (key prefix or separate instance), object storage (bucket or path prefix), and message queues (topic prefix or separate topic).
|
|
201
|
+
- **Quota & Rate Limiting**: Must support per-tenant configuration for API rate limits, storage quotas, compute limits, and concurrent user limits.
|
|
202
|
+
- **Billing Dimensions**: Usage metering must be accurate per tenant, supporting multiple billing models (seat-based, usage-based, tiered).
|
|
203
|
+
- **Tenant Lifecycle**: Provisioning, suspension, reactivation, and deletion must be automated with audit trail.
|
|
204
|
+
|
|
205
|
+
### 4.2 Playbook
|
|
206
|
+
|
|
207
|
+
**New Tenant Provisioning**
|
|
208
|
+
1. Validate tenant configuration (plan, region, admin user).
|
|
209
|
+
2. Create tenant record in control plane database.
|
|
210
|
+
3. Provision isolated resources (DB schema/namespace, cache prefix, storage path).
|
|
211
|
+
4. Seed default configuration and sample data.
|
|
212
|
+
5. Create admin user and send invitation.
|
|
213
|
+
6. Run smoke test against tenant-specific endpoints.
|
|
214
|
+
7. Enable billing metering.
|
|
215
|
+
|
|
216
|
+
**Tenant Migration & Consolidation**
|
|
217
|
+
1. Freeze source tenant (read-only mode).
|
|
218
|
+
2. Export all data with referential integrity preserved.
|
|
219
|
+
3. Transform data to target schema if needed.
|
|
220
|
+
4. Import to target tenant with validation checksums.
|
|
221
|
+
5. Run reconciliation report; resolve discrepancies.
|
|
222
|
+
6. Switch DNS / routing to target.
|
|
223
|
+
7. Maintain source in read-only for 30-day rollback window.
|
|
224
|
+
|
|
225
|
+
### 4.3 Checklist
|
|
226
|
+
|
|
227
|
+
- [ ] Cross-tenant access prevention verified (attempt access with Tenant-A token to Tenant-B data).
|
|
228
|
+
- [ ] Tenant-level backup and restore drill completed.
|
|
229
|
+
- [ ] Quota enforcement tested at limit boundaries.
|
|
230
|
+
- [ ] Billing metering accuracy verified (compare usage logs with billing records).
|
|
231
|
+
- [ ] Tenant deletion verified (all data purged, resources released, audit log retained).
|
|
232
|
+
- [ ] Noisy-neighbor protection tested (one tenant's spike does not degrade others).
|
|
233
|
+
|
|
234
|
+
### 4.4 Anti-Patterns
|
|
235
|
+
|
|
236
|
+
| Anti-Pattern | Impact | Remedy |
|
|
237
|
+
|-------------|--------|--------|
|
|
238
|
+
| Cache keys without tenant dimension | Cross-tenant data leakage | Enforce `tenant:{id}:` key prefix at SDK level |
|
|
239
|
+
| Super-admin operations without audit trail | Compliance violation, trust erosion | Log all admin operations with immutable audit trail |
|
|
240
|
+
| Shared connection pool without tenant limits | Noisy-neighbor resource exhaustion | Implement per-tenant connection pooling or priority queuing |
|
|
241
|
+
| Hardcoded single-tenant assumptions in ORM | Massive refactoring when adding multi-tenancy | Design tenant context from day one |
|
|
242
|
+
|
|
243
|
+
### 4.5 Case Studies
|
|
244
|
+
|
|
245
|
+
**Single-DB Multi-Tenant to Sharded Evolution**
|
|
246
|
+
- Challenge: 500+ tenants on single PostgreSQL; largest tenant causing lock contention.
|
|
247
|
+
- Solution: Introduced tenant-aware sharding with Citus; largest 10 tenants on dedicated shards.
|
|
248
|
+
- Result: P99 latency reduced from 2.3s to 180ms; zero cross-tenant data incidents.
|
|
249
|
+
|
|
250
|
+
**Dedicated Resource Pool for Enterprise Tenants**
|
|
251
|
+
- Challenge: Enterprise customers demanded guaranteed performance SLA.
|
|
252
|
+
- Solution: Kubernetes namespace per enterprise tenant with resource quotas and dedicated node pools.
|
|
253
|
+
- Result: Contractual SLA met (99.95%); premium pricing justified.
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## 5. Internationalization Scenario Pack
|
|
258
|
+
|
|
259
|
+
### 5.1 Standards
|
|
260
|
+
|
|
261
|
+
- **String Management**: All user-facing text must use locale keys managed in a translation management system (TMS). No hardcoded strings in source code.
|
|
262
|
+
- **Format Localization**: Date, time, number, currency, address, and phone formats must use locale-aware formatters (ICU / Intl API).
|
|
263
|
+
- **Timezone Handling**: All server-side timestamps stored in UTC. Conversion to local timezone happens at the presentation layer.
|
|
264
|
+
- **RTL Support**: Layout must correctly mirror for right-to-left languages (Arabic, Hebrew).
|
|
265
|
+
|
|
266
|
+
### 5.2 Playbook
|
|
267
|
+
|
|
268
|
+
**Multi-Language Release & Translation Workflow**
|
|
269
|
+
1. Developers use locale keys; never write raw strings.
|
|
270
|
+
2. New keys are extracted and pushed to TMS automatically on merge.
|
|
271
|
+
3. Translators work in TMS with context screenshots.
|
|
272
|
+
4. Translated bundles are pulled into the build pipeline.
|
|
273
|
+
5. Pseudo-localization test run to catch truncation and layout issues.
|
|
274
|
+
6. Release with fallback chain: user locale -> region default -> English.
|
|
275
|
+
|
|
276
|
+
**Regional Compliance Onboarding**
|
|
277
|
+
1. Identify applicable regulations per region (GDPR, CCPA, PIPL, etc.).
|
|
278
|
+
2. Map regulation requirements to feature flags (cookie consent, data residency, right to deletion).
|
|
279
|
+
3. Implement consent collection and storage per regulation.
|
|
280
|
+
4. Test compliance flow per region with legal review sign-off.
|
|
281
|
+
5. Document regional compliance matrix and update quarterly.
|
|
282
|
+
|
|
283
|
+
### 5.3 Checklist
|
|
284
|
+
|
|
285
|
+
- [ ] Pseudo-localization test passed (verify no truncation, overlap, or hardcoded strings).
|
|
286
|
+
- [ ] RTL layout verified for Arabic/Hebrew locales.
|
|
287
|
+
- [ ] Daylight saving time (DST) logic verified for all target timezones.
|
|
288
|
+
- [ ] Cross-timezone scheduling logic verified (meeting invites, cron jobs, report generation).
|
|
289
|
+
- [ ] Currency conversion and display verified for all supported currencies.
|
|
290
|
+
- [ ] Regional compliance requirements mapped and feature flags configured.
|
|
291
|
+
- [ ] Fallback locale chain verified (missing translation does not show key name to user).
|
|
292
|
+
|
|
293
|
+
### 5.4 Anti-Patterns
|
|
294
|
+
|
|
295
|
+
| Anti-Pattern | Impact | Remedy |
|
|
296
|
+
|-------------|--------|--------|
|
|
297
|
+
| Hardcoded UI strings in frontend code | Untranslatable, blocks i18n expansion | Enforce lint rule: no string literals in JSX/template |
|
|
298
|
+
| Storing timestamps in local timezone on server | Incorrect calculations across timezones | Store UTC; convert at presentation layer |
|
|
299
|
+
| Concatenating translated strings | Grammatically incorrect in many languages | Use ICU MessageFormat with placeholders |
|
|
300
|
+
| Assuming left-to-right layout | Broken UI for RTL users | Use logical CSS properties (`margin-inline-start` instead of `margin-left`) |
|
|
301
|
+
|
|
302
|
+
### 5.5 Case Studies
|
|
303
|
+
|
|
304
|
+
**Multi-Currency Settlement & Reconciliation Overhaul**
|
|
305
|
+
- Challenge: 12 currencies with different rounding rules and settlement schedules.
|
|
306
|
+
- Solution: Currency service with per-currency rounding config, real-time exchange rate feed, and automated reconciliation.
|
|
307
|
+
- Result: Settlement accuracy 99.99%; reconciliation time reduced from 4 hours to 15 minutes.
|
|
308
|
+
|
|
309
|
+
**Regional Content Strategy Driving Conversion**
|
|
310
|
+
- Challenge: Global landing page had low conversion in APAC markets.
|
|
311
|
+
- Solution: Region-specific hero content, local testimonials, and locale-appropriate CTA language.
|
|
312
|
+
- Result: APAC conversion rate increased by 34%.
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## 6. Mobile Superapp Scenario Pack
|
|
317
|
+
|
|
318
|
+
### 6.1 Standards
|
|
319
|
+
|
|
320
|
+
- **Performance Budgets**: Define and enforce budgets for cold start time (< 2s), memory usage (< 150MB baseline), crash rate (< 0.1%), and ANR rate (< 0.05%).
|
|
321
|
+
- **Offline & Retry**: Core flows must work offline with local queue and automatic retry on connectivity restoration.
|
|
322
|
+
- **Weak Network Resilience**: All network calls must have timeout, retry with exponential backoff, and graceful degradation.
|
|
323
|
+
- **Permission Minimization**: Request only necessary permissions; justify each in privacy manifest.
|
|
324
|
+
|
|
325
|
+
### 6.2 Playbook
|
|
326
|
+
|
|
327
|
+
**Staged Rollout & Hotfix**
|
|
328
|
+
1. Submit to app store with phased rollout (1% -> 5% -> 20% -> 50% -> 100%).
|
|
329
|
+
2. Monitor crash rate, ANR rate, and key metrics at each stage.
|
|
330
|
+
3. Hold at each stage for minimum 24 hours.
|
|
331
|
+
4. If regression detected: halt rollout and push hotfix.
|
|
332
|
+
5. Hotfix path: code-push for JS layer; expedited store review for native layer.
|
|
333
|
+
6. Emergency: server-side feature flag to disable problematic feature without app update.
|
|
334
|
+
|
|
335
|
+
**Client Emergency Rollback & Version Control**
|
|
336
|
+
1. Server-side minimum version enforcement: reject requests from deprecated versions.
|
|
337
|
+
2. Force-update dialog for critical security patches.
|
|
338
|
+
3. Maintain N-2 API version compatibility.
|
|
339
|
+
4. Feature flags for all major features; remotely disable without release.
|
|
340
|
+
|
|
341
|
+
### 6.3 Checklist
|
|
342
|
+
|
|
343
|
+
- [ ] Device compatibility matrix verified (top 20 devices by user base, min OS versions).
|
|
344
|
+
- [ ] Permission requests comply with platform guidelines and are minimized.
|
|
345
|
+
- [ ] Offline mode tested: complete core flow without network, sync on reconnect.
|
|
346
|
+
- [ ] Weak network tested: 2G simulation, high latency, intermittent connectivity.
|
|
347
|
+
- [ ] Cold start time measured on low-end reference device (< 2s target).
|
|
348
|
+
- [ ] Memory leak test: 30-minute usage session on low-end device.
|
|
349
|
+
- [ ] Deep link / universal link routing verified for all registered paths.
|
|
350
|
+
- [ ] Background / foreground transition state management verified.
|
|
351
|
+
|
|
352
|
+
### 6.4 Anti-Patterns
|
|
353
|
+
|
|
354
|
+
| Anti-Pattern | Impact | Remedy |
|
|
355
|
+
|-------------|--------|--------|
|
|
356
|
+
| Full release without staged rollout | Undetected crash affecting all users | Always use phased rollout with monitoring gates |
|
|
357
|
+
| No background/foreground state management | Data loss, stale UI, crash on resume | Implement lifecycle-aware state persistence |
|
|
358
|
+
| Requesting all permissions at launch | Low install-to-activation rate | Request permissions in context, at point of use |
|
|
359
|
+
| No offline capability for core flows | Unusable in elevators, subways, rural areas | Implement offline queue with sync-on-reconnect |
|
|
360
|
+
|
|
361
|
+
### 6.5 Case Studies
|
|
362
|
+
|
|
363
|
+
**Offline-First Field Service Application**
|
|
364
|
+
- Challenge: Field workers in areas with no connectivity needed to complete inspections.
|
|
365
|
+
- Solution: Local SQLite database with conflict-free replicated data types (CRDTs); background sync.
|
|
366
|
+
- Result: 100% task completion rate regardless of connectivity; sync conflicts < 0.01%.
|
|
367
|
+
|
|
368
|
+
**Deep Link Optimization Driving Conversion**
|
|
369
|
+
- Challenge: Marketing links opened the app but landed on home page, not target content.
|
|
370
|
+
- Solution: Deferred deep linking with attribution; fallback to web if app not installed.
|
|
371
|
+
- Result: Deep link conversion rate increased by 41%.
|
|
372
|
+
|
|
373
|
+
---
|
|
374
|
+
|
|
375
|
+
## 7. AI Application Scenario Pack
|
|
376
|
+
|
|
377
|
+
### 7.1 Standards
|
|
378
|
+
|
|
379
|
+
- **Trust Boundaries**: Model output must include confidence indicators or explicit uncertainty disclaimers. Never present AI output as verified fact.
|
|
380
|
+
- **RAG Data Governance**: Retrieval-Augmented Generation data sources must be traceable, updatable, and rollbackable. Source metadata must be attached to every retrieval result.
|
|
381
|
+
- **Prompt Versioning**: Prompts are code -- version controlled, reviewed, tested, and deployed through the standard release pipeline.
|
|
382
|
+
- **Safety Guardrails**: Input and output must be filtered for prompt injection, PII leakage, and harmful content.
|
|
383
|
+
|
|
384
|
+
### 7.2 Playbook
|
|
385
|
+
|
|
386
|
+
**Prompt Version Management & Deployment**
|
|
387
|
+
1. Store prompts in version control (alongside code or in dedicated prompt registry).
|
|
388
|
+
2. Each prompt change requires a PR with offline evaluation results.
|
|
389
|
+
3. Evaluation suite: accuracy, hallucination rate, latency, cost, and safety checks.
|
|
390
|
+
4. Deploy via feature flag; A/B test new prompt against baseline.
|
|
391
|
+
5. Monitor production metrics for 48 hours before full rollout.
|
|
392
|
+
6. Rollback: revert feature flag to previous prompt version.
|
|
393
|
+
|
|
394
|
+
**AI Incident Response & Human Fallback**
|
|
395
|
+
1. Define AI failure modes: hallucination, high latency, safety filter trigger, model unavailability.
|
|
396
|
+
2. For each failure mode, implement automated detection and human fallback path.
|
|
397
|
+
3. Hallucination: confidence below threshold triggers human review queue.
|
|
398
|
+
4. Latency: timeout triggers cached / static fallback response.
|
|
399
|
+
5. Safety filter: blocked output triggers human agent escalation.
|
|
400
|
+
6. Model down: circuit breaker routes to rule-based fallback.
|
|
401
|
+
|
|
402
|
+
### 7.3 Checklist
|
|
403
|
+
|
|
404
|
+
- [ ] Hallucination rate measured on representative test set (target: < 5% for factual queries).
|
|
405
|
+
- [ ] End-to-end latency measured (P50, P95, P99) and within budget.
|
|
406
|
+
- [ ] Cost per query calculated and within budget.
|
|
407
|
+
- [ ] User adoption rate and task completion rate tracked.
|
|
408
|
+
- [ ] Prompt injection attack tested (at least 10 known attack patterns).
|
|
409
|
+
- [ ] PII detection and redaction verified in both input and output.
|
|
410
|
+
- [ ] Human fallback path tested end-to-end.
|
|
411
|
+
- [ ] RAG source freshness verified (no stale data beyond defined TTL).
|
|
412
|
+
|
|
413
|
+
### 7.4 Anti-Patterns
|
|
414
|
+
|
|
415
|
+
| Anti-Pattern | Impact | Remedy |
|
|
416
|
+
|-------------|--------|--------|
|
|
417
|
+
| Treating the model as a factual database | Users trust incorrect output | Always show confidence and source attribution |
|
|
418
|
+
| Deploying without offline evaluation | Regressions discovered in production | Require evaluation suite pass before merge |
|
|
419
|
+
| No human fallback path | Users stuck when AI fails | Implement fallback for every AI-powered feature |
|
|
420
|
+
| RAG without source tracking | Unverifiable, non-updatable knowledge | Attach source metadata to every retrieval chunk |
|
|
421
|
+
| Prompt changes without version control | Unreproducible behavior, impossible rollback | Treat prompts as code with full CI/CD |
|
|
422
|
+
|
|
423
|
+
### 7.5 Case Studies
|
|
424
|
+
|
|
425
|
+
**Intelligent Customer Service with RAG Q&A Loop**
|
|
426
|
+
- Challenge: Customer service team overwhelmed; FAQ coverage insufficient.
|
|
427
|
+
- Solution: RAG-based Q&A with knowledge base, confidence scoring, and human escalation for low-confidence answers.
|
|
428
|
+
- Result: 72% of queries resolved automatically; CSAT maintained at 4.3/5.
|
|
429
|
+
|
|
430
|
+
**Code Assistant Integrated with Standards Review**
|
|
431
|
+
- Challenge: Code review bottleneck; style and security issues caught too late.
|
|
432
|
+
- Solution: AI code assistant that suggests fixes inline, referencing team coding standards and security rules.
|
|
433
|
+
- Result: PR review cycle reduced by 40%; security issue escape rate reduced by 65%.
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
## 8. Fintech Regulated Scenario Pack
|
|
438
|
+
|
|
439
|
+
### 8.1 Standards
|
|
440
|
+
|
|
441
|
+
- **Transaction Integrity**: Transaction chains must satisfy strong consistency and non-repudiation. Every transaction must have an immutable audit record.
|
|
442
|
+
- **Risk Control Traceability**: Risk control and anti-fraud strategies must be explainable and traceable. Decision logs must be retained for regulatory examination.
|
|
443
|
+
- **Data Classification**: All data fields must be classified (public, internal, confidential, restricted) with corresponding protection measures (encryption at rest, in transit, tokenization).
|
|
444
|
+
- **Regulatory Mapping**: Every applicable regulation must be mapped to specific technical controls with evidence of compliance.
|
|
445
|
+
|
|
446
|
+
### 8.2 Playbook
|
|
447
|
+
|
|
448
|
+
**Transaction Anomaly Rollback & Compensation**
|
|
449
|
+
1. Detect anomaly (timeout, inconsistency, fraud signal).
|
|
450
|
+
2. Halt affected transaction chain; log freeze point.
|
|
451
|
+
3. Determine compensation strategy: reverse transaction, credit adjustment, or manual review.
|
|
452
|
+
4. Execute compensation with separate audit trail.
|
|
453
|
+
5. Reconcile: verify source and destination balances match expected state.
|
|
454
|
+
6. Generate incident report with timeline and resolution evidence.
|
|
455
|
+
|
|
456
|
+
**Compliance Audit Evidence & Reporting**
|
|
457
|
+
1. Define audit scope (regulation, time period, data domain).
|
|
458
|
+
2. Extract relevant logs, transaction records, and decision trails.
|
|
459
|
+
3. Generate compliance report with required format and fields.
|
|
460
|
+
4. Internal review and sign-off before submission.
|
|
461
|
+
5. Archive evidence package with tamper-evident hash.
|
|
462
|
+
|
|
463
|
+
### 8.3 Checklist
|
|
464
|
+
|
|
465
|
+
- [ ] Sensitive data classification and masking/encryption verified for all fields.
|
|
466
|
+
- [ ] Key account reconciliation completed; discrepancies resolved within SLA.
|
|
467
|
+
- [ ] Transaction audit trail immutability verified (append-only, hash-chained).
|
|
468
|
+
- [ ] Risk control decision logs retained for required period (typically 5-7 years).
|
|
469
|
+
- [ ] Fraud detection rules tested with known attack patterns.
|
|
470
|
+
- [ ] Regulatory reporting capability verified (format, timing, content).
|
|
471
|
+
- [ ] Disaster recovery drill completed within target RTO/RPO.
|
|
472
|
+
|
|
473
|
+
### 8.4 Anti-Patterns
|
|
474
|
+
|
|
475
|
+
| Anti-Pattern | Impact | Remedy |
|
|
476
|
+
|-------------|--------|--------|
|
|
477
|
+
| No unified transaction ID across services | Impossible to trace end-to-end | Implement distributed tracing with correlation ID |
|
|
478
|
+
| Compliance logs missing critical fields | Audit failure, regulatory penalty | Define and enforce log schema per regulation |
|
|
479
|
+
| Manual reconciliation | Error-prone, slow, unscalable | Automate reconciliation with exception-based human review |
|
|
480
|
+
| Risk rules as hardcoded if-else | Inflexible, slow to update, impossible to explain | Use rules engine with version control and decision logging |
|
|
481
|
+
|
|
482
|
+
### 8.5 Case Studies
|
|
483
|
+
|
|
484
|
+
**Payment Timeout Compensation Mechanism**
|
|
485
|
+
- Challenge: 0.3% of payments timed out with inconsistent state between payment provider and internal ledger.
|
|
486
|
+
- Solution: Saga pattern with compensation steps; automated reconciliation job every 5 minutes.
|
|
487
|
+
- Result: Inconsistency resolution time reduced from 24 hours to 5 minutes; zero financial loss.
|
|
488
|
+
|
|
489
|
+
**Real-Time Risk Control Strategy Evolution**
|
|
490
|
+
- Challenge: Batch fraud detection had 6-hour delay; losses occurred before detection.
|
|
491
|
+
- Solution: Stream processing (Kafka + Flink) with real-time rule evaluation and ML scoring.
|
|
492
|
+
- Result: Fraud detection latency reduced from 6 hours to < 200ms; fraud loss reduced by 78%.
|
|
493
|
+
|
|
494
|
+
---
|
|
495
|
+
|
|
496
|
+
## 9. E-commerce Peak Scenario Pack
|
|
497
|
+
|
|
498
|
+
### 9.1 Standards
|
|
499
|
+
|
|
500
|
+
- **Consistency Strategy**: Inventory, order, and payment must have explicitly defined consistency levels (strong for inventory deduction, eventual for non-critical updates).
|
|
501
|
+
- **Tiered Rate Limiting**: Peak traffic must be managed with multi-layer rate limiting (CDN -> API Gateway -> Service -> Database).
|
|
502
|
+
- **Elastic Scaling**: Auto-scaling policies must be pre-configured and tested before peak events.
|
|
503
|
+
- **Degradation Switches**: Every non-critical feature must have a kill switch for graceful degradation during peak.
|
|
504
|
+
|
|
505
|
+
### 9.2 Playbook
|
|
506
|
+
|
|
507
|
+
**Peak Event War Room & Emergency Response**
|
|
508
|
+
1. T-7 days: capacity test at 2x projected peak; fix bottlenecks.
|
|
509
|
+
2. T-3 days: enable pre-warming for CDN, cache, and connection pools.
|
|
510
|
+
3. T-1 day: war room setup with dashboards, communication channels, and escalation roster.
|
|
511
|
+
4. T-0: real-time monitoring with 1-minute granularity; designated decision-maker for degradation switches.
|
|
512
|
+
5. T+1 hour: post-peak review; document actual vs. predicted metrics.
|
|
513
|
+
6. T+1 day: full post-mortem with improvement items.
|
|
514
|
+
|
|
515
|
+
**Inventory Hotspot Protection & Replenishment**
|
|
516
|
+
1. Identify hot-spot SKUs (top 0.1% by expected demand).
|
|
517
|
+
2. Pre-load hot-spot inventory into Redis with per-SKU rate limiting.
|
|
518
|
+
3. Implement two-phase inventory: Redis pre-deduction -> async DB confirmation.
|
|
519
|
+
4. Replenishment: monitor Redis inventory; trigger replenishment when below threshold.
|
|
520
|
+
5. Oversell protection: if DB confirmation fails, release Redis reservation and notify user.
|
|
521
|
+
|
|
522
|
+
### 9.3 Checklist
|
|
523
|
+
|
|
524
|
+
- [ ] Peak capacity stress test completed at 2x projected traffic.
|
|
525
|
+
- [ ] Capacity redundancy verified (compute, database connections, cache memory).
|
|
526
|
+
- [ ] Core flow degradation switches tested and documented.
|
|
527
|
+
- [ ] CDN and cache pre-warming completed for static and hot-spot content.
|
|
528
|
+
- [ ] Inventory hot-spot protection verified (no oversell under concurrent load).
|
|
529
|
+
- [ ] Payment timeout and retry logic verified under high latency.
|
|
530
|
+
- [ ] Auto-scaling policy tested and verified (scale-up time < 3 minutes).
|
|
531
|
+
- [ ] War room communication and escalation chain verified.
|
|
532
|
+
|
|
533
|
+
### 9.4 Anti-Patterns
|
|
534
|
+
|
|
535
|
+
| Anti-Pattern | Impact | Remedy |
|
|
536
|
+
|-------------|--------|--------|
|
|
537
|
+
| Promotional rules hardcoded and not hot-updatable | Cannot adjust during peak; wrong prices | Store rules in config service with hot-reload |
|
|
538
|
+
| Hot-spot cache key without protection | Cache avalanche / stampede | Implement per-key rate limiting and async refresh |
|
|
539
|
+
| No degradation switches for non-critical features | Everything fails together | Feature-flag every non-core feature; test kill switches |
|
|
540
|
+
| Testing at 1x expected peak | No headroom for traffic spikes | Always test at 2x minimum; 3x for critical events |
|
|
541
|
+
|
|
542
|
+
### 9.5 Case Studies
|
|
543
|
+
|
|
544
|
+
**Flash Sale Inventory Oversell Prevention**
|
|
545
|
+
- Challenge: Previous flash sale oversold 1,200 units due to database race condition.
|
|
546
|
+
- Solution: Redis Lua script for atomic inventory deduction; async order creation with compensation on failure.
|
|
547
|
+
- Result: Zero oversell across 5 subsequent flash sales handling 300K QPS.
|
|
548
|
+
|
|
549
|
+
**Peak Payment Success Rate Defense**
|
|
550
|
+
- Challenge: Payment success rate dropped to 89% during Double-11 due to upstream timeout.
|
|
551
|
+
- Solution: Circuit breaker per payment channel; automatic failover to secondary channel; increased timeout budget.
|
|
552
|
+
- Result: Payment success rate maintained at 99.7% during subsequent peak.
|
|
553
|
+
|
|
554
|
+
---
|
|
555
|
+
|
|
556
|
+
## Agent Checklist
|
|
557
|
+
|
|
558
|
+
- [ ] Identify all applicable scenario packs using the decision tree.
|
|
559
|
+
- [ ] Verify all five asset types (standard, playbook, checklist, anti-pattern, case) are populated for each selected pack.
|
|
560
|
+
- [ ] Apply standards from selected packs as hard constraints in architecture and implementation.
|
|
561
|
+
- [ ] Execute playbook steps for relevant operational procedures.
|
|
562
|
+
- [ ] Complete all checklist items before launch.
|
|
563
|
+
- [ ] Cross-reference anti-pattern catalog during code review.
|
|
564
|
+
- [ ] Reference case studies when evaluating solution approaches.
|
|
565
|
+
- [ ] Re-evaluate scenario selection when business requirements change.
|