pathforge-labs/pathforge
GitHub: pathforge-labs/pathforge
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™** 技术提供支持。
## 🏗️ 架构
| 层级 | 技术栈 | 用途 |
| :------------ | :---------------------------- | :---------------------------- |
| 前端 | Next.js 15, TailwindCSS v4 | 落地页、仪表板 |
| 后端 API | FastAPI (Python 3.12+) | REST API、AI 流水线 |
| 数据库 | PostgreSQL 16 + pgvector | 关系型 + 向量存储 |
| 缓存 / 队列 | Redis 7 | JWT 黑名单、ARQ 任务队列 |
| AI 模型 | Claude Sonnet 4, Gemini Flash | LLM 驱动的职业分析 |
| Embeddings | Voyage AI v3 | 语义匹配引擎 |
| 认证 | JWT (access + refresh tokens) | 无状态身份验证 |
| 部署 | 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 |
| :---------- | :-------------------------- |
| 前端 | http://localhost:3000 |
| 后端 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
```
| 关卡 | 工具 | 范围 |
| :--------- | :------------------------ | :-------------- |
| 代码检查 | Ruff | API |
| 类型检查 | MyPy | API |
| 测试 | Pytest | API (202 项测试) |
| 代码检查 | ESLint (Next.js) | Web |
| 构建 | Next.js 生产环境构建 | 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™** | ✅ 已上线 | 六维度职业档案分析 |
| **Career Threat Radar™** | ✅ 已上线 | AI 驱动的自动化风险评分 |
| **Career Resilience Score™** | ✅ 已上线 | 5 因子复合适应性指标 |
| **Skills Shield™ Matrix** | ✅ 已上线 | 将技能分类为防护与暴露 |
| **Career Moat Score** | ✅ 已上线 | 四维度职业防御力指标 |
| **Threat→Opportunity Engine** | ✅ 已上线 | 每一项威胁自动匹配相应机会 |
| 技能衰退追踪器 | ⏳ 下一步 | 技能保鲜度 + 市场需求曲线 |
| 薪酬智能 | ⏳ 已规划 | 个性化薪资计算 |
## 📖 文档
| 文档 | 用途 |
| :------------------------------------------------------ | :---------------------------------- |
| [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绕过, DLL 劫持, DNS解析, Docker, FastAPI, GitHub Actions, JWT认证, OSV, pgvector, PostgreSQL, Python, Railway, React, Redis, RESTful API, SaaS, Syscalls, TailwindCSS, Vercel, 人才分析, 向量数据库, 大语言模型, 安全防御评估, 市场趋势分析, 开源项目, 异步任务队列, 技能图谱, 技能画像, 提示词优化, 搜索引擎查询, 无后门, 测试用例, 生成式AI, 索引, 职业情报平台, 职业规划, 职场导航, 自动笔记, 语义匹配, 请求拦截, 逆向工具, 预测分析