共享页面基础能力
通过统一请求、登录状态、导航组件与主题变量,集中管理跨页面的通用行为。
小程序2026
面向明信片爱好者的微信小程序,串联内容发现、笔友匹配、互寄进度与收藏。当前提供 28 个原生页面和 Express Mock API,用于本地演示与接口联调。

关于这个项目
iPostYou 希望让一张明信片成为人与人之间的连接:发现喜欢的卡片,认识笔友,发起互寄,跟进寄送,再把收到的心意收藏起来。项目采用原生微信小程序与 TypeScript,配合 Node.js / Express Mock API,形成覆盖社区、互寄、消息和个人中心的可运行演示。以下展示的是现有实现与真实模拟器截图;正式后端、Web 端和管理端尚未实现,微信登录、短信与部分业务交互仍使用模拟行为。
产品围绕明信片爱好者的使用过程组织功能:从内容发现进入卡片详情,通过用户主页和匹配入口认识笔友,再进入申请、任务与收卡环节。收藏册承接寄出与收到的记录,让交流之后仍有可以回看的内容。
当前版本注册了 28 个原生小程序页面,使用自定义导航栏、卡片与底部弹层等共享组件。默认的「文艺邮局」主题以暖白底色和橙色操作元素呈现内容,主题配置还定义了清新社交、自然旅行与夜读胶片三套配色。
全部 28 张截图拍摄于 2026-10-28,来自微信开发者工具实际运行画面,使用 iPhone 12/13 (Pro) 模拟器、基础库 3.14.3 和本地 Mock 数据。图片仅裁切到手机画面。用户、地址、电话、消息和活动均为仓库演示数据;占位照片与明信片标题可能不对应,界面统计不代表真实运营成果。
首页将公告、活动与推荐明信片放在同一条浏览路径中;发现页提供分类与搜索入口,搜索结果页呈现关键词相关内容。进入明信片详情后,可以查看图片、作者和评论,并继续发起互寄。
内容浏览与互寄入口相互衔接,让卡片既是社区内容,也是认识笔友和开始交流的起点。
发布页围绕图片、标题、地区与标签组织表单,并提供草稿能力。我的卡片与我的收藏分别承接发布内容和收藏内容,便于回看与筛选。
收藏册进一步按照寄出、收到与心愿清单组织卡片记录,把单次浏览延伸为持续积累的个人收藏。
匹配页以星空气泡呈现推荐笔友,并提供随机匹配入口。互寄申请页区分收到与发出的申请,详情页展示申请人资料和选片入口,任务列表则集中呈现进行中、已完成与已关闭的互寄。
现阶段匹配与申请依赖 Mock 服务演示,重点是梳理页面之间的信息传递与操作路径。
任务详情展示双方寄送进度与操作入口,收卡页用动画和阅读视图承接收到明信片的时刻。失约申诉页提供记录、状态与历史信息,活动详情则展示时间、参与人数和规则。
这些页面覆盖正常互寄与异常反馈的展示场景。收卡截图为动画结束状态,申诉截图展示种子数据中的审核中状态;完整审核与真实邮寄服务尚未接入。
消息中心汇总未读提醒和私信会话,并将赞与收藏、评论、邮局通知拆分为独立列表。通知保留关联内容与业务信息,方便用户识别这次互动来自哪里。
消息相关接口提供会话、历史消息与通知的 Mock 数据,当前实现用于页面演示与接口契约联调。
用户主页集中展示个人介绍、互寄统计与发布内容,私信详情承接进一步交流。我的页面汇总个人功能入口,成就页通过勋章、统计与排行榜呈现演示中的互寄记录。
账号相关页面包括微信登录入口、地址管理、手机号绑定和系统设置。地址页支持收件资料与默认地址管理,设置页汇总隐私、通知及账号选项。
本地登录返回固定演示用户,手机号表单不会发送真实短信,设置中的部分操作仍待完善。当前 Mock 鉴权仅服务于开发,正式上线前还需实现真实身份验证、访问控制与持久化。
小程序使用 TypeScript、WXML、WXSS 与 glass-easel,结合内置 iView Weapp 和自定义业务组件构建界面。统一请求层处理响应与错误,MobX 管理登录状态,页面和单次操作分别通过登录拦截工具控制访问。
后端采用 Express、CORS 与 Multer,按业务模块组织路由,统一返回 code、message 和 data。数据保存在内存中,重启后恢复种子状态,便于重复演示和开发联调。
仓库包含 Node 内置测试运行器编写的接口契约回归测试,覆盖通知、私信、地址、成就、收藏、搜索、申请详情与申诉等场景;小程序通过 ESLint 做静态检查,页面渲染在微信开发者工具中验证。
通过统一请求、登录状态、导航组件与主题变量,集中管理跨页面的通用行为。
以现有页面所需字段为依据,联调通知路由、私信双方身份、地址与成就字段、收藏查询以及申请详情。
为 app.json 注册的 28 个页面各保留一张截图,明确展示参数、数据来源与尚未完成的功能边界。
Mock 服务降低了本地开发门槛,无需数据库或 Redis 即可运行,但不会持久保存操作记录。下一阶段需要接入正式后端、持久化、真实登录与短信、资源上传和生产消息能力,并完善审核流程。文档中的 Vue 与 Spring Boot 属于技术选型内容,当前仓库尚未实现对应 Web、管理端和正式后端。