解决的问题
招聘信息分散在多个网站，重复职位多，签证、语言、薪资和雇佣形式需要逐条确认，新职位也容易错过。
项目定位
基于项目需求说明书 1.0 MVP 基线整理，聚焦个人低成本、云端运行和可解释筛选。
核心价值
把每天逐站浏览改为每天集中审阅少量高匹配职位，降低信息噪音，同时保留原始链接、证据和风险说明。
MVP 原则
优先使用 Gmail、Google Apps Script、Google Sheets、Notion 和官方职位提醒邮件，不登录网站，不抓取受限页面。
求职条件
系统所有过滤与评分都围绕这一份求职档案运行，并记录配置版本用于解释历史结果。
硬性条件
需要签证支持
日语 N2
东京或可从东京远程
年收 400 万日元以上
正社员 / 契约社员
目标画像
资深前端
Electron 桌面应用
全栈
TypeScript
React
Vue
Electron
优先混合办公
端到端流程
系统按阶段处理，每个阶段需要可恢复和幂等，单个来源失败不能阻断其他来源。
职位提醒进入 Gmail
Indeed、LinkedIn、doda、マイナビ転職、リクナビNEXT、Daijob 的官方提醒邮件进入 JobDigest 标签。
采集与解析
Apps Script 读取过去 48 小时未处理邮件，按来源调用独立解析器输出统一 RawJob。
统一与硬过滤
统一职种、技能、薪资、语言、地点和签证字段，明确不符合条件的职位进入排除审计。
去重、评分和 AI
跨来源合并重复职位，按 100 分规则排序；高分或字段模糊职位可触发限额 AI 分析。
存储与送达
Google Sheets 作为主存储，Notion 用于状态管理，HTML 邮件日报在 08:00 发送。
每日运行时间线
时间均为 Asia/Tokyo，设计上避免单次 Apps Script 运行过长。
核心功能模块
MVP 由 14 个必需模块组成，后续可扩展手动导入和 Web 仪表盘。
| 模块 | 功能 | 说明 |
|---|---|---|
| M01 求职档案配置 | 保存条件和权重 | 维护签证、日语、职种、技能、地点、薪资、雇佣形式、日报时间和 AI 开关。 |
| M02-M04 来源与邮件解析 | 读取官方提醒邮件 | 管理 Gmail 标签、来源规则、增量采集、邮件状态和每个招聘来源的独立解析器。 |
| M05-M08 匹配引擎 | 统一、过滤、去重、评分 | 把原始职位转为标准职位，执行硬性条件判断，合并重复发布，并生成分数、等级和理由。 |
| M09 AI 辅助分析 | 处理模糊字段 | 仅在高分或字段模糊时调用，输出必须结构化、有证据、可降级且可关闭。 |
| M10-M12 输出与存储 | Sheets、Notion、邮件日报 | Sheets 是主记录，Notion 是用户交互视图，邮件日报是每日快速审阅入口。 |
| M13-M14 状态、监控和重试 | 闭环管理与故障隔离 | 支持收藏、忽略、已申请、已关闭，并记录运行状态、失败来源、告警和补偿重试。 |
过滤与评分
系统先硬过滤，再评分。未知信息不会轻易排除，但会进入人工确认区并扣分。
过滤结果
- PASS：明确满足签证、语言、地点、薪资、雇佣形式和职种相关性。
- REVIEW_REQUIRED：签证、语言、薪资或地点条件缺失或表述模糊，需要人工确认。
- EXCLUDED：明确不支持签证、要求 N1 或母语级日语、年收上限低于 400 万、非目标雇佣形式或地点不符。
100 分评分权重
输出体验
MVP 不开发独立 Web 前端，主要界面是邮件、Notion 和 Sheets。
HTML 邮件日报
按今日摘要、S 级、A 级、B 级前 10 条、人工确认、排除统计和来源健康状态组织。没有新职位时仍发送正常运行摘要。
Notion 职位数据库
提供 Today、High Match、Review Required、Saved、Applied、All Active、Closed 等视图，人工状态不会被同步任务覆盖。
Google Sheets 主存储
保存 Config、Sources、Jobs、JobSources、MatchResults、Runs、ParserErrors 等表，用于幂等、审计和恢复。
日报示意
每条职位卡片需要展示分数、等级、匹配理由、风险项、来源和原始链接。
[在日工作] 2026-07-23 新增 12 件｜高匹配 3 件｜需确认 5 件
来源健康：部分成功
88
Senior Frontend Engineer
东京 / 混合办公 / 年收 500-800 万日元 / 正社员 / 签证支持：Supported / 日语：N2
S 级
TypeScript
React
需确认奖金组成
76
Electron Desktop Application Engineer
东京远程可 / 契约社员 / 薪资面议 / 签证信息未说明，进入 Review Required。
A 级
Electron
Vue
签证待确认
安全与合规边界
该项目处理邮箱和求职数据，因此边界必须清晰。
允许保存
- 职位公开信息、来源邮件 ID 和原始职位链接。
- 用户求职筛选条件和职位处理状态。
- 脱敏后的运行日志、错误摘要和解析证据。
禁止保存或执行
- 不保存招聘网站密码、Cookie、登录会话、API Key 或完整简历正文。
- 不模拟登录、不绕过验证码、付费墙、限流或反爬机制。
- 不公开展示、转售或再分发聚合后的职位数据库。
MVP 验收重点
这些标准用于判断项目是否可以从需求进入稳定试运行。
初始化
setup() 能幂等创建 Gmail 标签、Sheets 表和时间触发器。
采集解析
六个 P0 来源各有脱敏样例通过测试，同一邮件重复运行不重复入库。
匹配结果
硬过滤、去重和评分符合签证、N2、东京、400 万年收等核心规则。
持续运行
连续 7 天无重复推送，单来源失败可见且不阻断日报。
实施路线
从账号准备到七天试运行，逐阶段降低集成风险。
| 阶段 | 目标 | 完成标志 |
|---|---|---|
| 阶段 0 | 准备 Gmail 标签、官方提醒、脱敏邮件样例、Google Sheet、Notion 集成和 AI 限额决策。 | 来源邮件能稳定进入指定标签，开发只接触脱敏样例。 |
| 阶段 1-2 | 建立 TypeScript + Apps Script 项目骨架，实现 Sheets 存储、Gmail 采集和六个来源解析器。 | 本地测试通过，每个 P0 来源能输出统一 RawJob。 |
| 阶段 3-4 | 完成字段统一、硬过滤、评分、去重、Notion 同步和邮件日报。 | 可连续三天自动产生 Notion 记录和日报，用户状态不被覆盖。 |
| 阶段 5-6 | 加入 AI 辅助、稳定性处理、来源健康检查和七天试运行。 | AI 开关两种模式均通过验收，达到成功指标后冻结 MVP 1.0。 |