jw_JIAWEI WANGGitHub ↗
← 返回项目作品
06 / FIT5032 · WEB APPLICATION / CASE STUDY

PatchCanopy

墨尔本社区绿地 Web 应用

让社区绿化机会,
更容易被发现和参与。

围绕城市绿化机会,构建可筛选的社区网站。从 Vue 响应式交互与表单校验,逐步扩展到 Firebase 登录、角色路由、数据导出、地图、邮件和图表服务集成。

ROLE个人课程项目 · 前端与服务集成
FOCUS墨尔本社区绿地 Web 应用
SOURCEGitHub ↗ · 私有仓库,需访问权限
Vue 3Vue RouterBootstrap 5FirebaseChart.jsMapbox GLjsPDFCloudflare
01 / THE PROBLEM

为什么做这个项目

PatchCanopy Melbourne 是 FIT5032 的个人课程 Web 项目,帮助社区发现本地绿化机会,并提交适合绿化的地点。项目从 Vue 组件、表单和列表交互逐步演进,加入身份认证、数据处理、地图和服务集成,强调清晰的反馈、响应式布局与可访问性。

MY CONTRIBUTION / 个人贡献

个人实现课程 A3 的前端页面与服务集成,包括绿化机会列表、提名表单、登录与角色路由、数据页面、CSV / PDF 导出、地图、邮件页面、统计图表及英文校验提示。

01

社区访客

浏览绿化机会、按地区筛选并提交绿地提名。

02

登录用户

进入数据、地图、邮件和统计等受保护页面。

03

协调员

通过角色限制进入 Coordinator 页面。

02 / HOW IT WORKS

从输入,到可检查的结果

  1. 01

    发现机会

    读取课程机会数据,在 Vue 计算属性中按 suburb 筛选,展示活动类型、下次活动和评分。

  2. 02

    提交提名

    通过 Location、Reason、Description 表单收集候选地点,并给出明确的校验与状态反馈。

  3. 03

    进入用户页面

    Firebase 完成登录后由 Vue Router 检查当前用户与角色,再访问对应功能。

  4. 04

    使用数据工具

    在数据页搜索、排序与分页,按需导出 CSV / PDF,或使用地图、统计和邮件服务。

03 / SYSTEM DESIGN

架构与职责划分

把不同的职责放在明确的边界内,让每一步的输入、输出和失败方式都可以单独理解。

ARCHITECTURE MAPPatchCanopy · 前端页面与服务集成
Vue Router 连接公开与受保护页面,课程 JSON 驱动列表和表格,地图、邮件与统计按功能接入外部服务。
蓝色:核心模块 · 虚线:辅助依赖 / 独立路径↔ 横向滑动查看完整架构

数据表基于课程 JSON;外部与云端功能需要相应配置,图中不代表当前在线可用性。

分层职责速览

01 / 前端入口Vite → Vue 3 + Vue Router + Bootstrap
02 / 交互与数据组件状态 / computed + 课程 JSON + LocalStorage
03 / 用户与云端Firebase Auth / Firestore + Cloud Functions
04 / 集成工具Chart.js / Mapbox GL / jsPDF / 邮件 Worker

核心工程实现

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 承担相应服务集成。外部依赖按页面提供加载、空结果与错误状态,避免服务不可用时仍显示成功反馈。

个人课程实现覆盖前端页面与服务对接;公开首页可使用课程样例运行,登录后的地图、统计及邮件依赖各自配置。作品集现有截图只证明公开页面的运行状态,不将其作为所有云端功能重新完成端到端验收的证据。

04 / ENGINEERING DECISIONS

技术难点与设计取舍

01

为什么使用页面自己的校验?

浏览器原生校验会随系统语言变化。项目统一使用英文错误提示,并保留 aria 等可访问性属性,让反馈语言和表单行为更一致。

02

怎样让导出保持简单?

将 CSV 字段转义和 PDF 表格生成集中在工具函数中,页面只传入当前数据,减少界面与导出格式的耦合。

03

怎样处理外部服务不可用?

地图、统计和邮件依赖外部配置与服务。页面为加载、空结果和错误提供可见状态,避免只显示原始异常或让用户误以为提交成功。

06 / VERIFY & REFLECT

如何验证,以及做到哪里

01

本轮实际运行

启动原始 A3 Vite 项目,检查公开首页并截取机会列表和提名表单;按 Clayton 筛选后显示对应机会。

02

既有课程验证

本地会话记录了构建、表单英文校验、桌面和手机布局,以及 Map 搜索区域对齐的验证。

03

功能边界

地图、邮件、统计等云端功能需要各自配置和已登录账号;本轮截图未把它们作为重新完成的端到端验收。

CURRENT SCOPE

当前实现边界

本地运行截图展示公开首页与课程样例数据。评分交互和离线 / LocalStorage 能力不等同于完整生产级多人后台。登录后的云端功能本轮未重新验收,也未发送邮件或修改云端记录。

继续阅读

课程源码仓库 ↗

PatchCanopy 为私有仓库,代码与文档链接需要仓库访问权限。

内容依据当前项目 README 与架构文档整理;展示工程设计和验证方式,不将示意图或流程描述作为实时运行数据。
NEXT PROJECT / 07

WildLens

Aussie EcoLens 多云野生动物平台

↗