Initial commit

README.md

+# 资源
+
+需求相关资源或其他信息
+
+# 文档
+
+前后端开发产出
+
+- 开发文档
+- 联调反馈
+- 注意事项
\ No newline at end of file

亲亲创客二期/文档/api-doc-第三点改动.md

+# partner-mp 第三点（现有接口）改动文档
+# partner-mp 第三点（现有接口）改动文档
+
+> 配套：`api-doc.md` §三「现有接口清单」。本文记录本批次（分配03）对**第三点现有接口**的改动。
+> 原则：**需要改的才改**；明确废弃的打 `@Deprecated`。改动位置：`hro/hro_spview/services/partner_api.groovy`、`models/partner/partner_users.json`。
+> 完成日期：2026-07-03
+
+---
+
+## 〇、本次改动总览
+
+| 项 | 对象 | 类型 | 结论 |
+|----|------|------|------|
+| 1 | `customer_collect_list` | 接口增强 | 列表项**新增归属来源** `source`/`source_type` |
+| 2 | `partner_users.create_type` | 元数据修正 | 字段 label/注释补全枚举值 3 |
+| 3 | 3.1/3.2/3.5/3.6/3.7 | 核对 | 无需改动（详见末节） |
+| 4 | 废弃接口 | 已处理 | 打 `@Deprecated`（详见末节） |
+
+调用方式同 api-doc.md：`sdk.domainServicePost("接口名", { data }, false, "hro_spview", "partner_api")`。
+
+---
+
+## 一、customer_collect_list — 我的客户列表（新增"归属来源"）
+
+- **页面/位置**：02 · **P2 我的客户列表**（每个客户卡片）；02 · **P3 客户详情**汇总沿用同接口。
+- **用途效果**：给"我的客户"列表每个客户**新增归属来源标记**——取该客户**所属合伙人的入驻方式**（`partner_users.create_type`）。
+  - 场景意义：**对接人**视角下该接口跨其名下多个合伙人聚合客户，用 `source` 区分每个客户来自"介绍人邀请 / 自主申请 / 介绍人后台添加"的合伙人；合伙人本人视角下同一值。
+  - 来源口径以 `partner_users.create_type` 为准，枚举：`1介绍人邀请 / 2自主申请 / 3介绍人后台添加`。
+- **入参**（**未变**，沿用原有）：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| user_combo | string | 姓名/手机号搜索 |
+| deal_date | string | 成交时间筛选 `yyyy-MM` |
+| UserMemberId | long | 精确查某客户（详情场景） |
+| page / page_size | int | 分页 |
+
+- **反参**：外层 `{ code, msg, data:{ rc_count, page, data_list[] } }`。`data_list[]` **在原有字段基础上新增 2 个**：
+
+| 字段 | 类型 | 新增? | 说明 |
+|------|------|------|------|
+| **source** | string | ✅ 新增 | 归属来源显示名："介绍人邀请"/"自主申请"/"介绍人后台添加"；无归属合伙人时 `"-"` |
+| **source_type** | string | ✅ 新增 | 归属来源码："1"/"2"/"3"；无则 `""` |
+| customer_name / customer_mobile | string | 原有 | 客户名 / 手机 |
+| UserMemberId / UserType | - | 原有 | 客户id / 类型(1个人/2企业) |
+| order_count / order_amount / order_commission | - | 原有 | 成交笔数 / 金额 / 佣金 |
+| intention_products | string | 原有 | 意向产品 |
+| companyName / last_order_createDate | - | 原有 | 企业名 / 最近成交时间 |
+
+- **示例**：
+
+```jsonc
+// 请求 data: { "page": 1, "page_size": 10 }
+// 响应（截取一个客户，★为本次新增）
+{ "code": 0, "msg": "成功", "data": {
+  "rc_count": 23, "page": 1,
+  "data_list": [{
+    "UserMemberId": 100234, "UserType": "2",
+    "customer_name": "杭州某某科技有限公司", "customer_mobile": "13800001111",
+    "companyName": "杭州某某科技有限公司",
+    "order_count": 2, "order_amount": "40000.00", "order_commission": "1200.00",
+    "intention_products": "岗位外包,薪酬代发",
+    "source": "介绍人邀请",   // ★ 归属合伙人的入驻方式
+    "source_type": "1"         // ★ 对应码
+  }]
+}}
+```
+
+- **前端接入提示**：P2 客户卡片可加一枚"来源"标签展示 `source`；若做来源筛选，用 `source_type`(1/2/3) 传参需后端再加筛选参数（本次未加筛选，仅出参）。
+
+---
+
+## 二、partner_users.create_type — 入驻方式枚举（元数据修正）
+
+- **页面/位置**：贯穿 01 P4 申请合伙人、后台合伙人管理、以及上文 `source` 来源。
+- **改动**：`create_type` 字段的 label/注释由"1介绍人邀请/2自主申请"**补全为"1介绍人邀请/2自主申请/3介绍人后台添加"**（映射 `create_type_mapping` 本就含 3 值，此前 label 漏写）。
+- **枚举权威**：
+
+| create_type | 含义 | 产生场景 |
+|-------------|------|---------|
+| 1 | 介绍人邀请 | 邀请链接/扫码进入申请，带介绍人（`contactor_uniplat_uid`），入驻后状态直接=正常 |
+| 2 | 自主申请 | 用户自行提交申请（01 P4），待审核 |
+| 3 | 介绍人后台添加 | 渠道管理员/后台代为添加 |
+
+- **无接口出入参变化**，仅元数据；`join_partner`（小程序端申请）仍只接受 `create_type` 1/2，值 3 由后台路径产生。
+
+---
+
+## 三、核对未改动的接口（§三 其余子节结论）
+
+| §三 子节 | ⚠️ 点 | 结论 | 说明 |
+|------|------|------|------|
+| 3.1 登录鉴权 `user_info` | 补 is_partner/is_contactor/is_introducer | **已具备** | is_partner/is_contactor 原有；`is_introducer` 已由第四点(分配02)补上 |
+| 3.2 申请合伙人 `join_partner` | 介绍人字段 | **已具备** | `contactor_uniplat_uid` 承载介绍人；create_type=1 时必填 |
+| 3.5 我的佣金 `get_deal_settlement` | 与对接人佣金口径 | **保持独立** | 合伙人=可提现余额模型；对接人=次月工资无提现（第四点 `contactor_commission_*` 另建）。两者本就是不同模型，无需合并 |
+| 3.6 产品 | — | 不改 | api-doc 明确无需改动 |
+| 3.7 海报 | — | 不改 | 见下"废弃候选" |
+
+---
+
+## 四、废弃接口
+
+废弃接口：recommend_list 、get_qrcode_image_with_poster

亲亲创客二期/文档/联调记录.md

+++ "a/\344\272\262\344\272\262\345\210\233\345\256\242\344\272\214\346\234\237/\346\226\207\346\241\243/\350\201\224\350\260\203\350\256\260\345\275\225.md"