diff --git a/README.md b/README.md index 543c251..0f620bb 100644 --- a/README.md +++ b/README.md @@ -66,12 +66,12 @@ export APP_VERSION=2.0.0-rc.66 docker compose pull docker compose --profile operations run --rm migrate docker compose up -d -curl -fsS http://服务器地址:48731/health/ready +curl -fsS http://127.0.0.1:48731/health/ready # 4. 首次部署时初始化 Owner 账号 docker compose --profile operations run --rm bootstrap ``` -默认访问地址是 `http://服务器地址:48731`。初始化成功后建议从 `.env` 里删掉 `OWNER_PASSWORD`,并删除或轮换 `BOOTSTRAP_TOKEN`。需要 HTTPS 和反向代理时可加 `--profile gateway`,由 Caddy 签发证书并发布入口。 +默认只有服务器本机能访问 `http://127.0.0.1:48731`。要让其他设备打开,二选一:把 `.env` 里的 `TASKDOCK_BIND_ADDRESS` 改成 `0.0.0.0`(明文 HTTP,仅限可信网络),或在 `APP_ORIGIN` 填好域名后执行 `docker compose --profile gateway up -d`,由 Caddy 提供 HTTPS 入口。初始化成功后建议从 `.env` 里删掉 `OWNER_PASSWORD`,并删除或轮换 `BOOTSTRAP_TOKEN`。 **网页端**:中枢起来后,浏览器打开你配置的 `APP_ORIGIN` 即可,无需安装。 diff --git a/docs/API.md b/docs/API.md index 3be6218..2aef188 100644 --- a/docs/API.md +++ b/docs/API.md @@ -4,29 +4,29 @@ ## v2 资源 -v2 不再把 Project/Inbox/category/priority 作为产品模型。`GET /api/v2/tree/children` 返回 Folder 与 Task 的混合直接子项;Folder 的 `aggregate` 由后代 Task 派生,状态顺序为 `IN_PROGRESS → TODO → DONE`。`POST /api/v2/tree/items/move` 使用 `baseVersion`、状态快照和前后锚点保护循环、已归档目标以及并发排序冲突。 +v2 不再把 Project/Inbox/category/priority 作为产品模型。`GET /api/v2/tree/children` 返回 Folder 与 Task 的混合直接子项;Folder 的 `status` 是文件夹自身持有的显式三态(默认 `TODO`),`aggregate` 里的 `todoCount/inProgressCount/doneCount/totalCount` 由后代 Task 派生,排序状态顺序为 `IN_PROGRESS → TODO → DONE`。`POST /api/v2/tree/items/move` 使用 `baseVersion`、状态快照和前后锚点保护循环、目标父级以及并发排序冲突。 目录分页:`GET /api/v2/tree/children?parentFolderId=root&limit=100`,`limit` 为 1–200;下一页携带响应的 `nextCursor`,末页为 `null`。游标绑定账户、父目录及账户版本;中途发生写入返回 HTTP 410 `SYNC_CURSOR_EXPIRED`,调用方应保留已展示内容并提供从第一页重新加载,不自动无限重试。排序键为状态组、整数 rank、类型(文件夹优先)、ID。未指定 `limit` 的旧客户端继续得到全部直接子项。 `GET /api/v2/tasks/{id}?view=summary` 只返回 `{ task }`,用于状态切换后保持当前行的位置,不读取备注或关系;省略 `view` 继续返回原有详情。 -PostgreSQL 的目录、文件夹选择器及面包屑读取不调用全账户 `prepare()`,不读取备注、步骤或工作流关系;文件夹状态汇总仍需扫描该目录下的活动后代,不能将一级分页当成后代扫描恒定开销。面包屑与内容独立加载。分页不推进全局同步游标;客户端只缓存精确页面成员,未完整 bootstrap 时不能据此构造未读取页或宣称全目录完整。完整本地投影使用独立的 `local.` 游标,绝不发送给服务器。 +PostgreSQL 的目录、文件夹选择器及面包屑读取不调用全账户 `prepare()`,不读取备注、步骤或工作流关系;文件夹进度计数仍需扫描该目录下的活动后代,不能将一级分页当成后代扫描恒定开销。面包屑与内容独立加载。分页不推进全局同步游标;客户端只缓存精确页面成员,未完整 bootstrap 时不能据此构造未读取页或宣称全目录完整。完整本地投影使用独立的 `local.` 游标,绝不发送给服务器。 -目录归档使用 `POST /api/v2/folders/:id/archive-tree`,响应 `ArchiveOperation`;恢复使用原 operationId,保证逐项精确恢复。归档中心通过 `GET /api/v2/archive-operations` 按顶层归档操作分组返回(含 `rootFolderTitle`、后代 Folder/Task 计数、原本已归档而恢复时需保留的计数,以及可展开的嵌套 Folder 列表);`?includeRestored=true` 才包含已恢复操作,`GET /api/v2/archive-operations/:id` 额外返回该操作的归档 Task 明细与独立归档 Task。整树删除必须先 `POST /api/v2/folders/:id/delete-preview`,再把短时 `confirmationToken` 发送到 `DELETE /api/v2/folders/:id/tree`;预览 fingerprint 变化或令牌过期时拒绝,不物理删除关联 Note、TaskStep、Placement、Workflow Membership 或父级引用。整树删除必须在线执行;离线客户端 fail-closed 并返回 `OFFLINE_TREE_DELETE_FORBIDDEN` 与归档建议,不允许排队执行不可恢复的删除。 +整树删除必须先 `POST /api/v2/folders/:id/delete-preview`,再把短时 `confirmationToken` 发送到 `DELETE /api/v2/folders/:id/tree`。预览返回将删除的文件夹、任务、备注、步骤、日程和流程关联计数,以及 `subtreeFingerprint`;fingerprint 变化或令牌过期时拒绝,不物理删除关联 Note、TaskStep、Placement、Workflow Membership 或父级引用。整树删除必须在线执行;离线客户端 fail-closed 并返回 `OFFLINE_TREE_DELETE_FORBIDDEN`,不允许排队执行不可恢复的删除。 -批量顺延使用 `POST /api/v2/dates/:localDate/rollover`,只把该日期仍处于活动状态的 Placement 复制到次日,跳过已完成或已归档任务;响应 `{ createdIds, skippedTaskIds, targetDate }`。撤销使用 `POST /api/v2/rollovers/undo`,body 传 `{ placementIds }`。该操作无服务端状态,可跨进程与重启使用;离线时不排队,直接 fail-closed。 +批量顺延使用 `POST /api/v2/dates/:localDate/rollover`,只把该日期仍处于活动状态的 Placement 复制到次日,跳过已完成或已删除的任务;响应 `{ createdIds, skippedTaskIds, targetDate }`。撤销使用 `POST /api/v2/rollovers/undo`,body 传 `{ placementIds }`。该操作无服务端状态,可跨进程与重启使用;离线时不排队,直接 fail-closed。 -`GET /api/v2/tasks?archived=false&q=...` 支持按任务标题、引用 ID 或备注内容搜索。Task 详情通过 `GET /api/v2/tasks/:id` 聚合 Note、独立 TaskStep、Placement、Workflow Membership 和 Folder path;每个 Placement 同时返回可直接展示的 `timePoint` 日期/事件信息。日期与 Event/Placement 使用 `/time-points`、`/placements` v2 路由;Workflow、Stage、Membership 使用 `/workflows`、`/workflow-stages` 和 `/workflow-memberships`。同一 Task 可以加入多个 Workflow,但同一 Workflow 只能有一个活动 Membership。 +`GET /api/v2/tasks?q=...` 支持按任务标题、引用 ID 或备注内容搜索。Task 详情通过 `GET /api/v2/tasks/:id` 聚合 Note、独立 TaskStep、Placement、Workflow Membership 和 Folder path;每个 Placement 同时返回可直接展示的 `timePoint` 日期/事件信息。日期与 Event/Placement 使用 `/time-points`、`/placements` v2 路由;Workflow、Stage、Membership 使用 `/workflows`、`/workflow-stages` 和 `/workflow-memberships`。同一 Task 可以加入多个 Workflow,但同一 Workflow 只能有一个活动 Membership。 v2 设置通过 `/api/v2/settings` 保存 `ROOT/RECENT_FOLDER` 目标;`GET /api/v2/status` 返回 `schemaVersion: 2`、支持的 API/sync 版本和 `minClientVersion`。v2 写入继续要求 `Idempotency-Key`、`X-Client-Id` 和适用的 `baseVersion`。 ## 认证 -首次部署由部署中枢执行 `docker compose --profile operations run --rm bootstrap`,服务端内部仍使用 `POST /bootstrap` 和 `BOOTSTRAP_TOKEN`,成功后永久关闭;Web、桌面和手机客户端不提供初始化令牌输入。`POST /auth/login` 返回短时 access token;Web refresh token 是 `HttpOnly`、`SameSite=Lax` Cookie:使用 HTTPS 时还会带有 `Secure` 属性,使用 HTTP 时为了让 HTTP 外网地址可用而不带 `Secure`,但密码和会话信息会明文传输,页面会显示安全警告。原生容器应通过平台安全存储持有 refresh token。每次 refresh 都轮换 token,并把 365 天滑动不活动窗口重新计时;旧链重放会撤销该设备会话链。Web Cookie 同样按该窗口重设,但浏览器对持久 Cookie 有约 400 天上限。`DELETE /devices/{id}` 可撤销指定设备的全部会话,`GET /devices` 会标记 `current` 表示当前设备。 +首次部署由部署中枢执行 `docker compose --profile operations run --rm bootstrap`,服务端内部仍使用 `POST /bootstrap` 和 `BOOTSTRAP_TOKEN`,成功后永久关闭;Web 和 Android 客户端不提供初始化令牌输入。`POST /auth/login` 返回短时 access token;Web refresh token 是 `HttpOnly`、`SameSite=Lax` Cookie:使用 HTTPS 时还会带有 `Secure` 属性,使用 HTTP 时为了让 HTTP 外网地址可用而不带 `Secure`,但密码和会话信息会明文传输,页面会显示安全警告。原生容器应通过平台安全存储持有 refresh token。每次 refresh 都轮换 token,并把 365 天滑动不活动窗口重新计时;旧链重放会撤销该设备会话链。Web Cookie 同样按该窗口重设,但浏览器对持久 Cookie 有约 400 天上限。`DELETE /devices/{id}` 可撤销指定设备的全部会话,`GET /devices` 会标记 `current` 表示当前设备。 ## 写入约定 -所有写请求需要合法 UUID `Idempotency-Key` 和 `X-Client-Id`。更新/归档/恢复需要 body 中的 `baseVersion`。服务端重复接收相同 mutation 返回第一次结果,不重复创建 Task 或 Placement。冲突 HTTP 409,错误体固定为: +所有写请求需要合法 UUID `Idempotency-Key` 和 `X-Client-Id`。更新/删除需要 body 中的 `baseVersion`。服务端重复接收相同 mutation 返回第一次结果,不重复创建 Task 或 Placement。冲突 HTTP 409,错误体固定为: ```json { @@ -45,8 +45,8 @@ v2 设置通过 `/api/v2/settings` 保存 `ROOT/RECENT_FOLDER` 目标;`GET /ap - `/placements/:id/move` 在一个 mutation 中建立目标并软删除来源。 - `/tasks/:id/duplicate` 才创建新的 Task、Note 和引用 ID。 - `POST /time-points/date` 对同一 Owner/localDate 幂等返回同一 Date TimePoint。 -- Task status 全局生效,Event 的 `reachedAt/archivedAt` 独立。 -- 普通列表默认排除归档和 tombstone;`/search/tasks?includeArchived=true` 可搜索归档任务。 +- Task status 全局生效,Event 的 `reachedAt` 独立。 +- 普通列表默认排除 tombstone;任务搜索使用 `GET /api/v2/tasks?q=`,覆盖标题、引用 ID 和备注内容。 ## 列表与分页 diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 6624ad2..776ca69 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -13,7 +13,7 @@ Web/PWA 直接加载 React Web 产物,并通过浏览器的 Fetch、Cookie、I - `packages/sync-client`:IndexedDB/Dexie v2 schema、v1 outbox 转换、push/pull、冲突记录、tombstone 和重同步。 - `apps/web`:React/PWA 目录树、混合排序、工作流、步骤、日期/Placement 和删除预览界面。 - `apps/mobile`:Capacitor 工程与 `apps/mobile/android` 原生 Compose/Room 客户端;原生客户端不依赖 React 页面来满足 v2 功能。 -- `apps/api/src/tree-store.ts`:Owner-scoped v2 目录树、归档操作、Workflow、TaskStep、时间点/Placement 以及内存迁移投影。 +- `apps/api/src/tree-store.ts`:Owner-scoped v2 目录树、Workflow、TaskStep、时间点/Placement 以及内存迁移投影。 - `apps/api/src/postgres-tree-store.ts`:PostgreSQL v2 projection 的单查询加载、增量 change-feed 追赶、批量持久化和 v2 change feed 适配。 - `apps/api/src/cache.ts`:可选 Redis 共享限流/冷启动缓存;缓存投影故障回退数据库,认证限流是否允许进程内回退由 `AUTH_RATE_LIMIT_REQUIRE_SHARED` 决定。 - 主题:Web 使用 `prefers-color-scheme`,Android 使用 `Configuration.uiMode` 同步系统栏并向 WebView 派发主题事件;主题是设备运行时状态,不进入账号同步设置。 @@ -28,8 +28,8 @@ Web/PWA 直接加载 React Web 产物,并通过浏览器的 Fetch、Cookie、I 4. v2 Task 只有一个 `parentFolderId`;旧 `projectId/category/priority` 仅在兼容存储/迁移边界保留,不进入 v2 DTO/UI。 5. 每次版本更新都检查 `baseVersion`;失败返回 `VERSION_CONFLICT` 和服务器快照。 6. mutation receipt、领域写入、版本递增和 change feed 在同一 Store mutation 中提交。 -7. Folder 归档为一次有 operationId 的逐实体写入;恢复只恢复该 operationId 写入的边界,不误恢复此前已归档的后代。删除预览的 fingerprint/token 过期或变化时 fail-closed,并为 Folder、Task、Note、Step、Placement、Membership 产生 tombstone。 -8. Folder aggregate/status 是由未归档、未删除后代 Task 迭代派生的只读结果,不进入持久化状态或 change feed。 +7. 整树删除先由 `POST /api/v2/folders/:id/delete-preview` 生成短时 token 和 subtree fingerprint,再通过 `DELETE /api/v2/folders/:id/tree` 执行;fingerprint 变化或 token 过期时 fail-closed,并为 Folder、Task、Note、Step、Placement、Membership 产生 tombstone。 +8. Folder 的 `status` 是文件夹自身持久化的显式三态;`aggregate` 的计数由未删除后代 Task 迭代派生,不进入持久化状态或 change feed。 9. 同一 Task 可进入多个 Workflow;同一 Workflow 内活动 Membership 唯一。TaskStep 的状态和 completedAt 独立于 Task.status。 ## ADR diff --git a/docs/BACKUP_RESTORE.md b/docs/BACKUP_RESTORE.md index c435a09..19f3936 100644 --- a/docs/BACKUP_RESTORE.md +++ b/docs/BACKUP_RESTORE.md @@ -4,7 +4,7 @@ ## 备份与校验 -TaskDock v2 数据升级前必须先完成 PostgreSQL custom dump;本轮新增 migration `0005_v2_structure.sql`、`0006_v2_backfill.sql`、`0007_v2_constraints.sql`。升级顺序是先备份,再让新代码读取旧/新结构,执行 backfill 和约束校验;禁止用 `TRUNCATE`、重建业务表或 destructive migration 替代。必须核对 Project→Folder、Task `reference_id`、Note、Placement、归档边界和用户设置计数后再继续。 +TaskDock v2 数据升级前必须先完成 PostgreSQL custom dump;本轮新增 migration `0005_v2_structure.sql`、`0006_v2_backfill.sql`、`0007_v2_constraints.sql`。升级顺序是先备份,再让新代码读取旧/新结构,执行 backfill 和约束校验;禁止用 `TRUNCATE`、重建业务表或 destructive migration 替代。必须核对 Project→Folder、Task `reference_id`、Note、Placement、删除边界(tombstone)和用户设置计数后再继续。 ```bash BACKUP_DIR="$PWD/backups" diff --git a/docs/STATUS.md b/docs/STATUS.md index 35262c2..02df150 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -2,6 +2,8 @@ 更新时间:2026-10-13 +> 后续变更(2026-11-12):归档机制已在 `2.0.0-rc.26` 移除,本文中归档中心相关条目已失效;文件夹状态在 `2.0.0-rc.62` 改为文件夹自身持有的显式三态。冲突时以 `docs/ARCHITECTURE.md` 和代码为准。 + 总体发布状态:**FAIL(v2 完成定义未满足,但阻断项已全部关闭)**。本轮已关闭全部已知 P0/P1 源码缺陷,并补齐归档中心、v2 rollover、V2 restore 策略、离线删除 fail-closed、Folder-first 迁移分层、Android 同步恢复等此前遗留项。所有本地门禁、真实 PostgreSQL migration/integration/runtime 门禁与三浏览器 E2E 均为 PASS。 仍未运行、因而继续阻断正式发布的门禁只有环境类项:WebKit、Android 真机/仪器、Docker Compose 与长期双端离线矩阵。这些是环境缺失,不是已知实现缺陷。 diff --git a/docs/SYNC_PROTOCOL.md b/docs/SYNC_PROTOCOL.md index 3306dfa..26bac27 100644 --- a/docs/SYNC_PROTOCOL.md +++ b/docs/SYNC_PROTOCOL.md @@ -1,6 +1,6 @@ # 同步协议 -协议版本:`2`。v1 仍只作为兼容读取/转换边界存在;客户端按 `hub origin + owner id` 建立 Dexie 数据库,v2 stores 为 folders、tasks、notes、taskSteps、timePoints、placements、workflows、workflowStages、workflowTaskMemberships、archiveOperations、settings、outbox、conflicts、deferredChanges、syncMeta。Android Room 对应版本 4 schema 与显式 `MIGRATION_3_4`。 +协议版本:`2`。v1 仍只作为兼容读取/转换边界存在;客户端按 `hub origin + owner id` 建立 Dexie 数据库,v2 stores 为 folders、tasks、notes、taskSteps、timePoints、placements、workflows、workflowStages、workflowTaskMemberships、settings、outbox、conflicts、deferredChanges、syncMeta。Android Room 对应版本 4 schema 与显式 `MIGRATION_3_4`。 v2 使用独立 cursor key/协议状态,不能复用 v1 cursor。服务端 `/api/v2/sync/push` 只接受 `protocolVersion: 2`,v1 push 不会创建 v2 receipt;`/api/v2/status` 明确公布 `schemaVersion`、`supportedApiVersions`、`supportedSyncProtocols` 和 `minClientVersion`。 @@ -20,10 +20,10 @@ cursor 是不透明十进制字符串。Pull 返回完整实体快照或 tombsto ## v2 快照与实体范围 -`GET /api/v2/sync/snapshot` 返回 Folder、Task、Note、TaskStep、TimePoint、Placement、Workflow、Stage、Membership、ArchiveOperation、Settings 的一次一致性快照和对应游标。客户端在一个 IndexedDB/Room 事务中替换 v2 实体,先保留 outbox/conflict/deferred change,再重放 pending after-image;删除 change 保留 tombstone,不物理清除以免破坏恢复和冲突审计。v1 snapshot 不得冒充 v2 snapshot。 +`GET /api/v2/sync/snapshot` 返回 Folder、Task、Note、TaskStep、TimePoint、Placement、Workflow、Stage、Membership、Settings 的一次一致性快照和对应游标。客户端在一个 IndexedDB/Room 事务中替换 v2 实体,先保留 outbox/conflict/deferred change,再重放 pending after-image;删除 change 保留 tombstone,不物理清除以免破坏恢复和冲突审计。v1 snapshot 不得冒充 v2 snapshot。 ## 冲突 -版本不匹配时保留本地意图和服务端快照,不静默覆盖。Note UI 应提供采用本地、采用服务器、合并后保存;Task/Project/TimePoint 展示冲突字段。活动 Placement 重复视为幂等成功;被归档/删除实体上的更新需由用户选择恢复应用或丢弃。 +版本不匹配时保留本地意图和服务端快照,不静默覆盖。Note UI 应提供采用本地、采用服务器、合并后保存;Task/Project/TimePoint 展示冲突字段。活动 Placement 重复视为幂等成功;已删除实体上的更新需由用户选择恢复应用或丢弃。 WebSocket `/api/v2/ws` 必须先收到 access-token auth 消息;认证成功只发送 `{ "type": "ready", "protocolVersion": 2 }` 和 `{ "type": "sync.required", "cursor": "..." }`,不传业务正文。断线时由轮询、focus、online 和 Android 回前台兜底。 diff --git a/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md b/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md index 0d75095..fe6f97b 100644 --- a/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md +++ b/docs/V2_TREE_WORKFLOW_DEVELOPMENT.md @@ -7,6 +7,8 @@ > 编写基线:master 分支 af98f22;实施者开始前必须重新检查 HEAD、工作区状态和已有变更 > 文档用途:交给后续开发代理作为 v2 的单一产品与工程实施依据 > 发布边界:完成实现和本地验证后先交由用户审查;未经用户明确要求,不部署、不打标签、不创建 Release +> +> 变更提示(2026-11-12):归档机制从 `2.0.0-rc.26` 起移除,整树删除改为预览计数 + 短时确认 token;文件夹状态从 `2.0.0-rc.62` 起改为文件夹自身持有的显式三态(默认 `TODO`),不再由后代任务推导。本文其余部分仍作为当时的实施基线保留,冲突时以 `docs/ARCHITECTURE.md` 和代码为准。 ## 1. 文档优先级与规范用语 diff --git a/docs/openapi.json b/docs/openapi.json index 8c8cc12..67db86e 100644 --- a/docs/openapi.json +++ b/docs/openapi.json @@ -1007,7 +1007,7 @@ "get": { "responses": { "200": { - "description": "TaskDock v2 GET /v2/tasks; optional archived and q filters (q searches title, reference ID and note content)" + "description": "TaskDock v2 GET /v2/tasks; optional q filter (q searches title, reference ID and note content)" } } }, diff --git a/website/docs/SITE.md b/website/docs/SITE.md index e533613..064f782 100644 --- a/website/docs/SITE.md +++ b/website/docs/SITE.md @@ -17,13 +17,13 @@ TaskDock 的产品官网:介绍产品、提供下载与部署入口和文档 桌面客户端已停止维护(产品 `CHANGELOG.md`,2.0.0-rc.37 起),站点不再介绍。 中枢以 Docker 镜像发布在 GitHub Container Registry(GHCR)。 -## 当前状态(2026-10-25) +## 当前状态(2026-11-12) - 首页、下载与部署页、404 页已实现; - 已部署到 Cloudflare Pages 项目 `taskdock-website`,正式地址为 (默认别名 ); - `.github/workflows/website.yml` 在 `master` 和正式发版后自动构建并部署;线上版本来自最新发布 - (当前 2.0.0-rc.59); + (当前 2.0.0-rc.66); - 旧的独立仓库 `IGNGserver/taskdock-website` 已归档,代码与历史以产品仓库为准。 ## 已定案的决策 @@ -86,15 +86,16 @@ website/ 站点上的产品事实与出处(改文案前先核对产品仓库当前版本): -| 站点内容 | 产品仓库出处 | -| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------ | -| 目录树、日期与时间点、流程、执行步骤四个维度;文件夹状态推导;一个任务多处安排 | `docs/V2_TREE_WORKFLOW_DEVELOPMENT.md`、`docs/ARCHITECTURE.md`(不变量) | -| 顺延只复制未完成的安排、可撤销、离线拒绝;事件到达不改任务 | `docs/API.md`、`docs/ARCHITECTURE.md` | -| 先读本地、待同步队列、按顺序推送、冲突保留双方、WebSocket 只发信号 | `docs/SYNC_PROTOCOL.md` | -| Docker 部署步骤、`.env` 变量、端口 48731、Owner 初始化、升级与回滚 | `README.md`、`docs/DEPLOYMENT.md`、`compose.yaml` | -| PWA 安装与离线打开需要 HTTPS | `docs/DEPLOYMENT.md` | -| 命令面板(⌘K / Ctrl K)、移动端右滑完成与左滑菜单、三态状态圆圈 | `apps/web/src/App.tsx`、`CHANGELOG.md`(rc.24、rc.28) | -| 版本规则(预发布默认、`latest` 只指向正式版) | `README.md`、`docs/RELEASING.md` | +| 站点内容 | 产品仓库出处 | +| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | +| 目录树、日期与时间点、流程、执行步骤四个维度;文件夹独立三态与后代进度统计;一个任务多处安排 | `packages/database/migrations/0013_folder_status.sql`、`packages/domain/src/index.ts`、`docs/ARCHITECTURE.md` | +| 顺延只复制未完成的安排、可撤销、离线拒绝;事件到达不改任务 | `docs/API.md`、`docs/ARCHITECTURE.md` | +| 整树删除先预览计数与确认 token,离线拒绝 | `apps/api/src/tree-store.ts`(`previewDelete`/`deleteTree`)、`apps/web/src/TreePage.tsx` | +| 先读本地、待同步队列、按顺序推送、冲突保留双方、WebSocket 只发信号 | `docs/SYNC_PROTOCOL.md` | +| Docker 部署步骤、`.env` 变量、端口 48731、默认只绑 127.0.0.1、Owner 初始化、升级与回滚 | `README.md`、`docs/DEPLOYMENT.md`、`compose.yaml` | +| PWA 安装与离线打开需要 HTTPS | `docs/DEPLOYMENT.md` | +| 命令面板(⌘K / Ctrl K)、移动端右滑切换完成状态与左滑菜单、三态状态圆圈 | `apps/web/src/App.tsx`、`CHANGELOG.md`(rc.24、rc.28) | +| 版本规则(预发布默认、`latest` 只指向正式版) | `README.md`、`docs/RELEASING.md` | ## 维护 diff --git a/website/site/assets/css/site.css b/website/site/assets/css/site.css index 0988825..e91f618 100644 --- a/website/site/assets/css/site.css +++ b/website/site/assets/css/site.css @@ -2604,48 +2604,45 @@ button.status[data-s='done'] { } } -/* 细节演示:归档恢复 */ -.demo-archive { +/* 细节演示:删除预览 */ +.demo-delete { display: flex; align-items: center; - gap: 8px; + gap: 10px; height: 100%; padding: 0 14px; font-size: 11.5px; color: var(--text-2); } -.demo-archive .box { +.demo-delete .files { display: flex; gap: 4px; } -.demo-archive .box i { - width: 14px; - height: 20px; +.demo-delete .files i { + width: 13px; + height: 19px; border-radius: 4px; background: var(--ink-4); border: 1px solid var(--line-strong); - animation: archive-fold 4s var(--ease-out) infinite; - animation-delay: calc(var(--i) * 0.08s); } -@keyframes archive-fold { - 0%, - 20% { - transform: none; - opacity: 1; - } - 40%, - 60% { - transform: translateY(10px) scale(0.6); - opacity: 0.35; - } - 80%, - 100% { - transform: none; - opacity: 1; - } +.demo-delete .sum { + flex: 1; + font-family: var(--font-mono); + font-size: 10px; + line-height: 1.4; + color: var(--text-3); +} + +.demo-delete .go { + padding: 4px 8px; + border-radius: 6px; + border: 1px solid rgba(239, 154, 143, 0.32); + background: rgba(239, 154, 143, 0.12); + font-size: 10.5px; + color: var(--rose); } /* 细节演示:TASK-N */ diff --git a/website/site/assets/js/dimensions.js b/website/site/assets/js/dimensions.js index 70c2931..01d0ac5 100644 --- a/website/site/assets/js/dimensions.js +++ b/website/site/assets/js/dimensions.js @@ -1,11 +1,11 @@ // “一个任务,四个维度”:同一个任务在目录、日程、流程、步骤四个视图里被引用。 // 切换视图时,任务卡作为共享元素在视图之间移动(View Transitions); -// 任意一处切换状态,所有引用同时更新,文件夹状态随之重新推导。 +// 任意一处切换状态,所有引用同时更新;文件夹状态由文件夹自己维护,不跟着任务变。 const NEXT = { todo: 'doing', doing: 'done', done: 'todo' }; const LABEL = { todo: '待开始', doing: '进行中', done: '已完成' }; const DESC = { - tree: '文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹没有手动状态,由全部后代任务实时推导。', + tree: '文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹也有自己的三态状态,默认待开始,在更多菜单里切换;后代任务只用来统计完成进度。', time: '同一个任务可以同时出现在多个日期,也可以挂在「额度重置后」「上线前」这样的自定义事件上。', flow: '把任务放进分阶段的流程看板。一个任务可以加入多个流程,在同一个流程里只出现一次。', steps: @@ -61,26 +61,19 @@ function days() { return out; } -/** 文件夹状态:全部待开始=待开始,全部完成=已完成,其余为进行中。 */ -function derive(list) { - if (list.every((s) => s === 'todo')) return 'todo'; - if (list.every((s) => s === 'done')) return 'done'; - return 'doing'; -} - function views() { const d = days(); return { tree: `
-
${svg('i-folder')}开发
-
${svg('i-folder')}TaskDock
-
${svg('i-folder')}发布 2.0
+
${svg('i-folder')}开发进行中
+
${svg('i-folder')}TaskDock进行中
+
${svg('i-folder')}发布 2.0进行中
${focusCard('style="--depth:3"')}
更新部署说明
-
${svg('i-folder')}Android
+
${svg('i-folder')}Android待开始
整理家里 NAS 的备份
-

