pathforge-labs/PathForge
GitHub: pathforge-labs/PathForge
AI 驱动的职业智能平台，通过技能图谱、市场信号和预测分析帮助专业人士制定个性化职业策略。
Stars: 0 | Forks: 0
# PathForge — 大众化的职业智能平台
[](https://github.com/pathforge-labs/PathForge/actions/workflows/ci.yml)
[](https://github.com/pathforge-labs/PathForge/actions/workflows/deploy.yml)
PathForge 是一个**职业智能平台**，旨在让每位专业人士都能使用企业级的职业智能 —— 技能图谱、市场信号、预测分析。由 **Career DNA™** 技术驱动。
## 🏗️ 架构
| 层级 | 技术栈 | 用途 |
| :------------ | :---------------------------- | :---------------------------- |
| Frontend | Next.js 15, TailwindCSS v4 | 落地页、仪表板 |
| Backend API | FastAPI (Python 3.12+) | REST API, AI pipelines |
| Database | PostgreSQL 16 + pgvector | 关系型 + 向量存储 |
| Cache / Queue | Redis 7 | JWT 黑名单，ARQ 任务队列 |
| AI Models | Claude Sonnet 4, Gemini Flash | LLM 驱动的职业分析 |
| Embeddings | Voyage AI v3 | 语义匹配引擎 |
| Auth | JWT (access + refresh tokens) | 无状态认证 |
| Deployment | Vercel (web) + Railway (API) | 生产基础设施 |
| CI/CD | GitHub Actions | 自动化质量门禁 |
## 🚀 快速开始
### 前置条件
- **Python** 3.12+ · **Node.js** 22+ · **pnpm** 10+ · **Docker** & Docker Compose
### 一键启动（推荐）
```
.\scripts\start-dev.ps1
```
这将一次性启动 Docker (PostgreSQL + Redis)、FastAPI 后端和 Next.js 前端。自动打开浏览器。
### 手动设置
### 开发环境 URL
| 服务 | URL |
| :---------- | :-------------------------- |
| Frontend | http://localhost:3000 |
| Backend API | http://localhost:8000 |
| Swagger UI | http://localhost:8000/docs |
| ReDoc | http://localhost:8000/redoc |
## 🧪 质量门禁
在推送之前在本地运行完整的 CI 流水线：
```
.\scripts\ci-local.ps1 # Run all gates
.\scripts\ci-local.ps1 -Scope api # API only
.\scripts\ci-local.ps1 -Scope web # Web only
```
| 门禁 | 工具 | 范围 |
| :--------- | :----------------------- | :-------------- |
| Lint | Ruff | API |
| Type check | MyPy | API |
| Tests | Pytest | API (202 项测试) |
| Lint | ESLint (Next.js) | Web |
| Build | Next.js production build | Web |
## 📁 项目结构
```
pathforge/
├── apps/
│ ├── api/ # FastAPI backend (Python)
│ │ ├── app/
│ │ │ ├── api/v1/ # Versioned route handlers
│ │ │ ├── core/ # Config, security, database
│ │ │ ├── models/ # SQLAlchemy ORM models
│ │ │ ├── schemas/ # Pydantic request/response DTOs
│ │ │ └── services/ # Business logic layer
│ │ ├── alembic/ # Database migrations
│ │ └── tests/ # Pytest test suite
│ └── web/ # Next.js 15 frontend
│ └── src/
│ ├── app/ # App Router pages & layouts
│ ├── components/ # React components
│ ├── config/ # Brand constants, settings
│ └── lib/ # Utilities, API client
├── packages/
│ └── shared/ # Shared TypeScript types
├── docker/ # Dockerfiles & Compose
├── docs/ # Architecture, roadmap, research
├── scripts/ # Dev & CI automation scripts
├── .github/workflows/ # CI/CD pipelines
└── railway.toml # Railway deployment config
```
## 🔑 职业智能功能
| 功能 | 状态 | 描述 |
| :---------------------------- | :--------- | :----------------------------------- |
| **Career DNA™** | ✅ 已发布 | 6 维度职业画像分析 |
| **Career Threat Radar™** | ✅ 已发布 | AI 驱动的自动化风险评分 |
| **Career Resilience Score™** | ✅ 已发布 | 5 因子复合适应性指标 |
| **Skills Shield™ Matrix** | ✅ 已发布 | 技能分类：护盾 vs 风险敞口 |
| **Career Moat Score** | ✅ 已发布 | 4 维度职业防御性指标 |
| **Threat→Opportunity Engine** | ✅ 已发布 | 每个威胁自动配对机会 |
| Skill Decay Tracker | ⏳ 下一项 | 技能新鲜度 + 市场需求曲线 |
| Salary Intelligence | ⏳ 计划中 | 个性化薪资计算 |
## 📖 文档
| 文档 | 用途 |
| :------------------------------------------------------ | :----------------------- |
| [ARCHITECTURE.md](docs/architecture/ARCHITECTURE.md) | 系统设计与技术决策 |
| [ROADMAP.md](docs/ROADMAP.md) | 冲刺跟踪 (SSOT) |
| [DEVELOPMENT_WORKFLOW.md](docs/DEVELOPMENT_WORKFLOW.md) | Git 工作流与贡献指南 |
| [BRANDING.md](docs/BRANDING.md) | 品牌治理与命名规范 |
| [CHANGELOG.md](docs/CHANGELOG.md) | 发布历史 |
## 🌐 生产环境
| 环境 | URL |
| :------- | :----------------------- |
| Web | https://pathforge.eu |
| API | https://api.pathforge.eu |
## 📄 许可证
UNLICENSED — 专有软件
逐步手动设置
#### 1. 启动基础设施 ``` docker compose -f docker/docker-compose.yml up -d ``` #### 2. 设置 API ``` cd apps/api python -m venv .venv .venv/Scripts/activate # Windows # source .venv/bin/activate # macOS/Linux pip install -e ".[dev,ai]" ``` #### 3. 运行迁移 ``` cd apps/api alembic upgrade head ``` #### 4. 启动 API 服务器 ``` cd apps/api uvicorn app.main:app --reload --port 8000 ``` #### 5. 启动 Web 应用 ``` pnpm install pnpm --filter web dev ```标签：AI招聘, AI职业生涯, AV绕过, Claude Sonnet, DLL 劫持, Docker, FastAPI, Gemini Flash, GitHub Actions, OSV, pgvector, PostgreSQL, Python, RAG技术, Railway, Redis, SaaS平台, TailwindCSS, TypeScript, Vercel, Voyage AI, 个性化职业策略, 人力资源科技, 人才分析, 向量数据库, 大语言模型, 威胁分析, 安全插件, 安全防御评估, 市场信号, 技能图谱, 技能映射, 搜索引擎查询, 无后门, 测试用例, 职业DNA, 职业情报平台, 职业规划, 自动化侦查工具, 自动笔记, 语义匹配, 请求拦截, 逆向工具, 预测性分析