燕中校友汇微信小程序

面向深圳市燕川中学在校生、毕业校友与教师的公益服务小程序。预览版围绕统一身份、校友动态和活动报名构建，并与 yanchuaner.cn 主站共享业务数据和管理后台。

暑期预览定位

小程序是“2026 燕中生态暑期预览”的移动服务端，不复制主站数据库，也不维护第二套审核规则。暑期结束目标是让成员在微信内完成登录、身份申请、资料维护、动态浏览、活动报名与账号治理；复杂内容编辑、生态说明和管理员操作继续留在主站。

预览版重点验证真实设备、弱网、登录恢复、隐私授权与报名闭环。电子纪念卡、通讯录和订阅消息按风险与必要性逐项评估。正式版计划在大二上学期通过一个学期的灰度反馈持续完善。

当前功能

• 微信登录与登录状态管理
• 姓名、毕业年份等身份资料提交与审核状态查询
• 个人资料与联系方式可见性设置
• 校友动态列表和详情
• 活动列表、详情、在线报名与取消报名
• 报名记录、隐私说明与账号注销
• 未登录访客可查看首页，进入具体服务时再登录

电子校友纪念卡、校友通讯录、城市分布和订阅消息属于后续阶段，不计入当前首测版本。

技术栈

• Taro 4.2、React 18、TypeScript
• Sass、Tailwind CSS、weapp-tailwindcss
• 服务端 API：/api/mp/*
• 鉴权：服务端签发 Bearer Token，客户端使用微信本地存储保存会话

本地开发

环境要求：Node.js 20、npm、微信开发者工具。

npm install
npm run dev:weapp

在微信开发者工具中导入仓库根目录。project.config.json 已将小程序目录设置为 dist/，开发构建完成后即可编译预览。

默认 API 地址为 https://yanchuaner.cn。如需连接本地服务端：

$env:MP_API_BASE_URL = 'http://localhost:3000'
npm run dev:weapp

微信开发者工具需要关闭“不校验合法域名”限制，或在小程序后台将正式 API 域名加入 request 合法域名。生产环境必须使用 HTTPS。

开发模拟登录

尚未配置可用的微信登录服务时，可在开发构建中显式开启模拟登录：

$env:MP_API_BASE_URL = 'http://localhost:3000'
$env:MP_DEV_MOCK_LOGIN_ENABLED = 'true'
npm run dev:weapp

服务端也必须开启 MP_DEV_MOCK_LOGIN_ENABLED，并配置允许登录的测试用户 ID。生产构建会固定关闭此入口，客户端不保存固定 Token、白名单或服务端密钥。

质量检查

npm run typecheck
npm run build:weapp

开发时使用 npm run dev:weapp 持续构建。微信开发者工具自动热重载期间不要反复执行生产构建，否则 dist/ 短暂清空时可能出现页面未注册提示。

项目结构

mp_yanchuaner/
├── config/              # Taro 构建配置与环境常量
├── docs/                # 产品、技术与界面规范
├── src/
│   ├── components/      # Card 等可复用界面组件
│   ├── hooks/           # 登录状态等共享逻辑
│   ├── lib/             # API 契约、请求封装与展示工具
│   └── pages/           # 首页、登录、认证、动态、活动与个人中心
├── project.config.json  # 微信开发者工具项目配置
└── package.json

项目文档

• MVP 产品与技术规划
• 首阶段实现报告
• 小程序界面设计规范

远程仓库：yanchuaner/mp_yanchuaner