文件夹状态由全部后代任务推导,试试把任务标记为已完成。

+

文件夹状态在更多菜单里单独切换,点任务只改任务。

`, time: ` ${focusCard()} @@ -160,34 +153,6 @@ export function initDimensions(lens, tabsEl) { }); const ref = stage.querySelector('[data-caption-ref]'); if (ref) ref.textContent = `${focus.ref} · ${LABEL[focus.s]}`; - - // 文件夹状态推导 - // 每个文件夹统计全部层级的后代任务,而不是子文件夹的状态 - const relTasks = [focus.s, 'done']; - const andTasks = ['doing', 'todo']; - const tdTasks = [...relTasks, ...andTasks]; - const devTasks = [...tdTasks, 'todo']; - const aggs = { - rel: derive(relTasks), - and: derive(andTasks), - td: derive(tdTasks), - dev: derive(devTasks), - }; - stage.querySelectorAll('[data-agg]').forEach((el) => { - const s = aggs[el.dataset.agg]; - const changed = el.dataset.s && el.dataset.s !== s; - el.dataset.s = s; - el.innerHTML = `${LABEL[s]}`; - el.style.color = s === 'done' ? 'var(--sage)' : s === 'doing' ? 'var(--amber)' : ''; - if (changed) - el.animate( - [ - { opacity: 0.2, transform: 'translateY(-4px)' }, - { opacity: 1, transform: 'none' }, - ], - { duration: 420, easing: 'cubic-bezier(.22,1,.36,1)' }, - ); - }); } function render(view) { diff --git a/website/site/download.html b/website/site/download.html index 076580c..f7e8c68 100644 --- a/website/site/download.html +++ b/website/site/download.html @@ -175,7 +175,7 @@

