2.7 KiB

Raw Blame History

家长到校参观邀请系统

面向学校老师和受邀家长的移动端 H5 项目。老师可向家长发送校园参观邀请，家长通过邀请链接查看到访时间、地点、联系人及注意事项，并完成到访确认。

项目目标

为老师提供清晰、统一的家长到校邀请入口
向家长展示参观安排和到访须知
支持邀请身份校验、访问控制及到访状态管理
为后续接入分享、签到、消息提醒和访问数据统计保留扩展能力

技术栈

Vue 3 + TypeScript
Vite 6
Vue Router 4
Pinia + pinia-plugin-persistedstate
Axios
UnoCSS

环境要求

Node.js >= 22.11.0
pnpm >= 9.13.2

可执行以下命令检查本地 Node.js 环境：

pnpm run check-env

本地开发

安装依赖：

pnpm install

在项目根目录创建 .env.local：

VITE_SECRET_KEY=replace-with-a-random-value

VITE_SECRET_KEY 用于本地持久化数据的加密。所有 VITE_ 变量都会进入前端产物，不能用于保存服务端密钥或其他高敏感凭证。

启动开发服务器：

pnpm run dev

默认访问地址为 http://localhost:5173。

常用命令

命令	说明
`pnpm run dev`	启动本地开发服务器
`pnpm run build`	执行类型检查并构建生产产物
`pnpm run preview`	本地预览生产构建
`pnpm run check-env`	检查 Node.js 版本
`pnpm run upload`	执行项目部署脚本
`pnpm run build-and-upload`	构建并部署项目

运行部署命令前，需要先根据目标环境检查 upload.sh 中的服务器地址、部署目录、私钥及通知配置。

目录结构

src/
├── api/          # 请求封装与鉴权处理
├── components/   # 通用组件
├── router/       # 路由配置、权限控制与页面缓存
├── store/        # Pinia 状态及持久化配置
├── utils/        # 通用工具
├── views/        # 业务页面
├── App.vue       # 根组件
└── main.ts       # 应用入口

开发约定

无需登录或身份校验的页面配置在 src/router/publicRoutes.ts
需要身份或角色控制的页面配置在 src/router/privateRoutes.ts
业务状态统一放在 src/store，可复用业务逻辑优先拆分为组合式函数
小型 SVG 图标放入 public/icons，通过 SvgIcon 组件使用
生产代码提交前至少执行一次 pnpm run build

2.7 KiB Raw Blame History Unescape Escape