N.G.I.T. 新人求职情报终端

NEW GRAD INTELLIGENCE TERMINAL 第一次进入职场之前，先看清你要进入的地方。 「不要急着投。先侦察。」

面向应届毕业生 / 第一次正式求职者的赛博工业风 AI 求职情报解构与避坑终端：把一段招聘 JD（可叠加个人简历），解构为一份 100% 结构化的「岗位情报报告」，帮助新人在投递前看清岗位真实情况、识别「战争迷雾」、优化简历与面试策略。

---

✨ 为什么这是 FDE 作品

本项目是一个 Forward Deployed Engineer / 交付前线工程师 能力展示，覆盖「复杂业务场景的工程落地 → 极致用户体验 → 高并发与性能」的完整链路：

1. 复杂业务场景的工程落地

• 将大模型（LLM）概率化、不可控的输出，收敛约束为严格的 JD_FACT / INFERENCE / UNKNOWN / CANDIDATE_EVIDENCE 事实分级协议。
• 输出 100% 结构化的 JSON 情报：通过 zod 校验 + 硬性数量约束（如 fog_items 6–10 条、resume_actions 恰好 3 条），杜绝模型编造薪资、加班、晋升路径等幻觉内容。
• 明确的「MISSION STATUS」决策框架：READY / VERIFY / CHALLENGE / BLOCKED，把模糊的「要不要投」转化为可执行的下一步。

2. 极佳的客户 / 用户体验（UX）

• 新粗野主义（Neo-Brutalism）工业暗黑设计系统：#0B0D0E 炭黑底 + #FF5A1F 信号橙 + 1px 工业细线 + 巨型英文排版（Roboto Condensed），像 NASA 标识手册与战术指挥系统的融合。
• 网页端 WebAudio 微声效、动态流式网格背景、平滑爬升扫描动画、clip-path 揭示动效，并支持 prefers-reduced-motion 无障碍降级。
• 全端响应式：桌面 12 列网格 → 移动端 4 列网格，交互触控区域 ≥ 44px。

3. 高并发与性能优化

• 部署在 Supabase Edge Function 的缓动逻辑：分析请求走 30 分钟内存缓存（同 JD+简历 SHA-256 去重），显著降低大模型重复调用成本。
• 智能 OCR 截图提取（百度 OCR，前端分块 Base64 编码避免大数组栈溢出）。
• 从 SYSTEM BOOT → TARGET ACQUISITION → INTELLIGENCE SCAN → MISSION BRIEF 的完整端到端交付体验。

---

🧭 核心功能

用户输入 JD 文本 + 可选简历（文本 / 文件 / 截图），系统依次生成结构化情报报告：

模块	说明
SYSTEM BOOT	3 秒赛博启动动画，进入终端
TARGET ACQUISITION	输入 JD 与简历
INTELLIGENCE SCAN	情报扫描（含 OCR 图片识别）
ENTRY ASSESSMENT	入职评估：硬性 / 软性 / 偏好条件分级
ROLE INTEL	岗位情报：核心要求与重要度
FOG OF ENTRY	求职「战争迷雾」：CONFIRMED / INFERRED / UNKNOWN 逐条拆解 + HR 追问话术
EVIDENCE MAP	能力证据图谱：简历经历 ↔ 岗位要求的匹配与呈现建议
LOADOUT	投递前履历配置：MOVE / REWRITE / ADD_EVIDENCE / REMOVE 操作
INTERVIEW BRIEF	面试简报：3 个目标 + 3 个预期问题
MISSION BRIEF	岗位行动简报：可截图分享的高密度战术文件排版

---

🛠 技术栈

• 前端：React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · Motion · React Router 7
• 后端：Supabase Edge Functions（Deno）· Supabase Auth / Storage
• AI：文心大模型（专用网关调用）· 百度 OCR
• 工程：Zod 校验 · Biome · tsgo 类型检查

---

🏗 架构

┌─────────────┐    invoke     ┌──────────────────────────────┐
│   React SPA │ ────────────▶ │  Supabase Edge Functions       │
│  (前端情报   │               │  ├── analyze-jd   情报分析核心  │
│   解构终端)  │ ◀──────────── │  └── accurate-ocr OCR 提取     │
└─────────────┘   JSON 报告   └──────────────┬───────────────┘
                                             │ X-Gateway-Authorization
                                             ▼
                                     ┌───────────────┐
                                     │  大模型网关    │  (文心 / OCR)
                                     └───────────────┘

• 事实分级协议：所有分析结果强制标注 JD_FACT / INFERENCE / UNKNOWN / CANDIDATE_EVIDENCE。
• 结构化约束：Edge Function 返回严格 JSON，数量与枚举均受约束。
• 缓存机制：30 分钟内存缓存，相同输入命中直接复用，降低成本与延迟。

---

🚀 快速开始

环境要求

• Node.js ≥ 20，npm ≥ 10

1. 安装依赖

npm install

2. 配置环境变量

cp .env.example .env

编辑 .env：

VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
VITE_APP_ID=your-app-id

3. 本地开发

npm run dev

4. 部署 Edge Functions

npx supabase functions deploy analyze-jd
npx supabase functions deploy accurate-ocr

部署前请确保 Supabase 项目中已配置 INTEGRATIONS_API_KEY 环境变量、并启用 integrations 网关。

---

🎨 设计系统

新粗野主义（Neo-Brutalism）工业情报终端视觉语言：

• 主色 #FF5A1F 信号橙（仅用于强调 / 状态 / CTA，占比约 9%）
• 强调色 #74D7D1 系统青（仅 CONFIRMED / ONLINE 状态，占比约 1%）
• 背景 #0B0D0E 极深炭黑 · 正文 #F1F1EC 工业白 · 边框 #2A2D2E 1px 细线
• 圆角 0–4px · 卡片用 1px 边框而非阴影 · 巨型英文排版（120–190px 编号）
• 禁止玻璃拟态 / 大圆角 / 霓虹渐变 / bounce 动画

详细规范见 docs/DESIGN.md，产品需求见 docs/prd.md。

---

📁 目录结构

├── src/                 # 前端源码
│   ├── screens/         # 10 个情报终端屏幕
│   ├── components/      # 通用 / 效果 / 报告组件 + shadcn/ui
│   ├── contexts/        # App / Auth 上下文
│   ├── db/              # Supabase 客户端
│   ├── lib/             # OCR / 音效 / 工具
│   ├── types/           # 情报类型定义（intel.ts）
│   └── services/        # 数据交互
├── supabase/functions/  # Edge Functions（analyze-jd / accurate-ocr）
├── docs/                # PRD 与设计规范
├── public/              # 静态资源
└── .env.example         # 环境变量示例

---

🔒 安全说明

• .env 已加入 .gitignore，请勿将真实密钥提交到公开仓库。
• INTEGRATIONS_API_KEY 等密钥仅存在于 Supabase 服务端环境变量，不进入前端代码。
• 本项目为求职作品集，不含任何生产环境凭证。

---

📝 License

本项目为个人作品集项目，仅用于求职展示与学习交流。