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
```sql
CREATE DATABASE jianli_boss DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
### 1. 准备 MySQL 并初始化表结构
```bash
# 直接执行初始化脚本(含建库 + 建表,服务端不会自动建表)
mysql -uroot -p < docs/schema.sql
```
> 表结构以 `docs/schema.sql` 为唯一标准,修改 `server/models.py` 后需同步更新该脚本。
### 2. 安装依赖
```bash
cd server
@@ -102,6 +105,36 @@ uvicorn server.main:app --host 0.0.0.0 --port 8000 --workers 4
> ⚠️ 生产环境务必修改 `.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)
+3
View File
@@ -148,6 +148,9 @@ class Applicant:
break
applied_in_kw += self._handle_card(card, greeting, min_score, delay_range)
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,
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:
db.close()
def init_db() -> None:
"""创建所有表(生产环境建议改用 Alembic 迁移)"""
from . import models # noqa: F401 确保模型被导入
Base.metadata.create_all(bind=engine)
# 注意:本服务不自动建表。
# 数据库结构由 docs/schema.sql 手动初始化(与 models.py 保持同步维护)。
+11 -3
View File
@@ -1,20 +1,28 @@
"""
服务端主入口
运行方式: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 fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from loguru import logger
from .config import settings
from .database import init_db
from .database import engine
from .routers import register, resumes, sessions, jobs
@asynccontextmanager
async def lifespan(app: FastAPI):
# 启动时建表
init_db()
# 启动时仅检查数据库连通性(不自动建表,表结构由 docs/schema.sql 初始化)
try:
with engine.connect():
logger.success("数据库连接成功")
except Exception as e:
logger.error(f"数据库连接失败,请检查配置及数据库是否已初始化:{e}")
yield
+1
View File
@@ -7,3 +7,4 @@ cryptography>=42.0.0
pydantic>=2.7.0
pydantic-settings>=2.3.0
python-jose[cryptography]>=3.3.0
loguru>=0.7.2