RuiStudio

组织说明

RuiStudio 为直饮云项目的统一代码与文档组织，用于承载后端服务、管理台、客户端 App、网关服务、模拟器及正式文档等内部研发资产。

组织目标

• 统一管理直饮云相关仓库
• 保持代码、文档、测试与规划资料边界清晰
• 为当前单人维护和后续多项目扩展提供稳定结构
• 为未来新增 App、工具仓库和公共模块预留空间

当前仓库规划

核心业务仓库

• yinclouds-server：后端主服务
• yinclouds-admin：后台管理前端
• yinclouds-cust-app：客户端主 App
• yinclouds-meter-gateway：独立水表网关服务
• yinclouds-meter-simulator：模拟器与联调测试工具
• yinclouds-docs：正式设计与验收文档

后续扩展仓库

• yinclouds-staff-app：员工端或师傅端 App
• yinclouds-manager-app：管家端或管理端 App
• yinclouds-product-plans：产品规划与品牌资料
• yinclouds-legacy-lvyuan：历史系统与兼容代码

组织使用原则

• 核心业务系统默认使用私有仓库
• 一个仓库只承载一个清晰边界的项目或能力
• 正式文档与运行代码尽量分仓管理
• 构建产物、日志、缓存、数据库临时文件不得进入 Git
• 涉及敏感信息的配置应以示例文件或运行时注入方式管理

分支约定

• main：稳定主分支
• dev：日常开发分支
• 功能分支示例：
  • feat/customer-api-auth
  • fix/meter-gateway-timeout
  • refactor/billing-module

许可证策略

• 当前组织下的核心业务仓库以内部私有使用为主
• 现阶段默认不添加开源许可证
• 如果未来拆出通用组件、SDK 或工具包再单独评估是否开源

维护说明

• 当前组织适合单人维护与多项目并行演进
• 后续若新增成员，可按仓库逐步分配权限，不需要重构整体组织结构

备注

• 当前组织面向内部研发与交付使用
• 当前阶段不作为公开开源组织运营