47 lines
3.5 KiB
Plaintext
47 lines
3.5 KiB
Plaintext
---
|
||
description: Soul 创业派对项目整体边界与 Skill 索引，防止子项目互窜；含会话启动自检
|
||
globs: ["**"]
|
||
alwaysApply: true
|
||
---
|
||
|
||
# Soul 创业派对 - 项目边界与开发约束
|
||
|
||
## 会话启动自检（新 Cursor 打开本项目时优先执行）
|
||
|
||
当新的 Cursor 会话打开本项目时，**先进行自检**，确保仅沿用本项目的开发风格与配置：
|
||
|
||
1. **Rules 与 Skills 范围**：仅使用本项目 `.cursor/rules/` 与 `.cursor/skills/` 下的规则与技能；不套用与本项目无关的全局或其它项目的 rules/skills（如存客宝AI、React 转 Vue、Next 全栈拆分等与本项目无关的能力）。
|
||
2. **开发风格**：按当前编辑目录遵守对应 boundary 与 Skill（miniprogram → 小程序规范；soul-admin → 管理端规范；soul-api → API 规范）；API 路径、路由分组、变更检查清单等均以本规则与 `.cursor/README.md` 为准。
|
||
3. **配置参数**：baseUrl、鉴权方式、路由前缀（`/api/miniprogram/*`、`/api/admin/*`、`/api/db/*`）等以项目内实际配置为准，不引入外部项目的默认值或约定。
|
||
4. **清理无关项**：若发现会话上下文中存在与本项目无关的 rules 或 skills 引用，应忽略或排除，仅以本项目 `.cursor` 为准。
|
||
|
||
自检通过后，再按「项目组成」「防互窜原则」「开发时」执行后续开发。
|
||
|
||
---
|
||
|
||
## 项目组成
|
||
|
||
| 子项目 | 目录 | 用途 | 后端对接 |
|
||
|--------------|---------------|--------------------------|------------|
|
||
| 小程序 | miniprogram/ | 微信原生小程序 C 端 | soul-api |
|
||
| 管理端 | soul-admin/ | React 管理后台 | soul-api |
|
||
| API 后端 | soul-api/ | Go + Gin + GORM 接口服务 | - |
|
||
| 预览/参考 | next-project/ | 仅预览，非当前线上后端 | 不依赖 |
|
||
|
||
- **线上约定**：小程序与管理端均只对接 **soul-api**；next-project 不参与当前线上联调与部署。
|
||
|
||
## 防互窜原则
|
||
|
||
1. **小程序**：只调 `/api/miniprogram/*`；不调 `/api/admin/*`、`/api/db/*`。详见 **soul-miniprogram-boundary.mdc** 与 **.cursor/skills/SKILL-小程序开发.md**。
|
||
2. **管理端**：只调 `/api/admin/*`、`/api/db/*` 等管理端路径；不调 `/api/miniprogram/*`。详见 **soul-admin-boundary.mdc** 与 **.cursor/skills/SKILL-管理端开发.md**。
|
||
3. **soul-api**：按使用方挂路由（admin/db vs miniprogram）；不在 miniprogram 组挂管理端专用接口，不在 admin/db 组挂小程序专属接口。详见 **soul-api-boundary.mdc**、**soul-api-coding.mdc** 与 **.cursor/skills/SKILL-API开发.md**。
|
||
4. **next-project**：仅参考用；新增/优化功能以 miniprogram、soul-admin、soul-api 为准。详见 **.cursor/skills/SKILL-next-project仅预览.md**。
|
||
|
||
## 开发时
|
||
|
||
- 在 **miniprogram/** 下编辑 → 遵守 soul-miniprogram-boundary 并参考 **.cursor/skills/SKILL-小程序开发.md**。
|
||
- 在 **soul-admin/** 下编辑 → 遵守 soul-admin-boundary 并参考 **.cursor/skills/SKILL-管理端开发.md**。
|
||
- 在 **soul-api/** 下编辑 → 遵守 soul-api-boundary 与 soul-api-coding 并参考 **.cursor/skills/SKILL-API开发.md**。
|
||
- 涉及「该接口给谁用」时，先确定使用方再写/改代码，避免路径混用或跨子项目逻辑互窜。
|
||
- **每次修改/优化后**：按 **soul-change-checklist.mdc** 过一遍关联层检查，避免漏改；流程与思路见 **.cursor/skills/SKILL-变更关联检查.md**。
|