志在"疆"来 · XJ-Vcom
西部计划志愿者互助平台 · 产品设计与全栈开发（2026）
简介
面向赴新疆支教的西部计划志愿者的互助平台，可以理解为「生活百科 + 志愿朋友圈」：打开手机即可看到服务地的手绘地图，小卖部、食堂、诊所的位置一目了然；还能浏览民俗科普、政策解读和往届志愿者的经验帖。
本人提出项目并撰写原始需求规格（V0.1.1，2026 年 2 月），负责产品设计；2026 年 7 月起与 AI 编程 Agent 协作，按软件工程流程完成重构与实现。
背景
志愿者初到支教地，普遍面临环境不熟、语言不通、民俗不懂三个问题。需求文档梳理的典型场景包括：
- 刚到支教地，想知道去哪里买生活用品 → 箱庭地图
- 当地居民送来小礼物，不知道如何回应 → 民俗科普
- 已经适应环境，想为下一届写一份支教指南 → 朋友圈 / 民俗上传
- 社区工作人员想给新志愿者一份生活手册 → 民俗 / 朋友圈上传
- 想向有经验的老志愿者请教 → 他人主页联系方式 + 朋友圈留言
产品设计
箱庭地图
地图是本产品的核心设计决策。偏远服务地往往没有精细的商业地图，因此不接入地图 SDK，而是采用「纯图 + 像素坐标」模型：每个服务地由管理员上传一张手绘图或平面图作为底图，用户直接在图上按像素坐标标注设施；定位只用来判断用户所在的服务地并切换对应底图。
技术实现
| 用户端 | uni-app + Vue 3 + TypeScript + Pinia，一套代码编译为 H5 与微信小程序 |
|---|---|
| 管理端 | 独立的 PC 网页端：审核台、举报处理、敏感词与审核策略、用户与地理信息管理、数据统计 |
| 后端 | Spring Boot 3.2 + Java 21 + MyBatis-Plus，按领域拆分为认证、内容、地图、审核、通知、后台、地理 7 个模块 |
| 数据 | MySQL 8（21 张表）· Redis（限频、Token 黑名单）· 对象存储；Docker Compose 单机部署 |
| 安全与合规 | JWT 双密钥隔离用户端与管理端；登录失败限频；上传图片校验文件头并清除 EXIF；需求阶段对照个人信息保护法与未成年人保护相关要求设计数据边界 |
开发流程
按「需求分析 → 架构 / 接口 / 数据库 / 模块详细设计 → 编码 → 白盒测试 → 设计与代码差异审查 → 种子数据」推进，每个阶段都有评审记录与开发日志。白盒测试共三轮，修复 40 余项安全漏洞与功能缺陷；差异审查修正 101 处设计与代码不一致；种子数据包含 20 份志愿者人设与 5 张服务地地图。
技能
后续
研学笔记本时期形成的产品设计能力在此落地，相关工程经验延续到智慧学工 SWO。
蒲草青青，织就百物 · © 2026 程千和 · 京ICP备2026006842号-2