Python全栈项目–智能办公自动化系统一、项目简介智能办公自动化系统是一个面向企业、学校或团队内部的轻量级 OA 平台。它把日常办公中最常见的文档沉淀、任务协同、审批流转和统计看板整合在一个 Web 系统中用户完成注册登录后即可管理自己的办公数据。本项目不是单纯演示某个算法或概念而是一个可运行的 Python 全栈项目后端提供 RESTful API、SQLite 数据持久化、密码哈希和 JWT 鉴权前端使用 Vue 3 Vite 构建单页应用完成登录态保存、鉴权请求、业务表单和列表展示。适用场景企业内部 OA 原型课程设计/毕业设计全栈项目FastAPI Vue 3 前后端分离实战办公自动化业务建模参考二、技术栈层级技术说明后端框架FastAPI构建高性能 REST API自动生成接口文档数据库SQLite单文件数据库适合教学、原型和本地部署ORMSQLAlchemy定义用户、文档、任务、审批等数据模型数据校验Pydantic请求参数和响应结构校验鉴权passlib python-josebcrypt 密码哈希、JWT 登录 token前端Vue 3 Vite组件化单页应用、快速开发调试接口通信Fetch API 封装统一处理 token、请求和异常三、系统架构系统采用经典前后端分离架构浏览器 Vue 3 前端 ├─ 登录/注册页面 ├─ 文档中心 ├─ 任务协同 ├─ 审批流程 └─ 办公看板 │ Authorization: Bearer JWT ▼ FastAPI 后端服务 ├─ auth.py密码哈希与 JWT 鉴权 ├─ main.py接口路由 ├─ crud.py业务操作 ├─ schemas.py请求响应模型 └─ models.pySQLAlchemy ORM 模型 │ ▼ SQLite 数据库 office_automation.db架构特点注册和登录接口开放访问核心业务接口全部通过 JWT 保护。前端登录后把 token 保存到 localStorage请求时统一追加Authorization请求头。SQLite 自动建表降低部署门槛。文档、任务、审批都绑定当前登录用户避免越权访问。四、功能模块1. 用户认证模块用户注册用户名、邮箱、密码、姓名、部门密码哈希后端不保存明文密码用户登录校验账号密码并签发 JWT当前用户根据 token 获取用户信息退出登录前端清理本地 token2. 文档中心新增文档标题、分类、内容、状态文档查询支持按标题关键字检索适用办公通知、制度、会议纪要等场景3. 任务协同创建任务标题、说明、优先级、截止日期任务列表按当前用户隔离任务更新可将任务标记为完成看板统计统计任务数量和完成数量4. 审批流程提交审批请假、报销、采购、通用审批审批列表查看个人审批单审批决策模拟通过或驳回流程看板统计展示待处理审批数量5. 办公看板文档总数任务总数待处理审批数已完成任务数五、数据库/数据模型设计项目使用 SQLite核心表包括users、documents、tasks、approvals。用户表 users字段类型说明idInteger主键usernameString用户名唯一emailString邮箱唯一hashed_passwordStringbcrypt 哈希密码full_nameString姓名departmentString部门is_activeBoolean是否启用created_atDateTime创建时间文档表 documents字段类型说明idInteger主键titleString文档标题categoryString分类contentText内容statusString状态owner_idInteger所属用户created_at/updated_atDateTime创建/更新时间任务表 tasks字段类型说明idInteger主键titleString任务标题descriptionText说明priorityString优先级statusString状态due_dateString截止日期owner_idInteger所属用户审批表 approvals字段类型说明idInteger主键titleString审批标题approval_typeString审批类型reasonText申请原因statusStringpending/approved/rejectedcommentText审批意见applicant_idInteger申请人六、后端接口设计方法URL功能是否需要登录GET/api/health健康检查否POST/api/auth/register注册否POST/api/auth/login登录否GET/api/users/me当前用户是GET/api/dashboard看板统计是POST/api/documents创建文档是GET/api/documents?keyword文档列表/搜索是POST/api/tasks创建任务是GET/api/tasks?status_filter任务列表是PATCH/api/tasks/{task_id}更新任务是POST/api/approvals提交审批是GET/api/approvals审批列表是PATCH/api/approvals/{id}/decision审批决策是接口设计遵循三个原则认证接口独立放在/api/auth下业务资源使用复数名词如documents、tasks业务接口通过Depends(auth.get_current_user)获取当前用户。七、前端页面设计前端使用 Vue 3 Vite核心页面集中在App.vue中适合教学示例快速理解。页面结构如下App.vue ├─ 顶部 Hero 区域系统名称、当前用户、退出按钮 ├─ 登录/注册卡片未登录时显示 ├─ 数据看板登录后显示 └─ 业务标签页 ├─ 文档中心 ├─ 任务协同 └─ 审批流程前端状态处理user保存当前登录用户stats保存看板统计docs/tasks/approvals保存业务列表api.js统一管理后端地址、token 读写和请求错误处理。八、核心代码讲解1. 数据库连接backend/app/database.py负责创建 SQLite 引擎和 SessionDATABASE_URLsqlite:///./office_automation.dbenginecreate_engine(DATABASE_URL,connect_args{check_same_thread:False})SessionLocalsessionmaker(autocommitFalse,autoflushFalse,bindengine)Basedeclarative_base()FastAPI 通过依赖注入获取数据库会话defget_db():dbSessionLocal()try:yielddbfinally:db.close()2. 密码哈希与 JWTauth.py中使用 bcrypt 对密码进行哈希pwd_contextCryptContext(schemes[bcrypt],deprecatedauto)defget_password_hash(password:str)-str:returnpwd_context.hash(password)defverify_password(plain_password:str,hashed_password:str)-bool:returnpwd_context.verify(plain_password,hashed_password)登录成功后生成 JWTdefcreate_access_token(data:dict,expires_delta:Optional[timedelta]None)-str:to_encodedata.copy()expiredatetime.utcnow()(expires_deltaortimedelta(minutesACCESS_TOKEN_EXPIRE_MINUTES))to_encode.update({exp:expire})returnjwt.encode(to_encode,SECRET_KEY,algorithmALGORITHM)3. 受保护接口例如创建任务接口app.post(/api/tasks,response_modelschemas.TaskRead)defcreate_task(task:schemas.TaskCreate,db:SessionDepends(get_db),current_user:models.UserDepends(auth.get_current_user)):returncrud.create_task(db,current_user.id,task)只有请求头携带合法 token 时current_user才能解析成功。4. 前端 API 封装frontend/src/api.js统一追加 tokenif(token)headers.AuthorizationBearer${token}constresponseawaitfetch(${API_BASE}${path},{...options,headers})登录后保存 tokenexportfunctionsetToken(value){tokenvalue||if(token)localStorage.setItem(office_token,token)elselocalStorage.removeItem(office_token)}这样 Vue 组件不需要重复处理认证细节。九、部署与运行步骤1. 后端运行cdproject/backend python3-mvenv .venvsource.venv/bin/activate pipinstall-rrequirements.txt uvicorn app.main:app--reload--host0.0.0.0--port8000后端默认地址http://localhost:8000。可访问接口文档http://localhost:8000/docs2. 前端运行cdproject/frontendnpminstallnpmrun dev默认访问http://localhost:5173。3. 使用流程打开前端页面注册一个账号例如admin / admin123登录进入系统新增文档、任务和审批单查看顶部数据看板变化点击退出登录验证鉴权状态处理。十、项目目录project/ README.md backend/ requirements.txt app/ __init__.py main.py database.py models.py schemas.py crud.py auth.py frontend/ package.json index.html src/ main.js App.vue api.js style.css十一、项目总结本项目完整覆盖了全栈开发的关键环节后端FastAPI 路由、SQLite 持久化、SQLAlchemy ORM、Pydantic 数据校验安全密码哈希、JWT 签发、受保护接口、用户数据隔离前端Vue 3 单页应用、登录态维护、鉴权请求、业务表单和列表渲染工程化前后端目录拆分、README 运行说明、可打包发布。后续可以继续扩展增加角色权限例如普通员工、部门主管、管理员引入审批流节点让审批从“模拟决策”升级为真实多人流转增加文件上传将文档附件保存到对象存储接入消息通知任务和审批变更时推送提醒使用 PostgreSQL/MySQL 替换 SQLite用于生产部署。通过这个项目可以比较系统地掌握 Python 全栈项目从需求分析、数据建模、接口开发、前端交互到部署运行的完整流程。项目代码下载链接
Python全栈项目–智能办公自动化系统一、项目简介智能办公自动化系统是一个面向企业、学校或团队内部的轻量级 OA 平台。它把日常办公中最常见的文档沉淀、任务协同、审批流转和统计看板整合在一个 Web 系统中用户完成注册登录后即可管理自己的办公数据。本项目不是单纯演示某个算法或概念而是一个可运行的 Python 全栈项目后端提供 RESTful API、SQLite 数据持久化、密码哈希和 JWT 鉴权前端使用 Vue 3 Vite 构建单页应用完成登录态保存、鉴权请求、业务表单和列表展示。适用场景企业内部 OA 原型课程设计/毕业设计全栈项目FastAPI Vue 3 前后端分离实战办公自动化业务建模参考二、技术栈层级技术说明后端框架FastAPI构建高性能 REST API自动生成接口文档数据库SQLite单文件数据库适合教学、原型和本地部署ORMSQLAlchemy定义用户、文档、任务、审批等数据模型数据校验Pydantic请求参数和响应结构校验鉴权passlib python-josebcrypt 密码哈希、JWT 登录 token前端Vue 3 Vite组件化单页应用、快速开发调试接口通信Fetch API 封装统一处理 token、请求和异常三、系统架构系统采用经典前后端分离架构浏览器 Vue 3 前端 ├─ 登录/注册页面 ├─ 文档中心 ├─ 任务协同 ├─ 审批流程 └─ 办公看板 │ Authorization: Bearer JWT ▼ FastAPI 后端服务 ├─ auth.py密码哈希与 JWT 鉴权 ├─ main.py接口路由 ├─ crud.py业务操作 ├─ schemas.py请求响应模型 └─ models.pySQLAlchemy ORM 模型 │ ▼ SQLite 数据库 office_automation.db架构特点注册和登录接口开放访问核心业务接口全部通过 JWT 保护。前端登录后把 token 保存到 localStorage请求时统一追加Authorization请求头。SQLite 自动建表降低部署门槛。文档、任务、审批都绑定当前登录用户避免越权访问。四、功能模块1. 用户认证模块用户注册用户名、邮箱、密码、姓名、部门密码哈希后端不保存明文密码用户登录校验账号密码并签发 JWT当前用户根据 token 获取用户信息退出登录前端清理本地 token2. 文档中心新增文档标题、分类、内容、状态文档查询支持按标题关键字检索适用办公通知、制度、会议纪要等场景3. 任务协同创建任务标题、说明、优先级、截止日期任务列表按当前用户隔离任务更新可将任务标记为完成看板统计统计任务数量和完成数量4. 审批流程提交审批请假、报销、采购、通用审批审批列表查看个人审批单审批决策模拟通过或驳回流程看板统计展示待处理审批数量5. 办公看板文档总数任务总数待处理审批数已完成任务数五、数据库/数据模型设计项目使用 SQLite核心表包括users、documents、tasks、approvals。用户表 users字段类型说明idInteger主键usernameString用户名唯一emailString邮箱唯一hashed_passwordStringbcrypt 哈希密码full_nameString姓名departmentString部门is_activeBoolean是否启用created_atDateTime创建时间文档表 documents字段类型说明idInteger主键titleString文档标题categoryString分类contentText内容statusString状态owner_idInteger所属用户created_at/updated_atDateTime创建/更新时间任务表 tasks字段类型说明idInteger主键titleString任务标题descriptionText说明priorityString优先级statusString状态due_dateString截止日期owner_idInteger所属用户审批表 approvals字段类型说明idInteger主键titleString审批标题approval_typeString审批类型reasonText申请原因statusStringpending/approved/rejectedcommentText审批意见applicant_idInteger申请人六、后端接口设计方法URL功能是否需要登录GET/api/health健康检查否POST/api/auth/register注册否POST/api/auth/login登录否GET/api/users/me当前用户是GET/api/dashboard看板统计是POST/api/documents创建文档是GET/api/documents?keyword文档列表/搜索是POST/api/tasks创建任务是GET/api/tasks?status_filter任务列表是PATCH/api/tasks/{task_id}更新任务是POST/api/approvals提交审批是GET/api/approvals审批列表是PATCH/api/approvals/{id}/decision审批决策是接口设计遵循三个原则认证接口独立放在/api/auth下业务资源使用复数名词如documents、tasks业务接口通过Depends(auth.get_current_user)获取当前用户。七、前端页面设计前端使用 Vue 3 Vite核心页面集中在App.vue中适合教学示例快速理解。页面结构如下App.vue ├─ 顶部 Hero 区域系统名称、当前用户、退出按钮 ├─ 登录/注册卡片未登录时显示 ├─ 数据看板登录后显示 └─ 业务标签页 ├─ 文档中心 ├─ 任务协同 └─ 审批流程前端状态处理user保存当前登录用户stats保存看板统计docs/tasks/approvals保存业务列表api.js统一管理后端地址、token 读写和请求错误处理。八、核心代码讲解1. 数据库连接backend/app/database.py负责创建 SQLite 引擎和 SessionDATABASE_URLsqlite:///./office_automation.dbenginecreate_engine(DATABASE_URL,connect_args{check_same_thread:False})SessionLocalsessionmaker(autocommitFalse,autoflushFalse,bindengine)Basedeclarative_base()FastAPI 通过依赖注入获取数据库会话defget_db():dbSessionLocal()try:yielddbfinally:db.close()2. 密码哈希与 JWTauth.py中使用 bcrypt 对密码进行哈希pwd_contextCryptContext(schemes[bcrypt],deprecatedauto)defget_password_hash(password:str)-str:returnpwd_context.hash(password)defverify_password(plain_password:str,hashed_password:str)-bool:returnpwd_context.verify(plain_password,hashed_password)登录成功后生成 JWTdefcreate_access_token(data:dict,expires_delta:Optional[timedelta]None)-str:to_encodedata.copy()expiredatetime.utcnow()(expires_deltaortimedelta(minutesACCESS_TOKEN_EXPIRE_MINUTES))to_encode.update({exp:expire})returnjwt.encode(to_encode,SECRET_KEY,algorithmALGORITHM)3. 受保护接口例如创建任务接口app.post(/api/tasks,response_modelschemas.TaskRead)defcreate_task(task:schemas.TaskCreate,db:SessionDepends(get_db),current_user:models.UserDepends(auth.get_current_user)):returncrud.create_task(db,current_user.id,task)只有请求头携带合法 token 时current_user才能解析成功。4. 前端 API 封装frontend/src/api.js统一追加 tokenif(token)headers.AuthorizationBearer${token}constresponseawaitfetch(${API_BASE}${path},{...options,headers})登录后保存 tokenexportfunctionsetToken(value){tokenvalue||if(token)localStorage.setItem(office_token,token)elselocalStorage.removeItem(office_token)}这样 Vue 组件不需要重复处理认证细节。九、部署与运行步骤1. 后端运行cdproject/backend python3-mvenv .venvsource.venv/bin/activate pipinstall-rrequirements.txt uvicorn app.main:app--reload--host0.0.0.0--port8000后端默认地址http://localhost:8000。可访问接口文档http://localhost:8000/docs2. 前端运行cdproject/frontendnpminstallnpmrun dev默认访问http://localhost:5173。3. 使用流程打开前端页面注册一个账号例如admin / admin123登录进入系统新增文档、任务和审批单查看顶部数据看板变化点击退出登录验证鉴权状态处理。十、项目目录project/ README.md backend/ requirements.txt app/ __init__.py main.py database.py models.py schemas.py crud.py auth.py frontend/ package.json index.html src/ main.js App.vue api.js style.css十一、项目总结本项目完整覆盖了全栈开发的关键环节后端FastAPI 路由、SQLite 持久化、SQLAlchemy ORM、Pydantic 数据校验安全密码哈希、JWT 签发、受保护接口、用户数据隔离前端Vue 3 单页应用、登录态维护、鉴权请求、业务表单和列表渲染工程化前后端目录拆分、README 运行说明、可打包发布。后续可以继续扩展增加角色权限例如普通员工、部门主管、管理员引入审批流节点让审批从“模拟决策”升级为真实多人流转增加文件上传将文档附件保存到对象存储接入消息通知任务和审批变更时推送提醒使用 PostgreSQL/MySQL 替换 SQLite用于生产部署。通过这个项目可以比较系统地掌握 Python 全栈项目从需求分析、数据建模、接口开发、前端交互到部署运行的完整流程。项目代码下载链接
