删除过时的部署管理端触发词文档，并更新相关索引以反映新的触发词约定，确保文档一致性和准确性。
This commit is contained in:
Alex-larget
26
.cursor/agent/安全工程师/evolution/2026-03-20-管理端部署触发词.md
Normal file
26
.cursor/agent/安全工程师/evolution/2026-03-20-管理端部署触发词.md
Normal file
@@ -0,0 +1,26 @@
|
||||
# 管理端部署触发词约定
|
||||
|
||||
**日期**：2026-03-20
|
||||
|
||||
## 场景
|
||||
|
||||
用户说「管理端帮我部署到xx环境」时，安全工程师应语义化解析 xx，直接执行对应部署脚本。
|
||||
|
||||
## 解决方案
|
||||
|
||||
- **触发词**：管理端帮我部署到xx环境（语义化，理解意图即可）
|
||||
- **脚本映射**：
|
||||
- 含「正式」「线上」「生产」→ `cd soul-admin && python master.py`（正式环境，/www/wwwroot/self/soul-admin）
|
||||
- 含「测试」「dev」→ `cd soul-admin && python deploy.py`（测试环境，/www/wwwroot/self/soul-admin-dev）
|
||||
|
||||
## soul-admin 部署脚本
|
||||
|
||||
| 脚本 | 环境 | 目标目录 | 构建命令 |
|
||||
|------|------|----------|----------|
|
||||
| master.py | 正式 | soul-admin | pnpm build |
|
||||
| deploy.py | 测试 | soul-admin-dev | pnpm run build:dev |
|
||||
|
||||
## 已升级 Skills
|
||||
|
||||
1. **security-server-ops**：何时使用表、2.2 soul-admin 脚本索引、4.4/4.5 常用操作
|
||||
2. **soul-project-boundary**：按场景触发词表新增
|
||||
18
.cursor/agent/安全工程师/evolution/2026-03-20-部署API触发词.md
Normal file
18
.cursor/agent/安全工程师/evolution/2026-03-20-部署API触发词.md
Normal file
@@ -0,0 +1,18 @@
|
||||
# 部署 API 触发词约定
|
||||
|
||||
**日期**：2026-03-20
|
||||
|
||||
## 场景
|
||||
|
||||
用户说「帮我部署api到线上」时，安全工程师应直接执行部署脚本，无需再询问或选择。
|
||||
|
||||
## 解决方案
|
||||
|
||||
- **触发词**：帮我部署api到线上
|
||||
- **动作**：直接执行 `cd soul-api && python master.py`
|
||||
- **脚本**：`soul-api/master.py`（soul-api 正式环境部署）
|
||||
|
||||
## 已升级 Skills
|
||||
|
||||
1. **security-server-ops**：何时使用表新增该触发词，明确直接执行命令
|
||||
2. **soul-project-boundary**：按场景触发词表新增，加载 security-server-ops 后执行
|
||||
@@ -1,24 +0,0 @@
|
||||
# 部署管理端触发词约定
|
||||
|
||||
**日期**：2026-03-20
|
||||
|
||||
## 场景
|
||||
|
||||
用户说「帮我部署管理端到线上」时，安全工程师应直接执行部署脚本，无需再询问或选择。
|
||||
|
||||
## 解决方案
|
||||
|
||||
- **触发词**：帮我部署管理端到线上
|
||||
- **动作**：直接执行 `cd soul-api && python master.py`
|
||||
- **脚本**：`soul-api/master.py`（soul-api 正式环境部署）
|
||||
|
||||
## 已升级 Skills
|
||||
|
||||
1. **security-server-ops**：何时使用表新增该触发词，明确直接执行命令
|
||||
2. **soul-project-boundary**：按场景触发词表新增，加载 security-server-ops 后执行
|
||||
|
||||
## 说明
|
||||
|
||||
- `master.py` 部署的是 soul-api（Go 后端），非 soul-admin 前端
|
||||
- 若需部署 soul-admin 前端，应使用 `soul-admin/deploy.py`
|
||||
- 用户明确指定「管理端」对应 master.py，按约定执行
|
||||
@@ -5,4 +5,5 @@
|
||||
| 日期 | 摘要 | 文件 |
|
||||
|------|------|------|
|
||||
| 2026-03-20 | 挖矿病毒排查经验转化为 Skills；服务器操作 Skill 创建 | 2026-03-20-挖矿与服务器Skills.md |
|
||||
| 2026-03-20 | 「帮我部署管理端到线上」→ 执行 soul-api/master.py | 2026-03-20-部署管理端触发词.md |
|
||||
| 2026-03-20 | 「帮我部署api到线上」→ 执行 soul-api/master.py | 2026-03-20-部署API触发词.md |
|
||||
| 2026-03-20 | 「管理端帮我部署到xx环境」→ 语义化解析，正式→master.py，测试→deploy.py | 2026-03-20-管理端部署触发词.md |
|
||||
|
||||
39
.cursor/agent/小程序开发工程师/evolution/2026-03-20-手机号登录与公用组件.md
Normal file
39
.cursor/agent/小程序开发工程师/evolution/2026-03-20-手机号登录与公用组件.md
Normal file
@@ -0,0 +1,39 @@
|
||||
# 手机号一键登录与登录弹窗公用组件
|
||||
|
||||
> 日期：2026-03-20 | 角色：小程序开发工程师
|
||||
|
||||
## 问题与场景
|
||||
|
||||
1. **getPhoneNumber 不弹窗**：点击手机号登录按钮时，无法弹出手机号选择界面，也无法获取手机号
|
||||
2. **登录弹窗重复**：read、my、gift-pay/detail 三处各自维护一套登录弹窗，逻辑重复、维护成本高
|
||||
3. **登录后手机号未同步**：手机号登录后若响应中 user.phone 为空，本地 userInfo 未更新
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. getPhoneNumber 必须与隐私协议耦合
|
||||
|
||||
- **open-type**：`open-type="getPhoneNumber|agreePrivacyAuthorization"`（基础库 2.32.3+）
|
||||
- **onNeedPrivacyAuthorization**：app.js 中需将使用 getPhoneNumber 的页面加入支持列表，否则会 `resolve({ event: 'disagree' })` 导致获取失败
|
||||
- **支持页面**：avatar-nickname、profile-edit、read、my、gift-pay/detail、index、settings
|
||||
- **隐私弹窗**：当 onNeedPrivacyAuthorization 触发时，页面需有 `showPrivacyModal` + `<button open-type="agreePrivacyAuthorization">` 供用户同意
|
||||
|
||||
### 2. 登录弹窗公用组件
|
||||
|
||||
- **组件路径**：`components/login-modal/`
|
||||
- **使用方式**：`<login-modal show="{{showLoginModal}}" desc="..." showPrivacyModal="{{showPrivacyModal}}" showCancel="{{true}}" bind:close="..." bind:success="..." bind:privacyagree="..." />`
|
||||
- **适用页面**：read、my、gift-pay/detail
|
||||
- **app.json**：全局注册 `"login-modal": "/components/login-modal/login-modal"`
|
||||
|
||||
### 3. 登录后手机号同步
|
||||
|
||||
- **loginWithPhone 后**：若 `user.phone` 为空，调用 `_syncPhoneFromProfileAfterLogin(userId)` 从 profile 拉取最新
|
||||
- **checkLoginStatus 恢复缓存时**：若 `userInfo.phone` 为空，调用 `_refreshUserInfoIfPhoneEmpty()` 静默刷新
|
||||
|
||||
## 管理后台配置
|
||||
|
||||
- **隐私保护指引**：小程序管理后台 → 设置 → 用户隐私保护指引，必须声明「收集你选择的手机号」
|
||||
- **主体限制**：个人主体小程序无法使用 getPhoneNumber
|
||||
|
||||
## 升级 Skill
|
||||
|
||||
- miniprogram-dev SKILL §8 补充 getPhoneNumber 耦合与 onNeedPrivacyAuthorization 页面支持
|
||||
@@ -14,3 +14,4 @@
|
||||
| 2026-03-16 | 编辑资料页分享名片：转发/朋友圈特殊处理，Canvas 绘制封面，标题「昵称+为您分享名片」 | [2026-03-16.md](./2026-03-16.md) |
|
||||
| 2026-03-17 | 代付美团式：读页→代付页→分享；详情页双态（发起人/好友）；目录 loading、最新新增 5 条折叠 | [2026-03-17.md](./2026-03-17.md) |
|
||||
| 2026-03-19 | 原生按钮覆盖定位：chooseAvatar 等用绝对定位 overlay 覆盖，禁止 button 包裹，避免原生样式影响 | [2026-03-19-原生按钮覆盖定位.md](./2026-03-19-原生按钮覆盖定位.md) |
|
||||
| 2026-03-20 | 手机号一键登录与公用组件：getPhoneNumber 耦合 agreePrivacyAuthorization；login-modal 组件；登录后手机号同步 | [2026-03-20-手机号登录与公用组件.md](./2026-03-20-手机号登录与公用组件.md) |
|
||||
|
||||
@@ -54,7 +54,9 @@
|
||||
| 2026-03-18 | 小程序、团队 | 业务规则/最佳实践 | - | 分享链路兼容好友/朋友圈 singlePage：单页模式能力降级（不支付/不自动领取），引导点击底部“前往小程序”进入完整版 |
|
||||
| 2026-03-18 | 产品、后端、管理端、测试 | 文档归档/需求口径 | - | 文档归档整理：以《以界面定需求》为基准，各角色重整“功能需求+验收口径+风险点”并写入各自经验库；补齐《项目落地推进表》 |
|
||||
| 2026-03-19 | 小程序 | 最佳实践 | miniprogram-dev SKILL §11 | 原生按钮覆盖定位：chooseAvatar 等用绝对定位 overlay 覆盖，禁止 button 包裹，避免原生样式影响（灰色矩形等） |
|
||||
| 2026-03-20 | 安全工程师 | 触发词约定 | security-server-ops、soul-project-boundary | 「帮我部署管理端到线上」→ 直接执行 soul-api/master.py |
|
||||
| 2026-03-20 | 安全工程师 | 触发词约定 | security-server-ops、soul-project-boundary | 「帮我部署api到线上」→ 直接执行 soul-api/master.py |
|
||||
| 2026-03-20 | 安全工程师 | 触发词约定 | security-server-ops、soul-project-boundary | 「管理端帮我部署到xx环境」→ 语义化解析：正式→master.py，测试→deploy.py |
|
||||
| 2026-03-20 | 小程序 | 最佳实践 | miniprogram-dev SKILL §8 | 手机号登录：getPhoneNumber 需耦合 agreePrivacyAuthorization；onNeedPrivacyAuthorization 支持页面；登录弹窗公用组件 login-modal |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
|
||||
## 项目总结
|
||||
|
||||
Soul 创业派对产品定位：面向创业者的社区/工具型小程序。核心需求文档在 `开发文档/1、需求/需求汇总.md`，项目推进表在 `开发文档/10、项目管理/项目落地推进表.md`，临时需求/分析在 `临时需求池/`。
|
||||
Soul 创业派对产品定位：面向创业者的社区/工具型小程序。核心需求文档在 `开发文档/1、需求/`（按日期命名，以最新为主；见 `1、需求/索引.md`），项目推进表在 `开发文档/10、项目管理/项目落地推进表.md`，临时需求/分析在 `临时需求池/`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -31,7 +31,8 @@ Soul 创业派对全项目架构与约定：路由隔离（miniprogram/admin/db
|
||||
| 2026-03-17 | 性能优化与 Redis 缓存方案落地：Redis 容灾回退 DB、OSS 上传容灾；/health 返回 database/redis 状态 | 已完成 |
|
||||
| 2026-03-18 | 吸收经验：分享进入链路需兼容朋友圈 singlePage；单页模式不执行支付/自动领取等强动作并引导“前往小程序” | 已完成 |
|
||||
| 2026-03-18 | 会议：超级个体开通后自动创建@人统一走 Person；幂等键绑定 userId；默认资料 flags 后端输出 | 已完成 |
|
||||
| 2026-03-20 | 「帮我部署管理端到线上」→ 安全工程师执行 soul-api/master.py；security-server-ops、soul-project-boundary 触发词升级 | 已完成 |
|
||||
| 2026-03-20 | 「帮我部署api到线上」→ 安全工程师执行 soul-api/master.py；security-server-ops、soul-project-boundary 触发词升级 | 已完成 |
|
||||
| 2026-03-20 | 「管理端帮我部署到xx环境」→ 语义化解析：正式/线上/生产→master.py，测试/dev→deploy.py；soul-admin 部署脚本索引 | 已完成 |
|
||||
|
||||
> **格式说明**：每次架构级讨论后在此追加一行，日期格式 YYYY-MM-DD
|
||||
|
||||
|
||||
@@ -42,9 +42,10 @@
|
||||
| 2026-03-18 | 吸收经验：分享链路需兼容好友/朋友圈 singlePage；单页模式能力降级并引导“前往小程序”进入完整版 | 已完成 |
|
||||
| 2026-03-18 | 会议：支付超级个体前/开通后资料默认校验，跳转 avatar-nickname 引导页（仅头像+昵称） | 已完成 |
|
||||
| 2026-03-19 | 吸收经验：原生按钮覆盖定位，chooseAvatar 用绝对定位 overlay 覆盖头像，禁止 button 包裹，已升级 SKILL §11 | 已完成 |
|
||||
| 2026-03-20 | 手机号一键登录：getPhoneNumber 耦合 agreePrivacyAuthorization；onNeedPrivacyAuthorization 支持 read/my/gift-pay/index/settings；登录弹窗公用组件 components/login-modal；登录后手机号同步 _syncPhoneFromProfileAfterLogin | 已完成 |
|
||||
|
||||
> **格式说明**：每次开发后在此追加一行，日期格式 YYYY-MM-DD，状态用：已完成 / 进行中 / 待续 / 搁置
|
||||
|
||||
---
|
||||
|
||||
**最后更新**：2026-03-19
|
||||
**最后更新**：2026-03-20
|
||||
|
||||
Reference in New Issue
Block a user