如果你正在为毕设选题发愁看到“基于PythonFlask框架的微信小程序CR公司建设项目信息管理系统前台”这个题目大概率是既想做一个能真正跑起来的项目又担心工作量失控收不了尾。我先给你吃颗定心丸这个题目的核心并不复杂本质就是一个用微信小程序做用户端、Python的Flask框架做后端接口的公司内部项目管理系统说人话就是让CR公司的员工在小程序里查项目、报进度、看通知。这类题目在计算机毕设里属于“选题稳妥、实现难度适中、论文素材好写”的经典类型前后端分离的结构也方便你分阶段完成。即便你之前没碰过小程序开发只要按这条路走两到三周把核心功能跑通完全可行。我更建议把这个项目当成一次完整的全栈实践来做下面这套从架构、数据库、接口到小程序端的完整拆解能帮你少走很多弯路。1. 项目整体架构与设计思路1.1 技术选型为什么是 Python Flask 微信小程序选技术栈是毕设里的第一个决策也是很多同学纠结最久的地方。说实话这个项目用 Python Flask 并不因为它性能有多强主要是三个字好写、好讲、好过。Python 语法简单对没写过几万行代码的同学来说用 Flask 写接口比用 Java 的 SpringBoot 要容易上手得多。Flask 本身是轻量级框架核心只有路由和请求处理配上 flask_sqlalchemy 操作数据库、flask_cors 解决跨域基本就够用了。更关键的是Flask 的中文资料极其丰富你遇到的绝大多数坑别人早就踩过并且留下了解决方案这对毕设阶段的节奏非常重要。我不止一次跟学弟学妹说毕设最怕的不是题难而是卡在一个奇怪的问题上几天出不来选一个社区活跃的框架能帮你把这种风险降到最低。微信小程序选原生开发而不是 uni-app 或 Vue理由更实际。小程序原生框架的组件和 API 就是最标准的教程多、坑少在微信开发者工具里调试也直观。虽然 uni-app 跨平台看起来很香但对你这种只需要出一个小程序端的毕设来说反而多了一层编译过程出了问题排查难度更大。记住毕设的目标是按时交付一个能演示、能讲清楚的项目不是展示你用了多少前沿技术栈。1.2 业务边界前台小程序到底要管哪些事这里需要先明确“前台”这个词。在毕设题目里一般会分成“管理后台”和“小程序前台”两个端。CR 公司的管理员通过管理后台维护项目信息、发布通知、审核进度员工则通过小程序前台查看项目、上报工作日志、接收通知。你拿到的题目写的是“前台”意味着核心工作量在小程序端但后端接口是你自己写来为小程序服务的所以前后端思维都要有。在这个前提下前台小程序的功能可以拆成下面几个模块登录注册模块微信授权一键登录服务端生成 token 返回前端首页项目展示模块轮播图、项目分类、项目列表、项目详情进度上报模块填写工作日志、上传现场图片、查看项目进度时间线消息通知模块系统通知、项目变更提醒个人中心模块个人信息维护、我的上报记录、退出登录很容易犯的一个错误是觉得小程序前台只有“展示”功能不需要处理“写”操作。实际上进度上报、工作日志这些模块都要在小程序端完成所以数据库设计时表结构要能支撑前台所有的增删改查不能只设计成只读架构。你要从一开始就清楚这个“前台”不是一个展示型门户而是一个有真实业务操作的员工工具。1.3 前后端分离架构与数据流向整体架构就是最标准的前后端分离微信小程序前端通过 HTTP 请求访问 Flask 接口后端Flask 再操作 MySQL 数据库。数据流向是单向的小程序端不直接连数据库所有数据操作都走后端接口。这个架构里有几个关键点要提前想明白小程序的 wx.request 请求域名必须是 HTTPS 且完成备案但在开发阶段可以勾选“不校验合法域名”来绕过限制直接请求本地后端。Flask 返回的数据格式建议统一为{code: 0, msg: ok, data: xxx}code 为 0 表示成功非 0 表示失败。这样小程序端处理响应时只需判断 code逻辑统一又简单。时间、金额这类格式化的任务放在后端完成不要把格式化的逻辑散落在小程序各个页面里。后面我会详细讲为什么这样做能帮你省掉一大半的联调时间。2. 数据库设计与后端接口实现2.1 核心数据表设计我第一次做这类项目的时候上来就把表设计得非常复杂权限表、角色表、菜单表全都加上结果把自己绕晕了。后来把设计精简之后反倒顺手很多。个人建议这套系统先保证这几张表表名用途关键字段user 用户表存储员工信息id, openid, username, password, real_name, phone, role, avatar, create_timeproject 项目表存储项目基本信息id, name, code, type, status, progress, manager, start_date, end_date, descriptionprogress 进度表记录项目进度节点id, project_id, title, description, create_time, creatorwork_log 工作日志表员工上报的工作日志id, project_id, user_id, content, images, work_datenotice 通知表系统通知id, title, content, target_role, create_timebanner 轮播图表首页轮播图id, image_url, link_url, sort项目表里的 progress 字段用来存项目的整体进度百分比是一个 0 到 100 的整数前端用进度条组件展示非常方便。进度表则记录每一次具体的进度更新比如“完成主体结构施工”“通过水电验收”这样项目详情页就能形成一条清晰的时间线。关于字段命名我建议统一用下划线风格。这样做的好处有两个一是和 Python 代码中 SQLAlchemy 模型属性对应起来更顺手二是前端小程序里读取数据时字段名一目了然。等到写论文的时候你会发现清晰的字段命名能让数据库设计章节好写很多评审老师看着也舒服。2.2 Flask 路由拆分与蓝图Flask 项目不推荐把所有接口写在一个 py 文件里哪怕你只有十几个接口也要用蓝图Blueprint拆开。实际工作里没人会把一堆路由堆在 app.py 里毕设论文里如果出现一个几百行的 app.py老师一眼就能看出你没有工程化意识。推荐的目录结构是这样cr_project/ ├── app.py # 入口文件创建 app 并注册蓝图 ├── config.py # 数据库连接等配置 ├── models.py # SQLAlchemy 模型定义 ├── blueprints/ │ ├── __init__.py │ ├── auth.py # 登录注册相关 │ ├── project.py # 项目相关 │ ├── log.py # 日志上报相关 │ └── notice.py # 通知相关 ├── requirements.txt └── cr_project.sql # 数据库初始化脚本接口设计遵循 REST 风格路径用名词复数方法表示操作类型POST /api/auth/login 提交 code 换 tokenGET /api/project/list 获取项目列表GET /api/project/detail 获取项目详情POST /api/log/create 新建工作日志GET /api/notice/list 获取通知列表蓝图的注册方式也不复杂在 app.py 里导入蓝图对象然后 register_blueprint。每个蓝图内部用url_prefix统一路径前缀这样每个模块只需关注自己内部的相对路径。后面的实操章节我会给出完整代码。2.3 登录鉴权与 token 机制这是整个后端最容易踩坑的地方。小程序端没有 cookie 这个概念不能像传统 Web 项目那样用 session 认证必须用 token 方式。完整流程是用户通过 wx.login 拿到临时 code传到后端后端拿 code 加上小程序的 appid 和 secret 去微信接口换取 openid用 openid 去 user 表查询查不到就自动注册一个新用户最后生成一个 token 返回给前端。前端拿到 token 后存到本地 storage 里之后每次请求在 header 里带上 Authorization 字段后端写一个装饰器统一校验。这个流程是标准做法答辩时老师最喜欢追问的就是登录这一块尤其是“token 过期了怎么办”和“为什么小程序不能用 session”。你只需要回答清楚这两点这一环节基本就稳了。至于 token 本身怎么生成毕设阶段不用整太复杂。用 hashlib 生成一个随机字符串存到数据库或作为通用凭证逻辑直观又好讲。如果项目要求更高可以用 PyJWT 签一个带过期时间的 token但这对毕设来说不是必须的。3. 微信小程序前台实现细节3.1 页面规划与目录结构微信小程序原生开发要掌握四块内容WXML 写结构、WXSS 写样式、JS 写逻辑、JSON 写配置。对于这套系统小程序端建议规划这些页面页面路径功能首页pages/index/index轮播图、项目推荐、快捷入口项目列表pages/project/list项目分类筛选、列表展示项目详情pages/project/detail项目信息、进度时间线、日志记录上报日志pages/log/create选择项目、填写内容、上传图片个人中心pages/mine/mine用户信息、我的上报、退出登录在 app.json 中配置页面路由和 tabBartabBar 一般设置三个首页、项目、我的。图标可以自己找一组简单的 PNG 放到 images 目录下也可以用微信官方提供的图标这里不用花太多时间。一个容易忽略的点是页面路径不要设得太深小程序页面栈有最多十层的限制。项目详情里如果有嵌套页面建议用组件或者模板判断来实现不要真的把一个流程拆成四五个页面跳来跳去否则用户操作起来也累。3.2 登录流程实战代码解析小程序端最典型的一条流程是用户进入小程序先走登录再进入首页加载项目列表。wx.login 获取到的 code 有效期只有 5 分钟拿到之后要尽快传给后端。后端用 code 换 openidopenid 是用户在小程序里的唯一标识用它去 user 表里查查不到就自动注册。登录逻辑在小程序端可以这样写// pages/index/index.js const app getApp() Page({ data: { projects: [] }, onLoad() { this.checkLogin() }, checkLogin() { const token wx.getStorageSync(token) if (!token) { this.wxLogin() } else { this.fetchProjects() } }, wxLogin() { wx.login({ success: (res) { wx.request({ url: http://localhost:5000/api/auth/login, method: POST, data: { code: res.code }, success: (resp) { const data resp.data.data wx.setStorageSync(token, data.token) wx.setStorageSync(userInfo, data.user) this.fetchProjects() } }) } }) }, fetchProjects() { const request require(../../utils/request) request(/project/list).then((data) { this.setData({ projects: data }) }) } })这段代码涵盖了登录、存储 token、拉取首页数据的完整流程。这里有个细节要提一下不要每次 onLoad 都强制走 wx.login先检查本地有没有 token有就直接用没有才走登录流程。否则用户每次打开小程序都白屏转圈等登录体验很糟糕。对应地后端的登录接口用一个简单但完整的例子来说明from flask import Blueprint, request, jsonify import requests, time, hashlib from models import User, db auth_bp Blueprint(auth, __name__) auth_bp.route(/login, methods[POST]) def login(): data request.get_json() code data.get(code) resp requests.get( https://api.weixin.qq.com/sns/jscode2session, params{ appid: 你的appid, secret: 你的secret, js_code: code, grant_type: authorization_code } ).json() openid resp.get(openid) if not openid: return jsonify({code: 1, msg: 微信登录失败}) user User.query.filter_by(openidopenid).first() if not user: user User(openidopenid, username用户 openid[-4:]) db.session.add(user) db.session.commit() token hashlib.md5((openid str(time.time())).encode()).hexdigest() return jsonify({code: 0, msg: ok, data: {token: token, user: user.to_dict()}})这里用 requests 库去请求微信的 jscode2session 接口换取 openid是标准流程。开发时可以用wx.setStorageSync手动存一个测试 token后端配合做一个模拟登录接口这样不依赖微信服务器也能前后端联调。3.3 请求封装与全局配置小程序里每个页面都要发请求如果每个页面都写一遍完整的 wx.request代码会非常冗余而且改接口地址时要全局替换很容易漏。建议封装一个 request 工具放到 utils 目录下统一处理 baseURL、token 注入和错误提示。// utils/request.js const BASE_URL http://localhost:5000/api const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method: method, data: data, header: { Content-Type: application/json, Authorization: Bearer wx.getStorageSync(token) }, success: (res) { if (res.data.code 0) { resolve(res.data.data) } else { wx.showToast({ title: res.data.msg, icon: none }) reject(res.data) } }, fail: (err) { wx.showToast({ title: 网络异常, icon: none }) reject(err) } }) }) } module.exports { request }封装之后页面的请求代码就简洁多了只需要request(/project/list).then(...)就能拿到数据。遇到 token 过期、session 失效这类全局问题也可以在封装里统一拦截处理比如跳转到登录页或者重新走 wx.login。我在很多项目里都坚持这个习惯请求层必须统一封装不管项目大小。这不只是为了少写几行代码更重要的是把鉴权逻辑收敛到一个地方排查问题时只需要看一个文件就够了。4. 实操过程从零搭建的关键步骤4.1 Flask 后端骨架搭建不管你有没有写过 Flask建议按下面的方式搭骨架容错率最高。先创建项目目录用虚拟环境管理依赖避免污染全局环境mkdir cr_project cd cr_project python -m venv venv # Windows 激活venv\Scripts\activate # Mac/Linux 激活source venv/bin/activate pip install flask flask_sqlalchemy flask_cors pymysql然后创建 config.py 配置文件import os class Config: SECRET_KEY cr-project-secret-key SQLALCHEMY_DATABASE_URI mysqlpymysql://root:123456localhost:3306/cr_project SQLALCHEMY_TRACK_MODIFICATIONS False TOKEN_EXPIRES 7 * 24 * 3600这里有个容易踩的坑MySQL 连接字符串里的密码如果包含 或者其他特殊字符必须做 URL 编码否则 pymysql 解析连接串时会报错。大多数毕设项目的密码都比较简单遇不到这个问题但一旦遇到就很难排查写在这里给大家提个醒。接下来是 models.py以 User 模型为例from flask_sqlalchemy import SQLAlchemy from datetime import datetime db SQLAlchemy() class User(db.Model): __tablename__ user id db.Column(db.Integer, primary_keyTrue) openid db.Column(db.String(64), uniqueTrue, nullableFalse) username db.Column(db.String(50)) password db.Column(db.String(128)) real_name db.Column(db.String(20)) phone db.Column(db.String(20)) role db.Column(db.String(10), default员工) avatar db.Column(db.String(255)) create_time db.Column(db.DateTime, defaultdatetime.now) def to_dict(self): return { id: self.id, username: self.username, real_name: self.real_name, phone: self.phone, role: self.role, avatar: self.avatar }app.py 入口文件from flask import Flask from flask_cors import CORS from config import Config from models import db app Flask(__name__) app.config.from_object(Config) db.init_app(app) CORS(app) from blueprints.auth import auth_bp from blueprints.project import project_bp from blueprints.log import log_bp from blueprints.notice import notice_bp app.register_blueprint(auth_bp, url_prefix/api/auth) app.register_blueprint(project_bp, url_prefix/api/project) app.register_blueprint(log_bp, url_prefix/api/log) app.register_blueprint(notice_bp, url_prefix/api/notice) if __name__ __main__: app.run(host0.0.0.0, port5000, debugTrue)注意 host 一定要设为 0.0.0.0这样微信开发者工具和手机真机才能访问到你电脑上的服务。用 Flask 自带的开发服务器跑毕设完全够用不用上 gunicorn 或者 uWSGI没必要在这个阶段增加复杂度。4.2 小程序端核心页面实现微信开发者工具导入项目时AppID 可以选择测试号不影响开发调试。pages 目录会自动生成我们只要在 app.json 里配置页面路由和 tabBar 即可。首页的 WXML 大致是这个结构view classpage view classbanner swiper indicator-dots autoplay circular swiper-item wx:for{{banners}} wx:keyid image src{{item.image_url}} classbanner-img modeaspectFill / /swiper-item /swiper /view view classsection-title进行中的项目/view view classproject-list view classproject-card wx:for{{projects}} wx:keyid bindtapgoDetail>def format_time(value): return value.strftime(%Y-%m-%d %H:%M) if value else 这样前端拿到的时间字符串直接展示即可不需要再写一层 formatTime 函数。把所有格式化的逻辑集中在后端小程序端只负责展示是减少联调摩擦最有效的方式。5.3 常见问题速查表下面的表格是这套系统开发和调试过程中的高频问题汇总每一行都是我或者我带的学生实际遇到过的建议收藏备用问题现象可能原因解决方案小程序请求一直转圈未勾选不校验合法域名开发者工具详情-本地设置勾选对应选项后端收到请求但前端报跨域错误后端未开启 CORS安装 flask_cors 并 CORS(app)真机请求失败但开发者工具正常IP 地址配置错误将请求地址改为电脑局域网 IP登录后接口仍然 401header 字段名不一致或 token 过期统一为 Authorization 字段检查有效期图片上传后显示不出来返回的是本地路径后端提供静态访问路由或存网络 URL中文乱码MySQL 字符集不是 utf8建库时指定 utf8mb4连接串加 charset 参数很多坑不是理论上看一遍就能避免的必须亲手踩过才有记忆。这个速查表的价值就在于此你遇到问题时不用重新查一遍资料直接对照着排查能省下大半天时间。6. 论文写作与答辩准备6.1 开题报告和论文的结构安排论文这部分很多同学最容易犯的错误是直接抄博客无脑堆技术名词评审老师一眼就能看出来。稍微想想就能明白你的程序是自己写的论文反而比程序更不应该“复制粘贴”。建议的结构安排是第 2 章写系统相关技术介绍第 3 章写需求分析第 4 章写系统设计第 5 章写系统实现与测试。技术介绍部分不用篇幅太长挑重点写清楚 Flask 框架的特点、微信小程序开发模式、MySQL 数据库的基础概念就好。真正的得分点在需求分析和系统设计这两章要把业务想透再落笔。需求分析里要从 CR 公司项目管理真实场景出发列出功能需求与非功能需求系统设计里要把数据库表的字段含义、接口的入参出参、页面跳转关系都整理清楚。开题报告的写法也要讲究。重点放在研究背景和意义、国内外研究现状、研究内容和方法、技术路线四块。研究背景可以从企业内部项目信息管理的痛点切入信息分散在 Excel 和微信群、进度不透明、汇报流程冗长、数据难以沉淀。研究现状要提一下国内外项目管理信息化的发展趋势以及当前微信小程序在移动办公中的普及情况。技术路线写清楚从需求分析、数据库设计、后端开发、前端开发到系统测试的完整流程每一步做完能产出什么。6.2 答辩高频问题与准备思路答辩时老师最爱问的方向有三个系统技术架构、登录鉴权逻辑、数据库设计。这些问题不是故意刁难你而是想确认这个项目是不是你亲手做的、你有没有真正理解自己的代码。技术架构方面准备好一句话概括这是一个前后端分离的架构小程序负责展示和交互Flask 提供 RESTful APIMySQL 存储数据前后端通过 HTTP 协议进行通信。老师接着追问的可能是“为什么不用 SpringBoot 或者 Django”这时候你要答出 Flask 轻量灵活、上手快、适合小型业务系统这几个点同时诚实承认它的局限反而显得你理解更深入。登录鉴权方面准备好你画过的那个流程小程序的 wx.login 拿到 code传给后端换取 openidopenid 去用户表查询判断是否注册生成 token 返回前端存储 token 并在后续请求中携带。老师问“token 过期怎么办”你就答设置有效期过期后前端检测到 401 自动重新走 login 流程。问“为什么不用 session”你就答小程序没有传统 cookie/session 机制且微信要求开发者在服务端自行管理登录态token 方式更合适。数据库设计方面准备好解释每一张表的作用尤其是 user 表和 project 表之间的关联、work_log 表通过 project_id 和 user_id 关联项目和用户这两处。如果老师问“项目进度和日志有什么区别”你要回答清楚进度是项目维度的里程碑节点日志是员工维度的工作记录二者都可以展示在项目详情页里但语义不同、统计口径不同。答辩还有一个加分细节准备一个可以现场演示的测试账号和数据。把项目数据库提前填充好足够多的真实感数据比如三四个进行中的项目、每个项目配套几条进度记录、若干条工作日志和通知。演示时先走一遍登录流程然后挨个展示查项目、看进度、上报日志、收通知这几个核心操作。整个过程流畅比你说一百句话都管用。把刚才提到的所有环节从 0 到 1 完整跑通一遍你会发现自己对 Flask 的理解、对小程序的熟悉程度、对前后端协作的认识都会上一个台阶。这里分享一个我反复强调的建议先把项目列表和登录这两个核心功能打通再往上面加进度上报、通知、个人中心这些周边模块不要一上来就想着一次做完。我见过不少同学一开始把数据库十几张表全部设计好结果刚写完两张表就想放弃。毕设的本质是训练你把一个实际问题拆解成可执行的模块并且按时交付这套系统做完你不光拿到了程序和论文前面积累的那套调试习惯和排错思路才是真正能带走的东西。 
长河君 · 2026/10/3 13:11:02 · 阅读 1.2k 基于Python Flask与微信小程序的项目管理系统设计与实现全攻略
如果你正在为毕设选题发愁看到“基于PythonFlask框架的微信小程序CR公司建设项目信息管理系统前台”这个题目大概率是既想做一个能真正跑起来的项目又担心工作量失控收不了尾。我先给你吃颗定心丸这个题目的核心并不复杂本质就是一个用微信小程序做用户端、Python的Flask框架做后端接口的公司内部项目管理系统说人话就是让CR公司的员工在小程序里查项目、报进度、看通知。这类题目在计算机毕设里属于“选题稳妥、实现难度适中、论文素材好写”的经典类型前后端分离的结构也方便你分阶段完成。即便你之前没碰过小程序开发只要按这条路走两到三周把核心功能跑通完全可行。我更建议把这个项目当成一次完整的全栈实践来做下面这套从架构、数据库、接口到小程序端的完整拆解能帮你少走很多弯路。1. 项目整体架构与设计思路1.1 技术选型为什么是 Python Flask 微信小程序选技术栈是毕设里的第一个决策也是很多同学纠结最久的地方。说实话这个项目用 Python Flask 并不因为它性能有多强主要是三个字好写、好讲、好过。Python 语法简单对没写过几万行代码的同学来说用 Flask 写接口比用 Java 的 SpringBoot 要容易上手得多。Flask 本身是轻量级框架核心只有路由和请求处理配上 flask_sqlalchemy 操作数据库、flask_cors 解决跨域基本就够用了。更关键的是Flask 的中文资料极其丰富你遇到的绝大多数坑别人早就踩过并且留下了解决方案这对毕设阶段的节奏非常重要。我不止一次跟学弟学妹说毕设最怕的不是题难而是卡在一个奇怪的问题上几天出不来选一个社区活跃的框架能帮你把这种风险降到最低。微信小程序选原生开发而不是 uni-app 或 Vue理由更实际。小程序原生框架的组件和 API 就是最标准的教程多、坑少在微信开发者工具里调试也直观。虽然 uni-app 跨平台看起来很香但对你这种只需要出一个小程序端的毕设来说反而多了一层编译过程出了问题排查难度更大。记住毕设的目标是按时交付一个能演示、能讲清楚的项目不是展示你用了多少前沿技术栈。1.2 业务边界前台小程序到底要管哪些事这里需要先明确“前台”这个词。在毕设题目里一般会分成“管理后台”和“小程序前台”两个端。CR 公司的管理员通过管理后台维护项目信息、发布通知、审核进度员工则通过小程序前台查看项目、上报工作日志、接收通知。你拿到的题目写的是“前台”意味着核心工作量在小程序端但后端接口是你自己写来为小程序服务的所以前后端思维都要有。在这个前提下前台小程序的功能可以拆成下面几个模块登录注册模块微信授权一键登录服务端生成 token 返回前端首页项目展示模块轮播图、项目分类、项目列表、项目详情进度上报模块填写工作日志、上传现场图片、查看项目进度时间线消息通知模块系统通知、项目变更提醒个人中心模块个人信息维护、我的上报记录、退出登录很容易犯的一个错误是觉得小程序前台只有“展示”功能不需要处理“写”操作。实际上进度上报、工作日志这些模块都要在小程序端完成所以数据库设计时表结构要能支撑前台所有的增删改查不能只设计成只读架构。你要从一开始就清楚这个“前台”不是一个展示型门户而是一个有真实业务操作的员工工具。1.3 前后端分离架构与数据流向整体架构就是最标准的前后端分离微信小程序前端通过 HTTP 请求访问 Flask 接口后端Flask 再操作 MySQL 数据库。数据流向是单向的小程序端不直接连数据库所有数据操作都走后端接口。这个架构里有几个关键点要提前想明白小程序的 wx.request 请求域名必须是 HTTPS 且完成备案但在开发阶段可以勾选“不校验合法域名”来绕过限制直接请求本地后端。Flask 返回的数据格式建议统一为{code: 0, msg: ok, data: xxx}code 为 0 表示成功非 0 表示失败。这样小程序端处理响应时只需判断 code逻辑统一又简单。时间、金额这类格式化的任务放在后端完成不要把格式化的逻辑散落在小程序各个页面里。后面我会详细讲为什么这样做能帮你省掉一大半的联调时间。2. 数据库设计与后端接口实现2.1 核心数据表设计我第一次做这类项目的时候上来就把表设计得非常复杂权限表、角色表、菜单表全都加上结果把自己绕晕了。后来把设计精简之后反倒顺手很多。个人建议这套系统先保证这几张表表名用途关键字段user 用户表存储员工信息id, openid, username, password, real_name, phone, role, avatar, create_timeproject 项目表存储项目基本信息id, name, code, type, status, progress, manager, start_date, end_date, descriptionprogress 进度表记录项目进度节点id, project_id, title, description, create_time, creatorwork_log 工作日志表员工上报的工作日志id, project_id, user_id, content, images, work_datenotice 通知表系统通知id, title, content, target_role, create_timebanner 轮播图表首页轮播图id, image_url, link_url, sort项目表里的 progress 字段用来存项目的整体进度百分比是一个 0 到 100 的整数前端用进度条组件展示非常方便。进度表则记录每一次具体的进度更新比如“完成主体结构施工”“通过水电验收”这样项目详情页就能形成一条清晰的时间线。关于字段命名我建议统一用下划线风格。这样做的好处有两个一是和 Python 代码中 SQLAlchemy 模型属性对应起来更顺手二是前端小程序里读取数据时字段名一目了然。等到写论文的时候你会发现清晰的字段命名能让数据库设计章节好写很多评审老师看着也舒服。2.2 Flask 路由拆分与蓝图Flask 项目不推荐把所有接口写在一个 py 文件里哪怕你只有十几个接口也要用蓝图Blueprint拆开。实际工作里没人会把一堆路由堆在 app.py 里毕设论文里如果出现一个几百行的 app.py老师一眼就能看出你没有工程化意识。推荐的目录结构是这样cr_project/ ├── app.py # 入口文件创建 app 并注册蓝图 ├── config.py # 数据库连接等配置 ├── models.py # SQLAlchemy 模型定义 ├── blueprints/ │ ├── __init__.py │ ├── auth.py # 登录注册相关 │ ├── project.py # 项目相关 │ ├── log.py # 日志上报相关 │ └── notice.py # 通知相关 ├── requirements.txt └── cr_project.sql # 数据库初始化脚本接口设计遵循 REST 风格路径用名词复数方法表示操作类型POST /api/auth/login 提交 code 换 tokenGET /api/project/list 获取项目列表GET /api/project/detail 获取项目详情POST /api/log/create 新建工作日志GET /api/notice/list 获取通知列表蓝图的注册方式也不复杂在 app.py 里导入蓝图对象然后 register_blueprint。每个蓝图内部用url_prefix统一路径前缀这样每个模块只需关注自己内部的相对路径。后面的实操章节我会给出完整代码。2.3 登录鉴权与 token 机制这是整个后端最容易踩坑的地方。小程序端没有 cookie 这个概念不能像传统 Web 项目那样用 session 认证必须用 token 方式。完整流程是用户通过 wx.login 拿到临时 code传到后端后端拿 code 加上小程序的 appid 和 secret 去微信接口换取 openid用 openid 去 user 表查询查不到就自动注册一个新用户最后生成一个 token 返回给前端。前端拿到 token 后存到本地 storage 里之后每次请求在 header 里带上 Authorization 字段后端写一个装饰器统一校验。这个流程是标准做法答辩时老师最喜欢追问的就是登录这一块尤其是“token 过期了怎么办”和“为什么小程序不能用 session”。你只需要回答清楚这两点这一环节基本就稳了。至于 token 本身怎么生成毕设阶段不用整太复杂。用 hashlib 生成一个随机字符串存到数据库或作为通用凭证逻辑直观又好讲。如果项目要求更高可以用 PyJWT 签一个带过期时间的 token但这对毕设来说不是必须的。3. 微信小程序前台实现细节3.1 页面规划与目录结构微信小程序原生开发要掌握四块内容WXML 写结构、WXSS 写样式、JS 写逻辑、JSON 写配置。对于这套系统小程序端建议规划这些页面页面路径功能首页pages/index/index轮播图、项目推荐、快捷入口项目列表pages/project/list项目分类筛选、列表展示项目详情pages/project/detail项目信息、进度时间线、日志记录上报日志pages/log/create选择项目、填写内容、上传图片个人中心pages/mine/mine用户信息、我的上报、退出登录在 app.json 中配置页面路由和 tabBartabBar 一般设置三个首页、项目、我的。图标可以自己找一组简单的 PNG 放到 images 目录下也可以用微信官方提供的图标这里不用花太多时间。一个容易忽略的点是页面路径不要设得太深小程序页面栈有最多十层的限制。项目详情里如果有嵌套页面建议用组件或者模板判断来实现不要真的把一个流程拆成四五个页面跳来跳去否则用户操作起来也累。3.2 登录流程实战代码解析小程序端最典型的一条流程是用户进入小程序先走登录再进入首页加载项目列表。wx.login 获取到的 code 有效期只有 5 分钟拿到之后要尽快传给后端。后端用 code 换 openidopenid 是用户在小程序里的唯一标识用它去 user 表里查查不到就自动注册。登录逻辑在小程序端可以这样写// pages/index/index.js const app getApp() Page({ data: { projects: [] }, onLoad() { this.checkLogin() }, checkLogin() { const token wx.getStorageSync(token) if (!token) { this.wxLogin() } else { this.fetchProjects() } }, wxLogin() { wx.login({ success: (res) { wx.request({ url: http://localhost:5000/api/auth/login, method: POST, data: { code: res.code }, success: (resp) { const data resp.data.data wx.setStorageSync(token, data.token) wx.setStorageSync(userInfo, data.user) this.fetchProjects() } }) } }) }, fetchProjects() { const request require(../../utils/request) request(/project/list).then((data) { this.setData({ projects: data }) }) } })这段代码涵盖了登录、存储 token、拉取首页数据的完整流程。这里有个细节要提一下不要每次 onLoad 都强制走 wx.login先检查本地有没有 token有就直接用没有才走登录流程。否则用户每次打开小程序都白屏转圈等登录体验很糟糕。对应地后端的登录接口用一个简单但完整的例子来说明from flask import Blueprint, request, jsonify import requests, time, hashlib from models import User, db auth_bp Blueprint(auth, __name__) auth_bp.route(/login, methods[POST]) def login(): data request.get_json() code data.get(code) resp requests.get( https://api.weixin.qq.com/sns/jscode2session, params{ appid: 你的appid, secret: 你的secret, js_code: code, grant_type: authorization_code } ).json() openid resp.get(openid) if not openid: return jsonify({code: 1, msg: 微信登录失败}) user User.query.filter_by(openidopenid).first() if not user: user User(openidopenid, username用户 openid[-4:]) db.session.add(user) db.session.commit() token hashlib.md5((openid str(time.time())).encode()).hexdigest() return jsonify({code: 0, msg: ok, data: {token: token, user: user.to_dict()}})这里用 requests 库去请求微信的 jscode2session 接口换取 openid是标准流程。开发时可以用wx.setStorageSync手动存一个测试 token后端配合做一个模拟登录接口这样不依赖微信服务器也能前后端联调。3.3 请求封装与全局配置小程序里每个页面都要发请求如果每个页面都写一遍完整的 wx.request代码会非常冗余而且改接口地址时要全局替换很容易漏。建议封装一个 request 工具放到 utils 目录下统一处理 baseURL、token 注入和错误提示。// utils/request.js const BASE_URL http://localhost:5000/api const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: BASE_URL url, method: method, data: data, header: { Content-Type: application/json, Authorization: Bearer wx.getStorageSync(token) }, success: (res) { if (res.data.code 0) { resolve(res.data.data) } else { wx.showToast({ title: res.data.msg, icon: none }) reject(res.data) } }, fail: (err) { wx.showToast({ title: 网络异常, icon: none }) reject(err) } }) }) } module.exports { request }封装之后页面的请求代码就简洁多了只需要request(/project/list).then(...)就能拿到数据。遇到 token 过期、session 失效这类全局问题也可以在封装里统一拦截处理比如跳转到登录页或者重新走 wx.login。我在很多项目里都坚持这个习惯请求层必须统一封装不管项目大小。这不只是为了少写几行代码更重要的是把鉴权逻辑收敛到一个地方排查问题时只需要看一个文件就够了。4. 实操过程从零搭建的关键步骤4.1 Flask 后端骨架搭建不管你有没有写过 Flask建议按下面的方式搭骨架容错率最高。先创建项目目录用虚拟环境管理依赖避免污染全局环境mkdir cr_project cd cr_project python -m venv venv # Windows 激活venv\Scripts\activate # Mac/Linux 激活source venv/bin/activate pip install flask flask_sqlalchemy flask_cors pymysql然后创建 config.py 配置文件import os class Config: SECRET_KEY cr-project-secret-key SQLALCHEMY_DATABASE_URI mysqlpymysql://root:123456localhost:3306/cr_project SQLALCHEMY_TRACK_MODIFICATIONS False TOKEN_EXPIRES 7 * 24 * 3600这里有个容易踩的坑MySQL 连接字符串里的密码如果包含 或者其他特殊字符必须做 URL 编码否则 pymysql 解析连接串时会报错。大多数毕设项目的密码都比较简单遇不到这个问题但一旦遇到就很难排查写在这里给大家提个醒。接下来是 models.py以 User 模型为例from flask_sqlalchemy import SQLAlchemy from datetime import datetime db SQLAlchemy() class User(db.Model): __tablename__ user id db.Column(db.Integer, primary_keyTrue) openid db.Column(db.String(64), uniqueTrue, nullableFalse) username db.Column(db.String(50)) password db.Column(db.String(128)) real_name db.Column(db.String(20)) phone db.Column(db.String(20)) role db.Column(db.String(10), default员工) avatar db.Column(db.String(255)) create_time db.Column(db.DateTime, defaultdatetime.now) def to_dict(self): return { id: self.id, username: self.username, real_name: self.real_name, phone: self.phone, role: self.role, avatar: self.avatar }app.py 入口文件from flask import Flask from flask_cors import CORS from config import Config from models import db app Flask(__name__) app.config.from_object(Config) db.init_app(app) CORS(app) from blueprints.auth import auth_bp from blueprints.project import project_bp from blueprints.log import log_bp from blueprints.notice import notice_bp app.register_blueprint(auth_bp, url_prefix/api/auth) app.register_blueprint(project_bp, url_prefix/api/project) app.register_blueprint(log_bp, url_prefix/api/log) app.register_blueprint(notice_bp, url_prefix/api/notice) if __name__ __main__: app.run(host0.0.0.0, port5000, debugTrue)注意 host 一定要设为 0.0.0.0这样微信开发者工具和手机真机才能访问到你电脑上的服务。用 Flask 自带的开发服务器跑毕设完全够用不用上 gunicorn 或者 uWSGI没必要在这个阶段增加复杂度。4.2 小程序端核心页面实现微信开发者工具导入项目时AppID 可以选择测试号不影响开发调试。pages 目录会自动生成我们只要在 app.json 里配置页面路由和 tabBar 即可。首页的 WXML 大致是这个结构view classpage view classbanner swiper indicator-dots autoplay circular swiper-item wx:for{{banners}} wx:keyid image src{{item.image_url}} classbanner-img modeaspectFill / /swiper-item /swiper /view view classsection-title进行中的项目/view view classproject-list view classproject-card wx:for{{projects}} wx:keyid bindtapgoDetail>def format_time(value): return value.strftime(%Y-%m-%d %H:%M) if value else 这样前端拿到的时间字符串直接展示即可不需要再写一层 formatTime 函数。把所有格式化的逻辑集中在后端小程序端只负责展示是减少联调摩擦最有效的方式。5.3 常见问题速查表下面的表格是这套系统开发和调试过程中的高频问题汇总每一行都是我或者我带的学生实际遇到过的建议收藏备用问题现象可能原因解决方案小程序请求一直转圈未勾选不校验合法域名开发者工具详情-本地设置勾选对应选项后端收到请求但前端报跨域错误后端未开启 CORS安装 flask_cors 并 CORS(app)真机请求失败但开发者工具正常IP 地址配置错误将请求地址改为电脑局域网 IP登录后接口仍然 401header 字段名不一致或 token 过期统一为 Authorization 字段检查有效期图片上传后显示不出来返回的是本地路径后端提供静态访问路由或存网络 URL中文乱码MySQL 字符集不是 utf8建库时指定 utf8mb4连接串加 charset 参数很多坑不是理论上看一遍就能避免的必须亲手踩过才有记忆。这个速查表的价值就在于此你遇到问题时不用重新查一遍资料直接对照着排查能省下大半天时间。6. 论文写作与答辩准备6.1 开题报告和论文的结构安排论文这部分很多同学最容易犯的错误是直接抄博客无脑堆技术名词评审老师一眼就能看出来。稍微想想就能明白你的程序是自己写的论文反而比程序更不应该“复制粘贴”。建议的结构安排是第 2 章写系统相关技术介绍第 3 章写需求分析第 4 章写系统设计第 5 章写系统实现与测试。技术介绍部分不用篇幅太长挑重点写清楚 Flask 框架的特点、微信小程序开发模式、MySQL 数据库的基础概念就好。真正的得分点在需求分析和系统设计这两章要把业务想透再落笔。需求分析里要从 CR 公司项目管理真实场景出发列出功能需求与非功能需求系统设计里要把数据库表的字段含义、接口的入参出参、页面跳转关系都整理清楚。开题报告的写法也要讲究。重点放在研究背景和意义、国内外研究现状、研究内容和方法、技术路线四块。研究背景可以从企业内部项目信息管理的痛点切入信息分散在 Excel 和微信群、进度不透明、汇报流程冗长、数据难以沉淀。研究现状要提一下国内外项目管理信息化的发展趋势以及当前微信小程序在移动办公中的普及情况。技术路线写清楚从需求分析、数据库设计、后端开发、前端开发到系统测试的完整流程每一步做完能产出什么。6.2 答辩高频问题与准备思路答辩时老师最爱问的方向有三个系统技术架构、登录鉴权逻辑、数据库设计。这些问题不是故意刁难你而是想确认这个项目是不是你亲手做的、你有没有真正理解自己的代码。技术架构方面准备好一句话概括这是一个前后端分离的架构小程序负责展示和交互Flask 提供 RESTful APIMySQL 存储数据前后端通过 HTTP 协议进行通信。老师接着追问的可能是“为什么不用 SpringBoot 或者 Django”这时候你要答出 Flask 轻量灵活、上手快、适合小型业务系统这几个点同时诚实承认它的局限反而显得你理解更深入。登录鉴权方面准备好你画过的那个流程小程序的 wx.login 拿到 code传给后端换取 openidopenid 去用户表查询判断是否注册生成 token 返回前端存储 token 并在后续请求中携带。老师问“token 过期怎么办”你就答设置有效期过期后前端检测到 401 自动重新走 login 流程。问“为什么不用 session”你就答小程序没有传统 cookie/session 机制且微信要求开发者在服务端自行管理登录态token 方式更合适。数据库设计方面准备好解释每一张表的作用尤其是 user 表和 project 表之间的关联、work_log 表通过 project_id 和 user_id 关联项目和用户这两处。如果老师问“项目进度和日志有什么区别”你要回答清楚进度是项目维度的里程碑节点日志是员工维度的工作记录二者都可以展示在项目详情页里但语义不同、统计口径不同。答辩还有一个加分细节准备一个可以现场演示的测试账号和数据。把项目数据库提前填充好足够多的真实感数据比如三四个进行中的项目、每个项目配套几条进度记录、若干条工作日志和通知。演示时先走一遍登录流程然后挨个展示查项目、看进度、上报日志、收通知这几个核心操作。整个过程流畅比你说一百句话都管用。把刚才提到的所有环节从 0 到 1 完整跑通一遍你会发现自己对 Flask 的理解、对小程序的熟悉程度、对前后端协作的认识都会上一个台阶。这里分享一个我反复强调的建议先把项目列表和登录这两个核心功能打通再往上面加进度上报、通知、个人中心这些周边模块不要一上来就想着一次做完。我见过不少同学一开始把数据库十几张表全部设计好结果刚写完两张表就想放弃。毕设的本质是训练你把一个实际问题拆解成可执行的模块并且按时交付这套系统做完你不光拿到了程序和论文前面积累的那套调试习惯和排错思路才是真正能带走的东西。