From 6dd33dc80234d3c6cff7c590ff4b6ff0e18e4305 Mon Sep 17 00:00:00 2001 From: wonder Date: Sun, 10 May 2026 21:47:14 +0800 Subject: [PATCH] vault backup: 2026-05-10 21:47:14 --- FinalHomework/hzh_doc/工程结构.md | 29 ++++++++++++++--------------- FinalHomework/hzh_doc/执行计划.md | 2 +- 2 files changed, 15 insertions(+), 16 deletions(-) diff --git a/FinalHomework/hzh_doc/工程结构.md b/FinalHomework/hzh_doc/工程结构.md index 19f1005..e0496c1 100644 --- a/FinalHomework/hzh_doc/工程结构.md +++ b/FinalHomework/hzh_doc/工程结构.md @@ -10,17 +10,16 @@ final_homework/ ├── user-frontend/ # 候选人用户端前端（React + Vite） ├── web-gin-service/ # Gin Web网关服务 ├── logic-grpc-service/ # gRPC核心业务服务 -├── api/ # Protobuf 定义 & API文档 -│ ├── proto/ -│ │ └── v1/ -│ │ ├── auth.proto # 认证相关 -│ │ ├── job.proto # 岗位相关 -│ │ ├── application.proto # 投递相关 -│ │ ├── profile.proto # 候选人档案 -│ │ ├── resume.proto # 简历/OSS上传 -│ │ └── chat.proto # AI对话 -│ ├── api.md # 前后端接口说明文档 -│ └── db.md # 数据库设计文档 +├── proto/ # Protobuf 定义 +│ └── v1/ +│ ├── auth.proto # 认证相关 +│ ├── job.proto # 岗位相关 +│ ├── application.proto # 投递相关 +│ ├── profile.proto # 候选人档案 +│ ├── resume.proto # 简历/OSS上传 +│ └── chat.proto # AI对话 +├── api.md # 前后端接口说明文档 +├── db.md # 数据库设计文档 ├── README.md # 启动部署指南 + 项目亮点 └── answer.md # 拓展设计方案（OpenClaw/Hermes集成思路） ``` @@ -314,12 +313,12 @@ logic-grpc-service/ --- -## 六、Protobuf 定义（`api/proto/v1/`） +## 六、Protobuf 定义（`proto/v1/`） -所有 proto 文件统一放在 `api/proto/v1/`，供 `web-gin-service` 和 `logic-grpc-service` 共同引用。 +所有 proto 文件统一放在 `proto/v1/`，供 `web-gin-service` 和 `logic-grpc-service` 共同引用。 ``` -api/proto/v1/ +proto/v1/ ├── common.proto # 公共定义（Response code/msg, Pagination） ├── auth.proto # AuthService: Login, Register, VerifyToken ├── job.proto # JobService: CreateJob, UpdateJob, ListJobs, DeleteJob @@ -553,6 +552,6 @@ graph TB ## 八、开发建议 1. **前后端各自独立运行**：每个 `frontend/` 用 `npm run dev` 启动 Vite 开发服务器，通过 `vite.config.ts` 中的 `server.proxy` 将 `/api/*` 代理到 `localhost:8080`（Web-Gin）。 -2. **Proto 先行**：先写好 `api/proto/v1/` 下的所有 `.proto` 文件，再各自 `protoc` 生成代码，避免来回改接口。 +2. **Proto 先行**：先写好 `proto/v1/` 下的所有 `.proto` 文件，再各自 `protoc` 生成代码，避免来回改接口。 3. **前端共享模式**：HR端和用户端都遵循「API层 → Store层 → 页面层」三层分离，可抽取公共的 Axios client 和类型定义作为参考。 4. **环境变量隔离**：两个前端的 `.env`、后端的 `.env` 全部加 `.gitignore`，使用 `.env.example` 作为模板提交。 diff --git a/FinalHomework/hzh_doc/执行计划.md b/FinalHomework/hzh_doc/执行计划.md index 9d5463d..7ce00ba 100644 --- a/FinalHomework/hzh_doc/执行计划.md +++ b/FinalHomework/hzh_doc/执行计划.md @@ -170,7 +170,7 @@ final_homework/ ### 3.3 验收标准 -- [ ] `protoc --go_out=... --go-grpc_out=...` 在 `api/proto/v1/` 下编译通过 +- [ ] `protoc --go_out=... --go-grpc_out=...` 在 `proto/v1/` 下编译通过 - [ ] 生成的 Go 代码存在于两个服务的 `proto/gen/v1/` 目录 - [ ] 所有 RPC 方法签名覆盖项目需求文档中的全部接口