团队工作区 — 共享管道、数据隔离与积分共享池

这是什么

用名称和 slug 创建工作区（POST /api/workspaces），按邮箱邀请同事并指定角色，所有协作对象随即共享：KOL 数据库视图（team 范围）、带筛选状态的名单、CRM 对话与任务、动态流，以及动态摘要等缓存的 AI 产物。个人账号照常可用——工作区是叠加在其上的可选结构。

数据范围：personal / team / both

每个达人查询都接受 scope 参数。personal = 只看你自己发现的达人；team = 工作区内任何成员发现的达人；both = 两者并集（默认）。隔离在服务端对每次请求强制执行——KOLens 绝不会返回工作区内无人发现过的达人。正因如此，代理商可以放心地「一个客户一个工作区」：客户 A 的调研不可能泄漏进客户 B 的视图。

品牌画像

工作区设置（GET/PUT /api/workspaces/{slug}/settings）承载品牌画像：卖什么、打谁、预算姿态和品牌语气。两个系统会读取它：AI 触达起草（邮件推的是你的真实产品、用你的真实语气）和名单契合度中的推荐分（达人按你的品牌打分，而非通用模板）。入驻时填一次——这是全产品杠杆率最高的一项配置。

积分共享池与账单

• 管理员向共享池注入积分（POST /api/workspaces/{slug}/billing/grant-credits）；成员扣费先走池子，不足再回退到个人余额。
• 账单摘要（GET /api/workspaces/{slug}/billing/summary）展示积分总量、消耗与消耗排行；history 是完整流水；Stripe 门户管理支付方式。
• 效果：一张发票、一个预算、按成员可见——财务拿到汇总，研究员不会在任务中途撞上个人余额墙。

如何搭建团队

1. 先创建工作区并填好品牌画像，再邀请成员——之后所有 AI 产物都会受益。
2. 按邮箱邀请成员并指定角色（POST /api/workspaces/{slug}/invitations）；对方接受后即进入共享视图。
3. 按当月调研计划注资共享池（例如 200 积分 ≈ 2,000 条抓取结果）。
4. 按工作流分工：研究员负责发现与名单筛选；客户经理推进 CRM 阶段；管理员盯账单。

典型场景

• 代理商：每个客户一个工作区，客户之间数据硬隔离，账单各自独立——投放后期还可以邀请客户进来旁观。
• 出海团队：深圳做调研、美国时区做触达——同一份名单、同一条管道，不再邮件传表格。
• 从单干到团队：先用个人账号，第一位同事入职时再建工作区；既有数据通过 scope=both 自然并入。