# interview-experience-card

**Repository Path**: Wolke-chen/interview-experience-card

## Basic Information

- **Project Name**: interview-experience-card
- **Description**: 专为中国技术求职者打造的 **AI 面试准备平台**。连接 Gitee 代码仓库，AI 从面试官视角深度分析你的项目，生成 7 维度面试报告，并基于真实项目进行 AI 模拟面试。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 面经卡 (Interview Experience Card)

> 🔗 连接 Gitee → 🤖 AI 分析代码 → 📋 面试级作品集 → 🎤 AI 模拟面试 → 📤 分享传播
>
> *"你的代码，就是最好的简历"*

![Version](https://img.shields.io/badge/version-0.6.0-blue) ![Tests](https://img.shields.io/badge/tests-20%2F20-green) ![Docker](https://img.shields.io/badge/docker-ready-blue)

---

## 📖 这是什么

专为中国技术求职者打造的 **AI 面试准备平台**。连接 Gitee 代码仓库，AI 从面试官视角深度分析你的项目，生成 7 维度面试报告，并基于真实项目进行 AI 模拟面试。

**FDE（现场交付工程师）岗位面试项目** — 展示从需求分析、架构设计、CI/CD、容器化到监控的全链路交付能力。

---

## 🖥️ 功能列表

| 功能 | 状态 |
|------|:---:|
| 🔐 Gitee OAuth 登录 / 退出 | ✅ |
| 📊 Dashboard 控制台（仓库管理 + 面试管理） | ✅ |
| 🔗 仓库连接 / 删除（Free ≤ 3，Pro 无限） | ✅ |
| 🤖 AI 深度分析（7 维度，Redis 缓存 24h） | ✅ |
| 📋 公开作品集 `/[你的用户名]`（含技能雷达图） | ✅ |
| 📄 项目详情页（完整面试报告） | ✅ |
| 🎤 AI 模拟面试（6 轮追问 + 三维评分） | ✅ |
| 📝 面试历史（查看/删除/清空/重新面试） | ✅ |
| 📤 分享卡片（面试战绩 + 项目分析 + 二维码） | ✅ |
| 📮 面经报告 PDF 导出 | ✅ |
| 💰 定价页面（Free/Pro/Team） | ✅ |
| 🐳 Docker 一键部署（app + PostgreSQL + Redis） | ✅ |
| 📊 Prometheus + Grafana 监控仪表盘 | ✅ |
| 📖 OpenAPI 3.0 文档（Swagger UI） | ✅ |
| 🧪 自动化测试（20 用例） + K6 压测 | ✅ |
| 💳 在线支付 | ⏳ |

---

## 🚀 快速开始

### 本地开发

```bash
npm install
cp .env.example .env          # 编辑填入配置
npx prisma generate
npx prisma db push
npm run dev                    # http://localhost:3000
```

### Docker 生产部署

```bash
cp .env.production.example .env.production
vim .env.production            # 填写真实配置
docker compose up -d           # 启动 app + PostgreSQL + Redis
curl http://localhost:3000/api/health  # 验证
```

### 监控栈（可选）

```bash
docker compose -f docker-compose.yml -f docker-compose.monitoring.yml up -d
# Grafana: http://localhost:3030 (admin/admin)
# Prometheus: http://localhost:9090
```

### CI/CD

```bash
bash ci.sh check    # TypeScript 类型检查
bash ci.sh test     # 类型检查 + 自动化测试
bash ci.sh build    # 构建 Docker 镜像
bash ci.sh          # 完整流水线
```

### 环境变量

```
DATABASE_URL="postgresql://user:password@localhost:5432/mianjingka"
AUTH_SECRET="xxx"                    # npx auth secret
AUTH_GITEE_ID="xxx"                  # Gitee OAuth Client ID
AUTH_GITEE_SECRET="xxx"              # Gitee OAuth Client Secret
DEEPSEEK_API_KEY="sk-xxx"           # DeepSeek API Key
NEXT_PUBLIC_APP_URL="http://localhost:3000"
REDIS_URL="redis://localhost:6379"   # 可选，不设则自动降级
```

### 配置 Gitee OAuth
1. https://gitee.com/oauth/applications → 创建应用
2. 回调地址: `http://localhost:3000/api/auth/callback/gitee`
3. 权限: `user_info` + `projects`

---

## 📂 架构

```
                         Docker Compose
┌─────────────────────────────────────────────┐
│  app (:3000)    PostgreSQL (:5432)  Redis (:6379)  │
│  Next.js 15     Prisma 6            AI 缓存 24h    │
│  standalone     9 表 7 枚举         限流 / 状态     │
└─────────────────────────────────────────────┘
        │              │
        ▼              ▼
   DeepSeek API    Gitee API v5
   (AI 分析+面试)   (OAuth + 仓库)

页面路由 (10 个):  /  /login  /pricing  /dashboard  /[user]  /interview/[id]  /report/[id]  /share/*
API 端点 (18 个):  repos CRUD · interview 生命周期 · health · metrics · docs
```

**技术栈**: Next.js 15 · TypeScript · TailwindCSS · shadcn/ui · Prisma 6 · PostgreSQL 16 · Redis 7 · NextAuth v5 · DeepSeek · Pino · Prometheus · Grafana · Docker · Jest · K6

---

## 🗺️ 路线图

```
Phase 1 ✅     Phase 2 ✅     Phase 3 ✅     Phase 4 ✅     Phase 5 ✅     Phase 6 ✅
骨架+登录      仓库+AI分析    模拟面试       分享+报告      UX 打磨        FDE 增强
                                                          (v0.5)        (v0.6)
```

---

## 📄 文档索引

| 文档 | 用途 |
|------|------|
| `CLAUDE.md` | AI 开发上下文（文件树 / 约定 / 修复记录） |
| `docs/ARCHITECTURE.md` | 架构设计（部署架构 / 分层 / 数据模型 / AI 引擎 / 错误降级 / 技术决策） |
| `docs/BUSINESS_LOGIC.md` | 业务全景（用户流程 / 状态机 / 付费规则 / API 清单 / 修复列表） |
| `docs/API.md` | API 文档（18 个端点 / 请求响应示例 / 错误码） |
| `docs/openapi.yaml` | OpenAPI 3.0 规范（Swagger UI 可用 at `/api/docs`） |
| `docs/CHANGELOG.md` | 版本更新日志（v0.1 ~ v0.6） |
| `docs/INTERVIEW_GUIDE.md` | FDE 面试演示指南（Demo 脚本 / 技术话术 / AI Native 叙事 / FAQ） |
| `docs/FDE_ROADMAP.md` | FDE 增强路线图（P0/P1/P2 任务清单 + 完成状态） |
| `docs/CLOUD_CICD.md` | 阿里云云效 CI/CD 配置参考 |

---

MIT License · Built with Claude Code