开发日记
按时间回看每个项目做了什么、踩了什么坑、做了哪些取舍。共 30 条记录。
项目全部项目智慧乐活圈 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-09-29
运维收尾:系统稳定运行,迭代至 v2.1.4
- 系统 2026-07-07 上线后稳定运行,Web 端迭代至 v2.1.4,此后均属运维。
- 环境:华为云 ECS + Docker Compose + Nginx + Let's Encrypt,已配 systemd 自动续期。
- 运维期:时间改北京时间、四态流转与投标去重(18 份→3 家)、截止后封锁上传删除、竞价按联系人隔离修泄露。
- 09-18 证书到期全线不可用后补自动续期。尾巴:小程序 footer 硬编码 v2.0.2、end_time 未过 fmtDate、certbot 待升级。
2026-09-18
踩坑:SSL 证书到期导致全线不可用(未配置自动续期)
- 09-18 早小程序接口全报错,HTTPS 握手失败,证书 09-17 08:34 GMT 已到期。
- 根因:部署时手动签发,服务器从未配自动续期,无 certbot.timer 也无 crontab。
- certbot renew --nginx 手动续期,新证书至 2026-12-17。
- 新建 certbot-renew.service + .timer,每天 00:00 与 12:00 跑,Persistent=true。
- 遗留:certbot 1.23 基于 Python 3.6,待升级。
2026-08-20
踩坑:竞价可见性必须按联系人隔离,不能只按公司
- 山东中航联系人李晓(487)能看到同事王(385)受邀的 4 个竞价,邀请查询只按 supplier_id 过滤、没按 contact_id。
- 4 处 SQL 补上 (contact_id IS NULL OR contact_id = ?),覆盖 portal 与 bidding 的列表/详情/出价。
- placeBid 原本没做邀请校验,顺手补上,避免知道竞价 ID 就能出价。
- 兼容早期邀请:contact_id 为 NULL 的记录仍可见。
2026-08-05
状态机收尾:定时任务覆盖四态 + 拆开「存储状态」与「计算状态」的职责
- 状态归属改三轮定稿:定时任务三条顺序执行,覆盖待开标(4)/已结束(2)/开标中(3)。
- 去掉 STATUS_SQL 里的 AND status != 2,计算状态只认时间,人工干预交给 status 字段。
- 补上 cron 自动切换时的操作日志;架构文档写明 status 为对外真实状态、computed_status 为纯时间推导值。
- 顺带修状态切换弹窗每秒重复弹(timer 缺 fired 标志),toast 从 alert 换成 3 秒自动消失。
2026-07-29
管理端文件下载改用 openDocument(showMenu) + 区分预览与下载
- 小程序「下载招标文件」只能预览存不下来,根因是 wx.openDocument 不带菜单入口。
- 改 showMenu:true,右上角「…」可转发、可保存到本地。
- 按客户要求拆成两个按钮:预览=纯查看,下载=打开+弹保存菜单。
- 版本号只在左下角显示,footer 技术支持处去掉版本号。
2026-07-18
列表状态实时计算 + 新增「待开标」状态 + 保存即发布
- 列表状态改用 getEffectiveStatus 按当前时间实时算,不再只信数据库 status 字段。
- 新增 status=4「待开标」,覆盖 end_time 到 opening_time 之间的窗口。
- 新建招标改保存即发布(create 默认 status 0→1),列表去掉发布按钮。
- 创建成功改 wx.redirectTo 回列表,避免停在表单重复提交。
2026-07-14
投标截止后封锁上传/删除:服务端 403 + 前端条件渲染双保险
- 截止后仍能上传甚至删标书,服务端 uploadDocument/deleteDocument 查 end_time 后直接返 403。
- 两接口小程序与 Web Portal 共用,改一处两边都盖住。
- 前端只做体验:详情算 isEnded,上传区与删除按钮条件渲染,截止后显示「投标已截止」。
- 坑:isEnded 用格式化字符串比大小导致按钮没隐藏,改用原始 UTC 时间戳。
招标四态流转 + 修复投标数量统计算重
- 招标状态从三态补到四态:0 草稿 / 1 已发布 / 2 已结束 / 3 开标中,到开标时间由 detail() 自动转开标中,另加「开标结束」按钮。
- 修统计 bug:后台显示 18 份标书实际 3 家投标,根因 tender_documents 缺 (tender_id, supplier_id) 唯一约束,重复上传堆记录。
- 三处修:上传前先删旧记录、统计改 COUNT(DISTINCT supplier_id)、补唯一索引并迁移清存量。
- 教训:计数 bug 先想清一个供应商应算几次。
2026-07-07
正式上线:客户投入生产使用(v2.1.1)
- 07-07 正式交付客户投产,从 06-19 立项算 18 天,小程序与 Web 后台均为 v2.1.1。
- 供应商端:邀请链接→验证→实时出价→投标;管理端小程序 + Web 双入口 8 模块。
- 上线前两天收口:开标时间不下发 file_url、文件选择坑链、中文文件名乱码、隐私合规只留 chooseMessageFile。
- 此后进运维阶段,不再算开发。
列表页时间从 UTC 原始串改为北京时间(新增字段漏格式化的坑)
- 首页与「我的」把开标时间显示成 UTC 原始串,因为只对 start_time/end_time 做了 fmtDate,后加的 opening_time 漏了。
- 两页补 fmtDate,wxml 增开标时间并用绿色区分,WXSS 加 .opening-text。
- 统一口径:所有时间按 YYYY-MM-DD HH:mm:ss 北京时间展示。
- 同类遗留:管理端统计页 end_time 至今没格式化,加时间字段应全局 grep 一遍 _time。
2026-07-06
踩坑:Web 端「上传按钮没反应」——Vue 静默吞掉 ReferenceError
- 招标详情弹窗点上传完全无反应,控制台也没报错,先怀疑文件选择和权限都排掉了。
- 根因:uploadFile()/save() 调的 token() 只在根 app setup 里定义,组件作用域没有,ReferenceError 被 Vue 3 静默吞掉。
- 修复:组件自己加 token() 读 localStorage 的 admin_token。
- 教训:Vue 里「点了没反应、无报错」先查模板/方法作用域。
开标时间到达自动刷新:15 秒轮询解锁投标文件
- 开标时间到页面不自动变,小程序与 Web 都加 15 秒轮询:canViewDocs 为 false 且有待开标时间才启,到点清定时器、刷新详情。
- 关键点:存原始 opening_time,fmtDate 转过的字符串不能比大小;onShow 补检、onUnload/onUnmounted 清定时器。
- 不改推送的理由:开标没有外部事件可挂,轮询只在未开标时启,开销一个详情接口。
- 遗留坑:定时器重复触发每秒弹 toast,07-18 补 fired 标志位才干净。
隐私合规改造:仅保留 chooseMessageFile(v2.1.1)
- 移除 chooseMedia/chooseImage/chooseVideo 全部调用,只保留 chooseMessageFile(从聊天记录选文件)。
- 新增隐私协议页,验证页 UI 压缩、竞价详情底部留白,版本升到 v2.1.1。
- 权衡:投标文件本来就走微信聊天记录传输,收窄权限换审核确定性。
踩坑:Web 端上传中文文件名乱码(Latin-1 误解码)
- Web 后台传文件后中文名变乱码,根因是 Content-Disposition 的 filename 按 Latin-1 解码 UTF-8 字节。
- 修复:服务端 Buffer.from(displayName,'latin1').toString('utf8') 重新解码。
- 供应商端早修过、管理端漏了,同一问题两个入口只补了一个,这次一并补齐。
踩坑:小程序文件选择与上传的一条完整坑链
- 选文件无反应,先疑隐私授权,加 requirePrivacyAuthorize 仍无效。
- 模拟器报栈溢出:chooseMessageFile 带 type 参数在基础库 3.16.1 触发微信 bug,去掉参数与授权壳仍无效。
- 正解改用 onNeedPrivacyAuthorization:未授权时弹自定义隐私弹窗,agree 按钮 resolve 放行原调用。
- 上传后文件名变 tmp_数字,改由客户端从 tempFilePath 拼 file_name,服务端多级探测扩展名;长名中间截断。
2026-07-05
招标开标时间机制:未开标不下发文件地址
- tenders 表加 opening_time 字段并写迁移脚本,新建招标支持上传招标文件供供应商下载。
- detail() 按开标时间判 can_view_docs,未到点把 file_url 置 null,数据不下发而非前端隐藏。
- 管理端与小程序同步:未开标只显示文件名,下载按钮不出现。
- 结论:可见性靠后端控制,前端 v-if 能被直接看接口绕过。
2026-06-24
踩坑:Failed to fetch 全面修复(网络 / CORS / 500 / 轮询泄漏四层)
- 一天内收掉 Failed to fetch 四层成因:请求层、服务端、CORS、前端定时器泄漏。
- 小程序 request() 加 try/catch,statusCode 补认 201,不再把创建成功当失败。
- Express 加全局错误中间件统一返 JSON 500;CORS 白名单补 http 生产域名;JWT_SECRET 后备值统一。
- 所有轮询定时器补 onUnmounted 清理,四处 footer 版本统一到 v2.0.2。
2026-06-23
产品化收尾:操作说明、仪表盘小程序码、供应商搜索筛选 + 架构文档
- 供应商管理加搜索与企业分类筛选,仪表盘加小程序码,管理员扫码即进后台。
- 出价排名补显示竞价标题,新增管理员图文操作说明;供应商「竞价中/我的」按状态分流。
- 补三份文档:功能对比表、服务端架构、小程序架构,README 加技术栈/目录/错误码速查。
- 定规矩:版本更新说明不用 emoji。
2026-06-22
出价规则定型:降幅整数倍 + 固定 5 分钟延时 + 弹窗交互
- 出价降幅限定为最小降幅的整数倍,服务端 bid() 做整除校验,不合法直接拒。
- 延时写死 5 分钟:结束前 5 分钟内有人出价即顺延 5 分钟,delay_minutes 字段保留但不再读取。
- 出价弹窗修四处:默认值自动填充、取消不关弹窗、字符串转 number、结束时间补 fmtDate。
- 已结束竞价的邀请链接改为返回 bidding_ended: true 跳只读详情,不再弹「请求异常」。
v2.0.0 发布 + 官网入口页与 SEO/AI 元数据
- 发布首个正式版 v2.0.0:隐私协议页、价格取整、WebSocket 实时同步、订阅消息、自动过期与重启。
- 官网入口页单页上线,补齐 OG/Twitter Card/canonical、Organization JSON-LD、robots.txt、sitemap.xml。
- 加 llms.txt 与 ai-summary 元数据供 AI 检索引用,首页标注备案号。
- 后续发 v2.1.0(开标时间)与 v2.1.2~v2.1.4,线上为 v2.1.4。
日期输入改年月日独立文本框(绕开浏览器 locale)
- 竞价表单日期输入在英文浏览器显示 mm/dd/yyyy,根因是原生 date 控件跟随 locale。
- 改为年/月/日三个独立文本框,同步改重置、回填解析、保存拼串,招标表单的 datetime-local 一并换掉。
- 改完白屏:save() 被多复制一行 async function 造成语法错误,用 new Function() 先验语法再部署。
- 部署前做本地→宿主机→容器三层 md5 比对。
WebSocket 实时价格同步 + 微信订阅消息推送
- WebSocket 实时同步价格,任一方出价所有在线端立即收到,不再等轮询。
- 订阅消息三类:开标提醒、被反超提醒、出价后引导重新订阅(微信订阅是一次性)。
- 价格统一取整去小数,出价加跳动动画;时区统一为存储北京时间、API 输出 UTC、客户端 +8h。
- 坑:订阅模板字段不匹配导致推送失败,逐字段对齐模板 ID 与 data 结构。
竞价状态双轨维护 + 自动过期 + 一键重启
- 竞价状态双轨:biddings.status 由后端 30 秒定时任务更新,API 返回时用 SQL 实时算 computed_status。
- 招标补自动过期:list() 开头把 status=1 且已过 end_time 的置为 2。
- 已结束的竞价/招标可一键重启并重设起止时间,其他状态按钮置灰防误操作。
2026-06-21
竞价招标完整流程走通 + UI 全面优化(单日 9 次提交)
- 单日 9 次提交,竞价(邀请→验证→看价→出价→排名→结果)与招标(建档→传文件→邀请→投标→下载)全流程走通。
- 半数提交是视觉:竞价卡片重排、状态标签配色、圆角间距统一、管理端按钮归位。
- 出价按钮从固定悬浮改为跟随内容滚动,滑到底才出现,避免误触。
- 新增出价排名自动刷新与首页按状态分流。
错误提示体系:从 toast 到带 errCode 的 Modal
- 报错从一句「请求失败」改成带 errCode + HTTP 状态码的 showModal 弹窗,弹窗限频 3 秒。
- 建统一错误码表,管理端加 /error-codes 接口可查全表。
- 坑:容器缺文件报 404 找不到错因,顺手把接口路径打进弹窗。
- 教训:源码必须 bind mount 进容器,否则 compose 重建后改动全丢。
2026-06-20
首版骨架跑通:招标管理 + 分享转发 + 日期统一格式化
- 两天内跑通招标链路:列表、详情、邀请供应商、分享转发全部可用。
- 抽 fmtDate() 统一所有时间字段,补齐竞价/招标前后端状态口径。
- 坑:管理后台 Web 跳小程序用 wx.navigateTo 失败,改 navigator 组件。
- 登录来源打 miniapp 标识,服务端据此区分 Web 与小程序。
重写决策:放弃旧版 uni-app 竞拍源码,改原生小程序 + 自建后端
- 接手外包竞拍小程序后先出逐项功能对比表,判定重写而非改造。
- 三条理由:旧后端 PHP 撑不了 WebSocket 推价、uni-app 对 chooseMessageFile 等原生 API 隔阂、数据模型要加邀请/日志/开标时间。
- 旧版缺的供应商邀请验证、管理员控制台、错误日志、手机号绑定列为新增项,对比表当需求清单用。
- 保留 RESTful 接口风格、原生小程序与 WXSS。
2026-06-19
项目立项:华为云 + Docker 容器化部署方案
- 中航天业竞价平台立项:固定降幅阶梯出价、结束前出价延时、同公司联系人隔离,SaaS 改不动,自研。
- 华为云 ECS(CentOS 8 / 40G / 7.6G),Docker Compose 两容器:Node 22 Alpine + Express、MySQL 8.0。
- Nginx 反代 443→3000,Let's Encrypt 证书;代码 bind mount,改代码不重建镜像。
- 选小程序:供应商不装 App,管理员转发卡片即可邀请。
操作日志系统:全链路留痕到 IP
- 新建 operation_logs 表:admin_id/admin_name/action/target_type/target_id/detail/ip/created_at。
- 新增 logger.js 统一写入,接入登录成功与失败、竞价/供应商/分类/用户 CRUD、配置修改、邀请发送。
- 新增 GET /api/admin/logs,支持分页与按 action、关键词筛选。
- 系统设置页加操作记录板块:时间/操作人/类型/详情/IP;登录失败也记,用于排查异常登录。
供应商邀请制:32 位 token + 身份验证 + 鉴权中间件
- 小程序导航标题由「竞价系统」改为「中航天业」,验证页显示 Logo 与系统名。
- 邀请制:每次生成 32 位随机 token,链接 pages/verify/verify?token=xxx,供应商填公司/姓名/手机验证后才能看竞价与价格。
- 服务端 supplierAuth 中间件拦截,未验证 token 访问详情接口直接 401。
- 后台竞价列表加邀请按钮:查看已邀供应商、复制链接、发送新邀请。