● 由 Leyon 开发 · FastAPI · 信创数据库(openGauss) · OA SSO · RBAC

LZ 招聘系统

OA 组织招聘工作站。岗位管理、投递管理、面试安排、人才库、部门/用户、公告、操作日志、Excel 导出、通知中心;支持 OA 单点登录与 RBAC 权限控制;管理权限仅 linyizheng、huanghuiming。

FastAPI信创数据库(openGauss)Uvicorn 5101OA SSORBAC
自上而下通读即可
01 / 概括

在 OA 体系内,造一个招聘指挥中心

定位、难点、技术框架——30 秒建立全貌。

定位系统定位

LZ 招聘系统是 OA 组织招聘工作站,覆盖岗位管理、投递管理、面试安排、人才库、部门/用户、公告、操作日志、Excel 导出、通知中心。管理权限仅 linyizheng、huanghuiming,其余人员仅可查看岗位与投递简历。

难点四个真问题

框架技术栈与运行形态

语言/形态
Python FastAPI 服务端 + Jinja2 模板,无前端框架依赖
协议层
REST API + 表单提交 + OA SSO 票据验证
数据
信创数据库(openGauss)(recruit.db),保留岗位、投递、面试、人才、部门、用户、公告、日志
登录
OA 单点登录(票据)+ 账号密码本地登录
运维
Uvicorn 监听 0.0.0.0:5101;.71 nginx stream 转发;用户级启动脚本
02 / 架构

数据怎么流,难点压在哪一层

三条主链路,每条各守一个硬约束。

链路 A认证:OA SSO → 本地会话

OA 登录→ 票据验证→ 本地会话→ RBAC 权限

OA 单点登录:票据验证通过后建立本地会话;账号密码登录适用于未登录 OA 场景。

链路 B业务:浏览器 → FastAPI → 信创数据库(openGauss)

浏览器→ FastAPI 路由→ 业务逻辑→ 信创数据库(openGauss)

所有 CRUD 操作经 FastAPI 路由处理,数据落盘 信创数据库(openGauss),支持并发读写。

链路 C通知:操作 → 审计日志 → 通知中心

用户操作→ 审计记录→ 通知中心→ 消息推送

操作日志与通知中心记录关键行为,便于追溯与消息推送。

模块难点分布

模块职责难点所在
认证OA SSO + 账号密码票据验证、账号切换检测
权限RBAC 控制管理员/员工权限分离
数据信创数据库(openGauss) 持久化并发、备份、迁移
运维服务守护未纳入 systemd,需手动重启
03 / 代码

核心代码

按难度递进:认证 → 权限 → 数据 → 业务 → 运维。

C1密码哈希与验证

def hash_password(password):
    salt = secrets.token_hex(16)
    h = hashlib.sha256((salt + password).encode('utf-8')).hexdigest()
    return 'sha256$%s$%s' % (salt, h)

def verify_password(stored, password):
    if not stored or '$' not in stored:
        return False
    try:
        algo, salt, h = stored.split('$', 2)
    except ValueError:
        return False
    if algo != 'sha256':
        return False
    return hashlib.sha256((salt + password).encode('utf-8')).hexdigest() == h

auth.py · 盐值 + SHA-256,避免明文存储。

C2用户确保存在(OA 同步)

def ensure_user(username, name=None, role='employee', login_name=None, sso_only=True, source='oa'):
    u = get_user(username)
    if u:
        return u
    allowed = ('admin', 'hr', 'interviewer', 'employee')
    r = role if role in allowed else 'employee'
    with db() as conn:
        conn.execute(
            'INSERT OR IGNORE INTO users (...) VALUES (...)',
            (username, None, name or username, r, ...),
        )
    return get_user(username)

auth.py · OA 用户首次访问自动创建,角色白名单校验。

C3门禁中间件(OAGateMiddleware)

class OAGateMiddleware(BaseHTTPMiddleware):
    SKIP_PREFIX = ('/health', '/api/', '/static/', '/uploads/', '/download/',
                   '/sso', '/login', '/register', '/logout', '/whoami', '/oo-proxy/')
    async def dispatch(self, request: Request, call_next):
        path = request.url.path
        if path in self.SKIP_EXACT or any(path.startswith(p) for p in self.SKIP_PREFIX):
            return await call_next(request)
        if client_host in ('127.0.0.1', '::1', 'localhost'):
            return await call_next(request)
        # 会话校验与账号切换检测
        ...

main.py · 未认证跳转选择页,已认证检测账号切换。

C4数据库初始化

def init_db():
    with db() as conn:
        conn.executescript("""
        CREATE TABLE IF NOT EXISTS users (...);
        CREATE TABLE IF NOT EXISTS jobs (...);
        CREATE TABLE IF NOT EXISTS applications (...);
        CREATE TABLE IF NOT EXISTS interviews (...);
        CREATE TABLE IF NOT EXISTS talents (...);
        CREATE TABLE IF NOT EXISTS departments (...);
        CREATE TABLE IF NOT EXISTS announcements (...);
        CREATE TABLE IF NOT EXISTS audit_logs (...);
        """)

db.py · 单 信创数据库(openGauss) 库,多表支持招聘全流程。

04 / 优化

踩坑与优化记录

真实问题与解法。

服务守护
未纳入 Leon-Control/systemd,进程退出后需手动执行 start.sh
权限分离
管理权限仅 linyizheng、huanghuiming,其余仅查看与投递
OA SSO
票据验证与本地账号并存,需兼容两种登录
数据备份
信创数据库(openGauss) 单库,建议定期备份 recruit.db

优化点性能与稳定性

📖 说明书📐 说明文档🕘 日志
'@ Set-Content -Path $localPath -Value $html -Encoding UTF8 (Get-Item $localPath).Length