Alfred · 产品设计文档¶
个人 AI 求职助理（命名取自蝙蝠侠的管家 Alfred Pennyworth）。本站点汇集产品需求、数据模型与架构决策，供在任意设备（电脑 / 手机）上随时翻阅、挑错。
怎么读这份文档¶
| 你想看 | 去这里 |
|---|---|
| 产品最终要成为什么 | 产品愿景 VISION |
| 数据库到底长什么样（权威内核） | 数据模型 V2 |
| 求职领域细化（草稿） | 数据模型 V3 |
| 术语别搞混（position / job_posting / occupation …） | 术语表 GLOSSARY |
| 改了什么、为什么改 | 变更记录 CHANGELOG |
| 三轮建模拷问的完整推理 | 重新设计会话 2026-08-03 |
| 每条关键决策的前因后果 | 架构决策 ADR |
| 旧版草稿（已作废，仅参考） | 历史基线 v0.1 |
当前设计的核心定论¶
- 真相双轨：
event（行为，append-only）与fact（状态，带valid_from→valid_to）并列互补，不是谁派生谁。 - 命名：
job_posting（具体招聘实例）+occupation（职位大类）；旧position退役。 - 多用户边界：私有表带
user_id，共享实体/词表（person/organization/occupation/skill/location）不带。 - 编排：LangGraph 管状态与中断，Action 原语仍管写库。
- 可解释简历：软引用
fact+ 渲染强制 footnote + 校验阻断无源。
本站点由 MkDocs Material 构建，支持全文搜索与移动端阅读。手机上浏览请善用右上角搜索与深色模式切换。