diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..1b8faa1 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,23 @@ +# Python 缓存 +__pycache__/ +*.py[cod] +.venv/ +venv/ + +# 敏感配置(镜像内不含任何密钥) +.env +**/.env +*.env.local +client/.token + +# 客户端与本地数据(服务端镜像不需要) +client/ +data/ +logs/ +*.db + +# 其他 +.git/ +.idea/ +.vscode/ +docs/ diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..fd15489 --- /dev/null +++ b/.env.example @@ -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 diff --git a/README.md b/README.md index 2a4e29a..e90576a 100644 --- a/README.md +++ b/README.md @@ -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) diff --git a/client/browser/applicant.py b/client/browser/applicant.py index 44ec660..408f67f 100644 --- a/client/browser/applicant.py +++ b/client/browser/applicant.py @@ -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: diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..361a384 --- /dev/null +++ b/docker-compose.yml @@ -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: diff --git a/docs/schema.sql b/docs/schema.sql new file mode 100644 index 0000000..f47c664 --- /dev/null +++ b/docs/schema.sql @@ -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 '实际发送的打招呼语'; diff --git a/server/Dockerfile b/server/Dockerfile new file mode 100644 index 0000000..0dda04f --- /dev/null +++ b/server/Dockerfile @@ -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"] diff --git a/server/database.py b/server/database.py index 9ef1323..1ebc1c3 100644 --- a/server/database.py +++ b/server/database.py @@ -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 保持同步维护)。 diff --git a/server/main.py b/server/main.py index 318505d..8fdf011 100644 --- a/server/main.py +++ b/server/main.py @@ -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 diff --git a/server/requirements.txt b/server/requirements.txt index dc16a0d..4bb7905 100644 --- a/server/requirements.txt +++ b/server/requirements.txt @@ -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