# career-web-api

**Repository Path**: xinyi-codeing/career-web-api

## Basic Information

- **Project Name**: career-web-api
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-14
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 职路新识 — 项目文档

> **文档版本**: v1.0  
> **生成日期**: 2026-05-05  
> **维护者**: 项目核心开发者

---

## 文档清单

| 编号 | 文档 | 受众 | 内容概要 |
|---|---|---|---|
| 01 | [PRD.md](./01-PRD.md) | 产品 / 设计 / 测试 / 全员 | 产品定位、功能模块、业务规则、数据字典 |
| 02 | [ARCHITECTURE.md](./02-ARCHITECTURE.md) | 架构师 / 后端 / 全栈 | 系统架构、技术选型、模块边界、演进路线 |
| 03 | [API.md](./03-API.md) | 前端 / App / 测试 / 第三方对接 | 完整接口规范、入参出参、调用示例 |
| 04 | [MIGRATION.md](./04-MIGRATION.md) | uni-app 开发 | 二期 uni-app 迁移指南、目录结构、踩坑 |
| 05 | [CLEANUP.md](./05-CLEANUP.md) | 主程 / 运维 | 当前两个仓库的清理建议、长期维护规则 |

---

## 阅读建议

### 你是产品经理 / 设计师 / 业务方
- 必读：**01-PRD.md**
- 选读：03-API.md（理解能力边界）

### 你是后端开发
- 必读：02-ARCHITECTURE.md、03-API.md
- 选读：01-PRD.md、05-CLEANUP.md

### 你是 uni-app 开发（二期主力）
- 必读：**04-MIGRATION.md**
- 必读：03-API.md
- 必读：01-PRD.md
- 选读：02-ARCHITECTURE.md

### 你是新加入的全栈
- 顺序读：01 → 02 → 03 → 04 → 05

### 你是运维 / DevOps
- 必读：02-ARCHITECTURE.md（部署相关章节）
- 必读：05-CLEANUP.md

---

## 项目仓库地图

| 仓库 | 路径 | 用途 | 状态 |
|---|---|---|---|
| **career-web-api** | `/Users/lirunnan/Desktop/workspace/career-web-api` | Flask 后端 + 管理后台前端 | 持续维护 |
| **career-development** | `/Users/lirunnan/Desktop/workspace/career-development` | 微信小程序（原生）| 维护期，二期后归档 |
| **career-app-uniapp** | （二期新建）| uni-app 多端项目 | 待启动 |
| **career-ai-service** | （后期新建）| AI 教授分身后端服务 | 待启动 |

---

## 服务器信息

| 项目 | 值 |
|---|---|
| 公网 IP | `47.105.40.54` |
| 业务后端域名 | `https://sp.uzyhr.com` |
| 管理后台域名 | `https://admin.uzyhr.com` |
| AI 服务域名（规划）| `https://ai.uzyhr.com` |
| SSH | `ssh -i ~/.ssh/id_rsa root@47.105.40.54` |
| 业务后端 systemd | `career-api`（端口 9010）|

---

## 文档维护规则

1. **PRD 改动** → 同步更新 02-ARCHITECTURE.md 的对应章节
2. **新增/修改 API** → 必须更新 03-API.md
3. **目录结构调整** → 更新 02-ARCHITECTURE.md + 05-CLEANUP.md
4. **uni-app 踩坑** → 持续追加到 04-MIGRATION.md 的"已知踩坑"章节
5. 每个文档顶部维护**版本号 + 修改日期**
6. 重大变更需在 commit message 写清"docs: ..."

---

## 联系方式

- 项目仓库：（GitHub 链接，待补）
- Issue 跟踪：GitHub Issues
- 文档反馈：直接提交 PR 修改本目录