立项原因，旨在解决什么产品问题
高校校园内每学期产生大量闲置旧书（教材、教辅、考研资料等），学生购买新书成本高，而传统二手交易渠道（校内论坛、QQ群）信息分散、缺乏检索、无信任机制，导致供需匹配效率低下。本项目旨在构建一个基于微信小程序的校园旧书交易平台，为学生提供便捷、安全的旧书发布与查找渠道，降低购书成本，促进资源循环利用。
行业场景，业务背景
随着“互联网+循环经济”在高校的推广，C2C二手交易模式已成为校园生活的重要补充。本项目定位为校内实名制交易平台，用户通过微信授权自动完成身份认证（基于openid），无需额外注册。平台仅服务于本校师生，避免校外广告骚扰。业务涵盖旧书信息发布、多图展示、按专业/价格筛选、个人书架管理等功能，符合大学生移动端使用习惯，具有明确的应用场景和商业价值。
项目有哪些具体功能模块
用户模块：微信一键登录（获取openid）、新用户注册（填写昵称、性别、年级、专业、上传头像）、个人资料修改。
旧书发布模块：支持上传1-6张实物照片、填写书籍标题、描述、价格、所属专业分类。
旧书浏览模块：按发布时间倒序排列、按专业或价格区间筛选、关键词搜索。
书籍详情模块：展示图片轮播、卖家信息（昵称/头像）、商品描述、虚拟联系方式。
个人中心模块：我的发布（编辑/下架）、我买到的记录（预留）。
项目的主要功能描述
用户首次进入小程序时自动触发微信登录，后端通过code换取openid并判断新老用户。新用户需补充个人信息（昵称、性别、年级、专业、头像）方可发布旧书。发布时，用户填写标题、描述、价格，并选择1-6张手机相册图片，后端接收multipart/form-data格式请求，将图片保存到服务器静态目录并生成访问URL，同时将图片URL列表以JSON格式存入数据库。买家在首页可滚动浏览书籍卡片，点击进入详情页查看大图、卖家信息及价格，并通过平台提供的虚拟电话联系卖家（需二次开发）。卖家可在“我的发布”中管理已上架书籍，支持下架或删除。整个流程闭环，无需线下接触即可完成信息撮合
“我”负责哪些具体任务？
我独立完成整个后端服务的设计与开发，包括数据库表结构设计（MySQL）、RESTful API实现、文件存储逻辑、微信登录集成、异步并发优化。同时负责小程序前端部分核心页面的编写（登录页、发布页、首页列表），并与后端联调解决跨域、图片上传422错误等问题。最终将服务部署在云服务器，配置Nginx反向代理与静态资源访问。
项目使用了哪些技术栈、架构，实现上亮点、难点
技术栈：
后端：Python 3.10 + FastAPI + SQLAlchemy 2.0（异步ORM）+ aiomysql + httpx。
数据库：MySQL 8.0。
前端：微信小程序原生框架（WXML + WXSS + JavaScript）。
部署：Ubuntu + Nginx + Supervisor + Docker（可选）。
架构亮点：
全异步架构：从数据库连接（aiomysql）到HTTP客户端（httpx.AsyncClient）均使用async/await，提高并发处理能力。
无状态认证：基于openid识别用户，无需session或JWT，简化小程序端逻辑。
静态文件分离：图片通过FastAPI的StaticFiles挂载，直接由Nginx代理，减轻后端压力。
实现难点与解决方案：
难点1：图片上传时前端使用JSON格式导致422错误。
解决：将Pydantic模型参数拆解为Form(...)和File(...)，要求前端使用multipart/form-data发送请求。
难点2：多图片保存时需保证事务一致性。
解决：先逐一保存图片至磁盘，再写入数据库；若数据库写入失败，手动删除已存图片（实际业务中可接受少量脏数据，通过定时任务清理）。
难点3：微信code2session接口在网络不稳定时可能超时。
解决：添加retry机制（使用tena
评论