日序 · 每天都有安排

面向普通用户的本地优先微信日程管理小程序：记录、安排日期、提醒、专注，再完成。

项目状态

这是一个仍在开发中的微信原生小程序源码项目，尚未发布为正式产品。当前 main 可通过本地质量检查；CloudBase、多账号共享、订阅消息和真机交互仍需要使用者在自己的微信/云开发环境中配置并验收。

项目不含 AppSecret、访问令牌、管理密钥、真实 CloudBase 环境 ID 或用户数据。project.config.json 使用微信开发者工具的 touristappid 占位符。

已实现能力

• 本地优先的事项创建、编辑、完成与软删除；收集箱、自定义清单与日期安排。
• 周历、6×7 月历、农历/节气展示、重复事项、子任务、倒数和应用内提醒中心。
• 基于时间戳的个人专注计时与记录；本地数据版本迁移、容量保护和稳定 UUID。
• 可选 CloudBase 同步、共享清单与 expectedVersion 乐观并发控制。
• 共同专注：固定公开自习室、微信邀请房、独立计时、有限轮询、成员状态及服务端内容安全校验。

未实现或未完成验收：管理后台、正式订阅消息发送、生产环境部署、真实多设备收敛、双账号共享及 iOS/Android 真机全量验收。项目不包含 AI、外部日历同步、附件、付费或公开动态社区。

技术栈

• 微信原生小程序、TypeScript、WXML、WXSS
• 微信 Storage（本地优先）与 CloudBase 云函数
• Node.js、pnpm、TypeScript、ESLint、Prettier、Node 内置测试运行器

功能预览

今日	日历	专注	我的

预览图只展示界面；不代表云端能力、双账号共享或真机发布已经验收。

架构

页面 / 组件
  → Service / Repository
  → 领域规则（日期、重复、提醒、同步、专注）
  → LocalDataStore → 微信 Storage
  → 可选 Cloud Adapter → rixuApi 云函数 → CloudBase

页面不直接读写业务 Storage 或 CloudBase。个人数据先本地写入，再按需同步；共享数据始终由云函数从可信 OPENID 判断身份、权限和版本，前端不拥有写入授权。

更完整的边界和数据契约见 架构文档、数据模型 与 决策记录。

快速开始

前置条件：Node.js >=22.13 <27、pnpm >=11 <12、微信开发者工具。

corepack enable
corepack prepare pnpm@11.16.0 --activate
pnpm install --frozen-lockfile
pnpm check
pnpm audit:public

然后在微信开发者工具中导入仓库根目录。不配置 CloudBase 时，小程序应以游客本地模式运行。

若要使用你自己的 AppID 或 CloudBase 环境，请仅在本机填写配置：

1. 在 apps/miniprogram/config/cloudbase.ts 的 envId 填写你自己的环境 ID；该文件的改动只能留在本机，不能提交。
2. 仅在本机的 project.config.json 填写你从微信平台取得的 AppID；不要提交该变更。
3. 按 CloudBase 配置说明 部署云函数、创建集合和索引。

不要在客户端、提交记录、Issue 或截图中放入 AppSecret、访问令牌、管理密钥、真实环境 ID、用户资料或聊天内容。

质量与验证

pnpm check 执行 TypeScript、ESLint、Prettier、结构安全检查和 201 个 Node 自动测试。自动测试覆盖本地数据、重复规则、同步合并、共享权限、内容审核失败关闭及页面静态契约；它不能替代微信开发者工具、真机、真实云环境或双账号验收。

目录

apps/miniprogram/  小程序页面、组件、领域规则与本地服务
cloudfunctions/    rixuApi：同步、共享权限和共同专注的可信入口
config/            可提交的配置示例
docs/              产品、架构、数据、UI、决策和公开发布资料
scripts/           结构检查与公开源码审计
tests/             单元、契约与静态页面测试

文档与贡献

• 产品范围 · 架构 · 数据模型 · UI 规范
• 开发计划与验收边界 · 技术决策 · CloudBase 配置
• 公开发布清单 · 贡献指南 · 安全政策

开源许可

本项目以 MIT License 发布。