产品定位:校园健康生活交流广场,主张「健康这件事,一起就容易一点」。本演示为双击即开的离线移动端原型:无框架、无后端、无登录,全部人物与互动均为虚构,数据仅保存在本机浏览器。
每节末尾的「去体验」会关闭文档并直接跳到对应功能;完整文字版见随附 docs/功能需求说明.md。
单页应用,四个页面共用一套底部导航与顶部状态栏,广场为核心页。
入口底部固定导航:地图 · 识热量 · 广场 · 我的
交互逻辑
- 点击导航项立即切换页面内容区,当前项高亮并标记
aria-current;切换后页面回到顶部。
- 搜索框、分类标签、发布加号按钮仅在广场页显示,其余页面自动隐藏,避免误触。
- 地图为范围外占位页:不读取定位、不提供虚构店铺或路线,给出「先去广场逛逛」返回按钮。
- 顶部状态栏实时反映存储状态:正常显示「本机演示 · 互动自动保存到此浏览器」,刷新后显示「已恢复本机数据」。
- 存储不可用或写入失败时,状态栏变为橙色警示「仅内存模式:刷新将丢失更改,请在『我的』导出」。
边界与异常- 页面切换不丢失广场的搜索词与分类选择。
- 弹层打开时锁定背景滚动,关闭后恢复。
朋友圈式帖子流,预置 10 条虚构种子帖(食堂 3、运动 1、搭子 4、探店 1、心情 1,含本人 2 条)。
入口广场页顶部四个分类标签:推荐 · 找搭子 · 关注 · 我发布的
交互逻辑
- 推荐:展示全部帖子,按热度排序。热度 = 帖子赞数 + 我的点赞(0 或 1)+ 评论数 × 3;热度相同按发布时间倒序。我的点赞会实时影响排序。
- 找搭子:仅展示搭子招募帖(type = buddy),按发布时间倒序。
- 关注:仅展示已关注作者的帖子,按发布时间倒序;关注 / 取关立即反映到本列表。
- 我发布的:仅展示本人帖子,按发布时间倒序。
- 切换标签即时重渲染,标题文案与排序角标(按热度推荐 / 最新发布)同步变化;标签支持键盘左右方向键与 Home / End 循环切换。
- 帖子卡片包含:头像、昵称(本人帖带「我」标记)、相对时间(刚刚 / N 分钟前 / N 小时前 / 月日)、位置、分类话题标签、配图、独立成就图插槽、搭子信息框(类型 / 时间 / 地点 / 人数)、点赞 / 评论 / 申请操作。
- 他人帖子显示「关注」与「私信」;本人帖子显示「···」管理菜单。
边界与异常- 各分类有专属空态与引导按钮:关注空态 →「去发现同学」;我发布的空态 →「发布我的日常」。
- 列表上限 200 帖;时间字段非法时显示「时间未知」。
全宽搜索框,输入即搜,无需点击搜索按钮。
入口广场页顶部「搜索内容/用户」输入框
交互逻辑
- 每次输入实时过滤当前分类下的帖子,匹配规则:昵称 + 正文拼接后做不区分大小写的子串匹配;关键词最长 100 字。
- 有关键词时:隐藏划卡入口与活动推荐区,标题变为「找到 N 条相关动态」,并显示「在当前分类搜索『关键词』」提示条。
- 输入非空时右侧出现清空按钮;点击清空恢复完整列表并把焦点还给输入框。
- 无结果时展示空态「还没找到这份同频」,附「清空搜索」按钮。
- 发布成功后自动清空搜索并切到「我发布的」,保证新帖可见。
边界与异常- 搜索只作用于当前分类,不跨分类;切换分类保留关键词。
- 纯空白关键词视为无搜索。
推荐页顶部接入 3 条通州校园活动资讯,横向滑动卡片,全部为已核实的回顾信息。
入口推荐分类顶部「通州活动推荐」横滑区
交互逻辑
- 点击卡片主体:直接在新窗口打开微信原文(
noopener noreferrer);无安全链接的卡片显示「原文链接待核实」,不可点击跳转。
- 点击卡片底部「来源与时效」:弹层展示校区、发布公众号、文章发布日期、官网收录日期、实际活动时间、具体场地、引用来源与核验说明;未核实项明确显示「待核实」,不推断。
- 时效判定:状态含「回顾 / 历史 / ended」等关键词,或文章发布超过 30 天 → 标记「活动回顾」;否则标记「活动资讯」。官网收录日期不等于活动日期。
- 标题右侧「N 条回顾 · 左右滑」按钮打开整体来源说明。
边界与异常- 活动数据缺失或为空时整区隐藏,不发起 404 请求、不编造链接。
- 回顾信息不代表正在报名;微信原文可能要求验证,需在微信中自行查看。
对广场里他人的搭子招募帖做「喜欢 / 不喜欢」快速筛选,左滑喜欢、右滑不喜欢。
入口推荐 / 找搭子分类顶部奶油绿插画横幅「划卡找搭子」(搜索时隐藏)
交互逻辑
- 候选规则:只取当前广场中其他用户的搭子招募帖(排除本人帖与普通帖),按发布时间倒序;完整保留作者、时间地点、正文换行、原配图、独立成就图、招募时间 / 地点 / 类型 / 人数与赞评数,不裁切成简介。
- 拖拽手势:卡片跟手平移并轻微旋转,「喜欢 / 不喜欢」角标随位移渐显。松手时水平位移 ≥ 80px 且水平 > 垂直 × 1.5 → 确认选择:向左为喜欢,向右为不喜欢。
- 滚动保护:垂直位移 > 10px 且 > 水平 × 1.2 时判定为纵向滚动,本次手势不再触发选择;短拖松手回弹复位,不产生选择。
- 卡片与切换:近全屏大卡片与真实下一帖叠放,有图显示原图封面,无图使用运动主题文字卡;完整正文可在卡内纵向滚动。确认后前卡 200ms 旋转离场,后卡接替并回到正文顶部;动画期间禁用选择按钮防连击。底部圆形「喜欢 / 撤销 / 不喜欢」按钮常驻,卡片聚焦时左右方向键提供等价操作。
- 即时保存:选择按帖子 ID 立即写入本机,关闭弹层不丢失;同一作者的不同帖子相互独立。
- 撤销:弹出上一次选择并重新展示该帖;「喜欢的帖子」列表可逐条跳回原帖;「查看原帖」关闭弹层、定位到广场对应帖子并高亮闪烁。
- 看完 / 无候选:分别显示「都看完啦」与「暂时没有他人的搭子帖」空态;「重新看这些帖子」需二次确认后清空本机选择记录。
边界与异常- 喜欢 ≠ 申请:不自动点赞、关注、申请或发私信,不伪造双向匹配;应征需回原帖点「来搭一下」。
- 系统开启「减少动态」时跳过位移动画,但保留 200ms 防连击窗口。
- 弹层被替换或关闭时,旧动画回调不会改写新弹层状态。
一个发布器覆盖普通动态与搭子招募两种类型,字段校验全部前置。
入口广场页右下角奶黄色加号按钮;各空态的发布引导按钮
交互逻辑
- 打开即发布抽屉,顶部分段控件切换「普通动态 / 找个搭子」;切换时保留已填内容,搭子类型自动锁定分类为「搭子」。
- 正文必填且 ≤ 500 字,右上角实时字数统计;分类五选一;位置选填 ≤ 60 字。
- 搭子必填四项:见面时间(必须晚于当前;编辑旧帖时允许保留原过去时间)、集合地点 1–60 字、搭子类型 1–20 字、总人数 2–30 的整数(含发起人)且不小于已有报名人数。
- 校验失败:表单内显示红色错误文案并自动聚焦出错字段;图片处理中禁止提交。
- 发布成功:保存 → 关闭抽屉 → 清空搜索并切到「我发布的」→ 平滑回顶 → Toast 提示。新帖置顶插入,发布时间为当前,赞与评论从零开始。
- 有未保存修改时关闭抽屉(点关闭 / Esc / 点遮罩)需确认「草稿尚未发布,确定放弃这次编辑吗?」。
边界与异常- 本机最多 200 帖,超出提示先删除部分动态并导出备份。
- 离开页面时若有未保存草稿,触发浏览器挽留提示。
发布器内配图,两种来源;成就图为独立对接插槽,不在发布器内生成。
入口发布抽屉「配一张生活照片」:预置餐食图 / 上传本地照片
交互逻辑
- 预置餐食图:一键写入草稿缩略图,可随时点 × 移除。
- 本地上传:仅接受 PNG / JPEG / WebP;MIME 与文件头签名字节双重校验,拒绝 SVG 与伪装格式;文件须 > 0 字节且 ≤ 5MB,像素 ≤ 3200 万。
- 压缩:最长边缩至 1280px,白底 JPEG 质量 0.82;结果仍超过 1.8MB 时降到 0.6 重试;仍过大则报错提示换图。
- 处理期间提交按钮显示「正在压缩图片…」并禁用;完成后缩略图回填草稿并 Toast「图片已压缩,仅保存在本机」。
- 成就图插槽只接收外部分享(识热量 / URL / API)传入的安全图片,与生活配图相互独立、分别可移除。
边界与异常- 格式不符、解码失败、像素过大、压缩后仍过大均有明确错误文案。
- 处理中切换草稿或关闭发布器会作废本次上传结果,不会写错草稿。
仅本人帖子可管理,删除需二次确认。
入口本人帖子右上角「···」→ 管理我的日常
交互逻辑
- 编辑:完整回填正文、分类、位置、配图、成就图与搭子四项;保留原发布时间、点赞数与全部评论;提交按钮变为「保存修改」,校验规则与发布一致。
- 删除:先弹确认层,明示「配图、评论与招募信息也会从本机移除,无法撤销」;「先留着」关闭,「确认删除」执行。
- 删除后同步清理本人对该帖的点赞与申请记录,列表即时刷新并 Toast。
边界与异常- 他人帖子无管理入口;帖子已被删除时操作提示「这条动态已被删除」。
- 编辑不存在或非本人的帖子会被拦截。
轻量社交互动,全部即时生效、可逆、不重复叠加。
入口帖子底部心形点赞按钮 / 评论按钮
交互逻辑
- 点赞:点击切换赞 / 取消。显示数 = 种子赞数 + 我的点赞(0 或 1),反复点击不会叠加;点赞后心形填充变色并 Toast「送出一个小小的鼓励」,取消则恢复。重渲染后键盘焦点保留在点赞按钮上。
- 评论:点击评论按钮打开弹层,顶部显示原帖摘要(前 80 字),下方评论列表(本人评论带「我」标记)与输入框。
- 评论校验:不能只含空白;≤ 200 字;单帖最多 100 条演示评论。
- 发送成功:评论追加到列表尾部,帖子流评论计数同步更新,弹层重开并保持输入焦点,便于连续评论。
边界与异常- 空评论 / 超长 / 超量均在弹层内显示红色错误并聚焦输入框。
- 原帖被删除时评论弹层自动关闭。
招募帖一键应征,人数实时核算,满员即止。
入口搭子招募帖底部「来搭一下」按钮
交互逻辑
- 点击「来搭一下」:记录本机申请(不通知发起人),按钮变为「取消申请」,展示人数 +1,Toast 说明仅本机演示。
- 人数核算:展示人数 = 发起人填写的已有成员数 + 我的申请(0 或 1)。取消申请只减去我的 1 人,绝不重复扣减。
- 达到总人数上限:标题变「已经满员」,按钮显示「已满员」并禁用;已申请者仍可取消退出。
- 本人发起的招募帖显示「我发起的」,不可应征自己。
- 「我的 → 我的搭子申请」汇总全部已申请招募,点击跳回原帖。
边界与异常- 满员瞬间的点击会被拦截并 Toast「已经满员,下次再一起吧」。
- 刷新恢复时自动清理失效申请(帖子已删 / 已满员)。
- 申请为本机占位,无真实预约保证。
按作者维度的订阅关系,立即驱动关注流。
入口他人帖子作者旁「关注」按钮;粉丝弹层内回关
交互逻辑
- 点击「关注」:按钮即时变为「已关注 ✓」,该作者全部帖子立即进入「关注」分类;再次点击取消关注并同步移出。
- 关注状态按用户 ID 全局同步:同一作者在任意帖子、粉丝弹层中的按钮状态一致。
- 「我的」页关注计数实时更新;「我的关注」菜单直达关注流。
边界与异常- 本人帖子不显示关注按钮,不能关注自己。
- 初始已关注 1 位示例同学,便于首次进入关注流不为空。
帖子旁保留私信入口,右上角消息中心统一管理四类消息;私信仅本机回显。
入口帖子作者旁「私信」;广场右上角消息图标(带未读红点)
交互逻辑
- 红点:首次进入显示未读红点;打开消息中心即消除并记忆,刷新后不再出现。
- 消息中心四分类:私聊(本机会话列表 + 新建私信)、评论(他人对我帖子的评论,点击打开对应评论区)、点赞(我帖子的种子赞汇总,点击定位原帖并高亮)、粉丝(示例粉丝「栗子同学」,可查看并回关)。
- 新建私信:列出全部虚构联系人,我喜欢的招募帖作者优先排序并标注「你喜欢过这位同学的招募帖 · 未通知对方」;点击进入会话。
- 会话:输入 ≤ 500 字、禁止空白;发送后气泡仅在本机回显,每条标注「本机演示,未发送」;无自动回复;单会话最多 100 条。
- 从帖子旁「私信」进入与从消息中心进入是同一会话,历史互通。
边界与异常- 不能给自己发私信;空消息 / 超长 / 超量均有错误提示。
- 评论通知不含本人对自己帖子的评论;点赞通知为种子数据,无真实推送。
帖子配图与成就图均可放大查看。
入口点击帖子中的配图或成就图
交互逻辑
- 点击图片打开预览弹层,按原比例放大展示,标题区分「生活配图」与「成就图 · 独立插槽」。
- 关闭方式三选一:关闭按钮、Esc 键、点击遮罩;关闭后焦点回到触发位置。
边界与异常- 任何图片加载失败自动替换为「图片暂不可用,文字分享依然在这里」占位,不影响其余内容。
- 预览前再次校验图片地址安全性。
模块联动演示:固定模拟热量结果,一键变成可编辑的食堂草稿。
入口底部导航「识热量」;外部 URL 分享;PlazaDemo.receiveShare()
交互逻辑
- 识热量页固定展示示例餐食「照烧鸡腿饭 · 486 kcal」,明确标注模拟结果、非真实识别,不调用摄像头或识别服务。
- 点击「分享这顿好好饭」:生成预填草稿(餐名与热量文案、食堂分类、餐图),打开后可编辑再发布,绝不自动发布。
- URL 分享:
?share=calorie&dish=…&kcal=…&image=…&achievementImage=… 打开页面即导入草稿。
- API 分享:
PlazaDemo.receiveShare({dish, kcal, image, achievementImage}) 返回 {ok, draft} 或 {ok:false, error}。
- 入参校验:dish 1–60 字;kcal 为 1–5000 的有效数字;image / achievementImage 必须是安全图片地址;成就图与生活图严格独立。
边界与异常- 校验失败 Toast 说明具体原因,不创建草稿。
- 当前有未保存草稿时先询问是否放弃,用户保留草稿则分享返回失败。
本机演示身份的个人中心,汇总动态、关系与申请,并提供数据出口。
入口底部导航「我的」
交互逻辑
- 身份卡显示演示昵称与「本机演示身份 · 无账号登录」标记;三项统计(发布 / 关注 / 搭子申请)随操作实时联动。
- 菜单直达:我的动态(我发布的分类)、我的关注(关注分类)、我的搭子申请(列表弹层)、演示消息中心、导出本机数据、功能需求说明(本文档)。
- 导出:一键下载 JSON 文件,包含全部帖子、点赞、关注、申请、会话、划卡选择与活动数据,文件名含日期。
边界与异常- 浏览器下载失败时提示改用
PlazaDemo.exportData() 获取数据。 - 页脚明示数据仅存本机、私信不发送、清除浏览器数据会丢失记录。
所有状态本机保存、失败可感知;输入全量净化,弹层与键盘操作完整。
入口贯穿全局;状态提示见顶部状态栏与「我的」页脚
交互逻辑
- 持久化:发帖、赞评、关注、申请、划卡选择、会话与红点状态写入 localStorage;刷新后恢复并逐项净化(版本校验、去重、数量上限、失效关联清理)。
- 失败降级:存储被拒 / 数据损坏 / 写入失败时进入仅内存模式:状态栏橙色警示,成功 Toast 追加「(仅内存,未保存)」,并引导导出;此时离开页面触发浏览器挽留。
- 内容安全:外部文字全部 HTML 转义;外链仅允许 HTTP(S) 且带
noopener noreferrer;图片仅放行预置图、经签名校验的 base64(PNG/JPEG/WebP)与安全外链,拒绝 SVG 与 javascript:。
- 弹层无障碍:Esc 关闭、点击遮罩关闭、Tab 焦点圈闭、关闭后焦点归还触发元素;按钮触控目标 ≥ 44px。
- 键盘与动效:分类标签支持方向键 / Home / End;划卡支持左右方向键;尊重系统「减少动态」设置;适配刘海安全区。
边界与异常- 数据损坏时保留原存储不覆盖,提示后以种子数据启动。
- 图片加载失败有占位回退;空态均有引导文案与按钮。