PatchCanopy
墨尔本社区绿地 Web 应用
让社区绿化机会,
更容易被发现和参与。
围绕城市绿化机会,构建可筛选的社区网站。从 Vue 响应式交互与表单校验,逐步扩展到 Firebase 登录、角色路由、数据导出、地图、邮件和图表服务集成。
为什么做这个项目
PatchCanopy Melbourne 是 FIT5032 的个人课程 Web 项目,帮助社区发现本地绿化机会,并提交适合绿化的地点。项目从 Vue 组件、表单和列表交互逐步演进,加入身份认证、数据处理、地图和服务集成,强调清晰的反馈、响应式布局与可访问性。
个人实现课程 A3 的前端页面与服务集成,包括绿化机会列表、提名表单、登录与角色路由、数据页面、CSV / PDF 导出、地图、邮件页面、统计图表及英文校验提示。
社区访客
浏览绿化机会、按地区筛选并提交绿地提名。
登录用户
进入数据、地图、邮件和统计等受保护页面。
协调员
通过角色限制进入 Coordinator 页面。
从输入,到可检查的结果
- 01
发现机会
读取课程机会数据,在 Vue 计算属性中按 suburb 筛选,展示活动类型、下次活动和评分。
- 02
提交提名
通过 Location、Reason、Description 表单收集候选地点,并给出明确的校验与状态反馈。
- 03
进入用户页面
Firebase 完成登录后由 Vue Router 检查当前用户与角色,再访问对应功能。
- 04
使用数据工具
在数据页搜索、排序与分页,按需导出 CSV / PDF,或使用地图、统计和邮件服务。
架构与职责划分
把不同的职责放在明确的边界内,让每一步的输入、输出和失败方式都可以单独理解。
数据表基于课程 JSON;外部与云端功能需要相应配置,图中不代表当前在线可用性。
分层职责速览
核心工程实现
Vue 响应式机会列表与组件状态
机会列表以课程 JSON 为基础,selectedSuburb 使用 ref 保存选择,filteredPatches 通过 computed 派生显示结果。按 patch.id 渲染卡片,评分选择和提交反馈按记录 ID 分别保存,评分提交后更新均分与数量。
列表筛选和评分反馈由组件状态驱动,Bootstrap 栅格负责不同屏宽的卡片布局。评分属于当前前端交互,不将本地数组更新描述为具备并发控制的多人评分服务。
提名表单、英文校验与本地草稿
NominationForm 将 Location、Reason、Description 与字段错误分开管理,提交时执行必填和长度检查,描述至少 30 个字符,并给出统一英文提示。输入与状态信息通过 label、aria 和可见反馈关联,避免原生浏览器校验随系统语言变化。
watch 深度观察表单,将草稿存入 LocalStorage;页面挂载时解析并检查字段类型后恢复。损坏草稿会清理,浏览器存储不可用时保留表单基本功能并显示保存失败状态。草稿保存是本地体验,不等同于服务端正式提交。
Firebase Auth 与异步路由守卫
Vue Router 的 beforeEach 先等待 authReady,避免 Firebase 尚未恢复登录状态时错误跳转。requiresAuth 页面要求当前用户,requiresCoordinator 额外检查 coordinator 角色;未登录时跳转 Login 并保留 redirect,角色不符返回公开首页。
路由元数据同时驱动页面标题,前端明确区分公开页、登录页与协调员入口。路由守卫限制导航体验,实际云端数据与接口访问仍需要对应 Firebase 规则或后端授权。
搜索分页与 CSV / PDF 导出
数据页集成搜索、排序和分页,导出逻辑集中到 exportData 工具。CSV 将值转换为字符串、双写内部双引号并统一包裹字段,以 UTF-8 BOM 和 CRLF 生成 Blob;下载结束释放 Object URL。
PDF 使用 jsPDF 与 AutoTable 生成横向表格,统一表头、字体、内边距及换行规则。页面负责传入表头和数据,文件格式细节留在工具函数中,便于多个数据视图复用。
地图、图表与邮件服务集成
Mapbox GL 展示地点和地图交互,Chart.js 提供统计视图,Firebase / Cloud Functions 与 Cloudflare 邮件 Worker 承担相应服务集成。外部依赖按页面提供加载、空结果与错误状态,避免服务不可用时仍显示成功反馈。
个人课程实现覆盖前端页面与服务对接;公开首页可使用课程样例运行,登录后的地图、统计及邮件依赖各自配置。作品集现有截图只证明公开页面的运行状态,不将其作为所有云端功能重新完成端到端验收的证据。
技术难点与设计取舍
为什么使用页面自己的校验?
浏览器原生校验会随系统语言变化。项目统一使用英文错误提示,并保留 aria 等可访问性属性,让反馈语言和表单行为更一致。
怎样让导出保持简单?
将 CSV 字段转义和 PDF 表格生成集中在工具函数中,页面只传入当前数据,减少界面与导出格式的耦合。
怎样处理外部服务不可用?
地图、统计和邮件依赖外部配置与服务。页面为加载、空结果和错误提供可见状态,避免只显示原始异常或让用户误以为提交成功。
项目实景
本轮从本地 A3 项目启动后直接截图;机会列表使用课程样例数据。点击图片可打开原图查看细节。
如何验证,以及做到哪里
本轮实际运行
启动原始 A3 Vite 项目,检查公开首页并截取机会列表和提名表单;按 Clayton 筛选后显示对应机会。
既有课程验证
本地会话记录了构建、表单英文校验、桌面和手机布局,以及 Map 搜索区域对齐的验证。
功能边界
地图、邮件、统计等云端功能需要各自配置和已登录账号;本轮截图未把它们作为重新完成的端到端验收。
当前实现边界
本地运行截图展示公开首页与课程样例数据。评分交互和离线 / LocalStorage 能力不等同于完整生产级多人后台。登录后的云端功能本轮未重新验收,也未发送邮件或修改云端记录。
继续阅读
课程源码仓库 ↗PatchCanopy 为私有仓库,代码与文档链接需要仓库访问权限。
内容依据当前项目 README 与架构文档整理;展示工程设计和验证方式,不将示意图或流程描述作为实时运行数据。WildLens
Aussie EcoLens 多云野生动物平台

