随笔：eSIM 在线售卖平台——从选题到仓库，我们这样起步！
| 条目 | 内容 |
|---|---|
| 这个作业属于哪个课程 | → 点我进入课程主页 |
| 这个作业要求在哪里 | → 点我查看作业要求 |
| 这个作业的目标 | 确定团队选题后通过需求分析形成需求规格说明书 |
> 作者：e脉相传团队
> 发布时间：2025-11-04
> 标签：团队随笔 / 需求规格 / Git协作 / 项目启动
一、选题落定：我们要做的究竟是什么？
经过三轮头脑风暴+投票，我们最终确定选题：
> eSIM Store：全球化数字 SIM 卡在线销售与激活平台
一句话描述：
让出境旅客、留学生、商务人士在3分钟内完成 eSIM 选购、支付与激活，下飞机即可上网。
| 维度 | 具体内容 |
|---|---|
| 核心场景 | ①选国家→②选套餐→③扫码支付→④秒发二维码→⑤手机激活 |
| 目标用户 | 18-35 岁跨境人群：留学生、背包客、出差党 |
| 预期用户量 | 3 个月内 1,000；6 个月 10,000；12 个月 50,000+ |
| 差异化亮点 | “一键退款”——激活失败 30 秒内自动原路退回；“多人共享”——一个订单生成 5 张子二维码，家庭游无需各自购买。 |
> 雷同项目不少，但把支付-激活-退款做成闭环、且提供家庭共享子码的，目前校内唯一。
二、需求规格说明书（v1.0 精简版）
已上传至仓库 需求规格说明书 ，下文摘录关键部分。
1. 面向用户分析
| 用户群 | 痛点 | 场景案例 |
|---|---|---|
| 留学生 | 落地办本地卡排队久 | 小张飞英国，起飞前买好 30 天套餐，落地 Heathrow 直接激活 |
| 背包客 | 多国跳转买卡麻烦 | 小李玩东南亚 4 国，一次下单 4 国套餐，自动切换 |
| 出差党 | 公司报销需发票 | 平台提供增值税电子发票 + 行程单 |
2. 功能性需求（一级需求）
- FR1：游客模式浏览套餐
- FR2：邮箱注册/登录（含验证码）
- FR3：支付宝 & 微信沙箱支付
- FR4：支付成功后实时生成 eSIM 二维码（含 ICCID、匹配运营商 SM-DP+ 地址）
- FR5：激活失败一键退款（30s 内自动调用支付平台撤销接口）
- FR6：订单管理（查看、下载、分享子码）
- FR7：管理后台（运营商上传套餐、设置库存、查看销量）
3. 技术需求
| 类型 | 选型 | 理由 |
|---|---|---|
| 前端 | Vue3 + Vite + TypeScript | 组件化、响应式、好招人 |
| 后端 | Django + Django REST Framework | Python 友好、ORM 成熟、方便接支付宝 SDK |
| 数据库 | PostgreSQL | 事务强一致、支持 JSONB 存子码 |
| 缓存 | Redis | 二维码生成限流、库存扣减 |
| 文件存储 | MinIO (S3 协议) | 存二维码 PNG，后期可迁阿里云 OSS |
| 容器化 | Docker + Docker Compose | 一键拉起开发环境 |
| CI/CD | GitHub Actions | 自动跑单元测试、build 镜像 |
| 文档 | Markdown + MkDocs | 版本化、可搜索 |
三、真实性·可用性·价值
| 维度 | 阐述 |
|---|---|
| 真实性 | 支付走支付宝/微信沙箱，可真实扣款/退款。 |
| 可用性 | MVP 跑通「选-付-发-激」闭环，支持 iPhone XS 以上、Pixel 等 eSIM 机型；落地即可上网。 |
| 价值 | ①用户：省排队、省实体卡、即买即用；②运营商：低门槛线上渠道；③社会：减少塑料 SIM，绿色低碳。 |
四、Git 协作方式 & 仓库地址
> 仓库已立刻建立 ⬇️
> 🔗 GitHub：https://github.com/Mark-Zhangbinghan/esimstore
1. 仓库初始化截图
s
2. Issue 驱动开发
- 需求、Bug、任务全部用 Issue 管理，标签：
需求/Bug/文档/优化 - Issue 模板已内置
.gitee/ISSUE_TEMPLATE.md - 提交信息格式：
[TYPE] 简述 #IssueID
例：[Feature] 完成支付宝沙箱支付 #14
五、团队计划（已写入 Issues）
使用《构建之法》「计划与估计」公式：
矫正耗时 Y = X ± X÷N ，初级团队 N=2
| 周次 | 任务 | 初估 X(h) | 矫正 Y(h) | IssueID |
|---|---|---|---|---|
| W9 | 需求规格说明书 | 12 | 6~18 | #4 |
| W10 | 原型设计 | 10 | 5~15 | #5 |
| W10 | 编码规范+环境搭建 | 8 | 4~12 | #6 |
| W11 | 架构设计+WBS | 8 | 4~12 | #7 |
| W12-13 | 7 天 Alpha 冲刺 | 42 | 21~63 | #8~#14 |
| W14 | 测试+发布博客 | 8 | 4~12 | #15 |
🔍 Issues 截图
六、团队分工
| 姓名 | 角色 | 本周负责任务 | 状态 |
|---|---|---|---|
| 张秉瀚 | PM+后端 | 需求说明书整体把关、建立仓库、写本随笔 | ✅ |
| 沈武钊 | 后端 | 负责支付模块时序设计、接口草案 | ✅ |
| 陈嘉煌 | 前端 | 输出 Axure 高保真原型 v1.0 | ✅ |
| 郑东楷 | 测试+安全 | 编写「一键退款」异常流程测试用例 | ✅ |
| 邱宇彦 | 数据 | 在需求文档里补充用户画像 & 数据指标 | ✅ |
| 陈俊源 | 全栈 | 搭建 Docker-compose 开发环境并写 README | ✅ |
| 崔乐浩 | DevOps | 配置 Gitee 与 GitHub 镜像同步 Action | ✅ |
七、个人感想（每人一句）
- 张秉瀚：「Issue 虽小，能把需求、代码、进度串成一条线，这就是工程化魅力。」
- 沈武钊：「第一次用公式矫正时间，发现以前总低估 30%，科学估算果然有效。」
- 陈嘉煌：「原型画完拿给留学生同学看，被夸‘比淘宝简单’，成就感爆棚！」
- 郑东楷：「把退款失败场景写成自动化测试脚本，安全感瞬间+10086。」
- 邱宇彦：「数据指标不再只是 PV/UV，还要关注‘激活成功率’，长见识了。」
- 陈俊源：「Docker 一键起环境，妈妈再也不用担心我‘在我电脑上是好的’。」
- 崔乐浩：「Gitee+GitHub 双仓库，Push 一次两边走，国产+国际双保险。」
八、快速索引
| 内容 | 链接 |
|---|---|
| 需求规格说明书 v1.0 | Github 浏览 |
| 仓库主页 | 点我查看 |
| Issues 看板 | 点我查看 |
🚀 e脉相传，连接无界。
欢迎来访、Star、提 Issue，一起把「出境上网」这件小事做到极致！
浙公网安备 33010602011771号