WEB PROJECTS · WORK RECORD

网页项目工作记录汇总

每日打卡 · 工作系统 · 个人门户 —— 三个独立网页项目的统一档案
整理日期:2026年10月8日 平台:Vercel + 阿里云域名 维护:AI 助手
PART 01 · OVERVIEW

项目总览

三个项目均托管在同一 Vercel 账号(chenmo0816)下,但彼此完全独立、各绑子域名;域名 iastro.ac.cn 在阿里云管理。

项目用途访问地址数据存储状态
checkin 田浩天每日学习打卡(家庭) checkin.iastro.ac.cn Upstash Redis(新加坡)+ 本地缓存 运行中 · v7.4
work-management 空间任务研制项目管理系统(工作) work.iastro.ac.cn Upstash Redis(云端) 运行中 · v2.5/2.6
home 个人综合门户(导航 + 内容) home.iastro.ac.cn 纯静态;随想页用浏览器本地存储 运行中 · 新建
统一的账号与域名信息 Vercel 账号 chenmo0816,团队 ID team_CITiDt3frX5PlFLxJKjAPtU8;根域名 iastro.ac.cn 在阿里云(万网,权威 NS 为 dns21/dns22.hichina.com),各子域名以 CNAME 指向 cname.vercel-dns.com。
PART 02 · CHECKIN

每日打卡系统(checkin)

田浩天每日学习打卡,含学科任务、户外锻炼、课外阅读、积分奖励与云端同步;项目 ID prj_V1xgBTL6aXwzPRCsKCnSdhXwo0wK。

前端四个页面

  • index.html 主打卡页(含 WEEK_THEME 循环配置)
  • dad.html / mom.html 爸爸端 / 妈妈端
  • family.html 家庭端(合影轮播)

后端接口与数据

  • api/data.js 数据读写(GET/POST)
  • api/geocode.js 地理编码
  • Upstash Redis「checkin-db」新加坡节点
  • Key 格式 checkin:{家庭ID}

规则打卡与积分

  • 7 天循环:周一四语文、周二五英语、周三六数学、周日补漏
  • 主题日须完成当天科目全部 3 项
  • 基础 +10,额外项每项 +3,全勤 +10
  • 连续 3/7/14/30/100 天里程碑奖励

版本演进时间线

v1.0 · 08-31

初始版本

基础打卡功能,部署到 Vercel。

v2.0 · 08-31

三科独立打卡

语文/数学/英语各 3 项;积分、连续打卡、日历、历史记录;绑定 checkin.iastro.ac.cn。

v4.0 · 08-31

7 天固定循环

由 6 天循环改为 7 天;主题科目须完成全部 3 项;任务显示「上次完成时间」。

v6.0–6.2 · 08-31

户外锻炼 + 课外阅读

新增两类独立附加打卡(各 3 项,1/2/3 项分别 +3/+6/+10),不影响学科打卡。

v7.0 · 09-01

云端同步(重大升级)

新增 /api/data 与 Upstash Redis;家庭 ID 机制(默认 tianhaotian)实现多设备共享,本地缓存兜底。

v7.1 · 09-02

补打卡功能

可补打最近 7 天内的卡;补打卡不计入连续里程碑,不能打未来日期。

v7.2 · 09-10

数学 / 英语主题对调

周二五改英语、周三六改数学;唯一配置点 WEEK_THEME。dpl_3TqmUpSnQssVRBbdMA3AiNYGcV2g

v7.3 · 09-13

家庭合影默认显示最新

合影轮播默认定位最新上传,上传后自动跳转。dpl_QNBDLWAcTTgq2Asswa2JUGGd6Jva

v7.4 · 10-08

法定节假日休息 + 自愿打卡

依据国务院2026放假安排,法定节假日当天默认折叠任务、显示休息提示,不算打卡记录日;连续打卡与月度完成率自动跳过节假日、不因休息中断;提供“自愿打卡”入口,自愿打卡仍计入连续与积分;日历标注节假日“休”。dpl_q7Kvk7NRH5TVCRYemPUv4ajYHUSH

PART 03 · WORK

工作系统(work-management)

空间任务研制项目管理系统,任务看板 / 甘特图 / 进度管理,多人协作、云端存储;项目 ID prj_iH7zwun5hlgKxyVwwYKBBxwPjmwz。

结构页面与接口

  • index.html 单页应用(业务界面 + 注入式登录)
  • api/workdata.js 任务数据读写(Upstash,key work_management_data)
  • api/upload.js 收文件并触发部署、强制保留登录

账号登录与权限

  • 8 个账号 user1 ~ user8
  • 仅 user1、user8 可见「上传更新」
  • 登录系统固化在服务器端,上传不丢失

数据云端与备份

  • Upstash Redis 云端,重部署不丢数据
  • 编辑后防抖 1.5 秒自动保存
  • 支持导出 JSON 备份

部署 / 变更脉络

09-09

系统上线 v2.5

8 用户登录、Upstash 云端 API、自动保存;绑定 work.iastro.ac.cn 并添加 CNAME。dpl_BoMxW3Rx52moPBj26iroKZsnhPfX

09-09

上传更新功能

工具栏 + 上传弹窗(支持 .html / .zip),/api/upload 自动部署。

09-10

登录功能保护机制

