vibe-coding-cn/docs/references/README.md

参考资料

字多不看

• 本目录回答“具体工程怎么组织、怎么选技术、怎么设置硬门禁”。
• 项目结构、Python 骨架、企业架构、Dataset First 已拆成独立模板。
• 质量门禁、常见坑、技术栈和底层逻辑作为查阅型参考文档维护。

快速导航

文档	定位
工程实践总入口	项目架构、代码组织、开发经验、质量门禁与常见坑的入口。
项目架构模板	常见项目结构、架构设计原则、最低门禁和检查清单。
通用 Python 项目骨架	Python 应用、服务、脚本工具和库项目的通用骨架。
企业级 Monorepo / Multi-repo 架构模板	中大型工程组织、平台工程和多产品线参考模型。
现代企业数字化平台架构	面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线架构原则、约束、反模式与例外执行总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与 RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、基线运营韧性与重要业务服务影响容忍总账、基线第三方与关键供应商风险总账、基线数据驻留与跨境处理总账、基线共享责任与继承控制总账、基线独立控制保证抽样总账、基线连续控制监测总账、基线运行时准入决策总账、基线运行时准入回执、基线长期验签回执、基线证据不可变归档回执、干净环境基线重建回执、私有制品托管交接清单、审计导出排除清单、本地私有制品边界、基线迁移执行回执、基线迁移工作单、基线消费锁定文件、基线准入执行策略、基线撤销与隔离记录、基线发布事务回执、基线门禁执行报告、基线证据追踪图、基线会审裁决记录、基线 EOL 退役证书、基线状态对账报告、基线生命周期状态机、基线就绪评分卡、基线例外总账、基线回滚验证记录、基线通知确认总账、基线验证环境锁定、基线制品清单、基线发布证据、基线兼容性总账、基线采纳总账、基线支持矩阵、基线发布列车、基线符合性声明、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档。
Dataset First 数据服务结构	以 dataset、contract、registry、runtime 为核心的数据服务模板。
代码组织	模块化、命名、注释、格式化、文档和工具。
开发经验	变量名、文件结构、编码规范、架构原则和常见基础设施经验。
AI 编程质量门禁与常见坑	系统提示词、强前置条件、常见坑和硬门禁。
AI 编程质量门禁与常见坑	系统提示词、强前置条件、常见坑和硬门禁。
底层程序逻辑设计与工程优化项	运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
技术栈	技术栈选型、组合案例与学习路径。
如何选择技术栈	从目标、约束、团队能力、生态成熟度和长期维护评估方案。

完整细粒度目录（点击展开/收起）

细粒度目录

• 工程实践总入口 - 项目架构、代码组织、开发经验、质量门禁与常见坑的入口。
• 项目架构模板 - 常见项目结构、架构设计原则、最低门禁和检查清单。
• 通用 Python 项目骨架 - Python 应用、服务、脚本工具和库项目的通用骨架。
• 企业级 Monorepo / Multi-repo 架构模板 - 中大型工程组织、平台工程和多产品线参考模型。
• 现代企业数字化平台架构 - 面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与 RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、基线运营韧性与重要业务服务影响容忍总账、基线第三方与关键供应商风险总账、基线数据驻留与跨境处理总账、基线共享责任与继承控制总账、基线独立控制保证抽样总账、基线连续控制监测总账、基线运行时准入决策总账、基线运行时准入回执、基线长期验签回执、基线证据不可变归档回执、干净环境基线重建回执、私有制品托管交接清单、审计导出排除清单、本地私有制品边界、基线迁移执行回执、基线迁移工作单、基线消费锁定文件、基线准入执行策略、基线撤销与隔离记录、基线发布事务回执、基线门禁执行报告、基线证据追踪图、基线会审裁决记录、基线 EOL 退役证书、基线状态对账报告、基线生命周期状态机、基线就绪评分卡、基线例外总账、基线回滚验证记录、基线通知确认总账、基线验证环境锁定、基线制品清单、基线发布证据、基线兼容性总账、基线采纳总账、基线支持矩阵、基线发布列车、基线符合性声明、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档。
• Dataset First 数据服务结构 - 以 dataset、contract、registry、runtime 为核心的数据服务模板。
• 代码组织 - 模块化、命名、注释、格式化、文档和工具。
• 开发经验 - 变量名、文件结构、编码规范、架构原则和常见基础设施经验。
• AI 编程质量门禁与常见坑 - 系统提示词、强前置条件、常见坑和硬门禁。
• AI 编程质量门禁与常见坑 - 系统提示词、强前置条件、常见坑和硬门禁。
• 底层程序逻辑设计与工程优化项 - 运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
• 技术栈 - 技术栈选型、组合案例与学习路径。
• 如何选择技术栈 - 从目标、约束、团队能力、生态成熟度和长期维护评估方案。

使用方式

• 新项目先看项目架构模板，再根据语言或组织规模选择 Python 骨架或企业架构模板。
• AI 产出不稳定时，查质量门禁与常见坑。
• 技术选型、学习路线和组合案例进入技术栈。

正文

正文已拆分到上方独立文档；本 README 只保留索引、旧锚点兼容入口和阅读顺序。