teamwiseflow ir-record — IR 记录数据库工具
在 Workspace db/ir_record.db 中维护持久化 SQLite 数据库，供投资人发掘与跟进、项目申报使用。
数据库位置
<Workspace 根>/db/ir_record.db
所有命令通过 PATH wrapper ir-record <子命令> 调用，不要拼接脚本路径。初始化（幂等，可重复执行）：ir-record init-db。
表结构
investors（投资人档案）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER PRIMARY KEY AUTOINCREMENT | 自增主键 |
| name | TEXT NOT NULL | 投资人姓名 |
| type | TEXT NOT NULL | 投资人类别（angel/vc/pe/cvc/fo/other） |
| firm | TEXT | 所属机构 |
| title | TEXT | 职位 |
| TEXT | 邮箱 | |
| phone | TEXT | 电话 |
| TEXT | 微信号 | |
| TEXT | LinkedIn URL | |
| source | TEXT | 来源 |
| focus_areas | TEXT | 关注领域（逗号分隔） |
| match_score | TEXT | 匹配度（high/medium/low） |
| status | TEXT NOT NULL DEFAULT 'new' | 进展状态 |
| notes | TEXT | 备注 |
| created_at | TEXT | 记录创建时间 |
| updated_at | TEXT | 最后更新时间 |
状态机：
new → contacted → bp_sent → meeting → dd → ts → invested
↓ ↓ ↓ ↓ ↓ ↓
passed passed passed passed passed passed
contacts（接触记录）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER PRIMARY KEY AUTOINCREMENT | 自增主键 |
| investor_id | INTEGER NOT NULL | 关联 investors.id |
| contact_type | TEXT NOT NULL | 接触方式（email/phone/meeting/intro/pitch/other） |
| direction | TEXT NOT NULL | 方向（outbound/inbound） |
| summary | TEXT NOT NULL | 接触内容摘要 |
| result | TEXT | 结果/对方反馈 |
| next_step | TEXT | 下一步行动 |
| contact_date | TEXT NOT NULL | 接触日期（YYYY-MM-DD） |
| created_at | TEXT | 记录时间 |
applications（项目申报）
| 字段 | 类型 | 说明 |
|---|---|---|
| id | INTEGER PRIMARY KEY AUTOINCREMENT | 自增主键 |
| name | TEXT NOT NULL | 申报项目名称 |
| type | TEXT NOT NULL | 申报类别（competition/grant/subsidy/incubator/other） |
| organizer | TEXT | 主办方/组织方 |
| platform_url | TEXT | 申报平台 URL |
| deadline | TEXT | 截止日期（YYYY-MM-DD） |
| status | TEXT NOT NULL DEFAULT 'planning' | 申报状态 |
| submitted_date | TEXT | 实际提交日期 |
| result | TEXT | 结果/获奖情况 |
| notes | TEXT | 备注 |
| created_at | TEXT | 记录创建时间 |
| updated_at | TEXT | 最后更新时间 |
申报状态：
planning → drafting → submitted → shortlisted → awarded
↓ ↓ ↓
passed rejected rejected
planning：计划申报drafting：材料准备中submitted：已提交shortlisted：入围/初筛通过awarded：获奖/获批rejected：未通过passed：放弃申报
命令
初始化
ir-record init-db
投资人档案管理
检查投资人是否已记录（按姓名+机构去重）：
ir-record check-investor --name <姓名> --firm <机构名>
返回 JSON：{"exists": true/false, "id": <记录ID或null>}
记录新投资人：
ir-record record-investor \
--name <姓名> --type <angel|vc|pe|cvc|fo|other> --firm <机构名> \
[--title <职位>] [--email <邮箱>] [--phone <电话>] [--wechat <微信号>] \
[--linkedin <LinkedIn>] [--source <来源>] [--focus-areas <关注领域>] \
[--match-score <high|medium|low>] [--status <new|contacted|...>] [--notes <备注>]
必填：--name、--type、--firm。
更新投资人状态：
ir-record update-status --id <投资人ID> --status <新状态> [--notes <备注>]
接触记录管理
检查近期接触：
ir-record check-contact --investor-id <ID> --days <天数>
记录接触：
ir-record record-contact \
--investor-id <投资人ID> --contact-type <email|phone|meeting|intro|pitch|other> \
--direction <outbound|inbound> --summary <接触内容摘要> \
--contact-date <YYYY-MM-DD> [--result <结果>] [--next-step <下一步行动>]
必填：--investor-id、--contact-type、--direction、--summary、--contact-date。
进展查询
查询投资人 Pipeline 摘要：
ir-record query-progress
查询待跟进投资人（N 天无 contact 进展）：
ir-record query-stale --days <天数>
项目申报管理
检查申报是否已记录（按项目名+主办方去重）：
ir-record check-application --name <项目名> [--organizer <主办方>]
返回 JSON：{"exists": true/false, "id": <记录ID或null>}
记录新申报：
ir-record record-application \
--name <项目名> --type <competition|grant|subsidy|incubator|other> \
[--organizer <主办方>] [--platform-url <申报平台URL>] [--deadline <YYYY-MM-DD>] \
[--status <planning|drafting|submitted|shortlisted|awarded|rejected|passed>] \
[--submitted-date <YYYY-MM-DD>] [--result <结果>] [--notes <备注>]
必填：--name、--type。
更新申报状态：
ir-record update-application --id <申报ID> --status <新状态> [--notes <备注>] [--result <结果>]
查询申报记录：
ir-record query-applications [--status <状态>] [--upcoming <天数>]
- 无参数：返回所有申报，按状态排序
--status：按状态过滤--upcoming：查询未来 N 天内截止的申报
使用规则
- 投资人发掘与跟进：
- 搜索到投资人后，先用
check-investor判断是否已记录 - 已在数据库中则跳过，除非有新信息需要更新
- 新投资人立即用
record-investor记录（status=new） - 首次接触后，用
update-status更新状态，用record-contact记录接触 - 可随时运行
query-stale --days 7检查超期未跟进；用户启用定时模式后（见expert-ir包内scheduling.md），由心跳定期运行 query-progress获取全局 Pipeline 视图（按需或按用户约定周期运行）
- 搜索到投资人后，先用
- 项目申报（配合
expert-ir包内 Project Application workflow）：- 发现申报机会后，先用
check-application判断是否已记录 - 已在数据库中则跳过，避免重复申报
- 确认申报后用
record-application记录（status=planning） - 提交后更新 status 为 submitted
- 可随时运行
query-applications --upcoming 7查即将截止的申报；用户启用定时模式后由心跳定期提醒
- 发现申报机会后，先用