浏览器 / PWA

APP_ORIGIN 地址就能使用,无需安装客户端。使用 HTTPS 时可以安装为 PWA 并离线打开。

-
默认 http://服务器地址:48731
+
默认仅本机 http://127.0.0.1:48731
03 · 手机 @@ -207,7 +207,7 @@

Android

部署五步完成

用 Docker Compose
部署中枢。

- 以下步骤与产品仓库的 README 和部署说明一致。服务器只需要 Docker 与 Docker Compose。 + 以下步骤按产品仓库的 README 和部署说明整理。服务器只需要 Docker 与 Docker Compose。

@@ -261,8 +261,19 @@

填写 .env

TASKDOCK_PORT - 对外 HTTP 端口,默认 - 48731;被占用时可以换成其他五位端口。 + 宿主机映射的 HTTP 端口,默认 + 48731;默认只绑定 + 127.0.0.1。被占用时可以换一个空闲端口。 + + + + TASKDOCK_BIND_ADDRESS + + 绑定的宿主机地址,默认 + 127.0.0.1,只有服务器本机能访问。要让局域网内其他设备直连,设为 + 0.0.0.0(明文 + HTTP,仅限可信网络);公网请用 gateway。 @@ -325,8 +336,8 @@

选择版本并启动

$ docker compose pull $ docker compose --profile operations run --rm migrate $ docker compose up -d -# 检查就绪状态(使用 HTTPS 或自定义端口时按 APP_ORIGIN 修改) -$ curl -fsS http://服务器地址:48731/health/ready +# 检查就绪状态(默认只绑本机,换地址或端口时按 APP_ORIGIN 修改) +$ curl -fsS http://127.0.0.1:48731/health/ready
初始化 Owner

