招聘判官 (Recruitment Judge)

以天命视角替企业 HR 裁决招聘难题的虚拟判官。3 秒完成一次招聘断案，判词必达。

项目简介

招聘判官是一个面向企业招聘 HR 的趣味断案工具。HR 选择招聘场景，点击"一键断案"，经历 3 秒仪式动画后获得一份判词结果（含天命指数、五维命盘、判官断语、建议、甩锅话术）。结果可分享、可复现。

技术栈

• 前端：原生 HTML + CSS + vanilla JS（ES Modules），Three.js（3D 罗盘），D3.js（雷达图），GSAP（动画时间线）
• 伴生服务：Python + FastAPI + Uvicorn，Pydantic 校验，Typer CLI，Rich 日志
• 构建：pyproject.toml + hatchling

核心架构原则

1. 算法与视觉彻底解耦：Fortune Engine 纯 JS 可独立运行，零视觉依赖
2. 判词必达：任意降级场景下，用户最终必定看到完整判词文本
3. 结果可复现：相同 seed + scene 产出完全相同结果

启动方式

CLI 启动

pip install -e .
recruitment-judge

直接启动

uvicorn server.app:app --host 0.0.0.0 --port 8000

启动后访问 http://localhost:8000

目录结构

recruitment_judge/
├── pyproject.toml          # Python 构建配置
├── README.md
├── server/                 # 伴生服务（FastAPI）
│   ├── app.py              # FastAPI 应用入口
│   ├── cli.py              # Typer CLI 启动
│   ├── api/v1/             # RESTful 端点
│   ├── core/               # 配置与统一响应
│   └── models/             # Pydantic 模型
├── web/                    # 招聘判官 Web App（纯前端）
│   ├── index.html          # SPA 主入口
│   ├── css/                # 样式
│   ├── js/                 # ES Modules
│   │   ├── core/           # 状态机与路由
│   │   ├── engine/         # Fortune Engine（纯逻辑）
│   │   ├── visual/         # 视觉表现层
│   │   ├── animation/      # GSAP 时间线
│   │   ├── ui/             # UI 组件
│   │   ├── analytics/      # 埋点适配
│   │   ├── data/           # 静态数据
│   │   └── utils/          # 工具
│   └── assets/             # 字体与纹理
└── tests/                  # 测试

开发约定

• Python 配置变量：UPPER_SNAKE_CASE
• JS 文件名：lower_snake_case
• CSS 类名：kebab-case
• 判词 ID：UPPER_TAG_DIGITS（如 BUSINESS_003）

生产部署

FastAPI 静态托管可无缝切换至 Nginx + CDN，前端无差异。伴生服务仅承担静态托管与埋点收集，不参与命运计算核心逻辑。