{{ step.title }}
+{{ step.description }}
+diff --git a/.cursor/rules/00-global.mdc b/.cursor/rules/00-global.mdc new file mode 100644 index 0000000..9f96d37 --- /dev/null +++ b/.cursor/rules/00-global.mdc @@ -0,0 +1,12 @@ +--- +description: 萧康云医项目全局编码规则 +alwaysApply: true +--- + +# 全局规则 + +- 代码、包、方法、结构体、接口、关键业务分支、复杂判断、关键配置均需要编写清晰的中文注释。 +- 注释要说明业务意图、输入输出、边界条件和注意事项,避免只重复代码字面含义。 +- 模块职责要清晰,避免跨层调用、重复实现和无关逻辑混入。 +- 新增或修改功能时,优先遵循项目已有目录结构、命名方式、封装习惯和错误处理方式。 +- 公共能力应沉淀为可复用模块或组件,避免在多个页面、控制器或服务中复制粘贴。 diff --git a/.cursor/rules/10-frontend.mdc b/.cursor/rules/10-frontend.mdc new file mode 100644 index 0000000..3c87691 --- /dev/null +++ b/.cursor/rules/10-frontend.mdc @@ -0,0 +1,17 @@ +--- +description: 萧康云医官网前端设计与实现规则 +globs: xk-of-view/**/*,**/*.html,**/*.css,**/*.scss,**/*.less,**/*.vue,**/*.tsx,**/*.ts,**/*.jsx,**/*.js +alwaysApply: false +--- + +# 前端规则 + +- 项目名称为“萧康云医官网”,定位为面向诊所赋能业务的 SaaS 平台。 +- 产品端形态包含小程序患者端、医生端、门店老板端、推广员端,以及 PC 端管理或官网相关页面。 +- 页面设计要体现 SaaS 平台的专业、清晰、高效,优先服务信息扫描、业务转化和多角色理解。 +- 必须注意多端适配,兼容移动端、平板端和桌面端,不允许出现文字溢出、布局重叠、关键按钮不可触达等问题。 +- 必须提供暗色模式适配,颜色、阴影、边框、图标、图表和状态提示都要在明暗主题下保持可读。 +- 采用模块化、组件化设计,页面由清晰的业务模块和可复用 UI 组件组成。 +- 组件应保持职责单一,状态、事件、属性和插槽设计清楚,避免单个组件承担过多页面逻辑。 +- 表单、列表、筛选、弹窗、空状态、加载态、错误态、成功态等常见状态要完整设计。 +- 视觉风格要克制、现代、可信,适合医疗和诊所经营场景;避免过度营销化、装饰化或单一色系堆叠。 diff --git a/.cursor/rules/20-backend-goframe.mdc b/.cursor/rules/20-backend-goframe.mdc new file mode 100644 index 0000000..866d73c --- /dev/null +++ b/.cursor/rules/20-backend-goframe.mdc @@ -0,0 +1,17 @@ +--- +description: 萧康云医后端 GoFrame GF 分层开发规则 +globs: **/*.go,api/**/*,internal/**/*,manifest/**/*,resource/**/* +alwaysApply: false +--- + +# 后端规则 + +- 后端使用 GoFrame GF 框架,必须遵循 GF 的项目结构、路由注册、控制器、服务、模型、配置和错误处理规范。 +- 分层链路为:路由 -> 控制器 -> service 服务层 -> 模型层。 +- 路由层只负责请求路径、HTTP 方法、中间件和控制器绑定,不编写业务逻辑。 +- 控制器层负责获取请求信息、参数验证、用户信息解析、调用 service,并返回统一响应。 +- 控制器层不编写核心业务逻辑,不直接操作数据库,不绕过 service 调用模型。 +- service 层是业务逻辑层,负责业务流程编排、权限判断、事务控制、数据处理和外部服务调用。 +- 模型层只用于定义表结构、表关系、字段映射和数据承载,不编写业务逻辑。 +- 数据库访问、事务、缓存、队列、第三方接口等能力应按 GF 推荐方式封装,并放在合适的服务或基础设施模块中。 +- 参数校验、错误码、日志、上下文传递和用户身份解析要保持统一规范。 diff --git a/.gitignore b/.gitignore index a547bf3..04c93ad 100644 --- a/.gitignore +++ b/.gitignore @@ -22,3 +22,4 @@ dist-ssr *.njsproj *.sln *.sw? +/.cursor/skills/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..849cfcd --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,33 @@ +# 项目协作规则 + +## 全局规则 + +- 代码、包、方法、结构体、接口、关键业务分支、复杂判断、关键配置均需要编写清晰的中文注释。 +- 注释要说明业务意图、输入输出、边界条件和注意事项,避免只重复代码字面含义。 +- 模块职责要清晰,避免跨层调用、重复实现和无关逻辑混入。 +- 新增或修改功能时,优先遵循项目已有目录结构、命名方式、封装习惯和错误处理方式。 +- 公共能力应沉淀为可复用模块或组件,避免在多个页面、控制器或服务中复制粘贴。 + +## 前端规则 + +- 项目名称为“萧康云医官网”,定位为面向诊所赋能业务的 SaaS 平台。 +- 产品端形态包含小程序患者端、医生端、门店老板端、推广员端,以及 PC 端管理或官网相关页面。 +- 页面设计要体现 SaaS 平台的专业、清晰、高效,优先服务信息扫描、业务转化和多角色理解。 +- 必须注意多端适配,兼容移动端、平板端和桌面端,不允许出现文字溢出、布局重叠、关键按钮不可触达等问题。 +- 必须提供暗色模式适配,颜色、阴影、边框、图标、图表和状态提示都要在明暗主题下保持可读。 +- 采用模块化、组件化设计,页面由清晰的业务模块和可复用 UI 组件组成。 +- 组件应保持职责单一,状态、事件、属性和插槽设计清楚,避免单个组件承担过多页面逻辑。 +- 表单、列表、筛选、弹窗、空状态、加载态、错误态、成功态等常见状态要完整设计。 +- 视觉风格要克制、现代、可信,适合医疗和诊所经营场景;避免过度营销化、装饰化或单一色系堆叠。 + +## 后端规则 + +- 后端使用 GoFrame GF 框架,必须遵循 GF 的项目结构、路由注册、控制器、服务、模型、配置和错误处理规范。 +- 分层链路为:路由 -> 控制器 -> service 服务层 -> 模型层。 +- 路由层只负责请求路径、HTTP 方法、中间件和控制器绑定,不编写业务逻辑。 +- 控制器层负责获取请求信息、参数验证、用户信息解析、调用 service,并返回统一响应。 +- 控制器层不编写核心业务逻辑,不直接操作数据库,不绕过 service 调用模型。 +- service 层是业务逻辑层,负责业务流程编排、权限判断、事务控制、数据处理和外部服务调用。 +- 模型层只用于定义表结构、表关系、字段映射和数据承载,不编写业务逻辑。 +- 数据库访问、事务、缓存、队列、第三方接口等能力应按 GF 推荐方式封装,并放在合适的服务或基础设施模块中。 +- 参数校验、错误码、日志、上下文传递和用户身份解析要保持统一规范。 diff --git a/index.html b/index.html index e687656..06cfc2e 100644 --- a/index.html +++ b/index.html @@ -6,7 +6,7 @@ -
每一段不是一个功能点,而是诊所日常经营里真实发生的动作。
+{{ step.description }}
+从线索到成交,从复诊到复购,系统持续描绘诊所的经营温度。
+
+
+
+ 萧康云医不是把功能堆在一起,而是让患者、医生、老板、推广员与后台数据在同一个节奏里流动。
+患者端负责触达,医生端负责服务,老板端负责判断,推广员端负责归因,PC 后台负责秩序。
+{{ item.description }}
+