谷雨开源 SaaS 平台（G2rain）
本文档由 g2rain-app-template 的 docs/index.md 自动同步生成。
# g2rain-app-template 文档

本目录用于让开发者和 AI Coding 基于当前源码维护模板。根 README 负责快速上手，docs/project.yaml 保存机器可读事实，专题文档保存架构、开发、生成、运行和安全规则。

本项目是组织级 frontend-app 1.0.0-draft (opens new window) 的首个试点。中央 Profile 管理同类 App 的公共规则，本目录维护模板实现、生成器、部署细节和架构偏差。正式发布后应切换到包含该 Profile 的固定架构 Tag。

# 架构

# 开发

业务 App 的创建、页面生成和资源配置生成使用 CLI 使用手册 (opens new window)。下面是维护本模板仓库时的文档。

# 运行与安全

# 需求与决策

# 维护规则

  • 源码、package.json、环境文件和部署脚本是实现事实；文档与它们冲突时，先判断代码缺陷还是文档过时，不能静默选择一方。
  • 修改模板将影响所有以后创建的应用，必须同时考虑模板仓库和生成后项目。
  • 生成器输出不是天然正确的代码；必须 Review、测试并允许业务项目继续修改。
  • 架构目标与当前偏差分开维护，不能把技术债固化为新规范。