Metadata-Version: 2.4
Name: recruitment-judge
Version: 0.3.0
Summary: 招聘判官 (Hire Fortune) — 打工人的招聘玄学搭子
Project-URL: Homepage, https://github.com/recruitment-judge/recruitment-judge
Project-URL: Repository, https://github.com/recruitment-judge/recruitment-judge
Author: Hire Fortune Team
License: MIT
Keywords: cli,divination,fastapi,fortune,metaphysics,recruitment
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Requires-Python: >=3.10
Requires-Dist: fastapi>=0.110
Requires-Dist: pydantic>=2.6
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Requires-Dist: uvicorn>=0.29
Provides-Extra: dev
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 招聘判官 (Hire Fortune)

> 打工人的玄学搭子。算一卦，甩个锅，该开工开工。

招聘判官是一个面向企业招聘 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 启动

```bash
pip install -e .
recruitment-judge
```

### 直接启动

```bash
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，前端无差异。伴生服务仅承担静态托管与埋点收集，不参与命运计算核心逻辑。