登录系统以哨兵标记固化在 upload.js,先剥离旧版再强制注入,失败熔断,保证登录永不丢失。

09-10

v2.6 新版适配

修复弹窗层级遮挡;数据源由本地 tasks.json 改指向 /api/workdata,解决线上 404 卡死。

09-10

用户信息条移至右下角

避免遮挡顶部工具栏;恢复服务器端权威的上传通道。

历史教训(维护时注意) 单页 HTML 代码量大,重复声明变量 / 误删业务 script 曾导致整页 JS 失效;改动务必保持脚本语法正确,上传逻辑只做范围删除、不整块删 <script>,空脚本清理须排除带 src 的 CDN 引用。
PART 04 · HOME

个人门户(home)

个人综合门户,统一入口与内容承载;纯静态、无数据库;项目 ID prj_ZLSzxYSZ5rMBMACM1qatAmavIHqK。

板块内容链接方式
每日打卡田浩天打卡系统外链 checkin.iastro.ac.cn(新标签)
工作系统空间任务项目管理系统外链 work.iastro.ac.cn(新标签)
参观报告参观 / 游记文集,首篇为陕历博报告内部 reports/shaanxi-museum/
随想记录随想本,可增删、本地保存内部 notes/(localStorage)
其他 · 更多照片影像、文档资料预留内部 more/(规划中)
部署信息 门户为全新独立项目,2026-06-10-08 上线,首个生产部署 dpl_7XJJbm1fgnbARrDDGCv1GsqphX52(READY),域名 home.iastro.ac.cn 已验证;本地项目目录 …\new-chat\home\。「随想记录」保存在当前浏览器、不跨设备同步。
PART 05 · ARCHITECTURE

架构与隔离关系

同一根域名下三条独立 CNAME,分别指向三个互不相通的 Vercel 项目;任何一个项目的部署都不会影响另外两个。

阿里云 DNS · iastro.ac.cn 权威 NS:dns21 / dns22.hichina.com CNAME checkin CNAME work CNAME home 均指向 cname.vercel-dns.com checkin(打卡) checkin.iastro.ac.cn 4 前端页 + api/data Upstash Redis 新加坡 独立项目 · v7.4 work-management(工作) work.iastro.ac.cn 单页 + workdata/upload Upstash Redis · 8 用户 独立项目 · v2.5/2.6 home(门户) home.iastro.ac.cn 纯静态 · 五板块 随想页 localStorage 独立项目 · 新建 三个项目之间无任何代码 / 部署依赖,各自独立发布、独立回滚
PART 06 · RUNBOOK

通用部署与运维流程

三个项目都通过 Vercel REST API 部署、阿里云 CNAME 解析,流程一致。

准备访问令牌

Vercel → Account Settings → Tokens → Create,Scope 选对应账号 / 团队,有效期宜短。

整理待上传文件

文本用 UTF-8;图片等二进制必须 "encoding":"base64",否则文件损坏。

(新项目)创建项目

POST /v11/projects,纯静态项目 framework 设为 null。

创建生产部署

POST /v13/deployments,带 name、files、"target":"production"。

轮询部署状态

GET /v13/deployments/{id},直到 readyState = READY(通常数十秒)。

绑定自定义域名

POST /v10/projects/{id}/domains,提交完整子域名。

添加阿里云解析

云解析 DNS 加 CNAME:主机记录为子域名前缀,记录值 cname.vercel-dns.com。

实测与比对

访问域名与接口确认 200;用 curl 下载 + SHA256 比对线上与本地一致。

两个常见“坑” ① 国内直连 *.vercel.app 常被墙 / 超时,务必走自定义域名访问;② 修改 Vercel 环境变量后需重新部署才生效。
PART 07 · SECURITY

凭据与安全

本汇总只记录凭据的“存放位置”,不复制明文密码与令牌。

凭据存放位置使用 / 处理
Vercel Access Token不长期留存;长期令牌置于项目环境变量 VERCEL_API_TOKEN短期令牌用后即在 Vercel 删除
Upstash URL / Token各项目 Vercel 环境变量(UPSTASH_REDIS_REST_URL / TOKEN)重部署不影响;勿外发
工作系统账号user1 ~ user8,初始密码见内部部署日志建议后续通知改密
阿里云控制台由本人掌握,用于域名解析添加 / 修改 CNAME
数据安全要点 打卡与工作的业务数据均在 Upstash Redis 云端,重新部署代码不影响数据;两个系统都支持导出备份。门户「随想」仅存本地浏览器,清除浏览器数据会一并清除。
PART 08 · TODO

后续待办

汇总自三个项目的原始记录,按项目归类。

checkin

  • 拍照上传作业截图(待定)
  • 打卡提醒推送功能
  • 任务时长按实际调整
  • 课内作业完成情况记录

work

  • 增加修改密码界面
  • 上传接口增加口令鉴权
  • 通知各账号修改初始密码

home

  • 照片 / 影像板块落地(按年月)
  • 文档 / 资料板块落地
  • 继续添加参观报告、游记
PART 09 · INDEX

原始记录与源码位置

本汇总依据下列原始档案整理,需要细节时可回溯对应文件。

说明 桌面 res_debug.txt 为远程桌面分辨率调试记录,与网页项目无关,未纳入本汇总。本档案随系统调整持续更新,新增部署 / 变更后在对应项目追加,并刷新本汇总。