打开并登录

- 浏览器访问 APP_ORIGIN 并登录;Android + 默认只有服务器本机能打开 + http://127.0.0.1:48731。要让其他设备访问,二选一:在 .env 里把 + TASKDOCK_BIND_ADDRESS 改成 + 0.0.0.0(明文 HTTP,仅限可信网络),或执行 + docker compose --profile gateway up -d,由 Caddy 用 + APP_ORIGIN 的域名提供 HTTPS 入口。 +

+

+ 然后用浏览器访问 APP_ORIGIN 并登录;Android 客户端安装后填写同一个中枢地址。HTTP 地址可以使用,但页面会显示安全警告,密码与会话信息会明文传输。公网环境请使用 - HTTPS:需要反向代理时,可以启用 Compose 中的 - gateway(Caddy)profile,注意不要让两个服务占用同一个宿主机端口。 + HTTPS;启用 gateway 时注意不要让两个服务占用同一个宿主机端口。

@@ -526,7 +545,9 @@

获取

  • 下载与部署
  • GitHub Releases
  • 产品源码
  • -
  • 官网源码
  • +
  • + 官网源码 +
  • diff --git a/website/site/index.html b/website/site/index.html index c379b8c..2ab0fa7 100644 --- a/website/site/index.html +++ b/website/site/index.html @@ -297,7 +297,7 @@

    一个任务,
    只有一个事实。01目录树 文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹没有手动状态,由全部后代任务实时推导。文件夹可以无限嵌套,同一级里文件夹和任务并存。文件夹也有自己的三态状态,默认待开始,在更多菜单里切换;后代任务只用来统计完成进度。 @@ -406,9 +406,7 @@

    安排不是复制

    顺延可以撤销

    -

    - 把某一天仍未完成的安排批量顺延到次日,自动跳过已完成或已归档的任务,随时可以撤销。 -

    +

    把某一天还没做完的安排顺延到第二天,已完成的任务会跳过,顺延完还能撤销。

    事件到达不改任务

    @@ -586,7 +584,7 @@

    数据放在你自己的
    服务器上。 $ docker compose pull $ docker compose --profile operations run --rm migrate $ docker compose up -d -# 默认访问 http://服务器地址:48731 +# 默认只在服务器本机可访问:http://127.0.0.1:48731
    命令面板

    05.3

    右滑完成

    - 在手机浏览器里,向右滑过阈值即可完成任务,向左滑展开操作菜单;随手记录有常驻的新建按钮。 + 在手机浏览器里,向右滑过阈值切换完成状态,向左滑展开操作菜单;随手记录有常驻的新建按钮。