开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 12 条记录。
项目全部项目智慧乐活圈 lehuoquan乐活圈 OA 考勤 lehuoquan-oaMagicEngine 悦居魔法引擎如影随形 TraceMate悦居集团数字化 · 统一后台悦居智能 CRM悦居可视通话 yueju-call悦居存储管家 StorageMate悦居反诈专家 AntiFraud悦居智能NVR小红花 LittleBlossom悦居统计后台 DashboardFileBreeze悦居护眼卫士 EyeGuard宠物小程序贝芽妈(lovely-child)悦居智能官网悦居存储管家 AndroidSmartHome 安卓控制端适老智家 AgeHome悦居 AI 日历轻风快传官网 FileBreeze中航天业竞价小程序绿荫网球中心官网绿荫网球小程序青年公社小程序青年公社官网中羊坊村官网 Zhongyangfang自动化脚本集 automation我的减肥日记 WeightLoss画山别墅的旅行家 Travel画山别墅里的国学世界 GuoXue冰雪冬奥张山营延庆骑行网 YanqingBike延庆徒步网 GoHike智能门锁 SmartLock排队仿真 QueueSimulation悦居智能小程序 yueju-miniprogram智能会议室预约 meeting乡村文旅 VillageHub减肥日记小程序日常运维国学小程序 guoxue3D智慧城市 SmartCityLiveRobot 数字人应梦寺爬山smart_home_chat花间向导 SmartGuideWorkBuddy 指标看板T5AI 聊天机器人悦居AI相册(相册管家)
2026-04-30
部署上线腾讯云 CloudBase 静态托管
- npm run build → deploy.js → cloudbase hosting deploy dist,站点上线 CloudBase 静态托管。
- vite.config.js 配 base: './' 适配静态托管子路径。
- 收尾给关键文件补中文注释,注明组件功能、数据结构与设计决策。
- 已知:默认测试域名首次访问有提示页需点确定;子路径无 SPA fallback,直接访问会 404。
修复 i18n 取数组返回 key 路径:t() 改 tm()
- 现象:切语言后标签、设施清单等列表被 v-for 拆成 key 路径字符串。
- 根因:vue-i18n v9 的 t() 只返回字符串,数组/对象值会回退成 key 路径。
- 修复:取数组或对象统一改 tm() 并加 || [] 兜底,涉及 6 个文件;约定 t() 管字符串、tm() 管数组对象。
- 附带修复:联系我们锚点被 70px 固定导航遮挡,加 scroll-margin-top: 80px。
中英文双语完整的国际化(vue-i18n@9)实施
- 引入 vue-i18n@9,建 src/i18n/,zh-CN 与 en 两包约 200+ key。
- key 按页面/组件分命名空间,导航、首页、教练、课程、场地预约等各一组。
- 自动检测浏览器语言 + localStorage 持久化,Navbar 加中/EN 切换;硬编码中文改 $t(),ref 数据用 computed + t()。
- 管理调试页不做国际化;修切换按钮白字看不见,改深色字 + 绿色 active。
SEO 优化:结构化数据 + 懒加载路由 + 404 兜底
- index.html 补 description / keywords / theme-color、Open Graph、Twitter Cards、JSON-LD(LocalBusiness)、preconnect。
- 新增 robots.txt 与 sitemap.xml。
- 路由全量懒加载,每路由带 meta,beforeEach 同步 title 与 OG 标签。
- 新增 NotFound 页与 :pathMatch(.*)* 兜底,删除脚手架残留 style.css。
踩坑:scroll-reveal 双层嵌套导致内容 opacity:0 不显示
- 现象:加滚动动画后首页课程体系整块 opacity:0 不显示。
- 根因:About/Coaches/Courses/Moments/Contact 五个组件模板自带 .scroll-reveal,Home.vue 又包一层,内层永远不被 IntersectionObserver 观察到。
- 修复:移除组件内 class、动画统一由 Home 控制;CSS 动画挂 html.sr-ready 前缀做渐进增强,useScrollReveal 加 nextTick。
- 同类坑:子页面根元素也不能加 .scroll-reveal,否则整页不显示。
滚动揭示动画 + 移动端响应式适配
- 新建 useScrollReveal.js,基于 IntersectionObserver 做滚动触发。
- style.css 加方向变体、data-reveal-delay 1~6 交错延迟、prefers-reduced-motion 降级。
- 子页面卡片改为每张独立滚动显示,避免整块空白等待;断点 768px 与 480px 适配,按钮 min-height 44px。
- 教练竖图高度 240→360px,配 object-fit: cover 与 center top,修掉只露下半张脸。
首页 Hero 可读性优化:黑色半透明毛玻璃文字框
- Hero 大图上白字与背景重叠,部分文字几乎看不清。
- 方案一改绿字对比度不够,已弃用。
- 最终给 .hero-content 加 rgba(0,0,0,0.35) 半透明底、圆角 20px、blur(4px) 毛玻璃,内边距 40/50px。
- 结论:大字压图加半透明底比改字色靠谱。
新增场地预定页,全站购买入口统一为「立刻咨询」
- 新建 VenueBooking.vue:3 片场地卡片 + 设施标签 + 日夜场价格 + 营业时间 06:00-00:00 + 预定须知。
- 价格:1/2 号场日场 100、夜场 150,3 号场日场 80、夜场 120。
- 3 号场类型由红土场修正为户外硬地场。
- 购买入口全改「立刻咨询」,新增 useContactAction:PC 跳联系我们锚点,手机直接拨号。
图片资源全面本地化:中文文件名转英文、去掉 Unsplash 外链
- coaches/ 下中文文件名改为 assen.jpg / he-coach.jpg / lu-coach.jpg,避开 URL 中文编码;venus/ 下网球场图改为 court-1/2/3.jpg。
- 教练照片、活动图片从 Unsplash 外链全部换本地路径,fallback 同步改。
- 客服二维码从占位接口换成真实图 /ScanMe.png。
- 原因:外链不稳、内容不可控、国内加载慢。
2026-04-21
新增课程体系与课程购买页,接入部署配置
- 新增 CourseSystem.vue(五阶段成长路线)与 CoursePurchase.vue(套餐卡片)。
- 路由全量懒加载,每个路由带 meta。
- 新增 deploy.js:构建后 cloudbase hosting deploy dist 发布静态托管。
- 补 README,含结构说明、Vite 操作与部署说明。
2026-04-09
基于小程序内容重组官网信息架构
- 小程序先于官网成型,官网沿用小程序已谈定的内容口径,避免两端不一致。
- 课程体系、教练团队、场地信息以小程序为准同步。
- 官网定位展示 + 咨询引流,不做交易闭环,购买入口全部改成「立刻咨询」。
2026-03-13
项目立项:从原生 HTML 改为 Vue 3 + Vite
- 原先是单文件原生 HTML,内容一多难维护,整体重构为 Vue 3 + Vue Router 4 + Vite。
- 组件拆为 Home / StarCoaches / Activities / CourseSystem / CoursePurchase。
- 公共组件单独抽出 Navbar / Hero / About / Stats / Coaches / Courses / Moments / Contact / Footer。
- 静态资源按 public/images/ 分类(coaches、venus、home.jpg)。