社区万象全流程
社区万象（SmartFund v3）是一套面向社区行动者的 H5 公益平台：Django 5 + Tailwind，微信网页授权登录，路由前缀 /v3/，主 App 为 community_v3。本技能把已经跑通多轮的「需求调研 → 产品设计 → 开发 → 反馈测试」四阶段固化为可复用 SOP——一句话触发即可按阶段推进，不必每次从零讲背景。
触发后第一步：定位阶段
四阶段是一条闭环流水线（反馈会回流成下一轮需求）：
① 需求调研 → ② 产品设计 → ③ 开发 → ④ 反馈测试
VOC/痛点 页面方案+规范 代码+上线 实测+反馈记录
▲ │
└──────────────── 反馈回流 ───────────────────┘
先判断用户当前在哪一步（或从哪一步开始），再读对应 reference，不要一上来就写代码。
四阶段总览
| # | 阶段 | 目标 | 核心产出 | 详细 SOP |
|---|---|---|---|---|
| 1 | 需求调研 | 把散落的用户声音变成可排期的需求 | 反馈 → 问题 → 需求 三级沉淀，需求池条目 | references/01-discovery.md |
| 2 | 产品设计 | 把需求翻译成符合社区万象规范的页面方案 | 页面方案 + 字段/交互定义 + 对齐设计规范 | references/02-design.md |
| 3 | 开发 | 在 smartfund_v3 落地、验证、上线 | 可运行代码 + 本机验证 + 部署 + 日志 | references/03-development.md |
| 4 | 反馈测试 | 用户实测 → 记录反馈 → 回流需求 | 反馈记录（进 AI Product OS）+ 迭代清单 | references/04-feedback-testing.md |
> 动手前必扫：references/05-pitfalls.md（历史坑速查，能省掉大半返工）。
关键路径
> ⚙️ 首次使用前需配置：本技能为可移植版本，环境相关地址已替换为占位符。安装后请按下表把占位符换成本地实际路径 / 地址。
| 占位符 | 含义 |
|---|---|
<SMARTFUND_ROOT> |
社区万象（SmartFund v3）开发项目根目录 |
<PRODUCT_OS_ROOT> |
AI Product OS（需求 / 反馈系统）根目录 |
<SERVER_APP_DIR> |
服务器上应用部署目录 |
<SFTP_REMOTE_DIR> |
SFTP 部署目标目录 |
<SERVER_HOST> / <SFTP_USER> |
部署服务器地址 / 账号 |
<GIT_HOST> |
内网 Git 服务地址 |
<V3_DOMAIN> / <LEGACY_DOMAIN> / <CDN_DOMAIN> / <TOS_CDN_DOMAIN> |
线上域名 / CDN 域名 |
开发项目（代码在这里）：<SMARTFUND_ROOT>/
- 主 App community_v3（H5 移动端，新模板在 server/community_v3/templates/tailwind/）
- 路由 /v3/（smartfund/urls.py 挂 include("community_v3.urls")）；旧版 /community/
- 视图 community_v3/views.py；urls.py 用 from views import *，新视图必须注册路由才生效
- 项目记忆：.codebuddy/memory/（MEMORY.md = 长期约定，YYYY-MM-DD.md = 每日开发日志）
需求与反馈系统（调研 / 反馈在这里）：<PRODUCT_OS_ROOT>/
- Django 5.2 + Tailwind，本地 python manage.py runserver 8000；AI 走腾讯云 TokenHub（auto 模型）
- 数据链路：Feedback（VOC 原始声音）→ FeedbackProblem（AI 梳理候选）→ Problem（长期资产）→ Requirement（可排期需求）
设计规范（阶段 2 必读）：
- docs/design.md —— 框架 / 结构层（技术栈、模板路线、品牌色 token、页面骨架、上线 checklist）
- server/community_v3/templates/tailwind/UI_STANDARD.md —— 视觉细节层（字号 / 色彩 / 组件尺寸）
贯穿全流程的铁律
- 改完必须部署才生效：本地无法完整跑起整个 Django 项目，真正的验证靠上线。改了
.py或模板后走git pull+ 重启服务（新环境sudo systemctl restart smartfund-v3；旧环境supervisorctl restart——先确认是哪一套，别想当然）。 - 本机验证 =
py_compile+ 模板编译渲染：本地manage.py check会因缺依赖挂掉，用scripts/verify_template.py做模板编译与渲染验证。 - 同一信息常多页展示：用户说"改了没生效 / 还是老样子"时，先全局
grep盘点展示点（H5 编辑页 / 打印预览页 / PDF 导出）再动手。 - 新视图必须注册路由：
urls.py是import *，注册了才生效。 - 不新增 model / 不跑迁移（用户明确偏好）：需要存字段时优先复用
PlanProposal键值表（plan + field_en_name + field_value）。 - 每轮结束追加 memory：写入
smartfund_v3/.codebuddy/memory/YYYY-MM-DD.md；跨天有效的约定/教训进MEMORY.md。
一句话触发示例
| 用户说 | 走哪些阶段 |
|---|---|
| "社区万象要加一个 XXX 功能" | 完整四阶段 |
| "启动社区万象需求调研" | 仅阶段 1 |
| "社区万象结项报告 XXX 显示不对" | 直接进阶段 3（定位并修复）→ 阶段 4（验证） |
| "社区万象最近用户反馈整理一下" | 阶段 1 + 4（VOC 录入与梳理） |
| "社区万象这个页面重做一版" | 阶段 2 → 3 → 4 |
阶段推进规则
- 用户只给目标、未指定阶段 → 默认从阶段 1 起步；若是修改既有功能，直接进阶段 3。
- 每进入一个阶段，先读对应 reference 再动手。
- 阶段产物要落盘：需求 / 反馈 → AI Product OS；设计 → 方案文档或飞书 wiki；开发 → 代码 +
.codebuddy/memory；上线后 → 追加部署记录。
