This commit is contained in:
2026-08-25 20:06:52 +08:00
parent e4f846c2cb
commit d827523f2b
10 changed files with 288 additions and 11 deletions
+23
View File
@@ -0,0 +1,23 @@
# Python 缓存
__pycache__/
*.py[cod]
.venv/
venv/
# 敏感配置(镜像内不含任何密钥)
.env
**/.env
*.env.local
client/.token
# 客户端与本地数据(服务端镜像不需要)
client/
data/
logs/
*.db
# 其他
.git/
.idea/
.vscode/
docs/
+18
View File
@@ -0,0 +1,18 @@
# docker-compose 环境变量示例
# 复制本文件为 .env(项目根目录)并修改敏感值:
# copy .env.example .env
# MySQL root 密码(compose 中 mysql 与 server 共用)
DB_PASSWORD=root123456
# 数据库名
DB_NAME=jianli_boss
# JWT 密钥(生产环境务必改为随机长字符串)
SECRET_KEY=please-change-this-to-a-long-random-string
# Token 有效期(天)
ACCESS_TOKEN_EXPIRE_DAYS=30
# 调试模式
DEBUG=false
+36 -3
View File
@@ -77,11 +77,14 @@ jianli-boss/
## 一、部署服务端(云服务器) ## 一、部署服务端(云服务器)
### 1. 准备 MySQL ### 1. 准备 MySQL 并初始化表结构
```sql ```bash
CREATE DATABASE jianli_boss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 直接执行初始化脚本(含建库 + 建表,服务端不会自动建表)
mysql -uroot -p < docs/schema.sql
``` ```
> 表结构以 `docs/schema.sql` 为唯一标准,修改 `server/models.py` 后需同步更新该脚本。
### 2. 安装依赖 ### 2. 安装依赖
```bash ```bash
cd server cd server
@@ -102,6 +105,36 @@ uvicorn server.main:app --host 0.0.0.0 --port 8000 --workers 4
> ⚠️ 生产环境务必修改 `.env` 中的 `SECRET_KEY`,并建议通过 Nginx 配置 HTTPS。 > ⚠️ 生产环境务必修改 `.env` 中的 `SECRET_KEY`,并建议通过 Nginx 配置 HTTPS。
### 替代方式:Docker 一键启动(推荐)
无需手动装 MySQL,项目根目录已提供 `docker-compose.yml` + `server/Dockerfile`:
```bash
# 1. 准备环境变量(可选,不改则用默认值)
copy .env.example .env # 然后修改 DB_PASSWORD / SECRET_KEY
# 2. 构建并启动(MySQL + 服务端)
docker compose up -d --build
# 3. 查看运行状态 / 日志
docker compose ps
docker compose logs -f server
# 4. 停止(-v 会同时删除数据库数据,慎用)
docker compose down
```
说明:
- 数据库初始化:`docs/schema.sql` 已挂载到 MySQL 的 `docker-entrypoint-initdb.d`,
**全新数据卷首次启动时自动执行一次**;服务端本身不自动建表
- 若数据卷已存在(之前启动过)但未初始化过表,手动补执行:
`docker exec -i jianli-boss-mysql mysql -uroot -p${DB_PASSWORD:-root123456} < docs/schema.sql`
- MySQL 带健康检查,服务端会等数据库就绪后再启动
- 数据持久化在 `mysql_data` 卷中,重启容器不丢数据
- 服务端映射到宿主机 `8000` 端口,客户端 `.env` 保持 `SERVER_URL=http://127.0.0.1:8000` 即可
- 老库升级(缺新增字段时):
`ALTER TABLE job_applications ADD COLUMN jd_text TEXT NULL, ADD COLUMN greeting VARCHAR(500) NULL;`
--- ---
## 二、运行客户端(本地 Windows) ## 二、运行客户端(本地 Windows)
+3
View File
@@ -148,6 +148,9 @@ class Applicant:
break break
applied_in_kw += self._handle_card(card, greeting, min_score, delay_range) applied_in_kw += self._handle_card(card, greeting, min_score, delay_range)
page += 1 page += 1
# 翻页前随机停顿,模拟真人翻页节奏,避免连续翻页被识别为机器行为
if applied_in_kw < max_per_keyword and not self._should_stop():
self._sleep(2, 5)
def _handle_card(self, card: JobCard, greeting: str, min_score: int, def _handle_card(self, card: JobCard, greeting: str, min_score: int,
delay_range: tuple[int, int]) -> int: delay_range: tuple[int, int]) -> int:
+59
View File
@@ -0,0 +1,59 @@
# Boss直聘投递系统 - 服务端编排
# 启动:docker compose up -d --build
# 查看:docker compose logs -f server
# 停止:docker compose down(加 -v 会同时删除数据库数据)
services:
mysql:
image: mysql:8.0
container_name: jianli-boss-mysql
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD:-root123456}
MYSQL_DATABASE: ${DB_NAME:-jianli_boss}
TZ: Asia/Shanghai
# 统一 utf8mb4,避免中文乱码
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
- --default-authentication-plugin=mysql_native_password
ports:
- "3306:3306"
volumes:
- mysql_data:/var/lib/mysql
# 数据库初始化:仅在全新数据卷首次启动时执行 docs/schema.sql(服务端不再自动建表)
- ./docs/schema.sql:/docker-entrypoint-initdb.d/schema.sql:ro
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "-uroot", "-p${DB_PASSWORD:-root123456}"]
interval: 5s
timeout: 5s
retries: 30
start_period: 20s
restart: unless-stopped
server:
build:
# 构建上下文必须是项目根目录(server 包从根目录导入)
context: .
dockerfile: server/Dockerfile
image: jianli-boss-server:latest
container_name: jianli-boss-server
depends_on:
mysql:
condition: service_healthy
environment:
# 容器网络内通过服务名 mysql 访问数据库
DB_HOST: mysql
DB_PORT: 3306
DB_USER: root
DB_PASSWORD: ${DB_PASSWORD:-root123456}
DB_NAME: ${DB_NAME:-jianli_boss}
# JWT 密钥(生产环境务必通过 .env 覆盖为随机长字符串)
SECRET_KEY: ${SECRET_KEY:-please-change-this-to-a-long-random-string}
ACCESS_TOKEN_EXPIRE_DAYS: ${ACCESS_TOKEN_EXPIRE_DAYS:-30}
DEBUG: ${DEBUG:-false}
ports:
- "8000:8000"
restart: unless-stopped
volumes:
mysql_data:
+113
View File
@@ -0,0 +1,113 @@
-- ============================================================
-- Boss直聘 AI 投递系统 - 数据库初始化脚本(必须手动执行)
-- 与 server/models.py 保持一一对应,模型变更时需同步修改本脚本
--
-- 说明:
-- 1. 服务端【不自动建表】,数据库结构完全由本脚本控制
-- 2. 初始化方式:
-- a) Docker:全新数据卷首次启动时自动执行(已挂载到
-- /docker-entrypoint-initdb.d);已有数据卷需手动执行方式 b
-- b) 手动:docker exec -i jianli-boss-mysql mysql -uroot -p<密码> < docs/schema.sql
-- 3. 应用层时间统一写入 UTC(datetime.utcnow),DEFAULT CURRENT_TIMESTAMP
-- 仅对手工插入的数据生效
-- ============================================================
CREATE DATABASE IF NOT EXISTS jianli_boss
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
USE jianli_boss;
-- ------------------------------------------------------------
-- 1. 系统用户(账号密码体系,身份与机器/指纹浏览器解耦)
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(64) NOT NULL COMMENT '登录用户名',
password_hash VARCHAR(255) NOT NULL COMMENT '密码加盐哈希(PBKDF2,格式:盐$摘要),不存明文',
nickname VARCHAR(64) NULL COMMENT '客户端显示昵称',
client_code VARCHAR(128) NULL COMMENT '最近一次登录的设备指纹(仅审计/展示,非身份标识)',
is_active TINYINT(1) NOT NULL DEFAULT 1 COMMENT '账号是否启用',
boss_account VARCHAR(128) NULL COMMENT 'Boss直聘账号标识(登录成功后回填)',
login_status VARCHAR(20) NOT NULL DEFAULT 'not_login' COMMENT 'Boss登录状态:not_login/logging_in/logged_in',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '注册时间',
last_seen_at DATETIME NULL COMMENT '最后活跃时间(心跳刷新,≤90s 判定 RPA 在线)',
UNIQUE KEY uq_users_username (username)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='系统用户';
-- ------------------------------------------------------------
-- 2. 简历(一个用户多份,其中一份为主简历)
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS resumes (
id INT AUTO_INCREMENT PRIMARY KEY,
user_id INT NOT NULL,
boss_resume_id VARCHAR(64) NULL COMMENT 'Boss直聘简历ID',
title VARCHAR(128) NOT NULL COMMENT '简历标题',
position VARCHAR(128) NULL COMMENT '求职意向岗位',
content TEXT NULL COMMENT '简历全文(AI整理后的结构化文本)',
is_primary TINYINT(1) NOT NULL DEFAULT 0 COMMENT '是否为主简历(用于JD匹配)',
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
updated_at DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
KEY ix_resumes_user_id (user_id),
CONSTRAINT fk_resumes_user FOREIGN KEY (user_id)
REFERENCES users (id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='简历';
-- ------------------------------------------------------------
-- 3. 投递会话(一次"开始投递 → 结束投递"的完整过程)
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS apply_sessions (
id INT AUTO_INCREMENT PRIMARY KEY,
user_id INT NOT NULL,
status VARCHAR(20) NOT NULL DEFAULT 'running' COMMENT '会话状态:running/stopped/finished',
keywords VARCHAR(512) NULL COMMENT '搜索关键词(逗号分隔)',
city_code VARCHAR(20) NULL COMMENT '城市代码',
salary_min INT NULL COMMENT '最低薪资(K)',
salary_max INT NULL COMMENT '最高薪资(K)',
applied_count INT NOT NULL DEFAULT 0 COMMENT '本次会话投递数',
skipped_count INT NOT NULL DEFAULT 0 COMMENT '本次会话跳过数',
started_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
ended_at DATETIME NULL,
KEY ix_apply_sessions_user_id (user_id),
CONSTRAINT fk_sessions_user FOREIGN KEY (user_id)
REFERENCES users (id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='投递会话';
-- ------------------------------------------------------------
-- 4. 投递记录(含公司/岗位/薪资/JD全文/打招呼语归档)
-- ------------------------------------------------------------
CREATE TABLE IF NOT EXISTS job_applications (
id INT AUTO_INCREMENT PRIMARY KEY,
user_id INT NOT NULL,
session_id INT NULL COMMENT '所属会话(会话删除时置NULL)',
job_id VARCHAR(64) NOT NULL COMMENT 'Boss直聘职位唯一ID',
job_title VARCHAR(128) NULL COMMENT '岗位名',
company VARCHAR(128) NULL COMMENT '公司名',
salary VARCHAR(32) NULL COMMENT '薪资(如 15-25K·14薪)',
location VARCHAR(64) NULL COMMENT '工作地点',
apply_type VARCHAR(20) NOT NULL COMMENT '投递方式:chat=立即沟通/deliver=投递简历/skipped=跳过',
ai_score INT NOT NULL DEFAULT -1 COMMENT 'AI匹配评分(-1=未评分)',
ai_reason VARCHAR(255) NULL COMMENT 'AI评分理由',
skip_reason VARCHAR(255) NULL COMMENT '跳过原因',
jd_text TEXT NULL COMMENT '职位JD全文(投递/跳过时归档,供复盘与面试准备)',
greeting VARCHAR(500) NULL COMMENT '实际发送的打招呼语(仅chat方式有值)',
applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '投递时间',
UNIQUE KEY uq_user_job (user_id, job_id) COMMENT '同一用户不重复投递同一职位',
KEY ix_job_applications_job_id (job_id),
KEY idx_user_session (user_id, session_id),
CONSTRAINT fk_jobs_user FOREIGN KEY (user_id)
REFERENCES users (id) ON DELETE CASCADE,
CONSTRAINT fk_jobs_session FOREIGN KEY (session_id)
REFERENCES apply_sessions (id) ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
COMMENT='投递记录';
-- ============================================================
-- 附:老库升级脚本(已建过表、缺少新增字段时执行)
-- ============================================================
-- ALTER TABLE job_applications
-- ADD COLUMN jd_text TEXT NULL COMMENT '职位JD全文',
-- ADD COLUMN greeting VARCHAR(500) NULL COMMENT '实际发送的打招呼语';
+22
View File
@@ -0,0 +1,22 @@
# Boss直聘投递服务端镜像
# 构建上下文必须是项目根目录(server 包需从根目录可导入):
# docker build -f server/Dockerfile .
FROM python:3.11-slim
WORKDIR /app
# 时区设置(投递记录时间统一为北京时间)
ENV TZ=Asia/Shanghai \
PYTHONUNBUFFERED=1 \
PYTHONDONTWRITEBYTECODE=1
# 先装依赖(利用 Docker 层缓存,代码变动不重装依赖)
COPY server/requirements.txt ./server/requirements.txt
RUN pip install --no-cache-dir -r server/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
# 复制服务端代码
COPY server/ ./server/
EXPOSE 8000
CMD ["uvicorn", "server.main:app", "--host", "0.0.0.0", "--port", "8000"]
+2 -5
View File
@@ -31,8 +31,5 @@ def get_db():
finally: finally:
db.close() db.close()
# 注意:本服务不自动建表。
def init_db() -> None: # 数据库结构由 docs/schema.sql 手动初始化(与 models.py 保持同步维护)。
"""创建所有表(生产环境建议改用 Alembic 迁移)"""
from . import models # noqa: F401 确保模型被导入
Base.metadata.create_all(bind=engine)
+11 -3
View File
@@ -1,20 +1,28 @@
""" """
服务端主入口 服务端主入口
运行方式:uvicorn server.main:app --host 0.0.0.0 --port 8000 --reload 运行方式:uvicorn server.main:app --host 0.0.0.0 --port 8000 --reload
注意:本服务不自动建表。数据库结构由 docs/schema.sql 手动初始化:
docker exec -i jianli-boss-mysql mysql -uroot -p<密码> < docs/schema.sql
""" """
from contextlib import asynccontextmanager from contextlib import asynccontextmanager
from fastapi import FastAPI from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware from fastapi.middleware.cors import CORSMiddleware
from loguru import logger
from .config import settings from .config import settings
from .database import init_db from .database import engine
from .routers import register, resumes, sessions, jobs from .routers import register, resumes, sessions, jobs
@asynccontextmanager @asynccontextmanager
async def lifespan(app: FastAPI): async def lifespan(app: FastAPI):
# 启动时建表 # 启动时仅检查数据库连通性(不自动建表,表结构由 docs/schema.sql 初始化)
init_db() try:
with engine.connect():
logger.success("数据库连接成功")
except Exception as e:
logger.error(f"数据库连接失败,请检查配置及数据库是否已初始化:{e}")
yield yield
+1
View File
@@ -7,3 +7,4 @@ cryptography>=42.0.0
pydantic>=2.7.0 pydantic>=2.7.0
pydantic-settings>=2.3.0 pydantic-settings>=2.3.0
python-jose[cryptography]>=3.3.0 python-jose[cryptography]>=3.3.0
loguru>=0.7.2