Merge branch 'dev-0.2' into android-1.0

2026-10-26 21:34:39 +08:00
parent 8cfa3802d5 4b19d1d929
commit 49583599b3
247 changed files with 49616 additions and 3092 deletions
@@ -0,0 +1,12 @@
+# 大目录/与镜像无关的内容不进 build context
+# 注意: dist/ 和 ota-package/ 不能忽略 —— CI 预构建产物要通过 context 进入镜像
+.git
+.gitea
+.local
+.pnpm-store
+node_modules
+src-tauri
+docs
+*.log
+readme
+deploy
@@ -0,0 +1,10 @@
+# Windows 外壳构建模式 (npm run build:shell / vite build --mode shell)
+# 外壳内前端跑在 tauri://localhost, 没有同源后端, API 必须指向远端 Express。
+# 与 android 打包脚本 (scripts/wsl/build-apk.sh) 注入的值保持一致;
+# 进程环境变量优先级高于本文件, android 流程不受影响。
+#
+# 0.2.1 起正式域名: https://iboard.honor3.com (NPM 反代 -> baihu:3001, 受信证书)
+# PowerSync 同步端点默认同域 (NPM 把 /sync 反代到同步服务); 若改用独立子域,
+# 打包时用 VITE_POWERSYNC_URL=https://sync.example.com 覆盖即可。
+VITE_API_BASE=https://iboard.honor3.com
+VITE_POWERSYNC_URL=https://iboard.honor3.com
@@ -1,177 +1,190 @@
-name: Android Build & Publish
-
-# 仅在 android-* 分支 push 时触发 (如 android/release, android-1.0)
-# 构建 release APK (keystore 签名) 并上传到 Gitea Generic Package Registry
-on:
-  push:
-    branches:
-      - 'android-*'
-
-jobs:
-  build-android:
-    runs-on: ubuntu-latest
-    # 需要写权限: 上传 packages
-    permissions:
-      contents: read
-      packages: write
-
-    env:
-      # 固定工具链版本, 便于 actions/cache 命中
-      # Android 后端地址 (bake 进 APK); 与 scripts/wsl/build-apk.sh 保持一致
-      VITE_API_BASE: http://bh.vps.honor3.com:3001
-
-    steps:
-      - name: Checkout
-        uses: https://gitea.com/actions/checkout@v4
-
-      - name: Setup Node
-        uses: https://gitea.com/actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: 'npm'
-
-      - name: Setup JDK 17
-        uses: https://gitea.com/actions/setup-java@v4
-        with:
-          distribution: temurin
-          java-version: '17'
-
-      # ---------- 缓存: 命中后跳过下面的安装 ----------
-      - name: Cache Android SDK & NDK
-        id: cache-android
-        uses: https://gitea.com/actions/cache@v4
-        with:
-          path: ~/android-sdk
-          key: android-sdk-ndk-27.2-${{ runner.os }}
-
-      - name: Cache Rust toolchain
-        id: cache-rust
-        uses: https://gitea.com/actions/cache@v4
-        with:
-          path: |
-            ~/.cargo
-            ~/.rustup
-          # 工具链升级时 bump 版本号使缓存失效重装 (含 cargo-ndk)
-          key: rust-android-v1-${{ runner.os }}
-
-      - name: Cache Tauri cargo target
-        uses: https://gitea.com/actions/cache@v4
-        with:
-          path: src-tauri/target
-          key: tauri-target-android-${{ runner.os }}
-
-      # ---------- 安装工具链 (仅缓存未命中时) ----------
-      - name: Install Rust + Android targets
-        if: steps.cache-rust.outputs.cache-hit != 'true'
-        run: |
-          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
-          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
-          . "$HOME/.cargo/env"
-          rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android i686-linux-android
-          cargo install cargo-ndk --locked
-
-      - name: Install Android SDK & NDK
-        if: steps.cache-android.outputs.cache-hit != 'true'
-        run: |
-          export ANDROID_HOME="$HOME/android-sdk"
-          sudo apt-get update
-          sudo apt-get install -y --no-install-recommends unzip
-          mkdir -p "$ANDROID_HOME/cmdline-tools"
-          wget -q https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip -O /tmp/cmdline-tools.zip
-          unzip -q /tmp/cmdline-tools.zip -d /tmp/
-          mv /tmp/cmdline-tools "$ANDROID_HOME/cmdline-tools/latest"
-          export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
-          yes | sdkmanager --licenses >/dev/null || true
-          sdkmanager --install \
-            "platforms;android-36" \
-            "build-tools;36.0.0" \
-            "platform-tools" \
-            "ndk;27.2.12479018" \
-            "cmake;3.22.1"
-
-      - name: Install frontend deps
-        run: npm ci --no-audit --no-fund
-
-      # ---------- 全局 Android 环境 (对后续所有 step 生效, 无论缓存是否命中) ----------
-      - name: Set Android env
-        run: |
-          echo "ANDROID_HOME=$HOME/android-sdk" >> "$GITHUB_ENV"
-          echo "ANDROID_NDK_HOME=$HOME/android-sdk/ndk/27.2.12479018" >> "$GITHUB_ENV"
-          echo "$HOME/android-sdk/cmdline-tools/latest/bin" >> "$GITHUB_PATH"
-          echo "$HOME/android-sdk/platform-tools" >> "$GITHUB_PATH"
-
-      # ---------- 构建 ----------
-      - name: Init Android project
-        run: |
-          # tauri android init 需要 cargo (运行 cargo metadata)。
-          # Rust 工具链缓存命中时 "Install Rust" 步骤被跳过, 不会把 cargo 加进全局 PATH,
-          # 因此这里显式加载 cargo 环境 (与 Build release APK 步骤保持一致)。
-          . "$HOME/.cargo/env"
-          cd src-tauri
-          npx tauri android init --ci
-
-      - name: Inject release signing config
-        run: bash scripts/ci/android-signing.sh
-        env:
-          ANDROID_KEYSTORE_B64: ${{ secrets.ANDROID_KEYSTORE_B64 }}
-          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
-          ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
-
-      - name: Build release APK
-        run: |
-          export ANDROID_HOME="$HOME/android-sdk"
-          export ANDROID_NDK_HOME="$ANDROID_HOME/ndk/27.2.12479018"
-          export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH"
-          export CARGO_HOME="$HOME/.cargo"
-          . "$HOME/.cargo/env"
-          cd src-tauri
-          npx tauri android build --apk
-          # 断言签名配置仍在且 release 块实际引用了它 (防止 tauri 重新生成 gen/android 或正则未命中)
-          if ! grep -q 'create("release")' gen/android/app/build.gradle.kts || ! grep -q 'signingConfig = signingConfigs.getByName("release")' gen/android/app/build.gradle.kts; then
-            echo "ERROR: 构建后签名配置丢失/未生效, APK 未签名" >&2
-            exit 1
-          fi
-
-      - name: Locate APK
-        id: apk
-        run: |
-          # 优先 universal 已签名 APK, 找不到再回退到其他已签名 APK
-          APK=""
-          UNIVERSAL=$(find src-tauri/gen/android/app/build/outputs/apk/universal/release -name '*.apk' ! -name '*unsigned*' 2>/dev/null | head -1)
-          if [ -n "$UNIVERSAL" ]; then
-            APK="$UNIVERSAL"
-          else
-            APK=$(find src-tauri/gen/android/app/build/outputs/apk -name '*.apk' ! -name '*unsigned*' | head -1)
-          fi
-          if [ -z "$APK" ]; then
-            echo "ERROR: 未找到已签名 APK" >&2
-            exit 1
-          fi
-          echo "path=$APK" >> $GITHUB_OUTPUT
-          ls -lh "$APK"
-
-      # ---------- 上传到 Gitea Generic Package ----------
-      - name: Publish APK to Gitea packages
-        env:
-          # 注意: 不能用 GITEA_TOKEN (内置 job token, 无组织 packages 写权限, 且命名规则禁止 GITEA_ 前缀)
-          # 用一个自定义名 secret 存放有 packages 写权限的 user token
-          PACKAGE_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
-          APK_PATH: ${{ steps.apk.outputs.path }}
-        run: |
-          set -euo pipefail
-          # 包版本: 用分支名去掉 android- 前缀 + 短 SHA, 保证每次 push 唯一
-          BRANCH="${GITHUB_REF_NAME#android-}"
-          PKG_VERSION="${BRANCH}-${GITHUB_SHA:0:8}"
-          FILE_NAME="iboard-$(basename "$APK_PATH")"
-          OWNER="${GITHUB_REPOSITORY_OWNER}"
-          PKG_NAME="iboard"
-          # Gitea Generic Package Registry 上传端点 (PUT)
-          # 注意: GITHUB_SERVER_URL 是仓库 web 根地址, 例如 http://git.honor3.com
-          URL="${GITHUB_SERVER_URL}/api/packages/${OWNER}/generic/${PKG_NAME}/${PKG_VERSION}/${FILE_NAME}"
-          echo "上传到: ${URL}"
-          curl -sS --fail-with-body \
-            -H "Authorization: token ${PACKAGE_TOKEN}" \
-            --upload-file "$APK_PATH" \
-            "${URL}"
-          echo ""
-          echo "已发布: ${URL}"
+name: Android Build & Publish
+
+# 仅在 android-* 分支 push 时触发 (如 android/release, android-1.0)
+# 构建 release APK (keystore 签名) 并上传到 Gitea Generic Package Registry
+on:
+  push:
+    branches:
+      - 'android-*'
+
+# 同分支连续 push 时取消旧的构建, 省资源也避免上传过时 APK
+concurrency:
+  group: android-${{ github.ref_name }}
+  cancel-in-progress: true
+
+jobs:
+  build-android:
+    runs-on: ubuntu-latest
+    # 需要写权限: 上传 packages
+    permissions:
+      contents: read
+      packages: write
+
+    env:
+      # 固定工具链版本, 便于 actions/cache 命中
+      # Android 后端地址 (bake 进 APK); 与 scripts/wsl/build-apk.sh 保持一致
+      VITE_API_BASE: https://iboard.honor3.com
+
+    steps:
+      - name: Checkout
+        uses: https://gitea.com/actions/checkout@v4
+
+      - name: Setup Node
+        uses: https://gitea.com/actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      # 版本号一致性: package.json / tauri.conf.json / Cargo.toml / Cargo.lock 必须完全相等。
+      # tauri.conf.json 的 version 就是 APK 的 versionName, 漏改会打出一个版本号错误的安装包。
+      - name: Check version consistency
+        run: node scripts/ci/check-version.mjs
+
+      - name: Setup JDK 17
+        uses: https://gitea.com/actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      # ---------- 缓存: 命中后跳过下面的安装 ----------
+      - name: Cache Android SDK & NDK
+        id: cache-android
+        uses: https://gitea.com/actions/cache@v4
+        with:
+          path: ~/android-sdk
+          key: android-sdk-ndk-27.2-${{ runner.os }}
+
+      - name: Cache Rust toolchain
+        id: cache-rust
+        uses: https://gitea.com/actions/cache@v4
+        with:
+          path: |
+            ~/.cargo
+            ~/.rustup/toolchains
+          # 工具链升级时 bump 版本号使缓存失效重装 (含 cargo-ndk)
+          key: rust-android-v1-${{ runner.os }}
+
+      - name: Cache Tauri cargo target
+        uses: https://gitea.com/actions/cache@v4
+        with:
+          path: src-tauri/target
+          # 依赖变化 → 新 key; 命不中时回退最近一次的 target 目录做增量编译
+          key: tauri-target-android-${{ hashFiles('src-tauri/Cargo.lock') }}
+          restore-keys: tauri-target-android-
+
+      # ---------- 安装工具链 (仅缓存未命中时) ----------
+      - name: Install Rust + Android targets
+        if: steps.cache-rust.outputs.cache-hit != 'true'
+        run: |
+          curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --default-toolchain stable
+          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+          . "$HOME/.cargo/env"
+          # 只构建 aarch64 (现代 Android 手机); 需要模拟器/x86 设备时再加回其他 target
+          rustup target add aarch64-linux-android
+          cargo install cargo-ndk --locked
+
+      - name: Install Android SDK & NDK
+        if: steps.cache-android.outputs.cache-hit != 'true'
+        run: |
+          export ANDROID_HOME="$HOME/android-sdk"
+          sudo apt-get update
+          sudo apt-get install -y --no-install-recommends unzip
+          mkdir -p "$ANDROID_HOME/cmdline-tools"
+          wget -q https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip -O /tmp/cmdline-tools.zip
+          unzip -q /tmp/cmdline-tools.zip -d /tmp/
+          mv /tmp/cmdline-tools "$ANDROID_HOME/cmdline-tools/latest"
+          export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$PATH"
+          yes | sdkmanager --licenses >/dev/null || true
+          sdkmanager --install \
+            "platforms;android-36" \
+            "build-tools;36.0.0" \
+            "platform-tools" \
+            "ndk;27.2.12479018" \
+            "cmake;3.22.1"
+
+      - name: Install frontend deps
+        run: npm ci --no-audit --no-fund
+
+      # ---------- 全局 Android 环境 (对后续所有 step 生效, 无论缓存是否命中) ----------
+      - name: Set Android env
+        run: |
+          echo "ANDROID_HOME=$HOME/android-sdk" >> "$GITHUB_ENV"
+          echo "ANDROID_NDK_HOME=$HOME/android-sdk/ndk/27.2.12479018" >> "$GITHUB_ENV"
+          echo "$HOME/android-sdk/cmdline-tools/latest/bin" >> "$GITHUB_PATH"
+          echo "$HOME/android-sdk/platform-tools" >> "$GITHUB_PATH"
+
+      # ---------- 构建 ----------
+      - name: Init Android project
+        run: |
+          # tauri android init 需要 cargo (运行 cargo metadata)。
+          # Rust 工具链缓存命中时 "Install Rust" 步骤被跳过, 不会把 cargo 加进全局 PATH,
+          # 因此这里显式加载 cargo 环境 (与 Build release APK 步骤保持一致)。
+          . "$HOME/.cargo/env"
+          cd src-tauri
+          npx tauri android init --ci
+
+      - name: Inject release signing config
+        run: bash scripts/ci/android-signing.sh
+        env:
+          ANDROID_KEYSTORE_B64: ${{ secrets.ANDROID_KEYSTORE_B64 }}
+          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+          ANDROID_KEY_PASSWORD: ${{ secrets.ANDROID_KEY_PASSWORD }}
+
+      - name: Build release APK
+        run: |
+          export ANDROID_HOME="$HOME/android-sdk"
+          export ANDROID_NDK_HOME="$ANDROID_HOME/ndk/27.2.12479018"
+          export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH"
+          export CARGO_HOME="$HOME/.cargo"
+          . "$HOME/.cargo/env"
+          cd src-tauri
+          npx tauri android build --apk --target aarch64
+          # 断言签名配置仍在且 release 块实际引用了它 (防止 tauri 重新生成 gen/android 或正则未命中)
+          if ! grep -q 'create("release")' gen/android/app/build.gradle.kts || ! grep -q 'signingConfig = signingConfigs.getByName("release")' gen/android/app/build.gradle.kts; then
+            echo "ERROR: 构建后签名配置丢失/未生效, APK 未签名" >&2
+            exit 1
+          fi
+
+      - name: Locate APK
+        id: apk
+        run: |
+          # 优先 universal 已签名 APK, 找不到再回退到其他已签名 APK
+          APK=""
+          UNIVERSAL=$(find src-tauri/gen/android/app/build/outputs/apk/universal/release -name '*.apk' ! -name '*unsigned*' 2>/dev/null | head -1)
+          if [ -n "$UNIVERSAL" ]; then
+            APK="$UNIVERSAL"
+          else
+            APK=$(find src-tauri/gen/android/app/build/outputs/apk -name '*.apk' ! -name '*unsigned*' | head -1)
+          fi
+          if [ -z "$APK" ]; then
+            echo "ERROR: 未找到已签名 APK" >&2
+            exit 1
+          fi
+          echo "path=$APK" >> $GITHUB_OUTPUT
+          ls -lh "$APK"
+
+      # ---------- 上传到 Gitea Generic Package ----------
+      - name: Publish APK to Gitea packages
+        env:
+          # 注意: 不能用 GITEA_TOKEN (内置 job token, 无组织 packages 写权限, 且命名规则禁止 GITEA_ 前缀)
+          # 用一个自定义名 secret 存放有 packages 写权限的 user token
+          PACKAGE_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
+          APK_PATH: ${{ steps.apk.outputs.path }}
+        run: |
+          set -euo pipefail
+          # 包版本: 用分支名去掉 android- 前缀 + 短 SHA, 保证每次 push 唯一
+          BRANCH="${GITHUB_REF_NAME#android-}"
+          PKG_VERSION="${BRANCH}-${GITHUB_SHA:0:8}"
+          FILE_NAME="iboard-$(basename "$APK_PATH")"
+          OWNER="${GITHUB_REPOSITORY_OWNER}"
+          PKG_NAME="iboard"
+          # Gitea Generic Package Registry 上传端点 (PUT)
+          # 注意: GITHUB_SERVER_URL 是仓库 web 根地址, 例如 http://git.honor3.com
+          URL="${GITHUB_SERVER_URL}/api/packages/${OWNER}/generic/${PKG_NAME}/${PKG_VERSION}/${FILE_NAME}"
+          echo "上传到: ${URL}"
+          curl -sS --fail-with-body \
+            -H "Authorization: token ${PACKAGE_TOKEN}" \
+            --upload-file "$APK_PATH" \
+            "${URL}"
+          echo ""
+          echo "已发布: ${URL}"
@@ -1,84 +1,149 @@
-name: Docker Build and Push
-
-# 仅 main 分支 push 触发, 其他分支不触发
-# 每次主分支提交: 构建前端 + 生成 OTA 升级包 (签名) → 打进 Docker 镜像 → 部署
-# OTA 随镜像发布: 容器内 OTA_PACKAGE_DIR=/app/ota-package 指向打包的 ota-package/
-on:
-  push:
-    branches:
-      - main
-      - master
-
-jobs:
-  build-image:
-    runs-on: ubuntu-latest
-    env:
-      # 关键: 显式固定 Android/OTA 后端地址, 覆盖 runner 环境里可能存在的
-      # 其他 VITE_API_BASE 值。否则 OTA 包里的前端可能连错后端, 导致
-      # "OTA 更新后登录失败/进不去内部"。与 android-build.yml 保持一致。
-      VITE_API_BASE: http://bh.vps.honor3.com:3001
-    steps:
-      - uses: https://gitea.com/actions/checkout@v4
-
-      - name: Setup Node
-        uses: https://gitea.com/actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - name: Install deps
-        run: npm ci --no-audit --no-fund
-
-      - name: Build frontend
-        # dist/ 供 OTA 打包用 (Dockerfile 内也会构建一份)
-        run: npm run build
-
-      - name: Install minisign
-        run: sudo apt-get update && sudo apt-get install -y minisign
-
-      - name: Build & sign OTA package
-        # 每次主分支提交生成 OTA 升级包, sequence 默认时间戳 (单调递增)
-        # 产物 ota-package/ (tar.gz + latest.json + .minisig) 进入 docker build context, 由 Dockerfile COPY 进镜像
-        env:
-          MINISIGN_PRIVATE_KEY: ${{ secrets.MINISIGN_PRIVATE_KEY }}
-          OTA_NOTES: ${{ github.sha }}
-        run: |
-          set -euo pipefail
-          node scripts/build-ota.mjs --out ota-package --notes ${OTA_NOTES}
-          echo "===== latest.json ====="
-          cat ota-package/latest.json
-          echo "===== bundle sha256 ====="
-          sha256sum ota-package/iboard-ota.tar.gz
-
-      - name: Build Docker image
-        # DATABASE_URL 仅在 prisma generate 阶段需要, 可用任何合法占位串
-        run: docker build -t iboard:latest --build-arg DATABASE_URL=mysql://build:build@127.0.0.1:3306/build .
-
-      - name: List images
-        run: docker images
-
-      - name: Apply DB migrations
-        # 仓库内的 prisma 迁移自动应用 (migrate deploy 幂等, 无新迁移时为 no-op)
-        env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-        run: npx prisma migrate deploy
-
-      - name: Remove old container
-        run: docker rm -vf iboard || true
-
-      - name: Recycle container
-        run: docker system prune --volumes -f
-
-      - name: Run container
-        # DATABASE_URL 通过 gitea Actions secret 注入, 不进镜像层
-        # OTA_PACKAGE_DIR 已在 Dockerfile 设为 /app/ota-package
-        # 米家凭证 (auth.txt) 不进 git: 运维放宿主机 /app/iboard/cache, bind-mount 进容器 (MIHOME_CACHE_DIR=/app/cache)
-        run: |
-          docker run -d --name iboard -p 3001:3001 \
-            -e DATABASE_URL="${{ secrets.DATABASE_URL }}" \
-            -e JWT_SECRET="${{ secrets.JWT_SECRET }}" \
-            -e MIHOME_CACHE_DIR=/app/cache \
-            -v /app/iboard/cache:/app/cache \
-            iboard:latest
-        env:
-          DATABASE_URL: ${{ secrets.DATABASE_URL }}
-          JWT_SECRET: ${{ secrets.JWT_SECRET }}
+name: Docker Build and Push
+
+# 仅主分支 (master) push 触发部署; 其他分支一律不触发 (见 readme「分支规则」)
+# 每次提交: 构建前端 + 生成 OTA 升级包 (签名) → 打进 Docker 镜像 → 自动升级数据库 → 部署
+# OTA 随镜像发布: 容器内 OTA_PACKAGE_DIR=/app/ota-package 指向打包的 ota-package/
+#
+# 分支策略 (2026-10 调整):
+#   - master  = 主分支, 唯一部署出口, push 即发布生产 (容器 iboard, 宿主 3001)
+#   - dev-*   = 开发集成分支, 只做 CI 校验 (构建/版本一致性), **不再自动部署**;
+#               要上线必须先合并到 master 再推 master
+#   - tmp-*   = 单个问题的临时分支, 合到 dev-* 后删除
+#   - android-*= 只用于触发 APK 外壳构建, 不部署; 改动前须与 master 同步
+#
+# 历史: 之前 dev-* 与 master 共用同一套生产环境 (推送即发布), 容易把半成品带上线,
+#       现已取消 dev-* 的 push 触发。
+on:
+  push:
+    branches:
+      - master
+
+# 连续 push master 时取消还在跑的旧部署, 避免排队执行过时版本的完整部署
+concurrency:
+  group: deploy-master
+  cancel-in-progress: true
+
+jobs:
+  build-image:
+    runs-on: ubuntu-latest
+    env:
+      # 关键: 显式固定 Android/OTA 后端地址, 覆盖 runner 环境里可能存在的
+      # 其他 VITE_API_BASE 值。否则 OTA 包里的前端可能连错后端, 导致
+      # "OTA 更新后登录失败/进不去内部"。与 android-build.yml 保持一致。
+      VITE_API_BASE: https://iboard.honor3.com
+      # OTA bundle 要求的最低原生二进制版本。
+      # 与 package.json 的应用版本是**两个概念**: 前端 OTA 不碰原生层,
+      # 现有 APK 仍是 0.1.0, 所以这里固定 0.1.0 (否则旧 APK 会被判定为不兼容而收不到更新)。
+      # 重打 APK 并确认原生层无破坏后, 再提升此值。
+      OTA_MIN_BINARY: '0.1.0'
+    steps:
+      - uses: https://gitea.com/actions/checkout@v4
+
+      - name: Setup Node
+        uses: https://gitea.com/actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: 'npm'
+
+      - name: Check version consistency & branch
+        # 1) package.json / tauri.conf.json / Cargo.toml / Cargo.lock 四处版本必须完全相等且不带 -ota
+        #    （tauri.conf.json 的 version 就是 APK 的 versionName）
+        # 2) 防止 OTA 版本号与分支错位: OTA 包的 version 直接取自 package.json,
+        #    dev-0.2 分支上必须是 0.2.x, 否则线上 OTA 会报成上一个版本的号
+        #    (master 分支跳过分支前缀校验, 但四处一致性照样强制)
+        env:
+          GITHUB_REF_NAME: ${{ github.ref_name }}
+        run: node scripts/ci/check-version.mjs
+
+      - name: Install deps
+        run: npm ci --no-audit --no-fund
+
+      - name: Build frontend
+        # 全流程唯一一次前端构建: dist/ 既供 OTA 打包, 也通过 build context 进入镜像
+        # (docker build 传 PREBUILT_DIST=true 跳过镜像内的重复构建)
+        run: npm run build
+
+      - name: Install minisign
+        # 静态二进制直接下载, 免去每次 apt-get update + install
+        # 注意: release tarball 是 macOS 上打包的, 混有多个平台的 minisign 二进制,
+        # 逐个试运行挑出本机可执行的, 都不行再回退 apt
+        run: |
+          set -euo pipefail
+          mkdir -p /tmp/ms
+          curl -sL https://github.com/jedisct1/minisign/releases/download/0.12/minisign-0.12-linux.tar.gz | tar xz -C /tmp/ms
+          BIN=""
+          for c in $(find /tmp/ms -type f -name minisign); do
+            if "$c" -v >/dev/null 2>&1; then BIN="$c"; break; fi
+          done
+          if [ -n "$BIN" ]; then
+            sudo install -m755 "$BIN" /usr/local/bin/minisign
+          else
+            echo "未找到可执行的静态二进制, 回退 apt 安装"
+            sudo apt-get update && sudo apt-get install -y minisign
+          fi
+          minisign -v
+
+      - name: Build & sign OTA package
+        # 每次主分支提交生成 OTA 升级包, sequence 默认时间戳 (单调递增)
+        # 发布说明 = 触发构建的 commit message (标题+正文; 打包脚本内安全截断 400 字符),
+        # commit sha 通过 --commit 单独写入 manifest, 前端分行展示
+        # 产物 ota-package/ (tar.gz + latest.json + .minisig) 进入 docker build context, 由 Dockerfile COPY 进镜像
+        env:
+          MINISIGN_PRIVATE_KEY: ${{ secrets.MINISIGN_PRIVATE_KEY }}
+        run: |
+          set -euo pipefail
+          # 不用 head -c 截断: 那会把多字节汉字切成非法 UTF-8, latest.json 解析失败
+          MSG="$(git log -1 --pretty=format:%B | sed -e '/^[[:space:]]*$/d')"
+          echo "notes: ${MSG}"
+          node scripts/build-ota.mjs --out ota-package --notes "${MSG}" --commit "${GITHUB_SHA}" --min-binary ${OTA_MIN_BINARY}
+          echo "===== latest.json ====="
+          cat ota-package/latest.json
+          echo "===== bundle sha256 ====="
+          sha256sum ota-package/iboard-ota.tar.gz
+
+      - name: Build Docker image
+        # DATABASE_URL 仅在 prisma generate 阶段需要, 可用任何合法占位串
+        # PREBUILT_DIST=true: 复用上一步构建好的 dist/, 镜像内跳过前端构建
+        # DOCKER_BUILDKIT=1: Dockerfile 用了 cache mount 语法
+        run: docker build -t iboard:latest --build-arg DATABASE_URL=mysql://build:build@127.0.0.1:3306/build --build-arg PREBUILT_DIST=true .
+        env:
+          DOCKER_BUILDKIT: '1'
+
+      - name: List images
+        run: docker images
+
+      - name: Apply DB migrations
+        # 数据库自动升级: 按 prisma/migrations/ 下的迁移顺序应用 (生产库由 master 部署时统一升级)
+        # migrate deploy 幂等, 无新迁移时为 no-op
+        # 位置关键: 在 "Remove old container" 之前 —— 建表/改表成功后才切换流量,
+        # 迁移失败则整个 workflow 中断, 不会用新镜像顶掉仍在运行的旧容器
+        env:
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+        run: |
+          set -euo pipefail
+          npx prisma migrate status || true
+          npx prisma migrate deploy
+
+      - name: Remove old container
+        run: docker rm -vf iboard || true
+
+      - name: Prune dangling images
+        # 只清理本项目的悬空镜像 (旧 iboard:latest 被同名新镜像顶掉后变 dangling),
+        # 不再用 `docker system prune --volumes` —— 那会清光宿主机 build cache,
+        # 导致每次部署都全量重装 npm 依赖、重跑构建
+        run: docker image prune -f
+
+      - name: Run container
+        # DATABASE_URL 通过 gitea Actions secret 注入, 不进镜像层
+        # OTA_PACKAGE_DIR 已在 Dockerfile 设为 /app/ota-package
+        # 米家凭证 (auth.txt) 不进 git: 运维放宿主机 /app/iboard/cache, bind-mount 进容器 (MIHOME_CACHE_DIR=/app/cache)
+        run: |
+          docker run -d --name iboard -p 3001:3001 \
+            -e DATABASE_URL="${{ secrets.DATABASE_URL }}" \
+            -e JWT_SECRET="${{ secrets.JWT_SECRET }}" \
+            -e MIHOME_CACHE_DIR=/app/cache \
+            -v /app/iboard/cache:/app/cache \
+            iboard:latest
+        env:
+          DATABASE_URL: ${{ secrets.DATABASE_URL }}
+          JWT_SECRET: ${{ secrets.JWT_SECRET }}
@@ -1,75 +1,97 @@
-name: OTA Frontend Build & Sign
-
-# 前端 OTA 升级包构建 + 签名 + 上传 artifact
-# 触发: 仅手动 (workflow_dispatch), 发版前用
-#   - 主分支 push 的自动 OTA 生成已并入 docker-build.yml (随镜像发布), 本 workflow 不再监听 push 避免重复构建
-# 输入: sequence / notes / min_binary (可覆盖默认)
-# Secret 依赖: MINISIGN_PRIVATE_KEY (整段 .key 文件内容, 含首行 untrusted comment)
-# 注意: 此 workflow 不会修改 src-tauri/tauri.conf.json 里的 pubkey,
-#       换密钥请手动改 conf 并 commit.
-
-on:
-  workflow_dispatch:
-    inputs:
-      sequence:
-        description: 'OTA sequence (单调递增整数, 留空用 timestamp)'
-        required: false
-        type: string
-      notes:
-        description: '发布说明 (写入 latest.json.notes)'
-        required: false
-        type: string
-        default: ''
-      min_binary:
-        description: '最低 binary 版本 (留空用 src-tauri/tauri.conf.json 的 version)'
-        required: false
-        type: string
-        default: ''
-
-jobs:
-  build-ota:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: https://gitea.com/actions/checkout@v4
-
-      - name: Setup Node
-        uses: https://gitea.com/actions/setup-node@v4
-        with:
-          node-version: 22
-
-      - name: Install deps
-        run: npm ci --no-audit --no-fund
-
-      - name: Build frontend
-        # 复用 vite build 产物; 不打 Docker (本 workflow 只关心前端)
-        run: npm run build
-
-      - name: Install minisign
-        run: sudo apt-get update && sudo apt-get install -y minisign
-
-      - name: Build & sign OTA package
-        env:
-          MINISIGN_PRIVATE_KEY: ${{ secrets.MINISIGN_PRIVATE_KEY }}
-          OTA_NOTES: ${{ inputs.notes }}
-        run: |
-          set -euo pipefail
-          OUT="ota-package"
-          ARGS="--out ${OUT}"
-          # inputs 留空时 → 不传 --sequence/--min-binary, 脚本默认 sequence=时间戳, min-binary=tauri.conf version
-          if [ -n "${{ inputs.sequence }}" ]; then ARGS="${ARGS} --sequence ${{ inputs.sequence }}"; fi
-          if [ -n "${OTA_NOTES}" ]; then ARGS="${ARGS} --notes ${OTA_NOTES}"; fi
-          if [ -n "${{ inputs.min_binary }}" ]; then ARGS="${ARGS} --min-binary ${{ inputs.min_binary }}"; fi
-          node scripts/build-ota.mjs ${ARGS}
-          echo "===== latest.json ====="
-          cat ${OUT}/latest.json
-          echo "===== bundle sha256 ====="
-          sha256sum ${OUT}/iboard-ota.tar.gz
-
-      - name: Upload OTA package as artifact
-        uses: https://gitea.com/actions/upload-artifact@v4
-        with:
-          name: iboard-ota-${{ inputs.sequence || github.run_number }}
-          path: ota-package/
-          retention-days: 30
-          if-no-files-found: error
+name: OTA Frontend Build & Sign
+
+# 前端 OTA 升级包构建 + 签名 + 上传 artifact
+# 触发: 仅手动 (workflow_dispatch), 发版前用
+#   - 主分支 push 的自动 OTA 生成已并入 docker-build.yml (随镜像发布), 本 workflow 不再监听 push 避免重复构建
+# 输入: sequence / notes / min_binary (可覆盖默认)
+# Secret 依赖: MINISIGN_PRIVATE_KEY (整段 .key 文件内容, 含首行 untrusted comment)
+# 注意: 此 workflow 不会修改 src-tauri/tauri.conf.json 里的 pubkey,
+#       换密钥请手动改 conf 并 commit.
+
+on:
+  workflow_dispatch:
+    inputs:
+      sequence:
+        description: 'OTA sequence (单调递增整数, 留空用 timestamp)'
+        required: false
+        type: string
+      notes:
+        description: '发布说明 (写入 latest.json.notes)'
+        required: false
+        type: string
+        default: ''
+      min_binary:
+        description: '最低 binary 版本 (默认 0.1.0 = 现有 APK 的原生版本, 与前端应用版本无关)'
+        required: false
+        type: string
+        default: '0.1.0'
+
+jobs:
+  build-ota:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: https://gitea.com/actions/checkout@v4
+
+      - name: Setup Node
+        uses: https://gitea.com/actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install deps
+        run: npm ci --no-audit --no-fund
+
+      - name: Build frontend
+        # 复用 vite build 产物; 不打 Docker (本 workflow 只关心前端)
+        run: npm run build
+
+      - name: Install minisign
+        # 静态二进制直接下载, 免去每次 apt-get update + install
+        # 注意: release tarball 是 macOS 上打包的, 混有多个平台的 minisign 二进制,
+        # 逐个试运行挑出本机可执行的, 都不行再回退 apt
+        run: |
+          set -euo pipefail
+          mkdir -p /tmp/ms
+          curl -sL https://github.com/jedisct1/minisign/releases/download/0.12/minisign-0.12-linux.tar.gz | tar xz -C /tmp/ms
+          BIN=""
+          for c in $(find /tmp/ms -type f -name minisign); do
+            if "$c" -v >/dev/null 2>&1; then BIN="$c"; break; fi
+          done
+          if [ -n "$BIN" ]; then
+            sudo install -m755 "$BIN" /usr/local/bin/minisign
+          else
+            echo "未找到可执行的静态二进制, 回退 apt 安装"
+            sudo apt-get update && sudo apt-get install -y minisign
+          fi
+          minisign -v
+
+      - name: Build & sign OTA package
+        # 发布说明默认 = 检出 commit 的 message (标题+正文), commit sha 单独写入;
+        # 手动填写的 notes 优先
+        env:
+          MINISIGN_PRIVATE_KEY: ${{ secrets.MINISIGN_PRIVATE_KEY }}
+        run: |
+          set -euo pipefail
+          OUT="ota-package"
+          ARGS="--out ${OUT} --commit ${GITHUB_SHA}"
+          if [ -n "${{ inputs.sequence }}" ]; then ARGS="${ARGS} --sequence ${{ inputs.sequence }}"; fi
+          if [ -n "${{ inputs.notes }}" ]; then
+            ARGS="${ARGS} --notes \"${{ inputs.notes }}\""
+          else
+            MSG="$(git log -1 --pretty=format:%B | sed -e '/^[[:space:]]*$/d')"
+            ARGS="${ARGS} --notes \"${MSG}\""
+          fi
+          if [ -n "${{ inputs.min_binary }}" ]; then ARGS="${ARGS} --min-binary ${{ inputs.min_binary }}"; fi
+          eval "node scripts/build-ota.mjs ${ARGS}"
+          echo "===== latest.json ====="
+          cat ${OUT}/latest.json
+          echo "===== bundle sha256 ====="
+          sha256sum ${OUT}/iboard-ota.tar.gz
+
+      - name: Upload OTA package as artifact
+        uses: https://gitea.com/actions/upload-artifact@v4
+        with:
+          name: iboard-ota-${{ inputs.sequence || github.run_number }}
+          path: ota-package/
+          retention-days: 30
+          if-no-files-found: error
@@ -1,47 +1,64 @@
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-
-# testing
-/coverage
-
-# production
-/build
-/out
-/.next
-
-# misc
-.DS_Store
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
-
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-lerna-debug.log*
-
-# Editor directories and files
-.idea
-.vscode
-*.swp
-*.swo
-*~
-dist/*
-
-# local env (contains API keys)
-/.env
-.reasonix/*
-# OTA 升级: 产物 (运行时生成, 部署时单独管理) + 私钥 (绝不能提交)
-ota-package/*
-!ota-package/README.md
+# dependencies
+/node_modules
+/.pnp
+.pnp.js

-# apizero 文件缓存 (运行时按需生成)
-cache/apizero/
-# Dockerfile 持久卷挂载点 (跟 ota-package 同类)
-.cache/
-# 米家凭证缓存 (含 token, 绝不能提交)
+# testing
+/coverage
+
+# production
+/build
+/out
+/.next
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Editor directories and files
+.idea
+.vscode
+*.swp
+*.swo
+*~
+dist/*
+
+# local env (contains API keys)
+/.env
+.reasonix/*
+# OTA å�‡çº§: äº§ç‰© (è¿�è¡Œæ—¶ç”Ÿæˆ�, éƒ¨ç½²æ—¶å�•ç‹¬ç®¡ç�†) + ç§�é’¥ (ç»�ä¸�èƒ½æ��äº¤)
+ota-package/*
+!ota-package/README.md
+
+# apizero æ–‡ä»¶ç¼“å˜ (è¿�è¡Œæ—¶æŒ‰éœ€ç”Ÿæˆ�)
+cache/apizero/
+# Dockerfile æŒ�ä¹…å�·æŒ‚è½½ç‚¹ (è·Ÿ ota-package å�Œç±»)
+.cache/
+# ç±³å®¶å‡è¯�ç¼“å˜ (å�« token, ç»�ä¸�èƒ½æ��äº¤)
 server/mihome/.cache/
+# å·¥ä½œåŒºè®°å¿†/ä¼šè¯�æ•°æ�® (æœ¬åœ°ç§�æœ‰, ä¸�å…¥åº“)
+.workbuddy/
+
+# æœ¬åœ° pnpm å®‰è£…äº§ç‰© (é¡¹ç›®ä½¿ç”¨ package-lock.json)
+/.pnpm-store
+
+# 0.2.1 éªŒè¯�éƒ¨ç½²: æœ�åŠ¡å™¨æœ¬åœ°æ•°æ�®å�·ä¸Žå¯†é’¥ (ç»�ä¸�å…¥åº“)
+deploy/0.2.1/data/
+deploy/0.2.1/.env
+
+# ¹¹½¨/¹¤¾ßÁÙÊ±Ä¿Â¼ (local)
+.esbuild-tmp/
+
+
+# Windows ´ò°ü²úÎï (±¾µØÉú³É, ²»Èë¿â)
+/artifacts/
+
@@ -0,0 +1,78 @@
+// CDP 触摸手势驱动: 长按 400ms 激活 + 水平拖动, 观察 useRowDrag 行为
+import WebSocket from 'ws'
+import { spawn } from 'node:child_process'
+
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0
+const pending = new Map()
+const send = (method, params = {}, sessionId) => new Promise((res) => {
+  const i = ++id
+  pending.set(i, res)
+  ws.send(JSON.stringify({ id: i, method, params, sessionId }))
+})
+ws.on('message', (d) => {
+  const m = JSON.parse(d)
+  if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) }
+  if (m.method === 'Runtime.consoleAPICalled') {
+    console.log('[console]', m.params.type, m.params.args.map((a) => a.value ?? a.description).join(' '))
+  }
+})
+await new Promise((r) => ws.on('open', r))
+
+const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
+const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+await S('Runtime.enable')
+await S('Page.enable')
+await S('Emulation.setDeviceMetricsOverride', { width: 400, height: 800, deviceScaleFactor: 2, mobile: true })
+await S('Emulation.setTouchEmulationEnabled', { enabled: true, maxTouchPoints: 5 })
+await S('Page.navigate', { url: 'http://127.0.0.1:5199/dragtest.html' })
+await new Promise((r) => setTimeout(r, 3000))
+
+const sleep = (ms) => new Promise((res) => setTimeout(res, ms))
+const ev = async (expr) => (await S('Runtime.evaluate', { expression: expr, returnByValue: true })).result.value
+let rect = null
+for (let i = 0; i < 30 && !rect; i++) {
+  await sleep(1000)
+  const v = await ev(`(() => { const el = document.querySelector('[data-task-id="3"]'); return el ? JSON.stringify(el.getBoundingClientRect()) : null })()`)
+  if (v) rect = JSON.parse(v)
+}
+if (!rect) { console.log('page never loaded'); ws.close(); process.exit(1) }
+console.log('row rect', JSON.stringify(rect))
+
+const r = rect
+const x0 = r.left + r.width / 2
+const y0 = r.top + r.height / 2
+
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', {
+  type,
+  touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }],
+})
+
+// 1) touchStart + 按住 500ms (激活长按)
+await touch('touchStart', x0, y0)
+console.log('--- touchStart, holding 500ms')
+await sleep(500)
+
+// 2) 水平拖动 +200px, 每步 +25px / 40ms (纯水平)
+for (let dx = 25; dx <= 200; dx += 25) {
+  await touch('touchMove', x0 + dx, y0)
+  await sleep(40)
+}
+console.log('--- moved to +200px (pure horizontal)')
+
+// 3) 带纵向分量的拖动 (模拟真实手指): +160px 横 / +40px 纵
+await touch('touchMove', x0 + 60, y0 + 12)
+await sleep(40)
+await touch('touchMove', x0 + 120, y0 + 26)
+await sleep(40)
+await touch('touchMove', x0 + 160, y0 + 40)
+await sleep(40)
+
+await touch('touchEnd')
+await sleep(600)
+
+console.log('--- events on page:')
+console.log((await ev('window.__ev.join("\\n")')))
+ws.close()
@@ -0,0 +1,77 @@
+// CDP 触摸手势驱动 v2: 把手立即拖动 + 长按路径, 组内/跨组落点
+import WebSocket from 'ws'
+
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0
+const pending = new Map()
+const send = (method, params = {}, sessionId) => new Promise((res) => {
+  const i = ++id
+  pending.set(i, res)
+  ws.send(JSON.stringify({ id: i, method, params, sessionId }))
+})
+ws.on('message', (d) => {
+  const m = JSON.parse(d)
+  if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) }
+})
+await new Promise((r) => ws.on('open', r))
+
+const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
+const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+await S('Runtime.enable'); await S('Page.enable')
+await S('Emulation.setDeviceMetricsOverride', { width: 400, height: 800, deviceScaleFactor: 2, mobile: true })
+await S('Emulation.setTouchEmulationEnabled', { enabled: true, maxTouchPoints: 5 })
+await S('Page.navigate', { url: 'http://127.0.0.1:5199/dragtest.html' })
+
+const sleep = (ms) => new Promise((res) => setTimeout(res, ms))
+const ev = async (expr) => (await S('Runtime.evaluate', { expression: expr, returnByValue: true })).result.value
+
+const center = async (sel) => {
+  const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('${sel}').getBoundingClientRect())`))
+  return { x: r.left + r.width / 2, y: r.top + r.height / 2 }
+}
+for (let i = 0; i < 30; i++) { await sleep(1000); if (await ev(`!!document.querySelector('[data-habit-id="1"]')`)) break }
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', {
+  type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }],
+})
+
+// 用例 1: 按住 habit-1 的把手, 立即垂直拖到 habit-4 中部, 松手 → 应 DROP before/after 4
+let p = await center('[data-habit-id="1"] .grip')
+await touch('touchStart', p.x, p.y)
+await sleep(60)
+const t = await center('[data-habit-id="4"]')
+await touch('touchMove', p.x, p.y + 20)
+await sleep(30)
+await touch('touchMove', t.x, t.y)
+await sleep(60)
+const cls1 = await ev(`document.querySelector('[data-habit-id="4"]').className`)
+console.log('case1 target class:', cls1)
+await touch('touchEnd')
+await sleep(300)
+
+// 用例 2: 按住 habit-1 把手拖到每周组 (habit-5) → 跨组, 应无落点无 DROP
+p = await center('[data-habit-id="1"] .grip')
+await touch('touchStart', p.x, p.y)
+await sleep(60)
+const w = await center('[data-habit-id="5"]')
+await touch('touchMove', w.x, w.y)
+await sleep(60)
+const cls2 = await ev(`document.querySelector('[data-habit-id="5"]').className`)
+console.log('case2 target class (应无 dragover):', cls2)
+await touch('touchEnd')
+await sleep(300)
+
+// 用例 3: 长按卡片主体 500ms 后拖到 habit-3 下半 → DROP after 3
+p = await center('[data-habit-id="2"]')
+await touch('touchStart', p.x, p.y)
+await sleep(520)
+const t3 = await center('[data-habit-id="3"]')
+await touch('touchMove', t3.x, t3.y + 20)
+await sleep(60)
+await touch('touchEnd')
+await sleep(300)
+
+console.log('--- events:')
+console.log(await ev('window.__ev.join("\\n")'))
+ws.close()
@@ -0,0 +1,27 @@
+import WebSocket from 'ws'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const targets = await send('Target.getTargets')
+const t = targets.targetInfos.find((x) => x.url.includes('dragtest'))
+const { sessionId } = await send('Target.attachToTarget', { targetId: t.targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+// 长按 habit-2 主体, 分别在 450ms 后检查激活态, 再拖动
+const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="2"]').getBoundingClientRect())`))
+const x = r.left + r.width / 2, y = r.top + r.height / 2
+await S('Input.dispatchTouchEvent', { type: 'touchStart', touchPoints: [{ x, y, id: 1 }] })
+await sleep(460)
+console.log('after 460ms class:', await ev(`document.querySelector('[data-habit-id="2"]').className`))
+const r3 = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="3"]').getBoundingClientRect())`))
+await S('Input.dispatchTouchEvent', { type: 'touchMove', touchPoints: [{ x: r3.left + r3.width / 2, y: r3.top + r3.height - 8, id: 1 }] })
+await sleep(80)
+console.log('class of 3 after move:', await ev(`document.querySelector('[data-habit-id="3"]').className`))
+await S('Input.dispatchTouchEvent', { type: 'touchEnd', touchPoints: [] })
+await sleep(300)
+console.log('events:', await ev('window.__ev.join(" | ")'))
+ws.close()
@@ -0,0 +1,32 @@
+import WebSocket from 'ws'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
+const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+await S('Runtime.enable'); await S('Page.enable')
+await S('Emulation.setDeviceMetricsOverride', { width: 400, height: 800, deviceScaleFactor: 2, mobile: true })
+await S('Emulation.setTouchEmulationEnabled', { enabled: true, maxTouchPoints: 5 })
+await S('Page.navigate', { url: 'http://127.0.0.1:5199/dragtest.html' })
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+for (let i = 0; i < 30; i++) { await sleep(1000); if (await ev(`!!document.querySelector('[data-task-id="101"]')`)) break }
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', { type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }] })
+
+// 用例1: 任务B(102) 把手拖到任务D(104) 下半 → 期望 REORDER 102 after 104
+const g = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-task-id="102"] .grip').getBoundingClientRect())`))
+await touch('touchStart', g.left + g.width / 2, g.top + g.height / 2)
+await sleep(60)
+const d = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-task-id="104"]').getBoundingClientRect())`))
+await touch('touchMove', d.left + d.width / 2, d.top + d.height - 10)
+await sleep(120)
+console.log('row104 class:', await ev(`document.querySelector('[data-task-id="104"]').className`))
+console.log('drag state:', await ev(`JSON.stringify({drag: !!document.querySelector('.task-row.dragging'), ghost: !!document.querySelector('.drag-ghost')})`))
+await touch('touchEnd')
+await sleep(200)
+console.log('events:', await ev('window.__ev.join(" | ")'))
+ws.close()
@@ -0,0 +1,40 @@
+import WebSocket from 'ws'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const targets = await send('Target.getTargets')
+const t = targets.targetInfos.find((x) => x.url.includes('dragtest'))
+const { sessionId } = await send('Target.attachToTarget', { targetId: t.targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', { type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }] })
+const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="2"] .grip').getBoundingClientRect())`))
+const x = r.left + r.width / 2, y = r.top + r.height / 2
+await touch('touchStart', x, y)
+await sleep(60)
+const t4 = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="4"]').getBoundingClientRect())`))
+const fx = t4.left + t4.width / 2, fy = t4.top + t4.height / 2
+await touch('touchMove', fx, fy)
+await sleep(150)
+const scan = await ev(`(() => {
+  const out = []
+  document.querySelectorAll('*').forEach((el) => {
+    const cs = getComputedStyle(el)
+    const b = el.getBoundingClientRect()
+    if (b.width === 0 || b.height === 0) return
+    const bg = cs.backgroundColor
+    // 找带蓝色背景的元素
+    if (/rgb\\((22|2[0-9]|1[0-9]), ?1[0-9]{2}/.test(bg) || bg.includes('22, 119, 255') || bg.includes('0, 149, 255')) {
+      out.push({ tag: el.tagName, cls: el.className && String(el.className).slice(0, 40), bg, rect: [Math.round(b.left), Math.round(b.top), Math.round(b.width), Math.round(b.height)], text: (el.textContent || '').slice(0, 12) })
+    }
+  })
+  return JSON.stringify(out)
+})()`)
+console.log('blue elements:', scan)
+console.log('ghost children:', await ev(`(() => { const g = document.querySelector('.drag-ghost'); return g ? g.children.length + ' kids, inner w ' + g.getBoundingClientRect().width : 'none' })()`))
+await touch('touchEnd')
+ws.close()
@@ -0,0 +1,35 @@
+import WebSocket from 'ws'
+import fs from 'node:fs'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
+const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+await S('Runtime.enable'); await S('Page.enable')
+await S('Emulation.setDeviceMetricsOverride', { width: 400, height: 800, deviceScaleFactor: 2, mobile: true })
+await S('Emulation.setTouchEmulationEnabled', { enabled: true, maxTouchPoints: 5 })
+await S('Page.navigate', { url: 'http://127.0.0.1:5199/dragtest.html' })
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+for (let i = 0; i < 30; i++) { await sleep(1000); if (await ev(`!!document.querySelector('[data-habit-id="1"]')`)) break }
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', { type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }] })
+const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="2"] .grip').getBoundingClientRect())`))
+const x = r.left + r.width / 2, y = r.top + r.height / 2
+await touch('touchStart', x, y)
+await sleep(60)
+const t = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="4"]').getBoundingClientRect())`))
+await touch('touchMove', t.x ?? t.left + t.width / 2, t.top + t.height / 2)
+await sleep(120)
+// 拖动中截图
+const shot = await S('Page.captureScreenshot', { format: 'png' })
+fs.writeFileSync(process.env.USERPROFILE + '\\AppData\\Local\\Temp\\drag-mid.png', Buffer.from(shot.data, 'base64'))
+console.log('shot saved; ghost exists:', await ev(`!!document.querySelector('.drag-ghost')`))
+console.log('ghost html head:', (await ev(`document.querySelector('.drag-ghost') ? document.querySelector('.drag-ghost').outerHTML.slice(0, 200) : 'NONE'`)))
+await touch('touchEnd')
+await sleep(200)
+console.log('events:', await ev('window.__ev.join(" | ")'))
+ws.close()
@@ -0,0 +1,36 @@
+import WebSocket from 'ws'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const { targetId } = await send('Target.createTarget', { url: 'about:blank' })
+const { sessionId } = await send('Target.attachToTarget', { targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+await S('Runtime.enable'); await S('Page.enable')
+await S('Emulation.setDeviceMetricsOverride', { width: 400, height: 800, deviceScaleFactor: 2, mobile: true })
+await S('Emulation.setTouchEmulationEnabled', { enabled: true, maxTouchPoints: 5 })
+await S('Page.navigate', { url: 'http://127.0.0.1:5199/dragtest.html' })
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+for (let i = 0; i < 30; i++) { await sleep(1000); if (await ev(`!!document.querySelector('[data-task-id="3"]')`)) break }
+await sleep(1000) // 等延迟数据加载完
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', { type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }] })
+
+// 用例: 按住任务3的把手 → 水平拖 +200px (带 +30 纵向漂移, 复现真机抖动) → 松手
+const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-task-id="3"] .grip').getBoundingClientRect())`))
+let x = r.left + r.width / 2, y = r.top + r.height / 2
+console.log('grip rect', JSON.stringify(r))
+await touch('touchStart', x, y)
+await sleep(60)
+for (const [dx, dy] of [[25, 4], [60, 10], [110, 18], [160, 26], [200, 30]]) {
+  await touch('touchMove', x + dx, y + dy)
+  await sleep(50)
+}
+console.log('row class after moves:', await ev(`document.querySelector('[data-task-id="3"]').className`))
+console.log('meta:', await ev(`document.querySelector('[data-task-id="3"] .task-meta').textContent`))
+await touch('touchEnd')
+await sleep(300)
+console.log('events:', await ev('window.__ev.join(" | ")'))
+ws.close()
@@ -0,0 +1,30 @@
+import WebSocket from 'ws'
+import fs from 'node:fs'
+const C = JSON.parse((await (await fetch('http://127.0.0.1:9223/json/version')).text()))
+const ws = new WebSocket(C.webSocketDebuggerUrl, { perMessageDeflate: false })
+let id = 0; const pending = new Map()
+const send = (m, p = {}, s) => new Promise((r) => { const i = ++id; pending.set(i, r); ws.send(JSON.stringify({ id: i, method: m, params: p, sessionId: s })) })
+ws.on('message', (d) => { const m = JSON.parse(d); if (m.id && pending.has(m.id)) { pending.get(m.id)(m.result); pending.delete(m.id) } })
+await new Promise((r) => ws.on('open', r))
+const targets = await send('Target.getTargets')
+const t = targets.targetInfos.find((x) => x.url.includes('dragtest'))
+const { sessionId } = await send('Target.attachToTarget', { targetId: t.targetId, flatten: true })
+const S = (m, p) => send(m, p, sessionId)
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+const ev = async (e) => (await S('Runtime.evaluate', { expression: e, returnByValue: true })).result.value
+await S('Page.reload')
+await sleep(2500)
+const touch = (type, x, y) => S('Input.dispatchTouchEvent', { type, touchPoints: type === 'touchEnd' ? [] : [{ x, y, id: 1 }] })
+const r = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="2"] .grip').getBoundingClientRect())`))
+const x = r.left + r.width / 2, y = r.top + r.height / 2
+await touch('touchStart', x, y)
+await sleep(60)
+const t4 = JSON.parse(await ev(`JSON.stringify(document.querySelector('[data-habit-id="4"]').getBoundingClientRect())`))
+await touch('touchMove', t4.left + t4.width / 2, t4.top + t4.height / 2)
+await sleep(150)
+console.log('ghost bg:', await ev(`getComputedStyle(document.querySelector('.drag-ghost')).backgroundColor`))
+console.log('ghost rect:', await ev(`JSON.stringify(document.querySelector('.drag-ghost').getBoundingClientRect())`))
+const shot = await S('Page.captureScreenshot', { format: 'png' })
+fs.writeFileSync(process.env.USERPROFILE + '\\AppData\\Local\\Temp\\drag-fixed.png', Buffer.from(shot.data, 'base64'))
+await touch('touchEnd')
+ws.close()
@@ -0,0 +1,8 @@
+fix(V0.2): 拖动浮层残留蓝色背景 —— 类名与遗留 .drag-ghost 规则冲突
+
+globals.css 里有一条无人使用的旧 .drag-ghost 规则 (蓝色气泡,
+max-width 180px, 看板早期方案遗留), 排在新增规则之后同特异性胜出,
+克隆卡片容器被套上蓝色背景并被压缩到 180px 宽, 即真机上手下面的
+蓝色 div。删除遗留规则; 新规则显式清零背景/内边距并禁用
+tap-highlight/user-select (克隆脱离 .mv-view/.task-content 祖先后
+需自带防选中)。CDP 实测拖动中容器背景已透明、宽度正常。
@@ -0,0 +1,4 @@
+const s = '问题，；、！'
+console.log(JSON.stringify(s.replace(/[\s\p{P}]+$/u, '')))
+console.log(JSON.stringify('正常标题'.replace(/[\s\p{P}]+$/u, '')))
+console.log(JSON.stringify('a-b_c'.replace(/[\s\p{P}]+$/u, '')))
@@ -0,0 +1,5 @@
+Exception during registration:
+System.ComponentModel.Win32Exception (0x80004005): 系统找不到指定的文件。
+   在 System.Diagnostics.Process.StartWithCreateProcess(ProcessStartInfo startInfo)
+   在 System.CommandLine.Invocation.Process.StartProcess(String command, String args, String workingDir, Action`1 stdOut, Action`1 stdErr, ValueTuple`2[] environmentVariables)
+   在 System.CommandLine.Builder.CommandLineBuilderExtensions.<>c.<<RegisterWithDotnetSuggest>b__5_1>d.MoveNext()
@@ -0,0 +1,31 @@
+# CHANGELOG
+
+版本号规则见 [README.md](README.md)「版本管理」。前端与外壳版本号**互相独立**、独立发版,
+分三部分记录;PATCH 仅在明确提出时自增, 否则沿用, 每次变更在对应部分追加一行。
+
+---
+
+## 程序版本 (Web / OTA)
+
+**当前值: 0.2.0**  (管理点: `package.json` 的 `version`; OTA 包 = 同值 + `-ota`)
+
+| 日期 | 版本 | commit | 要点 |
+| --- | --- | --- | --- |
+| 2026-10-25 | 0.2.0 | — | V0.2 基线。前端与外壳版本解绑; build 标识统一 `YYYYMMDDHHmmss` (北京时间); PATCH 规则确立 (仅明确提出时自增) |
+| 2026-10-25 | 0.2.1 | 93b7c7b | 主要解决离线编辑与不同终端数据合并问题 |
+
+## Android 外壳版本
+
+**当前值: 0.2.0**  (管理点: `src-tauri/tauri.conf.json` 的 `version`, 须与 Cargo.toml/Cargo.lock 组内一致; 产物 = APK versionName)
+
+| 日期 | 版本 | commit | 要点 |
+| --- | --- | --- | --- |
+| 2026-10-25 | 0.2.0 | — | V0.2 基线。外壳与前端版本解绑, 独立维护 (android-* 分支出包) |
+
+## Windows 外壳版本
+
+**当前值: —**  (尚未建立; 建立后管理点同为 `src-tauri/tauri.conf.json` + Cargo 三件套, 走独立分支/打包工作流)
+
+| 日期 | 版本 | commit | 要点 |
+| --- | --- | --- | --- |
+| — | — | — | 暂无 |
@@ -1,73 +1,85 @@
-# ===============================================================
-# iBoard 一体化镜像: 静态前端 (dist/) + Express API (server/) 同进程
-# 构建: docker build --build-arg DATABASE_URL=... -t iboard:latest .
-#       可选 --build-arg VITE_API_BASE=https://api.example.com 让前端走绝对地址
-# 运行: docker run -d --name iboard -p 3001:3001 -e DATABASE_URL=... iboard:latest
-# ===============================================================
-FROM node:22-alpine AS builder
-
-WORKDIR /app
-
-# 国内构建时可换源
-RUN npm config set registry https://registry.npmmirror.com
-
-# 先拷贝 package 文件, 利用 Docker 缓存
-COPY package*.json ./
-COPY prisma ./prisma/
-COPY prisma.config.ts ./
-COPY generated ./generated/
-
-# 装全量依赖 (dev 也装, 后面 build 要用)
-RUN npm install
-
-# 拷贝源码
-COPY . .
-
-# 构建前端 (输出到 dist/) 与 Prisma 客户端
-RUN npx prisma generate
-# build 时把 VITE_API_BASE 写进 bundle, 默认空 = 走相对路径 /api (同源 Express)
-ARG VITE_API_BASE=
-ENV VITE_API_BASE=$VITE_API_BASE
-RUN npm run build
-
-# 运行时阶段
-FROM node:22-alpine
-
-WORKDIR /app
-
-# 阿里源加速
-RUN npm config set registry https://registry.npmmirror.com
-
-# 只装运行时依赖
-COPY package*.json ./
-RUN npm install --omit=dev
-
-# 拷贝构建产物
-COPY --from=builder /app/dist ./dist
-COPY --from=builder /app/server ./server
-COPY --from=builder /app/generated ./generated
-COPY --from=builder /app/prisma ./prisma
-COPY --from=builder /app/prisma.config.ts ./prisma.config.ts
-COPY --from=builder /app/scripts ./scripts
-COPY --from=builder /app/content ./content
-COPY --from=builder /app/public ./public
-
-# OTA 升级包: CI (docker-build.yml) 生成的 ota-package/, 随镜像发布
-# 本地构建时只有占位文件 (ota-package/README.md), server 找不到 latest.json 则 OTA 返回"无更新"
-COPY ota-package ./ota-package
-ENV OTA_PACKAGE_DIR=/app/ota-package
-# OTA bundle 下载用的绝对 base (manifest.url 必须是绝对 URL, 插件不拼 base, 相对路径会导致下载 0% 失败)
-# 生产为 http 明文 (无 https), 客户端 tauri.conf.json 的 hotswap.require_https 已设为 false 放行 http
-ENV OTA_PUBLIC_BASE=http://bh.vps.honor3.com:3001
-
-# 健康检查
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
-  CMD wget -qO- http://127.0.0.1:3001/api/health || exit 1
-
-EXPOSE 3001
-
-ENV NODE_ENV=production
-ENV PORT=3001
-
-# Node 22 默认未开 strip-types, 显式开启以便加载 generated/prisma/*.ts
+# syntax=docker/dockerfile:1
+# ===============================================================
+# iBoard 一体化镜像: 静态前端 (dist/) + Express API (server/) 同进程
+# 构建: docker build --build-arg DATABASE_URL=... -t iboard:latest .
+#       可选 --build-arg VITE_API_BASE=https://api.example.com 让前端走绝对地址
+#       CI 传入 --build-arg PREBUILT_DIST=true 复用 CI 已构建的 dist/ (跳过镜像内前端构建)
+# 运行: docker run -d --name iboard -p 3001:3001 -e DATABASE_URL=... iboard:latest
+# 需要 BuildKit (cache mount 语法; Docker 23+ 默认开启)
+# ===============================================================
+FROM node:22-alpine AS builder
+
+WORKDIR /app
+
+# 国内构建时可换源
+RUN npm config set registry https://registry.npmmirror.com
+
+# 先拷贝 package 文件, 利用 Docker 缓存
+COPY package*.json ./
+COPY prisma ./prisma/
+COPY prisma.config.ts ./
+COPY generated ./generated/
+
+# 装全量依赖 (dev 也装, 后面 prisma generate / 本地构建前端要用)
+# cache mount 复用 npm 下载缓存, 不进镜像层
+RUN --mount=type=cache,target=/root/.npm npm ci
+
+# 拷贝源码
+COPY . .
+
+# 构建 Prisma 客户端
+RUN --mount=type=cache,target=/root/.npm npx prisma generate
+
+# 构建前端 (输出到 dist/)
+# PREBUILT_DIST=true: CI 已在镜像外构建过 dist/ (供 OTA 打包), 直接复用, 跳过镜像内构建
+ARG PREBUILT_DIST=false
+# build 时把 VITE_API_BASE 写进 bundle, 默认空 = 走相对路径 /api (同源 Express)
+ARG VITE_API_BASE=
+ENV VITE_API_BASE=$VITE_API_BASE
+RUN if [ "$PREBUILT_DIST" = "true" ]; then \
+      test -f dist/index.html || { echo "PREBUILT_DIST=true 但 dist/ 缺失"; exit 1; }; \
+    else \
+      npm run build; \
+    fi
+
+# 运行时阶段
+FROM node:22-alpine
+
+WORKDIR /app
+
+# 阿里源加速
+RUN npm config set registry https://registry.npmmirror.com
+
+# 只装运行时依赖 (better-sqlite3 是 @powersync/node 的 devOptional peer, 需同时 omit optional 才能跳过)
+COPY package*.json ./
+RUN --mount=type=cache,target=/root/.npm npm ci --omit=dev --omit=optional
+
+# 拷贝构建产物
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/server ./server
+COPY --from=builder /app/generated ./generated
+COPY --from=builder /app/prisma ./prisma
+COPY --from=builder /app/prisma.config.ts ./prisma.config.ts
+COPY --from=builder /app/scripts ./scripts
+COPY --from=builder /app/content ./content
+COPY --from=builder /app/public ./public
+
+# OTA 升级包: CI (docker-build.yml) 生成的 ota-package/, 随镜像发布
+# 本地构建时只有占位文件 (ota-package/README.md), server 找不到 latest.json 则 OTA 返回"无更新"
+COPY ota-package ./ota-package
+ENV OTA_PACKAGE_DIR=/app/ota-package
+# OTA bundle 下载用的绝对 base (manifest.url 必须是绝对 URL, 插件不拼 base, 相对路径会导致下载 0% 失败)
+# 生产为 http 明文 (无 https), 客户端 tauri.conf.json 的 hotswap.require_https 已设为 false 放行 http
+ENV OTA_PUBLIC_BASE=https://iboard.honor3.com
+
+# 健康检查 (端口跟随 PORT 环境变量, 0.2.1 部署为 13001)
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD wget -qO- http://127.0.0.1:${PORT:-3001}/api/health || exit 1
+
+EXPOSE 3001
+
+ENV NODE_ENV=production
+ENV PORT=3001
+
+# Node 22 默认未开 strip-types, 显式开启以便加载 generated/prisma/*.ts
 CMD ["node", "--experimental-strip-types", "--no-warnings", "server/index.js"]
@@ -0,0 +1,276 @@
+# iBoard
+
+跨平台个人看板 (Tauri + React + Express + MariaDB)。用于收集和整理经济数据，但是以策略为主体重新组织。
+
+- 首页主要是放经济文章
+- 数据主要是放各种经济数据和图表
+- 策略是放按照经济理论组织的相关数据和图表的对比
+
+## 首页
+
+首页显示新闻模块和报警模块的数据，按照时间最新优先，无限滚动，直到数据库中没有数据为止。
+
+### 新闻模块
+
+增加一个新闻模块，数据来源是每日夜间 3 点，通过妙想 MCP 获取国内外最新经济政治新闻，按影响大小排序 10 条。存入数据库。
+
+### 报警模块
+
+World Bank 中的数据只用来对比妙想 MCP 拉取的数据正确性。当同一时间的同一项数据不同时，记录一个报警。
+
+## 监控
+
+监控分为服务器监控和服务监控两部分。服务器监控对接 komari，地址：<https://komari.honor3.com/>
+
+---
+
+## 分支规则
+
+### 分支类型与职责
+
+| 分支 | 职责 | 部署 | 合并方向 |
+| --- | --- | --- | --- |
+| `master` | **主分支**（生产分支） | ✅ 唯一部署出口，push 即发布生产 | — |
+| `dev-*` | **开发集成分支**，如 `dev-0.2` | ❌ 不部署（只跑 CI 校验） | 合到 `master` 后由 master 部署 |
+| `tmp-*` | **临时分支**，针对单个问题的修改 | ❌ 不部署 | 合到对应 `dev-*` 后删除 |
+| `android-*` | **Android 外壳构建分支** | ❌ 不部署，只触发 APK 构建 | 构建前须与 `master` 同步 |
+
+> **关于 `main`**：团队约定里的「main 主分支」在本仓库落地为 **`master`**（仓库默认分支即 `master`，不另建 `main`）。
+> 下文所有「main 主分支」均指 `master`。
+
+### 流程
+
+```
+tmp-xxx  ──合并──▶  dev-0.2  ──合并──▶  master  ──push──▶  自动部署生产
+   │                    │
+   │                    └──push──▶ 只跑 CI（版本一致性校验），不部署
+   │
+   └── 问题解决后删除
+
+android-1.0 ── 从 master 同步代码后 push ──▶ 只触发 APK 构建 / 发布到 Packages
+```
+
+1. **日常开发**：从 `dev-*` 拉 `tmp-*`，改完合回 `dev-*`，`tmp-*` 用完即删。
+2. **上线**：`dev-*` 验收通过后合并到 `master`，**推送 `master` 才部署生产**。
+3. **打 Android 包**：`android-*` 与 `master` 同步（`git merge master` 或 `git reset --hard origin/master`）后推送，
+   触发 [android-build.yml](.gitea/workflows/android-build.yml)，产物发布到 Gitea Generic Packages。
+
+### CI 触发范围
+
+| 工作流 | 触发分支 | 动作 |
+| --- | --- | --- |
+| [docker-build.yml](.gitea/workflows/docker-build.yml) | **仅 `master`** | 构建前端 + 生成签名 OTA 包 + 构建镜像 + 迁移数据库 + 部署生产 |
+| [android-build.yml](.gitea/workflows/android-build.yml) | `android-*` | 构建并签名 release APK，上传到 Packages |
+| [ota-build.yml](.gitea/workflows/ota-build.yml) | 仅手动 `workflow_dispatch` | 单独构建/签发 OTA 包 |
+| [sync-registry.yml](.gitea/workflows/sync-registry.yml) | 见文件 | 同步注册中心 |
+
+> ⚠️ **重要变更（2026-10）**：`dev-*` 分支**已取消** push 自动部署。
+> 此前 `dev-*` 与 `master` 共用同一套生产环境，推送开发分支等于直接发布，容易把半成品带上线。
+> 现在开发分支的提交只有合并进 `master` 并推送后才会部署。
+
+### 日常操作规则（工作目录约定）
+
+- 主工作目录（`iboard/`）**默认停留在 `dev-0.2`**，所有修改都在 `dev-0.2` 上提交；`dev-0.2` 可随时 push（只跑 CI 校验，不部署）。
+- 独立功能开发使用**独立分支 + 独立工作目录**（如离线编辑在 `iboard-dev-0.2.1/` 的 `tmp-offline-edit` 分支），不占用 `dev-0.2`。
+- **发布流程（仅在明确需要发布时执行，结束后立刻回到 `dev-0.2`）**：
+
+  ```bash
+  git switch master
+  git merge --ff-only dev-0.2
+  git push origin master        # push 即部署生产
+  git switch dev-0.2
+  ```
+
+---
+
+## 版本管理
+
+### 版本号构成与口径（2026-10-25 决议）
+
+```
+V MAJOR.MINOR.PATCH   例: V0.2.0
+       │      └── PATCH  小版本号: 仅在明确提出时自增, 否则沿用 (记录见 CHANGELOG.md)
+       └── MINOR  大版本迭代, 对应一个开发分支 (V0.2 ↔ dev-0.2)
+```
+
+**前端与外壳解绑，独立维护、独立发版**（2026-10-25 决议）：
+
+| 组 | 版本 | 管理点 | 产物 | 发版节奏 |
+| --- | --- | --- | --- | --- |
+| **前端** (Web/OTA) | `0.2.0` | `package.json` 的 `version`（唯一手动管理点，只写裸版本号，不允许带 `-ota`） | 前端运行时 `APP_VERSION` = `0.2.0`；OTA 包 `version` = `0.2.0-ota` | 随 master push 高频发版 |
+| **外壳** | `0.2.0` | `src-tauri/tauri.conf.json` 的 `version`（须与 `Cargo.toml`/`Cargo.lock` 组内一致） | APK versionName、桌面安装包版本；后续 Windows 外壳同理 | 独立分支（如 `android-*`）低频发版 |
+
+- 两组版本号**不要求相等**，CI（`scripts/ci/check-version.mjs`）只校验组内一致 + 前端版本与 `dev-<major>.<minor>` 分支前缀对应。
+- 分支口径：**dev-0.2 开发，发布一律走 master**。
+
+### build 标识
+
+- 格式统一为 **`YYYYMMDDHHmmss`（北京时间）**：
+  - 前端 `BUILD_ID`：vite 编译时生成（`vite.config.js#makeBuildId`），无需手动维护；
+  - OTA 包 `build_id`：打包时按同一格式生成（`scripts/build-ota.mjs`）。
+- OTA 包的 `sequence`（Unix 毫秒，单调递增）保留，仅用于判新与热插拔协议，不再用于展示。
+
+### PATCH 小版本号
+
+- 仅在**明确提出**时自增（改 `package.json` version 第三位），否则一直沿用。
+- 每次自增在 [CHANGELOG.md](CHANGELOG.md) 追加一行（patch 号 / 日期 / commit / 要点）。
+
+### 改版本号时要同步的位置
+
+| 组 | 文件 | 字段 | 说明 |
+| --- | --- | --- | --- |
+| 前端 | `package.json` | `version` | **前端唯一源**，`src/version.js` 与 OTA 打包脚本均读取此值 |
+| 外壳 | `src-tauri/tauri.conf.json` | `version` | APK 的 versionName、桌面安装包版本 |
+| 外壳 | `src-tauri/Cargo.toml` | `[package].version` | Rust 包版本，须与 tauri.conf.json 一致 |
+| 外壳 | `src-tauri/Cargo.lock` | `name = "iboard"` 条目 | 随 Cargo.toml 一起改 |
+
+### APK 版本号是怎么来的
+
+`tauri android init` 会按 `src-tauri/tauri.conf.json` 的 `version` 生成
+`src-tauri/gen/android/app/tauri.properties`（该目录被 gitignore，CI 每次 `android init` 重新生成）：
+
+```
+tauri.android.versionName = 0.2.0     # 人类可见版本，与 tauri.conf.json 一致
+tauri.android.versionCode = 2000      # 整数，升级判定用 = major*1000000 + minor*1000 + patch
+```
+
+注意：
+- `versionCode` 必须**单调递增**才能覆盖安装，所以外壳版本号只能往上走（`0.2.0` → 2000 > `0.1.0` → 1000）。
+- 本地如果 APK 装完显示旧版本号，是 `src-tauri/gen/android` 缓存没刷新，
+  删掉该目录重新 `npx tauri android init` 即可。
+
+### 其它
+
+- `src/version.js` 从 `package.json` 取值，前端运行时与 OTA 检查接口展示的即此版本，不要另写死版本号。
+- **`min_binary_version` 与这里的版本号是两件事**：它是 OTA 包要求的最低原生二进制版本
+  （CI 里由 `OTA_MIN_BINARY` 显式指定，当前 `0.1.0`）。前端版本升到 0.2.0 时它不应跟着抬，
+  否则装了 0.1.0 APK 的设备会直接收不到热更。
+- `ota-package/latest.json` 为运行时产物，不纳入版本管理。
+
+### "我的"页版本展示口径
+
+| 行 | 展示 |
+| --- | --- |
+| 当前版本 | `v0.2.0 · build 20261025204300`（前端 APP_VERSION + BUILD_ID 原始格式） |
+| 运行资源 | OTA 覆盖包版本 / 内置 |
+| 新版本 | `v0.2.0-ota · build 20261025210000`（OTA 包 build_id） |
+| 发布说明 | 触发构建的 commit message |
+| 提交 | commit sha 前 10 位 |
+| 页面底部 | `外壳 v0.2.0`（Tauri API 读取；Web 端显示 `—`） |
+
+---
+
+## 前端 OTA 升级
+
+只升级前端资源 (`dist/`)，**不触碰** Tauri 框架/原生层，不重打 APK。
+底层使用 [`tauri-plugin-hotswap`](https://github.com/denniskribl/tauri-plugin-hotswap)
+（签名/回滚/资源替换全部由插件处理）。
+
+### 工作流
+
+```
+开发者                                   服务端
+npm run build                ──┐
+scripts/build-ota.mjs          │  生成 iboard-ota.tar.gz + minisign 签名
+                               │  输出 latest.json (sequence/version/...)
+                               ▼
+                          ota-package/   ── 部署到服务器 ──▶   /srv/iboard/ota-package
+                                                                    │
+                                                                    ▼
+                                                          GET /api/ota/check/<seq>
+客户端 (Tauri)                                                     │
+启动 ─▶ notifyReady()                                              ▼
+我页 ─▶ checkUpdate()  ◀──── 200 + manifest (含 url/signature) ─────┘
+       applyUpdate()  ─▶  下载 tar.gz ─▶ minisign 校验 ─▶ 解压到 AppData/ota-dist
+       location.reload() ─▶  后续资源从 tauri://localhost 优先命中覆盖包
+```
+
+### 发布说明与提交号（2026-10-25 起）
+
+- CI（docker-build.yml）把**触发构建的 commit message**（标题+正文，去空行，截断 400 字）作为 `notes` 写入 latest.json；
+- commit sha 经 `--commit` 参数单独写入 `commit` 字段；
+- "我的"页：发布说明展示 commit message，「提交」行展示短 sha。
+
+### 首次部署
+
+1. **生成签名密钥** (一次性):
+   ```bash
+   # 安装 minisign: Windows (scoop) / macOS (brew) / Linux (apt)
+   node scripts/ota-genkey.mjs
+   # 产物: ota-package/hotswap.{key, pub}
+   ```
+2. **把公钥写入 `src-tauri/tauri.conf.json`** 的 `plugins.hotswap.pubkey` 字段（脚本会打印）。
+3. **配置 endpoint** (`src-tauri/tauri.conf.json`):
+   ```json
+   "hotswap": {
+     "endpoint": "https://your-server/api/ota/check/{{current_sequence}}",
+     "pubkey": "RWR...",
+     "require_https": true
+   }
+   ```
+4. **服务端环境变量** `OTA_PACKAGE_DIR` 指向 `ota-package/` 所在目录。
+
+### 发布新版前端
+
+```bash
+npm run build                # 生成 dist/
+node scripts/build-ota.mjs   # 打成 tar.gz + 签名 + latest.json
+# sequence 默认 = Date.now(), 也可 --sequence 43 手动指定
+# 也可加 --notes "修复登录按钮" --commit <sha> --min-binary 0.1.0
+```
+
+然后把 `ota-package/` 下两个文件 (`iboard-ota.tar.gz` + `latest.json`) 同步到
+服务端 `OTA_PACKAGE_DIR` 指向的目录。sequence 单调递增即可。
+
+### 客户端使用
+
+打开 App 的"我"页，点 [检查更新] → [立即升级] 即可。失败会自动回滚到内置 dist。
+
+> **注意:** Tauri 2 的 dev 模式 (`tauri dev`) 会代理到 Vite dev server，**OTA 不生效**。
+> OTA 仅在 release/打包构建中可用，测试请用 `tauri build` 产物。
+
+### 客户端判新口径（V0.2）
+
+"我"页 OTA 组内有一个 **开发版本** 开关（默认关闭），切换"怎么算新版本"：
+
+| 开关 | 判新依据 | 适用 |
+| --- | --- | --- |
+| 关（默认） | **版本号**逐字段比大小（`0.2.0-ota` > `0.1.0` 才算新） | 生产。旧分支被重建（sequence 变大但版本号更小）时不会把设备拉回旧版 |
+| 开 | **build sequence**（服务端 sequence 比本地大就算新） | 开发联调。每次构建都能推到设备 |
+
+- 开关值持久化在设备端 `localStorage.iboard_ota_dev_mode`（`'1'`/`'0'`），默认 `'0'`。
+- 版本比较在 `src/utils/version.js`（纯函数，`src/api/ota.js` 统一封装两种模式）。
+- **`min_binary_version` 与应用版本是两件事**：前者是前端 bundle 要求的最低原生二进制版本，
+  当前 APK 原生层仍是 `0.1.0`，所以 CI 里固定传 `--min-binary 0.1.0`（见 `docker-build.yml` 的
+  `OTA_MIN_BINARY`）。只改前端版本号时**不要**跟着抬这个值，否则旧 APK 会收不到更新。
+
+### Web 端
+
+Web 浏览器访问 (同源) 时，服务端返回简化版 manifest，仅显示"有新版本请刷新"。
+Web 端不会自动下载包，也不会替换前端代码。
+
+### CI 自动签名 (Gitea Actions)
+
+.gitea/workflows/ota-build.yml 是手动触发的 OTA 打包工作流（每次发版前点一次）。
+
+**配置 secret** (Gitea 仓库 -> Settings -> Actions -> Secrets):
+- MINISIGN_PRIVATE_KEY: 完整 .key 文件内容，**整段**（含首行 `untrusted comment: minisign encrypted secret key` 和 base64 行），整段作为多行 secret 粘贴即可。
+
+**使用流程**:
+1. 在 Gitea Actions 页面选 OTA Frontend Build & Sign -> Run workflow
+2. 填 sequence（可选，不填用时间戳）和 notes（可选）
+3. CI 跑完会在 artifact 里看到 ota-package/iboard-ota.tar.gz + latest.json + iboard-ota.tar.gz.minisig
+4. 下载 artifact，scp 到服务器 OTA_PACKAGE_DIR 目录
+5. 客户端"我"页 [检查更新] 即可触发升级
+
+**注意**:
+- CI 用的私钥必须**与** `tauri.conf.json` 里 plugins.hotswap.pubkey **配对**；换密钥时需要同时更新 CI secret 和 conf。
+- 不要把私钥 commit 到 git，整个 ota-package/hotswap.key 已被 .gitignore 排除。
+
+### 数据库升级约定
+
+- 唯一入口是 `prisma/migrations/` 下的迁移文件，由 `npx prisma migrate deploy` 在**启新容器之前**执行
+  （幂等，无新迁移时为 no-op）；迁移失败会中断 workflow，不会用新镜像顶掉仍在运行的旧容器。
+- 由于只有 `master` 会部署，**迁移真正作用到生产库的唯一时机就是 master 发布**；
+  开发分支上的迁移不会被自动应用，请在合并到 `master` 前确认可回滚。
+- 本地改了 `prisma/schema.prisma` 后：写迁移 SQL → `npx prisma migrate deploy` 验证 → 提交迁移目录。
@@ -0,0 +1,11 @@
+# 复制为 .env (服务器上 chmod 600, 已 gitignore)。
+# POWERSYNC_JWT_KEY_B64 = base64url(POWERSYNC_JWT_SECRET 的 UTF-8 字节)
+#   生成: printf %s "$POWERSYNC_JWT_SECRET" | openssl base64 -A | tr '+/' '-_' | tr -d '='
+
+PG_PASSWORD=change-me
+PS_STORAGE_PASSWORD=change-me
+JWT_SECRET_021=change-me
+POWERSYNC_JWT_SECRET=change-me
+POWERSYNC_JWT_KEY_B64=change-me
+POWERSYNC_URL=https://bh.vps.honor3.com:13443
+OTA_PUBLIC_BASE=http://bh.vps.honor3.com:13001
@@ -0,0 +1,61 @@
+# 0.2.1 独立验证部署 (baihu /app/iboard-0.2.1)
+
+与现网 `/app/iboard`(3001/宿主 MySQL) 完全隔离：本栈使用独立 PG 容器、端口 13443/13001/13002，不写原库。
+
+**浏览器入口: `https://bh.vps.honor3.com:13443`**（自签证书，首次访问需在浏览器"高级→继续访问"接受一次；PowerSync 网页端必须运行在安全上下文，http://13001 入口仅供接口调试，任务模块会报 Navigator locks 错误）。
+正式启用需替换受信证书：把 `bh.pem/bh.key` 换成受信证书后 `docker compose restart tls-front`（例如 Let's Encrypt DNS-01，80/443 已被 gateway 占用无法 HTTP-01）。
+
+## 栈
+
+| 服务 | 说明 |
+| --- | --- |
+| `pg` | postgres:16-alpine，`wal_level=logical`（供 PowerSync 逻辑复制），数据在 `./data/pg`，**不对外暴露端口** |
+| `app` | 本仓库 Dockerfile 构建，13001 对外；启动时先 `prisma migrate deploy`；`DISABLE_CRON=1` 关闭定时任务 |
+| `powersync` | journeyapps/powersync-service，13002 对外；源库=pg，bucket storage=同实例 PG 的 powersync schema |
+
+## 首次部署
+
+```bash
+# 服务器上 (源码已上传到 /app/iboard-0.2.1)
+cd /app/iboard-0.2.1/deploy/0.2.1
+
+# 1. 生成 .env (参照 .env.example; POWERSYNC_JWT_KEY_B64 由 secret 派生)
+umask 077
+PG_PASSWORD=$(openssl rand -hex 16)
+PS_STORAGE_PASSWORD=$(openssl rand -hex 16)
+JWT_SECRET_021=$(openssl rand -hex 32)
+POWERSYNC_JWT_SECRET=$(openssl rand -hex 32)
+POWERSYNC_JWT_KEY_B64=$(printf %s "$POWERSYNC_JWT_SECRET" | openssl base64 -A | tr '+/' '-_' | tr -d '=')
+cat > .env <<EOF
+PG_PASSWORD=$PG_PASSWORD
+PS_STORAGE_PASSWORD=$PS_STORAGE_PASSWORD
+JWT_SECRET_021=$JWT_SECRET_021
+POWERSYNC_JWT_SECRET=$POWERSYNC_JWT_SECRET
+POWERSYNC_JWT_KEY_B64=$POWERSYNC_JWT_KEY_B64
+POWERSYNC_URL=http://bh.vps.honor3.com:13002
+OTA_PUBLIC_BASE=http://bh.vps.honor3.com:13001
+EOF
+
+# 2. 构建并启动
+docker compose build app
+docker compose up -d
+
+# 3. 验证
+docker compose ps
+curl -s http://127.0.0.1:13001/api/health
+docker compose logs powersync --tail 50   # 应看到连接源库/建 publication/sync config 部署成功
+```
+
+## 日常更新
+
+```bash
+cd /app/iboard-0.2.1
+git archive 方式重新上传源码 tar 后解包覆盖 (data/.env 不受影响)
+cd deploy/0.2.1 && docker compose build app && docker compose up -d app
+```
+
+## 注意
+
+- `./data/pg` 为 0.2.1 独立数据卷；`./.env` 为密钥，两者均已 gitignore，更新源码时不会覆盖 `.env`（tar 解包不产生它）。
+- PowerSync 的 publication / replication slot 由 service 自动管理（账号 iboard021 为容器内 superuser）。
+- 同步规则改动：编辑 `powersync/sync-config.yaml` 后 `docker compose restart powersync`。
@@ -0,0 +1,84 @@
+name: iboard-021
+
+# 0.2.1 独立验证栈: PG (逻辑复制) + PowerSync + App, 与现网 /app/iboard 完全隔离
+# 见 docs/V0.2/离线编辑模块/0.2.1实施方案.md; 端口 13001 (app) / 13002 (powersync), PG 不对外
+
+services:
+  pg:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    command: ["postgres", "-c", "wal_level=logical"]
+    environment:
+      POSTGRES_USER: iboard021
+      POSTGRES_PASSWORD: ${PG_PASSWORD:?PG_PASSWORD missing}
+      POSTGRES_DB: iboard021
+      # initdb 脚本用: 创建 powersync bucket storage 用户
+      PS_STORAGE_PASSWORD: ${PS_STORAGE_PASSWORD:?PS_STORAGE_PASSWORD missing}
+    volumes:
+      - ./data/pg:/var/lib/postgresql/data
+      - ./initdb:/docker-entrypoint-initdb.d:ro
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U iboard021 -d iboard021"]
+      interval: 5s
+      timeout: 5s
+      retries: 12
+
+  app:
+    build:
+      context: ../..
+      dockerfile: Dockerfile
+    restart: unless-stopped
+    depends_on:
+      pg:
+        condition: service_healthy
+    environment:
+      DATABASE_URL: postgresql://iboard021:${PG_PASSWORD}@pg:5432/iboard021
+      PORT: "13001"
+      JWT_SECRET: ${JWT_SECRET_021:?JWT_SECRET_021 missing}
+      POWERSYNC_JWT_SECRET: ${POWERSYNC_JWT_SECRET:?POWERSYNC_JWT_SECRET missing}
+      POWERSYNC_URL: ${POWERSYNC_URL:-http://bh.vps.honor3.com:13002}
+      OTA_PUBLIC_BASE: ${OTA_PUBLIC_BASE:-http://bh.vps.honor3.com:13001}
+      # 0.2.1 验证部署关闭定时任务 (新闻/油价/米家等), 避免重复外呼
+      DISABLE_CRON: "1"
+    command: ["sh", "-c", "npx prisma migrate deploy && node --experimental-strip-types --no-warnings server/index.js"]
+    ports:
+      - "13001:13001"
+    healthcheck:
+      test: ["CMD-SHELL", "wget -qO- http://127.0.0.1:13001/api/health || exit 1"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+      start_period: 20s
+
+  # TLS 前置 (自签证书): PowerSync 网页端必须在安全上下文运行 (navigator.locks),
+  # 因此浏览器入口统一走 https://bh.vps.honor3.com:13443 (证书接受一次即可, app+sync 同源同证书)
+  tls-front:
+    image: nginx:alpine
+    restart: unless-stopped
+    depends_on:
+      - app
+      - powersync
+    volumes:
+      - ./tls/nginx.conf:/etc/nginx/conf.d/default.conf:ro
+      - ./data/tls:/etc/nginx/certs:ro
+    ports:
+      - "13443:443"
+
+  powersync:
+    image: journeyapps/powersync-service:latest
+    restart: unless-stopped
+    depends_on:
+      pg:
+        condition: service_healthy
+    command: ["start", "-r", "unified"]
+    volumes:
+      - ./powersync/service.yaml:/config/service.yaml:ro
+      - ./powersync/sync-config.yaml:/config/sync-config.yaml:ro
+    environment:
+      POWERSYNC_CONFIG_PATH: /config/service.yaml
+      # service.yaml 内 !env PS_* 引用 (整值替换; URI 在此组装)
+      PS_SOURCE_URI: postgresql://iboard021:${PG_PASSWORD}@pg:5432/iboard021?sslmode=disable
+      PS_STORAGE_URI: postgresql://powersync_storage:${PS_STORAGE_PASSWORD}@pg:5432/iboard021?sslmode=disable
+      PS_JWT_KEY_B64: ${POWERSYNC_JWT_KEY_B64:?POWERSYNC_JWT_KEY_B64 missing}
+    ports:
+      - "13002:8080"
@@ -0,0 +1,13 @@
+#!/bin/bash
+# 一次性 ETL: 清空 0.2.1 库 -> 从现网 MariaDB 只读快照导入
+# 现网连接串从 iboard 容器环境变量读取 (不回显), 源库仅 SELECT
+set -e
+cd /app/iboard-0.2.1/deploy/0.2.1
+SRC=$(docker inspect iboard --format '{{range .Config.Env}}{{println .}}{{end}}' | grep '^DATABASE_URL=' | cut -d= -f2-)
+[ -n "$SRC" ] || { echo '未取到现网 DATABASE_URL'; exit 1; }
+
+echo '--- truncate 0.2.1 库 ---'
+docker compose exec -T pg psql -U iboard021 -d iboard021 -c "TRUNCATE TABLE \"User\",\"Project\",\"ProjectMember\",\"BoardColumn\",\"Task\",\"TaskMember\",\"TaskTag\",\"Habit\",\"CheckIn\",\"CheckList\",\"CheckListItem\",\"CheckListTemplate\",\"Article\",\"Strategy\",\"Indicator\",\"IndicatorPoint\",\"News\",\"Alert\",\"ServerNode\",\"ServerNodeHistory\",\"ServiceCheck\",\"Econ_SowInventory\",\"ScraperCache\",\"OilPriceHistory\",\"MihomeAccount\",\"MihomeHome\",\"MihomeDevice\",\"MihomeEnvSample\",\"MihomeEnvHour\" RESTART IDENTITY CASCADE;"
+
+echo '--- etl run ---'
+docker compose exec -T -e SRC_DATABASE_URL="$SRC" app node scripts/etl-mariadb-to-pg.mjs
@@ -0,0 +1,18 @@
+#!/bin/bash
+# 一次性初始化 (仅首次建库时执行): 创建 powersync bucket storage 专用用户
+# PG >= 14 允许源库与 bucket storage 同实例 (powersync schema 由 service 自建)
+set -e
+: "${PS_STORAGE_PASSWORD:?PS_STORAGE_PASSWORD missing}"
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
+  DO \$\$
+  BEGIN
+    IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'powersync_storage') THEN
+      CREATE USER powersync_storage WITH PASSWORD '$PS_STORAGE_PASSWORD';
+    END IF;
+  END
+  \$\$;
+  GRANT CREATE ON DATABASE $POSTGRES_DB TO powersync_storage;
+EOSQL
+
+echo "[initdb] powersync_storage user ready."
@@ -0,0 +1,10 @@
+-- 一次性初始化: PowerSync 逻辑复制所需 publication (服务不自建, 见 PSYNC_S1141)
+-- 仅发布任务域 + User; 新增同步表时需 ALTER PUBLICATION powersync ADD TABLE ...
+CREATE PUBLICATION powersync FOR TABLE
+  "Project",
+  "ProjectMember",
+  "BoardColumn",
+  "Task",
+  "TaskMember",
+  "TaskTag",
+  "User";
@@ -0,0 +1,41 @@
+# PowerSync Service 主配置 (0.2.1 验证部署)
+# 参考: https://docs.powersync.com/configuration/powersync-service/self-hosted-instances
+# 注意: !env 是 YAML 整值标签, 只能整个值替换变量, 不能内嵌在 URI 字符串中;
+#       完整连接串由 docker-compose 以 PS_* 环境变量注入。
+
+replication:
+  connections:
+    - type: postgresql
+      # 源库: 本栈 pg 容器 (0.2.1 独立实例), 复制走 iboard021 账号
+      uri: !env PS_SOURCE_URI
+      sslmode: disable
+
+# bucket storage: 同实例 PG (16 >= 14 允许同库不同 schema, service 自建 powersync schema)
+storage:
+  type: postgresql
+  uri: !env PS_STORAGE_URI
+  sslmode: disable
+
+port: 8080
+
+sync_config:
+  path: /config/sync-config.yaml
+
+# 客户端鉴权: app 后端 /api/powersync/token 签发 HS256 JWT (aud=powersync)
+# oct 密钥 k = base64url(POWERSYNC_JWT_SECRET)
+client_auth:
+  jwks:
+    keys:
+      - kty: oct
+        k: !env PS_JWT_KEY_B64
+        alg: HS256
+  audience:
+    - powersync
+
+telemetry:
+  disable_telemetry_sharing: true
+
+system:
+  logging:
+    level: info
+    format: text
@@ -0,0 +1,25 @@
+# Sync Streams (edition 3): 任务模块 6 表 + User (展示用)
+# Sequential ID Mapping (见 docs/V0.2/离线编辑模块/0.2.1实施方案.md §3):
+#   - 客户端主键 = uuid 列 (离线新建行同步回填后 id 稳定); int 自增 id 不下发
+#   - 外键输出 uuid 镜像列, 别名回 projectId/columnId/parentId/taskId (客户端字段名不变)
+#   - 引号保留 PG PascalCase 标识; 可见性按 ProjectMember 过滤
+
+config:
+  edition: 3
+
+streams:
+  iboard_users:
+    auto_subscribe: true
+    query: SELECT CAST("id" AS TEXT) AS "id", "name", "email" FROM "User"
+
+  iboard_task_data:
+    auto_subscribe: true
+    with:
+      my_projects: SELECT "projectId" FROM "ProjectMember" WHERE CAST("userId" AS TEXT) = auth.user_id()
+    queries:
+      - SELECT "uuid" AS "id", "uuid", "code", "name", CAST("ownerId" AS TEXT) AS "ownerId", "isPersonal", "archived", "notes", "taskKinds", "icon", "autoArchive", "createdAt", "updatedAt" FROM "Project" WHERE "id" IN my_projects
+      - SELECT "uuid" AS "id", "uuid", "projectUuid" AS "projectId", CAST("userId" AS TEXT) AS "userId", "permission", "createdAt" FROM "ProjectMember" WHERE "projectId" IN my_projects
+      - SELECT "uuid" AS "id", "uuid", "projectUuid" AS "projectId", "name", "sortOrder", "boundStatus", "retention", "createdAt", "updatedAt" FROM "BoardColumn" WHERE "projectId" IN my_projects
+      - SELECT "uuid" AS "id", "uuid", "projectUuid" AS "projectId", "columnUuid" AS "columnId", "parentUuid" AS "parentId", "title", "description", "kind", "markDate", "status", "doneAt", CAST("assigneeId" AS TEXT) AS "assigneeId", CAST("creatorId" AS TEXT) AS "creatorId", "extras", "sortOrder", "number", "archived", "archivedAt", "archiveSource", "createdAt", "updatedAt" FROM "Task" WHERE "projectId" IN my_projects
+      - SELECT "uuid" AS "id", "uuid", "taskUuid" AS "taskId", CAST("userId" AS TEXT) AS "userId" FROM "TaskMember" WHERE "taskId" IN (SELECT "id" FROM "Task" WHERE "projectId" IN my_projects)
+      - SELECT "uuid" AS "id", "uuid", "taskUuid" AS "taskId", "name" FROM "TaskTag" WHERE "taskId" IN (SELECT "id" FROM "Task" WHERE "projectId" IN my_projects)
@@ -0,0 +1,37 @@
+# 0.2.1 TLS 前置: 单端口 13443, 按路径分流 (自签证书, 见 README)
+# PowerSync 页面必须在安全上下文运行 (navigator.locks 仅 HTTPS/localhost), 故 app 与 sync 统一走 TLS
+server {
+    listen 443 ssl;
+    server_name bh.vps.honor3.com;
+
+    ssl_certificate     /etc/nginx/certs/bh.pem;
+    ssl_certificate_key /etc/nginx/certs/bh.key;
+
+    # PowerSync (HTTP 流式 + WebSocket 兜底)
+    location /sync/ {
+        proxy_pass http://powersync:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Connection '';
+        proxy_buffering off;
+        proxy_read_timeout 3600s;
+    }
+    location /socket/ {
+        proxy_pass http://powersync:8080;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_read_timeout 3600s;
+    }
+    location /health {
+        proxy_pass http://powersync:8080;
+    }
+
+    # 应用 (静态前端 + API)
+    location / {
+        proxy_pass http://app:13001;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection "upgrade";
+        proxy_set_header Host $host;
+    }
+}
@@ -0,0 +1,399 @@
+# iBoard V0.2 任务模块 功能设计
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2（对应分支 `dev-0.2`，应用版本 `0.2.0`） |
+| 文档状态 | **设计基线**（待评审） |
+| 上游文档 | `任务模块需求文档.md`（**149 条需求点**，编号 `T-*`） |
+| 配套文档 | `任务模块设计文档-框架设计.md`、`任务模块数据库设计文档.md`、`任务模块界面设计.html` |
+| 对应关系 | **本文与需求点一一对应**：每条需求点均给出「设计落点（功能/组件/接口/表字段）」与「实现要点」 |
+
+> **阅读方式**
+> 1. 本文按需求文档的模块码组织（`VW` / `COL` / `BD` / `FL` / `TK` / `AS` / `ST` / `PJ` / `PM` / `CP` / `UI` / `DT` / `NF` / `EX`）。
+> 2. 每条需求点一行：**编号 → 设计落点 → 实现要点**。设计落点中的组件名、接口路径、表字段均与《任务模块数据库设计文档》《任务模块界面设计》一致。
+> 3. 文末 §15 给出**覆盖自检表**，确保 149 条无遗漏。
+
+---
+
+## 0. 通用约定
+
+### 0.1 契约命名
+
+| 类别 | 约定 | 示例 |
+| --- | --- | --- |
+| 状态枚举 | `todo` / `doing` / `done` | 未开始 / 执行中 / 完成 |
+| 列 | `BoardColumn` 实体，按 `sortOrder` 升序 | 默认 `Plan/Doing/Action/Done` |
+| 保留选项 | `never` / `today` / `3d` / `week` / `month` / `forever` | 永不显示 / 当天 / 3 天 / 本周 / 本月 / 永久显示 |
+| 视图 | `list` / `board` | 设备端记忆 |
+| 设备端键 | `iboard_task_prefs` | `{ lastProjectId, viewMode: { [projectId]: 'list'\|'board' } }` |
+
+### 0.2 接口总览
+
+| 方法 | 路径 | 用途 |
+| --- | --- | --- |
+| GET | `/api/projects` | 我参与的项目（含个人默认项目、归档标记） |
+| POST | `/api/projects` | 新建普通项目（同时初始化 4 个默认列） |
+| GET | `/api/projects/:id` | 项目详情（含成员、列配置） |
+| PUT | `/api/projects/:id` | 改名 / 归档 |
+| DELETE | `/api/projects/:id` | 删除项目（个人项目 400） |
+| POST | `/api/projects/:id/members` | 加成员（个人项目 400） |
+| DELETE | `/api/projects/:id/members/:uid` | 移成员 / 自己退出 |
+| GET/POST | `/api/projects/:id/columns` | 列列表 / 新增列 |
+| PUT | `/api/columns/:id` | 改名 / 改绑定 / 改保留选项 |
+| DELETE | `/api/columns/:id` | 删列（需 `moveToColumnId`，最后列 400） |
+| PUT | `/api/projects/:id/columns/order` | 列排序 |
+| GET | `/api/projects/:id/tasks` | 任务列表（含子任务与列信息） |
+| POST | `/api/projects/:id/tasks` | 新建任务 / 子任务 |
+| GET | `/api/tasks/:id` | 任务详情 |
+| PUT | `/api/tasks/:id` | 改状态 / 换列 / 改字段（触发裁决） |
+| DELETE | `/api/tasks/:id` | 删除任务（级联子任务） |
+| POST | `/api/tasks/:id/copy` | 跨项目拷贝 |
+
+---
+
+## 1. 视图体系（T-VW）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-VW-01 | `ProjectView.jsx` 内 `viewMode` 分支渲染 `ListView` / `BoardView` | 两视图共用 `TaskStore` 的同一份任务数据，仅渲染方式不同 |
+| T-VW-02 | `SwipeTabs`/分段控件切换 `viewMode` | 纯本地状态切换，不触发路由跳转、不重新拉取数据（满足"无整页刷新"） |
+| T-VW-03 | `prefs.js` → `viewMode[projectId]` | 按项目 id 分键存储，A/B 项目互不影响 |
+| T-VW-04 | `ProjectView` 挂载时读 `prefs.getViewMode(projectId)` | 有值用之；无值走 T-VW-05 默认 |
+| T-VW-05 | 默认值 `'list'` | 新项目首次进入为列表 |
+| T-VW-06 | `localStorage.iboard_task_prefs` | **不落库、不同步**；换设备不继承（与 T-FL-15 的项目级配置区分） |
+| T-VW-07 | `prefs.getLastProjectId()` / `setLastProjectId()` | 进入 `/task` 时读取；无记录或记录的项目已不可见 ⇒ 回落个人默认项目 |
+| T-VW-08 | `TaskPage` 首屏上部 `RecentProjects` 条 | 取最近访问的 3 个项目（按设备端访问时间倒序），末尾「更多项目」入口 → `/task/list`（完整项目列表 `ProjectList`，从「更多」进入） |
+| T-VW-09 | `TaskPage` 首屏下部直接内嵌 `ProjectView` | 当前项目 = 上次访问项目（无记录 ⇒ 个人默认项目）；点首屏项目卡片切换当前项目，下部整体切换，不跳转页面 |
+| T-VW-10 | `prefs.js` 增 `recentOrder[]`（设备端） | 长按卡片拖动排序并持久化；无手动记录时按最近访问时间自动排列；项目不可见时从记录剔除 |
+
+> **首屏结构调整（T-VW-08/09）**：`TaskPage`（`/task`）不再以项目列表为首屏，改为「最近项目条 + 当前项目 `ProjectView`」；完整项目列表迁移至 `/task/list`。旧路由 `/task/:pid` 保留（打开指定项目），供深链使用。
+
+> **实现细节**：`lastProjectId` 指向的项目若已被退出/删除，视为"无记录"，静默回落到个人默认项目，不弹错。
+
+---
+
+## 2. 看板列管理（T-COL）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-COL-01 | `POST /api/projects` 内部初始化 4 列 | 事务内创建 `Plan(todo, sort 0)`、`Doing(doing,1)`、`Action(null,2)`、`Done(done,3)` |
+| T-COL-02 | `ColumnSettings` → `POST /api/projects/:id/columns` | `sortOrder = max+1` 追加末尾；`boundStatus=null`、`retention='forever'`（B-18） |
+| T-COL-03 | `PUT /api/columns/:id` | 改 `name`；前端 `TaskStore` 整体替换列列表后重渲染 |
+| T-COL-04 | `DELETE /api/columns/:id?moveToColumnId=` | 二次确认弹窗；见 T-EX-16 |
+| T-COL-05 | `PUT /api/projects/:id/columns/order` | 传完整 `[columnId…]` 数组，服务端按索引重写 `sortOrder` |
+| T-COL-06 | 服务端校验总量 | `1 <= count <= 10`；达上限拒绝新增（T-EX-19）、仅剩 1 列拒绝删除（T-EX-17） |
+| T-COL-07 | `BoardColumn.name` 校验 | trim 后非空、长度 ≤ 12；`@@unique([projectId,name])` 兜底重名 409 |
+| T-COL-08 | 列删除即绑定消失 | 绑定存在列记录上，列删则解除，无需额外清理 |
+| T-COL-09 | `requireProjectMember` | 项目级配置，任一成员可改；不影响其他项目 |
+| T-COL-10 | `ListView` 不分组但仍显示列信息 | 任务行内以小标签显示所属列名（可关闭），归属始终正确 |
+
+---
+
+## 3. 看板与列-状态绑定（T-BD）
+
+> 联动的**唯一实现**在 `server/task-domain/resolveStatus.js`，前端只做乐观更新。判定矩阵见《框架设计》§2.3。
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-BD-01 | `BoardView` 按 `columns` 数组渲染列 | 列来自项目配置，可增删改排序 |
+| T-BD-02 | `ColumnSettings` 每列一组「绑定开关 + 状态下拉」 | 写入 `BoardColumn.boundStatus`（`null`/`todo`/`doing`/`done`） |
+| T-BD-03 | 无唯一约束限制多列绑定同状态 | 允许 `done` 与 `action` 同为 `done` |
+| T-BD-04 | `onColumnChange()` | 目标列 `boundStatus != null` ⇒ `status = boundStatus` |
+| T-BD-05 | `onStatusChange()` | 状态变更后若当前列已匹配则不动作，否则走归位 |
+| T-BD-06 | 归位取列序首个匹配 | `columns` 按 `sortOrder` 排序后 `find()` 首个 |
+| T-BD-07 | **只看目标列** | 目标列不绑定 ⇒ 保留原状态；**无"拖出回退"规则** |
+| T-BD-08 | 不绑定列完全正交 | 拖入/拖出、改状态均不改该列以外语义 |
+| T-BD-14 | `resolveColumn(task, newStatus)` | 当前列 `boundStatus !== newStatus` ⇒ 触发归位 |
+| T-BD-15 | 按当前 `sortOrder` 取首个 | 用户调序后归位目标随之改变 |
+| T-BD-16 | 无匹配返回 `null` | `null` ⇒ 不改 `columnId`，状态照常写库 |
+| T-BD-09 | 初始化默认值 | `Plan=todo`、`Doing=doing`、`Done=done`、`Action=null` |
+| T-BD-10 | 项目级配置 | 任一成员可改；不同项目独立 |
+| T-BD-11 | 配置变更不回溯 | 保存配置时**不触发**任何任务更新语句 |
+| T-BD-12 | 保存后返回最新列列表 | 前端整体替换 + 重算可见集合，无需刷新 |
+| T-BD-13 | `resolveStatus()` 首行判 `parentId` | 子任务直接跳过全部联动 |
+
+---
+
+## 4. 已完成任务显示控制（T-FL）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-FL-01 | `BoardColumn.retention` | 每列独立字段 |
+| T-FL-02 | `ColumnSettings` 下拉 6 项 | 固定枚举，无自由输入 |
+| T-FL-03 | `retention='forever'` | 判定恒为可见 |
+| T-FL-04 | `retention='never'` | 已完成任务恒不可见 |
+| T-FL-05 | `retention='today'` | `doneAt >= 今天 00:00` |
+| T-FL-06 | `retention='3d'` | `doneAt >= 今天-2天 00:00` |
+| T-FL-07 | `retention='week'` | `doneAt >= 本周一 00:00` |
+| T-FL-08 | `retention='month'` | `doneAt >= 本月1日 00:00` |
+| T-FL-09 | `task-domain/retention.js` + 前端定时重算 | 超出窗口自动隐藏，无需操作 |
+| T-FL-10 | 判定字段 `Task.doneAt` | 与当前列无关；取消完成时 `doneAt=null` |
+| T-FL-11 | 前端可见性统一走同一函数 | 列表与看板共用 `isTaskVisible(task, column)`；列表不分组但归属不变 |
+| T-FL-12 | 判定前置 `status !== 'done'` | 未完成任务恒可见 |
+| T-FL-13 | 纯展示层过滤 | 不修改任何字段；接口返回全量，前端过滤（或服务端按需过滤但不改数据） |
+| T-FL-14 | 列计数取过滤后集合长度 | 列头计数与卡片数同源，杜绝不一致 |
+| T-FL-15 | 存在 `BoardColumn` 上 | 项目级共享，非个人偏好（对比 T-VW-06 设备端） |
+
+> **实现细节**：保留判定在前后端各有一份实现（服务端用于分页/统计，前端用于即时过滤），但**必须共用同一口径常量**，跨度边界由 `date.js` 单测覆盖。
+
+---
+
+## 5. 任务字段体系（T-TK）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-TK-01 | `Task` 表 | 字段：`title`/`description`/`projectId`/`columnId`/`status`/`assigneeId`/`creatorId`/`doneAt`/`sortOrder` + 关联成员/标签/扩展 |
+| T-TK-02 | `title` 非空校验 | 其余字段允许空；trim 后为空 ⇒ 400 |
+| T-TK-03 | `status` 枚举三值 | DB 层用 `VARCHAR(8)` + 应用层校验（避免 ENUM 改值困难） |
+| T-TK-04 | **已移除 UI**（2026-10-24）：`ExtrasCard` 组件删除；信息记录由项目信息块（T-PJ-13）承载 |
+| T-TK-05 | **随 T-TK-04 移除**；`extras` 字段在 DB 保留不再使用 |
+| T-TK-06 | **随 T-TK-04 移除** |
+| T-TK-07 | **随 T-TK-04 移除** |
+| T-TK-08 | `Task.assigneeId` 单值 | 重复设置以最后一次为准 |
+| T-TK-09 | 新建时服务端默认赋值 | 未显式传 `assigneeId` ⇒ 取 `req.user.id`（B-10） |
+| T-TK-10 | `assigneeId` 允许 `null` | 显式传 `null` 即清空，UI 显示「未指派」 |
+| T-TK-11 | `TaskMember` 关联表 | 多对多，`@@unique([taskId,userId])` 去重 |
+| T-TK-12 | `TaskTag` 表 + 卡片标签渲染 | 多标签，展示于卡片/条目 |
+| T-TK-13 | 服务端维护 | `creatorId`/`createdAt` 不可改；`updatedAt` 自动刷新 |
+| T-TK-14 | 标题 30 字上限 + 快速添加截断 | 服务端 create/update 校验 `title ≤ 30`；前端 `quickAdd.js#splitTitle`：≤30 原样，超长在 30 字内（≥8 字）找最后一个分隔符截断，前段为标题、**完整原文**写入 `description`；快速添加输入框 `maxLength=200` |
+| T-TK-15 | `Task.markDate DATETIME(3) NULL`（迁移 20261025120000） | create/update 接受 `YYYY-MM-DD`（空/null 清除），完整日期存储；详情页 DatePicker（precision=day）选择/清除；卡片展示 `MM-dd` 小标签（`date-tag`） |
+| T-TK-16 | `quickAdd.js#parseTimePrefix` | 前缀词表：今天/明天/后天/本周/下周/本月/下月（须后跟分隔符或结束）；今天=当日，明天/后天=+1/+2，本周=本周日、下周=下周日（周一为一周开始），本月/下月=当月/下月最后一天；命中后前缀移出标题并写入 `markDate` |
+
+---
+
+## 6. 负责人 & 成员（T-AS）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-AS-01 | `TaskCard` 负责人区 | 字号 13px/600 + 头像，位于标题下方主信息位 |
+| T-AS-02 | `TaskCard` 成员区 | 字号 11px/400、色 `#999`，位于卡片底部 |
+| T-AS-03 | `UserPicker` 数据源 = 项目成员 | 只列 `ProjectMember` 中的用户 |
+| T-AS-04 | 同上（多选模式） | 不可选项目外用户 |
+| T-AS-05 | `assigneeId === null` 时渲染「未指派」 | 占位样式弱化，可点击再次指派 |
+| T-AS-06 | 渲染时 `LEFT JOIN ProjectMember` 判定 | 非成员 ⇒ 显示「已退出」灰标；见 T-EX-06 |
+| T-AS-07 | 权限模型 | 无"负责人可编辑"概念，所有成员全读写（T-PM-02） |
+
+---
+
+## 7. 子任务体系（T-ST）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-ST-01 | `Task.parentId` 自关联 | 创建子任务时校验：父任务 `parentId IS NULL`，否则 400 |
+| T-ST-02 | 一致性校验 | 子任务 `projectId` 必须等于父任务 `projectId`，否则 400（T-EX-12） |
+| T-ST-03 | 状态独立 | 父/子状态字段各自独立，无级联更新 |
+| T-ST-04 | `SubtaskRow` 缩进 | 左侧 28px 缩进 + 层级线 |
+| T-ST-05 | 折叠/展开按钮 | 组件内存状态，折叠时不渲染子项 |
+| T-ST-06 | `TaskCard` 内嵌 `SubtaskRow` 列表 | 简洁单行：复选框 + 标题，最多显示 3 条 + 「查看全部」 |
+| T-ST-07 | 卡片内直接勾选 | 勾选调 `PUT /api/tasks/:id {status}`；完整编辑走 `TaskDetail` 弹窗 |
+| T-ST-08 | 子任务跳过绑定 | 见 T-BD-13；父任务完成时子任务状态不变 |
+| T-ST-09 | `SubtaskRow` 带 `StatusDot` | 三色小圆点：灰=未开始 / 蓝=执行中 / 绿=完成 |
+| T-ST-10 | 看板只渲染顶层任务 | 看板查询 `WHERE parentId IS NULL` |
+| T-ST-11 | `Task.parentId` 级联删除 | `onDelete: Cascade`（T-EX-07） |
+| T-ST-12 | `useLongPressDrag` 落点为目标顶层任务 | 设置 `parentId` |
+| T-ST-13 | 目标为子任务 ⇒ 拒绝 | Toast「仅支持一级子任务」 |
+| T-ST-14 | 被拖任务有子任务 ⇒ 拒绝 | 避免二级嵌套 |
+| T-ST-15 | 保持原列与状态 | 仅更新 `parentId`，不触发状态裁决 |
+
+---
+
+## 8. 项目体系（T-PJ）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-PJ-01 | 用户首次访问自动创建 | 按 `isPersonal=true` 且 `ownerId=userId` 幂等创建 |
+| T-PJ-02 | `DELETE /api/projects/:id` 校验 `isPersonal` | 为真 ⇒ 400（T-EX-09） |
+| T-PJ-03 | `POST .../members` 校验 `isPersonal` | 为真 ⇒ 400 |
+| T-PJ-04 | `name` 初始 `${user.name}的任务` | 允许 `PUT` 改名，`isPersonal` 不变 |
+| T-PJ-05 | `POST /api/projects` | 创建者自动写入 `ProjectMember` |
+| T-PJ-06 | 成员接口 | 增/删成员，即时影响可见性 |
+| T-PJ-07 | `DELETE .../members/:uid` 允许 `uid == ownerId` | 创建人退出后不再是成员 ⇒ 不可见 |
+| T-PJ-08 | 删除最后成员不删项目 | 仅删 `ProjectMember`（B-11）；见 T-EX-11 |
+| T-PJ-09 | `Project.archived` | 列表分「进行中 / 已归档」 |
+| T-PJ-10 | 列表查询按成员关系过滤 | `WHERE EXISTS ProjectMember(userId)` |
+| T-PJ-11 | 新组件 `ProjectManage`（项目管理页） | 分区承载：成员（复用 `ProjectMembers` 逻辑）、列设置（复用 `ColumnSettings`）、项目信息；`ProjectView` 头部仅保留「项目管理」一个入口 |
+| T-PJ-12 | `ProjectManage` 的「项目信息」分区 | 改名（`PUT /api/projects/:id {name}`）、归档/取消归档（`{archived}`）、删除（个人项目隐藏入口）、退出（仅创建人可见）；删除与退出均有二次确认 |
+| T-PJ-13 | `Project.notes` Json + `ProjectManage` 的「信息块」分区 | 存 `[{title, content}]`（≤50 块，标题 ≤50 字、内容 ≤20000 字）；`PUT {notes}` 整体替换；底部弹层独立编辑（标题输入 + 多行 textarea + 删除），键盘弹出时复用 `useKeyboardInset` 抬升 |
+
+---
+
+## 9. 项目权限与入口（T-PM）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-PM-01 | `requireProjectMember` 中间件 | 非成员 403；列表查询天然过滤 |
+| T-PM-02 | 无角色区分 | 所有成员对任务/列/成员均有全读写 |
+| T-PM-03 | `ProjectMember.permission` 字段 | 本期恒为 `member`，预留分级扩展位 |
+| T-PM-04 | 归档接口无权限限制 | 任意成员可归档（`PUT /api/projects/:id {archived}`） |
+| T-PM-05 | 复用 `authRequired` | 未登录 401 |
+| T-PM-06 | `BottomNav.TABS` 插入 `{ key:'/task', label:'任务' }` | 位于 `打卡` 之后；`HomePath` 仍为 `/checkin` |
+| T-PM-07 | `prefs.lastProjectId` | 设备端；无记录 ⇒ 个人默认项目 |
+
+---
+
+## 10. 跨项目拷贝（T-CP）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-CP-01 | `POST /api/tasks/:id/copy` | 复制而非移动，源任务零改动 |
+| T-CP-02 | `copyTask()` 字段映射 | 标题/描述/状态/列/扩展/标签/成员 全量复制 |
+| T-CP-03 | 递归复制子任务 | 只复制一层（子任务无更深层级） |
+| T-CP-04 | `creatorId = req.user.id` | 覆盖源创建人 |
+| T-CP-05 | 无任何关联字段 | 拷贝后两条独立记录 |
+| T-CP-06 | 校验目标项目成员身份 | 非成员 403 |
+| T-CP-07 | 人员交集过滤 | 保留属于目标项目成员者，返回 `dropped` 名单（T-EX-08） |
+| T-CP-08 | 子任务 `projectId` 同步改写 | 与父任务一致 |
+| T-CP-09 | 状态与列沿用不纠正 | 见 T-EX-14 |
+
+---
+
+## 11. UI 交互规范（T-UI）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-UI-01 | 列表条目结构 / 快速新增 / 子任务折叠 | 参考 Todoist：底部输入框回车即建 |
+| T-UI-02 | `TaskCard` 精简版 | 仅标题、状态点、负责人、子任务摘要；无边框装饰 |
+| T-UI-03 | 单 `TaskStore` | 任一视图修改写入 store，另一视图读取同一数据 |
+| T-UI-04 | 视图切换纯本地 | 不重新请求，不重载页面 |
+| T-UI-05 | 复用 `.card` 与安全区变量 | 375~430px 无横向滚动；底部预留 TabBar 高度 |
+| T-UI-06 | 勾选即时变色 | 乐观更新，先改 UI 再发请求 |
+| T-UI-07 | `useLongPressDrag` | 长按 300ms 拖拽 + 「⋯」菜单「移动到」兜底 |
+| T-UI-08 | `EmptyState` 组件 | 无项目 / 无任务 / 无子任务三档空态 + CTA |
+| T-UI-09 | `LoadingState` 骨架屏 | 首屏与切换视图 |
+| T-UI-10 | `ErrorState` 组件 | 展示错误 + 重试按钮 |
+| T-UI-11 | 弹层容器统一 `padding-bottom: calc(env(safe-area-inset-bottom) + 20px)` | 底部按钮（删除等）与屏幕底边保持安全距离；小屏下弹层 `max-height` + 内部滚动，底部按钮始终完整可见 |
+
+---
+
+## 12. 数据需求（T-DT）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-DT-01 | `Project` / `ProjectMember` | 见《数据库设计文档》 |
+| T-DT-02 | `BoardColumn.boundStatus` | 每列独立字段，允许多列同值 |
+| T-DT-03 | `BoardColumn.retention` | 六档枚举字符串 |
+| T-DT-04 | `Task` | 含 `parentId` 自关联、`assigneeId`、`status`、`columnId`、`extras` |
+| T-DT-05 | `TaskMember` / `TaskTag` | 关联表；`extras` 为 JSON |
+| T-DT-06 | 设备端 | 不落库 |
+| T-DT-07 | 索引 | `(projectId, columnId)`、`(projectId, status)`、`(parentId)` |
+| T-DT-08 | 迁移文件 | `prisma migrate deploy` 流程 |
+| T-DT-09 | `Project.archived` / 任务无物理删 | 归档保留历史 |
+
+---
+
+## 13. 非功能需求（T-NF）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-NF-01 | 单请求聚合 + 乐观更新 | 见《框架设计》§4.2 |
+| T-NF-02 | 不依赖桌面专有 API | 触控事件统一 `touch` / `pointer` 兼容 |
+| T-NF-03 | `src/pages/task/*` + `server/routes/*.js` | 与既有模块结构一致 |
+| T-NF-04 | 路由挂载于 `server/index.js` | 沿用既有组织方式 |
+| T-NF-05 | 千级任务可用 | 索引 + 分页/虚拟滚动 |
+
+---
+
+## 14. 异常与边界（T-EX）
+
+| 编号 | 设计落点 | 实现要点 |
+| --- | --- | --- |
+| T-EX-01 | 前端 500ms 防抖 + 服务端幂等判定 | 相同终态请求直接返回当前任务 |
+| T-EX-02 | 乐观更新快照回滚 | 失败恢复快照 + Toast + 重试按钮 |
+| T-EX-03 | 列配置改为不绑定 | 已有任务保持不动 |
+| T-EX-04 | 状态与列不匹配 | 走 T-BD-14~16 归位 |
+| T-EX-05 | 拖到不绑定列 | 状态保留，不回退 |
+| T-EX-06 | 非成员渲染「已退出」 | 见 T-AS-06 |
+| T-EX-07 | 级联删除子任务 | 确认弹窗提示条数 |
+| T-EX-08 | 拷贝丢弃人员 | 返回 `dropped` 并提示 |
+| T-EX-09 | 个人项目两个保护接口 | 400 + 明确文案 |
+| T-EX-10 | 列空态 | 展示该列空态，不报错 |
+| T-EX-11 | 无成员项目 | 静默不可见，无特判报错 |
+| T-EX-12 | 子任务跨项目 | 服务端 400 |
+| T-EX-13 | 拖拽降级 | 保持原列与状态 |
+| T-EX-14 | 拷贝状态/列无法对应 | 沿用源值，不纠正 |
+| T-EX-15 | 拖到自身或后代 | 拒绝 + Toast |
+| T-EX-16 | 删除有任务的列 | 二次确认 + 迁移到指定列（默认相邻）+ 重新裁决 |
+| T-EX-17 | 删除最后一列 | 400「至少保留一列」 |
+| T-EX-18 | 跨周期当场消失 | 定时重算 + 退场动画 + 重排 |
+| T-EX-19 | 达到列数上限 | 拒绝新增 + 提示 |
+
+---
+
+## 15. 任务归档（T-ARC）
+
+> 归档与 T-FL 显示控制的分层：**隐藏 = 展示过滤（可逆、不落库）**；**归档 = 移出主工作集（落库、可恢复）**。
+> 自动归档的倒计时起点是任务**被隐藏的时刻**（由 `doneAt + 列保留窗口` 推导，不新增 hiddenAt 字段）。
+
+### 15.1 数据
+
+| 落点 | 说明 |
+| --- | --- |
+| `Project.autoArchive VARCHAR(8) NOT NULL DEFAULT 'never'` | 自动归档档位：`3d` / `1w` / `1m` / `never`；项目级共享（同 T-FL-12 口径） |
+| `Task.archived BOOLEAN NOT NULL DEFAULT false` | 归档标记；归档**不迁移表**，主查询统一追加 `archived = false` |
+| `Task.archivedAt DATETIME(3) NULL` | 归档时刻（查询过滤与排序键） |
+| `Task.archiveSource VARCHAR(8) NULL` | `'manual'` / `'auto'`，溯源用 |
+| 索引 | `idx_task_project_archived (projectId, archived, archivedAt)`；`idx_task_project_status_archived (projectId, status, archived)` |
+| 迁移（待实施） | `20261026000000_task_archive`：三列 + 两索引（MySQL DDL 见数据库设计文档 §3.1/§3.4） |
+
+### 15.2 API
+
+| 接口 | 说明 |
+| --- | --- |
+| `POST /api/tasks/:id/archive` | 手动归档：父任务连带全部后代置 `archived/archivedAt/archiveSource='manual'`；幂等（已归档直接返回当前态） |
+| `POST /api/tasks/:id/unarchive` | 恢复：父任务连带后代清除归档三字段；原列因 `ON DELETE RESTRICT` 必存在，状态保持不变 |
+| `GET /api/projects/:id/tasks/archived?keyword&kind&columnId&from&to&cursor&limit` | 归档查询：`keyword` 标题 LIKE、`kind`、`columnId`、`from/to`（归档日期，含边界）；`limit` 默认 20、≤100；游标 = `archivedAt+id` 复合降序，返回 `{ items, nextCursor }`，`nextCursor` 为空即到底 |
+| `PUT /api/projects/:id` | 增接受 `autoArchive`，枚举校验（非法 400） |
+| 既有查询 | `GET /projects/:id/tasks`、统计、列计数等全部追加 `archived: false`；`taskCount`（projectSummary）同口径 |
+
+### 15.3 自动归档执行
+
+- **归档到期判定**：`due = 隐藏时刻 + autoArchive 档位`；隐藏时刻 = `doneAt + 列保留窗口`（复用 `retentionStart` 口径，含 `today/3d/week/month`；`forever` 列任务永不隐藏、不进入自动归档）。
+- **执行时机（双保险）**：
+  1. **读时惰性**：加载项目任务时对该项目先执行一轮到期归档（保证用户看到的数据与判定一致，刚到期的任务当场消失）；
+  2. **每小时 cron 兜底**：扫描全部 `autoArchive != 'never'` 项目的到期 done 任务批量归档（`archiveSource='auto'`）。
+- **幂等**：`archived = false` 且 `status = 'done'` 且 `doneAt` 非空才进入判定；重复执行无副作用。
+- **批量写**：cron 用 `updateMany`（按到期集合），读时惰性用单项目范围 `updateMany`。
+
+### 15.4 前端
+
+| 落点 | 说明 |
+| --- | --- |
+| 任务 `⋯` 菜单 | 新增「归档」（`Dialog.confirm`，含子任务时提示连带条数）；成功后列表/看板乐观移除 |
+| 项目管理 | 「归档设置」分区：`Selector` 四档（3 天后/一周后/一月后/永不），保存即生效 |
+| 项目视图头部 | 项目栏新增「已归档」入口 → 全屏弹层：过滤条（关键词/类型/列/归档时段）+ 分页「加载更多」+ 行内「恢复 / 删除」 |
+| 主视图 | 列表/看板无需感知归档（数据源已排除）；恢复后经 `load()` 回到原位 |
+
+### 15.5 边界
+
+| 场景 | 处理 |
+| --- | --- |
+| 归档父任务时新增/恢复子任务 | 子任务随父判定：父 archived 则子不单独出现在主列表（查询按父排除） |
+| 自动归档期间用户正在编辑该任务 | 详情弹层保存正常（归档不锁写）；保存后任务仍在归档集 |
+| 恢复后任务再次到期隐藏 | 重新进入自动归档倒计时（`doneAt` 未变则可能立即再次到期，属预期） |
+| 「永不」档位 | 不做任何自动归档；手动归档不受影响 |
+| 拷贝任务 | 拷贝件不继承归档态（`copyTask` 不复制 archived 三字段） |
+
+---
+
+## 16. 覆盖自检表
+
+| 模块 | 编号范围 | 条数 | 本文对应章节 |
+| --- | --- | --- | --- |
+| 视图体系 | T-VW-01 ~ 10 | 10 | §1 |
+| 看板列管理 | T-COL-01 ~ 10 | 10 | §2 |
+| 列-状态绑定 | T-BD-01 ~ 16 | 16 | §3 |
+| 已完成显示控制 | T-FL-01 ~ 15 | 15 | §4 |
+| 任务字段体系 | T-TK-01 ~ 13 | 13 | §5 |
+| 负责人 & 成员 | T-AS-01 ~ 07 | 7 | §6 |
+| 子任务体系 | T-ST-01 ~ 15 | 15 | §7 |
+| 项目体系 | T-PJ-01 ~ 13 | 13 | §8 |
+| 项目权限与入口 | T-PM-01 ~ 07 | 7 | §9 |
+| 跨项目拷贝 | T-CP-01 ~ 09 | 9 | §10 |
+| UI 交互规范 | T-UI-01 ~ 11 | 11 | §11 |
+| 数据需求 | T-DT-01 ~ 09 | 9 | §12 |
+| 非功能需求 | T-NF-01 ~ 05 | 5 | §13 |
+| 异常与边界 | T-EX-01 ~ 19 | 19 | §14 |
+| 任务归档 | T-ARC-01 ~ 08 | 8 | §15 |
+| **合计** | — | **157** | — |
+
+> 需求文档共 **157 条**需求点，本文逐条给出设计落点，覆盖率 **157/157**。（其中 `T-BD-14~16`、`T-COL-*`、`T-EX-18~19`、`T-VW-08~10`、`T-PJ-11/12`、`T-UI-11`、`T-ARC-*` 为评审后新增，编号不连续，非笔误。）
@@ -0,0 +1,467 @@
+# iBoard V0.2 任务模块 数据库设计文档
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2（对应分支 `dev-0.2`，应用版本 `0.2.0`） |
+| 文档状态 | **设计基线**（待评审，未落库） |
+| 数据库 | MariaDB / MySQL 8（Prisma `provider = "mysql"`） |
+| 字符集 | `utf8mb4 / utf8mb4_unicode_ci` |
+| 时区约定 | 应用层统一 `Asia/Shanghai`，库内 `DATETIME` 存 UTC |
+| 相关文件 | `prisma/schema.prisma`、`prisma/migrations/20261024xxxxxx_add_task_module/migration.sql` |
+| 关联文档 | `任务模块需求文档.md`、`任务模块设计文档-框架设计.md`、`任务模块功能设计.md`、`任务模块界面设计.html` |
+
+---
+
+## 1. 概述
+
+任务模块新增 **6 张表**，并把既有 `User` 表补上反向关系（不改 `User` 结构）：
+
+| 表 | 作用 | 归属 |
+| --- | --- | --- |
+| `Project` | 项目（隔离与权限单位） | 项目域 |
+| `ProjectMember` | 项目成员（权限关系） | 项目域 |
+| `BoardColumn` | 看板列（名称 / 顺序 / 状态绑定 / 保留选项） | 看板域 |
+| `Task` | 任务与子任务（自关联，一层） | 任务域 |
+| `TaskMember` | 任务成员（多人标记） | 任务域 |
+| `TaskTag` | 任务标签 | 任务域 |
+
+### 1.1 设计原则
+
+1. **列是实体，不是枚举。** 看板列允许增删改与排序（T-COL），若仍用 `plan/doing/action/done` 枚举，则"改名"无从表达、"排序"只能堆在 JSON 里、"删除列"会留下悬空字符串。因此独立建 `BoardColumn` 表，`Task` 用 `columnId` 外键引用。
+2. **状态与列双落库，互不推导。** `Task.status`（三值）与 `Task.columnId` 是两个正交维度；未绑定的列（默认 `Action`）必须允许二者不一致（T-BD-08、T-BD-16），任何"由状态反推列"或"由列反推状态"的写法都会丢失信息。联动只在写接口中按项目配置即时裁决。
+3. **配置不下沉到任务。** 绑定与保留选项只存在 `BoardColumn` 上，任务不冗余任何配置副本——改配置立即对所有任务生效，且不需要回填。
+4. **按项目隔离。** 所有业务表都可通过 `projectId` 归集，权限校验统一查 `ProjectMember`。
+5. **软删除优先。** 项目用 `archived`；任务删除为级联物理删除（T-ST-11），但删除前有二次确认。
+6. **迁移只增不改。** 新增需求一律新迁移文件，不修改已执行的迁移。
+
+---
+
+## 2. 概念模型（ER）
+
+```
+                    ┌────────────────┐
+                    │      User      │  (既有表, 仅补反向关系)
+                    └───┬────────┬───┘
+                        │        │
+             ┌──────────▼──┐  ┌──▼──────────────┐
+             │ProjectMember│  │ TaskMember      │
+             │(权限关系)    │  │ (任务成员)       │
+             └──────┬──────┘  └──▲──────────────┘
+                    │ *          │ *
+                    │            │
+                ┌───▼──────┐   ┌─┴──────┐
+                │ Project  │1─*│  Task  │*─1┌────────────┐
+                └───┬──────┘   └───┬────┘   │ BoardColumn│
+                    │ *            │ *      └────────────┘
+               ┌────▼───────┐      │             ▲
+               │BoardColumn │1────*┘             │
+               └────────────┘  (columnId)        │
+                                                 │
+                    ┌────────┐                   │
+                    │TaskTag │*──────────────────┘
+                    └────────┘
+
+    Task 自关联: parentId ── 子任务(一层, 仅顶层任务可作父)
+```
+
+基数说明：
+
+| 关系 | 基数 | 级联 |
+| --- | --- | --- |
+| User → ProjectMember | 1 : N | Cascade |
+| Project → ProjectMember | 1 : N | Cascade |
+| Project → BoardColumn | 1 : N | Cascade |
+| Project → Task | 1 : N | Cascade |
+| BoardColumn → Task | 1 : N | **RESTRICT**（有任务的列不可直接删） |
+| Task → Task（parent） | 1 : N | Cascade |
+| Task → TaskMember | 1 : N | Cascade |
+| Task → TaskTag | 1 : N | Cascade |
+| User → Task（assignee / creator） | 1 : N | SetNull / Cascade（见下） |
+
+> `BoardColumn → Task` 使用 `RESTRICT` 而非 `Cascade`：防止误删列时静默丢任务。删除列必须先在其接口内把任务迁移走（事务内改 `columnId`），迁移完成后再删列。
+
+---
+
+## 3. 表结构
+
+### 3.1 `Project` — 项目
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | 主键 |
+| `name` | `VARCHAR(50)` | 否 | — | 项目名 |
+| `ownerId` | `INT` | 否 | — | 创建人（可退出项目，故与成员表分离） |
+| `isPersonal` | `BOOLEAN` | 否 | `false` | 个人默认项目：不可删、不可加成员（T-PJ-02/03） |
+| `archived` | `BOOLEAN` | 否 | `false` | 归档（T-PJ-09） |
+| `notes` | `JSON` | 否 | `[]` | 项目信息块 `[{title, content}]`（T-PJ-13） |
+| `taskKinds` | `JSON` | **是** | `NULL` | 任务类型标签列表；`NULL` 时服务端回落默认四类（T-TK-14） |
+| `icon` | `TEXT` | **是** | `NULL` | 项目图标 data URL（客户端裁剪 96x96 JPEG） |
+| `autoArchive` | `VARCHAR(8)` | 否 | `'never'` | 自动归档档位：`3d`/`1w`/`1m`/`never`（T-ARC-02） |
+| `createdAt` | `DATETIME(3)` | 否 | `now()` | — |
+| `updatedAt` | `DATETIME(3)` | 否 | — | `@updatedAt` |
+
+索引：
+
+| 名称 | 字段 | 用途 |
+| --- | --- | --- |
+| `idx_project_owner` | `(ownerId)` | 查"我的项目" |
+| `idx_project_archived` | `(archived)` | 归档分区 |
+
+**约束说明**
+- `isPersonal` 唯一性由应用层保证（每个用户至多一个）：`UNIQUE(ownerId, isPersonal)` 不可用（普通项目也是 `false`），改为在创建时查询判重。
+
+### 3.2 `ProjectMember` — 项目成员
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | — |
+| `projectId` | `INT` | 否 | — | FK → `Project.id` `ON DELETE CASCADE` |
+| `userId` | `INT` | 否 | — | FK → `User.id` `ON DELETE CASCADE` |
+| `permission` | `VARCHAR(16)` | 否 | `'member'` | 预留权限分级（T-PM-03），本期恒为 `member` |
+| `createdAt` | `DATETIME(3)` | 否 | `now()` | 加入时间 |
+
+索引：
+
+| 名称 | 字段 | 唯一 | 用途 |
+| --- | --- | --- | --- |
+| `uk_member_project_user` | `(projectId, userId)` | ✔ | 防重复加入；权限查询 |
+| `idx_member_user` | `(userId)` | — | "我参与的项目" |
+
+> **注意**：视图记忆与上次项目**不在此表**。视图记忆存设备端（T-VW-06、T-DT-06），早期草案把它放在 `ProjectMember` 上，已在评审中否决。
+
+### 3.3 `BoardColumn` — 看板列
+
+**本模块新增的核心实体**，承载三件事：显示顺序、状态绑定、已完成保留选项。
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | — |
+| `projectId` | `INT` | 否 | — | FK → `Project.id` `ON DELETE CASCADE` |
+| `name` | `VARCHAR(20)` | 否 | — | 列名，项目内唯一（T-COL-07） |
+| `sortOrder` | `INT` | 否 | `0` | 显示顺序；**决定自动归位取"第一个匹配列"**（T-BD-15） |
+| `boundStatus` | `VARCHAR(8)` | **是** | `NULL` | `NULL`=不绑定；或 `todo`/`doing`/`done`（T-BD-02） |
+| `retention` | `VARCHAR(8)` | 否 | `'forever'` | `never`/`today`/`3d`/`week`/`month`/`forever`（T-FL-02） |
+| `createdAt` | `DATETIME(3)` | 否 | `now()` | — |
+| `updatedAt` | `DATETIME(3)` | 否 | — | — |
+
+索引：
+
+| 名称 | 字段 | 唯一 | 用途 |
+| --- | --- | --- | --- |
+| `uk_column_project_name` | `(projectId, name)` | ✔ | 列名不重名（T-COL-07） |
+| `idx_column_project_sort` | `(projectId, sortOrder)` | — | 看板渲染与归位查找 |
+
+**默认数据**（新建项目时由应用层在事务内写入，T-COL-01、T-BD-09）：
+
+| sortOrder | name | boundStatus | retention |
+| --- | --- | --- | --- |
+| 0 | `Plan` | `todo` | `forever` |
+| 1 | `Doing` | `doing` | `forever` |
+| 2 | `Action` | `NULL` | `forever` |
+| 3 | `Done` | `done` | `forever` |
+
+> **为什么保留选项默认为 `forever` 而不是 `never`**：默认应"看得见"，避免用户误以为数据丢失；隐藏是主动行为。
+
+**约束与校验**
+
+| 规则 | 实现层 |
+| --- | --- |
+| 列数 1~10（上限待确认，T-COL-06） | 应用层：新增/删除前计数校验 |
+| 至少保留 1 列（T-EX-17） | 应用层：删除前 count > 1 |
+| 删列必须指定迁移目标（T-EX-16） | 应用层：接口必须带 `moveToColumnId` |
+| `boundStatus` 取值合法 | 应用层白名单校验 |
+| `retention` 取值合法 | 应用层白名单校验 |
+
+### 3.4 `Task` — 任务 / 子任务
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | — |
+| `projectId` | `INT` | 否 | — | FK → `Project.id` `ON DELETE CASCADE` |
+| `columnId` | `INT` | 否 | — | FK → `BoardColumn.id` `ON DELETE RESTRICT`（T-BD-01） |
+| `parentId` | `INT` | **是** | `NULL` | 非空 = 一级子任务；FK → `Task.id` `ON DELETE CASCADE`（T-ST-01/11） |
+| `title` | `VARCHAR(200)` | 否 | — | 唯一必填（T-TK-02）；应用层限 30 字（T-TK-14） |
+| `description` | `TEXT` | 否 | `''` | 快速添加超长文本的余文并入此处（T-TK-14） |
+| `kind` | `VARCHAR(20)` | **是** | `NULL` | 任务类型标签，取值见 `Project.taskKinds` |
+| `markDate` | `DATETIME(3)` | **是** | `NULL` | 时间标记，完整日期存储、展示 `MM-dd`（T-TK-15；迁移 20261025120000） |
+| `status` | `VARCHAR(8)` | 否 | `'todo'` | `todo`/`doing`/`done`（T-TK-03） |
+| `doneAt` | `DATETIME(3)` | **是** | `NULL` | 完成时刻；**保留选项判定依据**（T-FL-10） |
+| `assigneeId` | `INT` | **是** | `NULL` | 负责人（单人）；新建默认创建者（T-TK-09） |
+| `creatorId` | `INT` | 否 | — | 创建人；拷贝时为操作者（T-CP-04） |
+| `extras` | `JSON` | 否 | `[]` | 扩展信息卡片 `[{label,value,url?}]`（T-TK-04/05） |
+| `sortOrder` | `INT` | 否 | `0` | 列内/列表内排序 |
+| `archived` | `BOOLEAN` | 否 | `false` | 归档标记；主查询一律 `archived = false`（T-ARC-01/03） |
+| `archivedAt` | `DATETIME(3)` | **是** | `NULL` | 归档时刻；归档查询的过滤/排序键（T-ARC-04） |
+| `archiveSource` | `VARCHAR(8)` | **是** | `NULL` | `'manual'` / `'auto'` 溯源（T-ARC-01/02） |
+| `createdAt` | `DATETIME(3)` | 否 | `now()` | — |
+| `updatedAt` | `DATETIME(3)` | 否 | — | — |
+
+外键与索引：
+
+| 名称 | 字段 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `fk_task_project` | `(projectId)` | Cascade | 删项目连带删任务 |
+| `fk_task_column` | `(columnId)` | **Restrict** | 有任务的列不可直接删（见 §2 说明） |
+| `fk_task_parent` | `(parentId)` | Cascade | 删父任务连带删子任务（T-EX-07） |
+| `fk_task_assignee` | `(assigneeId)` | SetNull | 用户删除时清空负责人 |
+| `fk_task_creator` | `(creatorId)` | Cascade | 用户删除时连带删其创建的任务* |
+| `idx_task_project_column` | `(projectId, columnId)` | — | 看板按列查询 |
+| `idx_task_project_status` | `(projectId, status)` | — | 列表/统计 |
+| `idx_task_parent` | `(parentId)` | — | 取子任务 |
+| `idx_task_done_at` | `(projectId, doneAt)` | — | 保留窗口计算 |
+| `idx_task_project_archived` | `(projectId, archived, archivedAt)` | — | 已归档查询（T-ARC-04） |
+| `idx_task_project_status_arch` | `(projectId, status, archived)` | — | 主列表/看板排除归档（T-ARC-03） |
+
+> \* `creatorId` 用 Cascade 会丢失"他人创建的任务"的历史；更稳妥的做法是 `Restrict` 并禁止删除有任务的用户。**建议改为 `Restrict`**，与既有 `User` 删除行为保持一致（本期系统无删除用户入口）。
+
+**校验规则**
+
+| 规则 | 位置 |
+| --- | --- |
+| `title` trim 后非空且 ≤ 200 | 应用层 |
+| `parentId` 非空时，其父任务 `parentId` 必须为空（禁止二级，T-ST-01） | 应用层 |
+| 子任务 `projectId` == 父任务 `projectId`（T-EX-12） | 应用层 + 事务内校验 |
+| `parentId` 不得指向自身或其后代（T-EX-15） | 应用层 |
+| `status='done'` 时写 `doneAt=now()`；退出 `done` 时置 `NULL` | 应用层（领域统一裁决） |
+| 归档/恢复父任务连带全部后代，同事务内更新 `archived`/`archivedAt`/`archiveSource`（T-ARC-01/05） | 应用层 |
+| `autoArchive` 枚举 `3d`/`1w`/`1m`/`never`，非法 400（T-ARC-02） | 应用层 |
+| `assigneeId` 必须是 `ProjectMember` 中的用户（T-AS-03） | 应用层 |
+
+### 3.5 `TaskMember` — 任务成员
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | — |
+| `taskId` | `INT` | 否 | — | FK → `Task.id` `ON DELETE CASCADE` |
+| `userId` | `INT` | 否 | — | FK → `User.id` `ON DELETE CASCADE` |
+
+索引：`uk_task_member (taskId, userId)` 唯一。
+
+### 3.6 `TaskTag` — 任务标签
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | `INT` PK AI | 否 | — | — |
+| `taskId` | `INT` | 否 | — | FK → `Task.id` `ON DELETE CASCADE` |
+| `name` | `VARCHAR(20)` | 否 | — | 标签名 |
+
+索引：`idx_tag_task (taskId)`。
+
+---
+
+## 4. Prisma Schema（草案）
+
+```prisma
+model Project {
+  id         Int      @id @default(autoincrement())
+  name       String   @db.VarChar(50)
+  ownerId    Int
+  isPersonal Boolean  @default(false)
+  archived   Boolean  @default(false)
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  owner    User            @relation("ProjectOwner", fields: [ownerId], references: [id])
+  members  ProjectMember[]
+  columns  BoardColumn[]
+  tasks    Task[]
+
+  @@index([ownerId])
+  @@index([archived])
+  @@map("Project")
+}
+
+model ProjectMember {
+  id         Int      @id @default(autoincrement())
+  projectId  Int
+  userId     Int
+  permission String   @default("member") @db.VarChar(16)
+  createdAt  DateTime @default(now())
+
+  project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  user    User    @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([projectId, userId])
+  @@index([userId])
+  @@map("ProjectMember")
+}
+
+model BoardColumn {
+  id          Int      @id @default(autoincrement())
+  projectId   Int
+  name        String   @db.VarChar(20)
+  sortOrder   Int      @default(0)
+  boundStatus String?  @db.VarChar(8)   // null | todo | doing | done
+  retention   String   @default("forever") @db.VarChar(8)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  tasks   Task[]
+
+  @@unique([projectId, name])
+  @@index([projectId, sortOrder])
+  @@map("BoardColumn")
+}
+
+model Task {
+  id          Int       @id @default(autoincrement())
+  projectId   Int
+  columnId    Int
+  parentId    Int?
+  title       String    @db.VarChar(200)
+  description String    @default("") @db.Text
+  status      String    @default("todo") @db.VarChar(8)
+  doneAt      DateTime?
+  assigneeId  Int?
+  creatorId   Int
+  extras      Json      @default("[]")
+  sortOrder   Int       @default(0)
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  project  Project     @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  column   BoardColumn @relation(fields: [columnId], references: [id], onDelete: Restrict)
+  parent   Task?       @relation("Subtask", fields: [parentId], references: [id], onDelete: Cascade)
+  children Task[]      @relation("Subtask")
+  assignee User?       @relation("TaskAssignee", fields: [assigneeId], references: [id], onDelete: SetNull)
+  creator  User        @relation("TaskCreator", fields: [creatorId], references: [id], onDelete: Restrict)
+
+  members TaskMember[]
+  tags    TaskTag[]
+
+  @@index([projectId, columnId])
+  @@index([projectId, status])
+  @@index([parentId])
+  @@index([projectId, doneAt])
+  @@map("Task")
+}
+
+model TaskMember {
+  id     Int @id @default(autoincrement())
+  taskId Int
+  userId Int
+
+  task Task @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([taskId, userId])
+  @@map("TaskMember")
+}
+
+model TaskTag {
+  id     Int    @id @default(autoincrement())
+  taskId Int
+  name   String @db.VarChar(20)
+
+  task Task @relation(fields: [taskId], references: [id], onDelete: Cascade)
+
+  @@index([taskId])
+  @@map("TaskTag")
+}
+```
+
+`User` 需补反向关系（不改字段）：
+
+```prisma
+model User {
+  // …既有字段…
+  ownedProjects   Project[]      @relation("ProjectOwner")
+  projectMembers  ProjectMember[]
+  assignedTasks   Task[]         @relation("TaskAssignee")
+  createdTasks    Task[]         @relation("TaskCreator")
+  taskMembers     TaskMember[]
+}
+```
+
+---
+
+## 5. 关键查询
+
+| 场景 | 查询 |
+| --- | --- |
+| 我的项目 | `SELECT p.* FROM Project p JOIN ProjectMember m ON m.projectId=p.id WHERE m.userId=? AND NOT p.archived` |
+| 项目详情 + 列 | `SELECT * FROM BoardColumn WHERE projectId=? ORDER BY sortOrder` |
+| 看板任务（含子任务） | 顶层：`WHERE projectId=? AND parentId IS NULL`；子任务：`WHERE parentId IN (...)` 一次取回后在内存分组（避免 N+1） |
+| 权限校验 | `SELECT 1 FROM ProjectMember WHERE projectId=? AND userId=?` |
+| 保留窗口过滤 | 服务端可选：`status <> 'done' OR (doneAt >= ?)`；前端另有一份同口径实现 |
+| 自动归位选列 | 内存中对已加载的 `columns`（按 sortOrder）`find(c => c.boundStatus === status)` |
+| 已归档查询（T-ARC-04） | `WHERE projectId=? AND archived=1 [AND kind=?] [AND columnId=?] [AND archivedAt BETWEEN ? AND ?] [AND title LIKE ?] ORDER BY archivedAt DESC, id DESC LIMIT ?+1`；多取 1 条判定 `nextCursor` |
+
+**防 N+1**：一次请求返回 `{ project, columns, members, tasks }`，子任务与父任务同批返回，由前端按 `parentId` 分组。
+
+---
+
+## 6. 迁移与初始化
+
+### 6.1 迁移文件
+
+`prisma/migrations/20261024xxxxxx_add_task_module/migration.sql`：
+
+1. 建 `Project`、`ProjectMember`、`BoardColumn`、`Task`、`TaskMember`、`TaskTag` 六张表；
+2. 建外键（注意 `Task.columnId` 为 `RESTRICT`）；
+3. 建唯一索引与普通索引；
+4. **不做数据回填**（本模块为新功能，无历史数据）。
+
+后续增量迁移：
+
+| 迁移 | 内容 | 状态 |
+| --- | --- | --- |
+| `20261022120000_add_checkin_checklist` | 打卡/清单模块 | 已上线 |
+| `20261025030000_task_kind` | `Project.taskKinds` / `Task.kind` | 已上线 |
+| `20261025120000_task_mark_date` | `Task.markDate` | 已上线 |
+| `20261025130000_project_icon` | `Project.icon` | 已上线 |
+| `20261026000000_task_archive` | 任务归档三字段 + 两索引（T-ARC，DDL 见 §3.1/§3.4 与功能设计 §15） | **待实施** |
+
+### 6.2 个人默认项目初始化
+
+```sql
+-- 应用层逻辑（伪 SQL），首次访问 /api/projects 时执行
+INSERT INTO Project (name, ownerId, isPersonal, createdAt, updatedAt)
+SELECT CONCAT(u.name, '的任务'), u.id, 1, NOW(3), NOW(3)
+FROM User u
+WHERE u.id = ? 
+  AND NOT EXISTS (SELECT 1 FROM Project p WHERE p.ownerId = u.id AND p.isPersonal = 1);
+
+-- 随后为该项目的 4 个默认列插入 BoardColumn（同事务）
+```
+
+### 6.3 新建普通项目
+
+同事务内：建 `Project`（`isPersonal=0`）→ 写 `ProjectMember(owner)` → 写 4 个默认 `BoardColumn`。**任一步失败整体回滚**，避免出现"无列项目"。
+
+---
+
+## 7. 容量与性能估算
+
+| 项 | 估算 | 依据 |
+| --- | --- | --- |
+| 单项目任务 | 千级 / 年 | T-NF-05 |
+| 单项目列 | ≤ 10 | T-COL-06 |
+| `Task` 行宽 | ~400 B + JSON | 含 `extras` |
+| 单项目年增量 | ≈ 400 KB | 1k 任务 × 400B |
+| 索引开销 | 约表大小 30% | 4 个二级索引 |
+
+**无需分表**；按 `projectId` 的查询均可走索引。
+
+---
+
+## 8. 与既有模块的关系
+
+| 项 | 说明 |
+| --- | --- |
+| `User` 表 | 仅补反向关系，**不改结构**，不影响打卡/宏观/监控模块 |
+| 打卡模块（`Habit`/`CheckIn`） | 完全独立，同为"按用户隔离"；任务模块改为"按项目隔离" |
+| 迁移顺序 | 在 `20261022120000_add_checkin_checklist` 之后追加，互不依赖 |
+| 时区 | 沿用 Asia/Shanghai 应用层口径；`doneAt` 用 `DATETIME(3)` 存 UTC |
+
+---
+
+## 9. 未决事项
+
+| # | 事项 | 当前处理 |
+| --- | --- | --- |
+| 1 | 列数上限是否 10 | 按 10 设计（T-COL-06 标注"待确认"），若定其他值只改常量 |
+| 2 | `Task.creatorId` 外键行为 | 草案建议 `Restrict`（见 §3.4 注），需与"用户删除策略"一并确认 |
+| 3 | 孤儿项目（无成员）的维护 | 本期不处理（T-PJ-08），由后台流程清理；数据库层保留数据 |
+| 4 | `extras` 条目数量上限 | 建议 ≤ 20，未在需求中约束，设计预留 |
@@ -0,0 +1,451 @@
+# iBoard V0.2 任务模块 设计文档 — 框架设计
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2（对应分支 `dev-0.2`，应用版本 `0.2.0`） |
+| 文档状态 | **设计基线**（待评审；不含实现代码） |
+| 上游文档 | `任务模块需求文档.md`（需求编号 `T-*` 原文见该文档，本文按编号逐条对应） |
+| 配套文档 | `任务模块功能设计.md`（功能设计，需求点一一对应）、`任务模块数据库设计文档.md`、`任务模块界面设计.html` |
+| 技术栈 | Tauri 2 + React 18 + antd-mobile + React Router v6 + Express 4 + Prisma / MariaDB |
+| 设计基线 | 移动端优先，视口 420×820，375~430px 自适应；时区统一 `Asia/Shanghai` |
+
+> **编号约定**：本文多处出现需求编号（如 `T-BD-14`），其完整描述与验收要点以《任务模块需求文档》为准。每个模块的「需求点 → 设计落点」对照见《任务模块功能设计》。
+
+---
+
+## 1. 总体设计
+
+### 1.1 目标与范围
+
+在既有 iBoard 之上新增**任务模块**，并把它作为**顶级 Tab 插入「打卡」之后**（顺序：打卡 → **任务** → 宏观 → 监控 → 我，默认首页仍为打卡，T-PM-06）。
+
+模块解决的问题与核心隐喻：
+
+| 视图 / 概念 | 解决的问题 | 核心隐喻 |
+| --- | --- | --- |
+| **列表视图** | 快速记录、逐条推进 | Todoist 式条目 + 一级子任务缩进 |
+| **看板视图** | 多人分工下的阶段流转 | 列（阶段）× 卡片（任务），长按拖拽换列 |
+| **项目** | 数据与权限的隔离单位 | 项目即"工作区"，成员可见即可读写 |
+| **列-状态绑定** | 让"拖动列"与"改状态"两个动作不必重复做 | 列是**空间**，状态是**属性**，绑定是二者之间的**可选桥** |
+| **列保留选项** | 已完成任务不淹没在列表里 | 每列自己的"保质期" |
+
+**设计的关键取舍**：把「看板列」与「任务状态」设计成**两个独立维度**，再用**项目级、逐列的绑定配置**把它们关联起来。这样既支持"拖动即改状态"的一体化体验，也支持"这一列只是分类、不进状态机"的轻量用法——这正是需求中 `Action` 默认不绑定状态的意图。
+
+### 1.2 架构总览
+
+```
+┌──────────────────── 前端 (React + antd-mobile，打包进 Tauri / OTA) ────────────────────┐
+│  App.jsx 路由                                                                          │
+│    └ /task            ──► TaskPage (首屏: 上=RecentProjects 条, 下=当前项目 ProjectView)  │
+│         /task/list    ──► ProjectList  (完整项目列表, 从「更多项目」进入)                  │
+│         /task/:pid    ──► TaskPage     (打开指定项目, 供深链)                              │
+│         ProjectView ──┬── ListView   (列表 + 子任务缩进折叠)                              │
+│                       ├── BoardView  (看板 + 长按拖拽)                                     │
+│                       └── ProjectManage (项目管理: 成员 / 列设置 / 项目信息)                │
+│  组件: TaskCard / SubtaskRow / StatusDot / ExtrasCard / UserPicker / RecentProjects      │
+│  状态: TaskStore (项目内单例) / ReorderableList / useLongPressDrag                        │
+│  工具: src/pages/task/date.js (与后端同口径的自然日边界)                                   │
+│        src/pages/task/prefs.js (设备端: 视图记忆 / 上次项目 / 最近项目手动排序)              │
+└──────────────────────────────┬─────────────────────────────────────────────────────────┘
+                               │ HTTPS + JWT (Authorization: Bearer)
+┌──────────────────────────────▼─────────────────────────────────────────────────────────┐
+│ Express                                                                                │
+│   /api/projects/*  ─► routes/projects.js ─┐                                            │
+│   /api/tasks/*     ─► routes/tasks.js     ─┤─► middleware.authRequired                   │
+│   /api/columns/*   ─► routes/columns.js   ─┤─► requireProjectMember (项目成员校验)       │
+│                                           └─► task-domain/  ← 【领域逻辑唯一来源】       │
+│                                                 resolveStatus()  列/状态联动裁决         │
+│                                                 resolveColumn()  自动归位                 │
+│                                                 retentionWindow() 保留窗口                │
+│                                                 copyTask()       跨项目拷贝               │
+└──────────────────────────────┬─────────────────────────────────────────────────────────┘
+                               ▼
+        MariaDB: Project / ProjectMember / BoardColumn / Task / TaskMember / TaskTag
+```
+
+### 1.3 分层与职责
+
+| 层 | 位置 | 职责 |
+| --- | --- | --- |
+| 页面 | `src/pages/task/*.jsx` | 视图编排、本地状态、乐观更新与回滚 |
+| 组件 | `src/components/task/*.jsx` | 纯展示 + 局部交互（卡片、列、子任务行、状态点、扩展卡片） |
+| 设备端偏好 | `src/pages/task/prefs.js` | `viewMode` / `lastProjectId`（**仅设备端**，T-VW-06、T-VW-07） |
+| 日期工具 | `src/pages/task/date.js` | 自然日边界计算，**与后端 `task-domain/date.js` 同口径，改一处必须同步另一处** |
+| API 封装 | `src/api/task.js` | 统一走既有 `api()`（自带 token / 错误解析） |
+| 路由 | `server/routes/tasks.js`、`projects.js`、`columns.js` | 参数校验、鉴权、组装展示态 |
+| 领域逻辑 | `server/task-domain/*.js` | **列-状态裁决、自动归位、保留窗口、拷贝**（唯一口径） |
+| 持久化 | Prisma Client | 表操作 |
+
+> **与打卡模块的区别**：打卡的周期口径只有 `period.js` 一个文件；任务模块的领域规则（三条）彼此有依赖（归位依赖列序、保留依赖完成时间与列配置），统一收敛到 `task-domain/` 目录，**前后端不得各自实现一遍裁决逻辑**——前端只做乐观更新，最终以服务端返回为准。
+
+### 1.4 目录结构（本次新增/修改）
+
+```
+prisma/
+  schema.prisma                                        # +6 个 model，User 加反向关系
+  migrations/20261024xxxxxx_add_task_module/           # 新建表 + 外键 + 索引
+server/
+  task-domain/
+    date.js                                            # 自然日边界（今天/本周/本月）
+    resolveStatus.js                                   # 列→状态、状态→列、自动归位
+    retention.js                                       # 列保留窗口 → 可见性
+    copyTask.js                                        # 跨项目深拷贝
+  routes/
+    projects.js                                        # /api/projects/*
+    columns.js                                         # /api/columns/*
+    tasks.js                                           # /api/tasks/*
+  index.js                                             # 挂载三个路由
+src/
+  api/task.js                                          # projectApi / columnApi / taskApi
+  pages/task/
+    date.js                                            # 与后端同口径
+    prefs.js                                           # 设备端偏好（视图记忆/上次项目/最近项目手动排序）
+    TaskPage.jsx                                       # 首屏容器: RecentProjects 条 + 当前项目 ProjectView
+    ProjectList.jsx                                    # 完整项目列表（/task/list, 从「更多项目」进入）
+    ProjectView.jsx                                    # 列表/看板容器
+    ListView.jsx                                       # 列表视图
+    BoardView.jsx                                      # 看板视图
+    ColumnSettings.jsx                                 # 列管理 + 绑定 + 保留选项（由项目管理进入）
+    TaskDetail.jsx                                     # 任务详情（含扩展卡片 / 子任务；底部安全距离）
+    ProjectMembers.jsx                                 # 成员管理（由项目管理进入）
+    ProjectManage.jsx                                  # 项目管理: 成员 / 列设置 / 项目信息 三区
+  components/task/
+    TaskCard.jsx  SubtaskRow.jsx  StatusDot.jsx
+    ExtrasCard.jsx  UserPicker.jsx  useLongPressDrag.js
+    RecentProjects.jsx                                 # 首屏最近项目条（卡片可长按排序）
+  components/BottomNav.jsx                             # Tab 增「任务」，位于打卡之后
+  components/TabIcon.jsx                               # 增 task 图标
+  App.jsx                                              # +/task、/task/:pid
+  styles/globals.css                                   # .task-* 样式段
+docs/V0.2/任务模块/                                      # 需求 / 框架 / 功能 / 数据库 / 界面
+```
+
+### 1.5 数据流总览
+
+```
+用户操作 ──► 前端乐观更新（本地 store 立即变）
+              │
+              ▼
+        PUT /api/tasks/:id { columnId?, status?, done? }
+              │
+              ▼
+        requireProjectMember（非成员 403）
+              │
+              ▼
+        resolveStatus()  ── 读项目 columnBindings（列序 + 绑定）
+              │            ① 目标列绑定状态 ⇒ status = boundStatus
+              │            ② 目标列不绑定   ⇒ 保留原 status
+              │            ③ 状态变了且当前列不绑定该状态 ⇒ 自动归位（列序首个匹配）
+              │            ④ 无匹配列        ⇒ 列不动
+              ▼
+        写库（status + columnId 同时落库）
+              │
+              ▼
+        返回最新任务 ──► 前端以响应覆盖本地乐观值（不一致则纠正）
+```
+
+---
+
+## 2. 领域规则设计（重点）
+
+> 本模块所有"难"的地方都集中在**列与状态的双向联动**上。下面把规则收敛为一组**无歧义的判定函数**，前后端都以此为准。
+
+### 2.1 两个正交维度的定义
+
+| 维度 | 字段 | 取值 | 谁决定 |
+| --- | --- | --- | --- |
+| **空间** | `Task.columnId` | 指向项目内某个 `BoardColumn` | 用户拖拽 / 自动归位 |
+| **属性** | `Task.status` | `todo`（未开始）/ `doing`（执行中）/ `done`（完成） | 用户勾选 / 列绑定联动 |
+
+**二者独立落库**，不做互相推导（见《数据库设计文档》§2）。原因：
+
+1. 未绑定的列（如默认 `Action`）要求二者**完全正交**，任何推导都会丢失信息；
+2. 同一状态可被多列绑定（T-BD-03），状态无法反推唯一列；
+3. 保留选项依赖"完成时间"而非列，推导会引入隐式状态。
+
+### 2.2 三种联动场景与判定函数
+
+设项目列列表为 `C = [c₁, c₂, …, cₙ]`（按 `sortOrder` 升序），每列 `c.boundStatus ∈ {todo, doing, done, null}`。
+
+**场景 A · 拖拽换列（`T-BD-04/07/08`）**
+
+```
+function onColumnChange(task, targetColumnId):
+    c = columnById(targetColumnId)
+    if c.boundStatus != null:
+        task.status = c.boundStatus        # 列决定状态
+    else:
+        # 目标列不绑定 ⇒ 保留原状态（T-BD-07、T-EX-05）
+        pass
+    task.columnId = targetColumnId
+```
+
+> **注意**：这里**不存在「从某列拖出即回退状态」的规则**。是否改状态只看**目标列**。这是评审中明确修正过的口径（原设计曾写"拖出回退为未开始"，已废弃）。
+
+**场景 B · 改状态（勾选/选择器，`T-BD-14/15/16`）**
+
+```
+function onStatusChange(task, newStatus):
+    task.status = newStatus
+    # 当前列是否已经"匹配"这个状态？
+    if task.column.boundStatus == newStatus:
+        return                            # 已匹配，列不动
+    # 不匹配 ⇒ 自动归位，按列序取第一个绑定 newStatus 的列（T-BD-15）
+    target = first(c in C where c.boundStatus == newStatus)
+    if target != null:
+        task.columnId = target.id
+    else:
+        # 无匹配列 ⇒ 不移动，保留原列（T-BD-16）
+        pass
+```
+
+**场景 C · 子任务（`T-BD-13`）**
+
+```
+if task.parentId != null:
+    # 子任务完全跳过上述两种联动
+    persist(status, columnId) as-is
+```
+
+### 2.3 判定矩阵（可转写为单测）
+
+以默认配置 `plan→todo, doing→doing, action→null, done→done` 为例：
+
+| # | 初始（列 / 状态） | 操作 | 结果（列 / 状态） | 覆盖需求 |
+| --- | --- | --- | --- | --- |
+| 1 | plan / todo | 拖到 doing | doing / doing | T-BD-04 |
+| 2 | plan / todo | 拖到 action（不绑定） | action / **todo**（保留） | T-BD-07、T-BD-08 |
+| 3 | action / todo | 改为 done | **done** / done（自动归位） | T-BD-14、T-BD-15 |
+| 4 | action / todo | 改为 doing | doing / doing | T-BD-14 |
+| 5 | done / done | 拖到 action | action / **done**（保留） | T-BD-07、T-EX-05 |
+| 6 | done / done | 改为 doing | doing / doing | T-BD-14 |
+| 7 | plan / todo | 改为 todo | plan / todo（已匹配，不动） | T-BD-14 |
+| 8 | 全部列不绑定 done，任务在 action | 改为 done | action / done（**无匹配不移动**） | T-BD-16 |
+| 9 | 父任务 done，子任务在 action | 改父任务状态 | 子任务完全不受影响 | T-BD-13 |
+| 10 | 两列都绑定 done（done、action） | 改为 done | 列序靠前者（done） | T-BD-06、T-BD-15 |
+
+> 第 8 行是评审中特别确认的：**没有「已完成统一归到 Done 列」的强制规则**，那只是默认配置下的自然效果。用户取消全部绑定后，任务就停在原列。
+
+### 2.4 列配置变更的语义（`T-BD-11`、`T-COL-08`）
+
+**核心原则：配置变更只影响后续操作，不批量改写历史数据。**
+
+| 变更 | 处理 |
+| --- | --- |
+| 列 A 由「绑定 done」改为「不绑定」 | 已在 A 中且状态为 done 的任务**保持不动**（列与状态都保留），见 T-EX-03 |
+| 列 A 绑定状态由 doing 改为 done | 已在 A 中的任务状态**不回写**；后续拖入 A 的任务才按 done 处理（T-BD-11） |
+| 删除列 A | 二次确认 → 列内任务迁移到指定列（默认相邻列）→ 迁移后**按目标列重新裁决状态**；A 的绑定解除（T-COL-08、T-EX-16） |
+| 新增列 | 取默认值 `retention=forever`、`boundStatus=null`，**不继承相邻列**（B-18） |
+
+> 为什么删除列要"重新裁决"而改绑定不裁决：删除是**数据搬家**（任务必须有个列），搬家后必须与目标列的语义自洽；而改绑定只是改了"未来的规则"，不该动已有数据。
+
+### 2.5 空归属与一致性保障
+
+| 风险 | 保障 |
+| --- | --- |
+| 删除列后任务 `columnId` 悬空 | 迁移在同事务内完成；`Task.columnId` 为 `NOT NULL`，外键 `ON DELETE RESTRICT` 从库层面阻止误删 |
+| 列被删后 `boundStatus` 残留 | `BoardColumn` 是实体，列删则绑定自然消失，无残留（优于早期 JSON 方案） |
+| 并发拖拽同一任务 | 服务端以「读-判定-写」在同一事务内完成；前端防抖 + 版本号（可选） |
+| 状态改了但归位列不存在 | 判定函数显式处理「无匹配列」分支（T-BD-16），不抛异常 |
+
+---
+
+## 3. 重点流程设计
+
+### 3.1 看板拖拽（长按 → 跨列 → 落到子任务）
+
+这是本模块交互最复杂的一条链路，同时涉及**换列**与**降级为子任务**两种语义。
+
+```
+长按 300ms ─► 卡片抬起（缩小 + 浮层跟随手指）
+                │
+                ├─ 拖到【另一列空白区】
+                │     └─ 松手 → onColumnChange(任务, 目标列)
+                │              → 按 §2.2 场景 A 裁决
+                │              → 乐观更新本地列与状态 → PATCH（失败回滚 + Toast）
+                │
+                ├─ 拖到【另一列某卡片上】
+                │     └─ 该卡片高亮为"落点"
+                │        松手 → 若落点是顶层任务且被拖任务无子任务 ⇒ 降为子任务
+                │               ├─ 是子任务 ⇒ 拒绝（T-ST-13）
+                │               ├─ 被拖任务有子任务 ⇒ 拒绝（T-ST-14）
+                │               └─ 拖到自己/后代 ⇒ 拒绝（T-EX-15）
+                │
+                └─ 拖到【原列】→ 视为排序（本期仅更新 sortOrder）
+```
+
+**难点与对策**：
+
+| 难点 | 对策 |
+| --- | --- |
+| 移动端长按与滚动冲突 | 长按 300ms 后才进入拖拽态；进入后 `touch-action:none` 并锁定滚动容器 |
+| 看板横向滚动 vs 拖拽换列 | 拖拽时容器允许横向自动滚动（边缘 24px 触发），松手位置决定列 |
+| 落点判定（列 vs 卡片） | 用 `elementFromPoint` 命中 `[data-column-id]` / `[data-task-id]`，卡片优先 |
+| 误操作 | 拒绝场景统一 Toast 说明原因；松手动画回弹原位 |
+| 降为子任务后卡片消失 | 子任务不出独立卡片（T-ST-10），故从其原列移除，父任务卡片内出现该子任务行（T-ST-06） |
+
+> 兜底：无法拖拽时（如长按被系统手势占用），卡片「⋯」菜单提供「移动到列 / 移动到子任务」的等价操作（T-UI-07）。
+
+### 3.2 保留选项的可见性计算与"当场消失"
+
+**窗口计算**（后端 `task-domain/retention.js`，自然日口径）：
+
+```
+function retentionStart(option, now):
+    today = startOfDay(now)                 # Asia/Shanghai 00:00
+    switch option:
+        never     => 返回"不可见"
+        forever   => 返回"无下界"（全可见）
+        today     => today
+        3d        => today - 2 天           # 含今天共 3 天
+        week      => 本周一 00:00
+        month     => 本月 1 日 00:00
+
+可见性判定：task.status == done
+            ? (doneAt != null && doneAt >= retentionStart(该任务所属列的 option))
+            : true                           # 未完成任务始终可见（T-FL-12）
+```
+
+**判定依据**：`Task.doneAt`（完成时刻），**与任务当前所在列无关**（T-FL-10）；归属哪一列决定用哪一列的选项（T-FL-11）。
+
+**前端"当场消失"**（T-EX-18）：
+
+```
+每分钟（以及跨日/跨周/跨月边界整点）执行一次：
+  重新计算当前可见集合
+  对"由可见变不可见"的任务卡片：
+      加 .is-leaving（透明 + 高度收缩，约 240ms）
+      动画结束移除 DOM
+      其余卡片通过布局动画平滑重排（不做全局刷新）
+```
+
+> 也允许退化为"刷新时计算"——需求明确接受该实现方式（§5 决策 23）。跨周期边界用**定时器 + 页面可见性变化（`visibilitychange`）**双保险。
+
+### 3.3 跨项目拷贝
+
+拷贝是**深拷贝**，且要处理目标项目成员差异（T-CP-07）与绑定差异（T-CP-09）。
+
+```
+POST /api/tasks/:id/copy { projectId: 目标项目 }
+  │
+  ├─ 校验：源任务可读、目标是本人成员（T-CP-06）
+  ├─ 事务内：
+  │    newTask = create({
+  │        ...全部业务字段（标题/描述/状态/列/扩展卡片/标签）
+  │        creatorId = 当前操作者        ← T-CP-04
+  │        projectId = 目标项目
+  │        columnId  = 目标项目中"列名相同"的列，找不到则取第一列
+  │    })
+  │    assigneeId = 目标项目成员？保留 : 置 null        ← T-CP-07
+  │    taskMembers = 过滤出目标项目成员中的交集        ← T-CP-07
+  │    for 每个子任务：同法 create（parentId = newTask.id）  ← T-CP-03、T-CP-08
+  │    状态与列不强行纠正（T-EX-14）
+  └─ 返回 { task, dropped: { assignee, members[] } }   ← 提示被丢弃的人员
+```
+
+**新旧任务完全独立**（T-CP-05）：拷贝后无任何关联字段，是两条独立记录。
+
+### 3.4 个人默认项目的创建与保护
+
+```
+创建时机：用户首次访问 /api/projects（或注册时）→ 不存在 isPersonal 项目则创建
+          name = `${user.name}的任务`（T-PJ-04，可改名）
+
+保护规则（服务端强制，前端不提供入口）：
+  DELETE /api/projects/:id        → isPersonal ⇒ 400（T-PJ-02、T-EX-09）
+  POST   /api/projects/:id/members → isPersonal ⇒ 400（T-PJ-03、T-EX-09）
+  PUT    /api/projects/:id         → 允许改名（T-PJ-04）
+```
+
+### 3.5 成员清空后的项目
+
+删除最后一名成员时**不删除项目**，只删 `ProjectMember` 记录（B-11、T-PJ-08）：
+
+- 项目成为"无成员项目"，任何人都不可见（T-PJ-10）；
+- 前端不做特判、不报错（T-EX-11）；
+- 数据保留，由后台维护流程后续处理（不在本模块范围，§1.5）。
+
+> 副作用：曾为该项目任务的负责人 / 成员会显示为「已退出」（T-EX-06），因为其 `userId` 已不是项目成员。
+
+---
+
+## 4. 状态管理与性能
+
+### 4.1 前端状态
+
+| 状态 | 存放 | 生命周期 |
+| --- | --- | --- |
+| 当前项目、任务列表、列配置 | `TaskStore`（项目内单例） | 进入项目时加载，切换项目时替换 |
+| 视图（list/board） | **设备端** `localStorage.iboard_task_prefs` | 按 `projectId` 分键（T-VW-03/06） |
+| 上次访问项目 | **设备端** 同上 | 单个 key（T-VW-07） |
+| 折叠状态（子任务） | 内存（组件内） | 会话内，不持久化 |
+| 弹窗 / 拖拽态 | 组件内 | 操作结束即清 |
+
+### 4.2 性能设计
+
+| 场景 | 目标 | 手段 |
+| --- | --- | --- |
+| 首屏加载（T-NF-01） | < 1.5s | 任务与列配置**一次请求返回**；子任务随父任务同批返回 |
+| 交互响应（T-NF-01） | < 300ms | 乐观更新，不等接口返回 |
+| 千级任务（T-NF-05） | 可用 | 索引覆盖（`projectId+columnId`、`projectId+status`）；列表虚拟化（按需） |
+| 保留计算 | 不额外请求 | 前端本地按 `doneAt` + 列选项实时过滤，切换档位零请求 |
+| 看板拖拽 | 60fps | 拖拽期只用 transform，不改布局；落下后才重排 |
+
+### 4.3 一致性与容错
+
+- **乐观更新 + 回滚**：失败时恢复快照并 Toast（T-EX-02）。
+- **幂等**：拖拽/勾选 500ms 内重复提交合并（T-EX-01）。
+- **配置变更即时生效**：保存列配置后服务端返回最新列列表，前端整体替换并重算可见集合，无需刷新（T-BD-12）。
+
+---
+
+## 5. 风险与权衡
+
+| # | 风险 / 权衡 | 说明与对策 |
+| --- | --- | --- |
+| 1 | **列与状态双维度带来的认知成本** | 默认配置下二者一一对应（除 Action），用户"不懂也不会错"；只有主动改配置时才需要理解绑定 |
+| 2 | **自动归位可能让用户"找不到"任务** | 任务从当前列跳走。对策：归位后该卡片带一次高亮动画；提供 Toast「已移至 <列名>」 |
+| 3 | **保留选项与"未绑定完成的已完任务"** | 状态为 done 但所有列都不绑定 done 时，任务停在不绑定列，其可见性按该列选项判定（T-FL-11）——语义自洽但需要文案说明 |
+| 4 | **列可增删导致看板横向过宽** | 上限暂定 10 列（T-COL-06，**待确认**）；超出时看板横向滚动 + 列头悬浮 |
+| 5 | **子任务状态与父任务不一致的展示** | 卡片内嵌子任务带**小状态标记**（T-ST-09），避免"父已完成但子未做"的信息丢失 |
+| 6 | **跨项目拷贝丢弃人员** | 返回被丢弃的名单并在前端提示，避免静默丢数据（T-EX-08） |
+| 7 | **无成员项目的数据残留** | 本期不处理（T-PJ-08），需后台维护；在数据库设计文档中标注为"孤儿项目" |
+| 8 | **前后端日期口径不一致** | `date.js` 双份实现是既有项目的做法；本期继续沿用并在两处加注释互指，写单测覆盖边界（周日 23:59 / 周一 00:00 / 月末） |
+
+---
+
+## 6. 测试与验证要点
+
+| 类别 | 要点 |
+| --- | --- |
+| **领域规则单测** | §2.3 判定矩阵 10 条全覆盖；`retentionStart()` 六档边界（含周日/月末跨点） |
+| **接口测试** | 非项目成员访问 403；个人默认项目的两个保护接口返回 400；拷贝后源任务不变 |
+| **交互验证** | 拖拽换列 / 降为子任务 / 拒绝场景 Toast；保留档位切换任务当场消失并重排 |
+| **兼容性** | Android WebView + 移动浏览器（T-NF-02）；375 / 390 / 430 三档视口 |
+| **两视图一致** | 列表与看板可见条数一致（T-FL-11、T-FL-14）；任一处修改另一处即时可见（T-UI-03） |
+
+---
+
+## 7. 重点设计（2026-10-24 二轮评审）
+
+### 7.1 任务拖动方案（重做）
+
+旧版（手指跟随浮层 + 落点命中即转子任务）在真机上不可靠：浮层遮挡视线、touch 事件与滚动冲突、拖到卡片上误触转子任务。重做后的方案收敛为「**一个可靠手势 + 一个可靠菜单**」：
+
+| 场景 | 交互 | 实现 |
+| --- | --- | --- |
+| 看板换列 | 长按 400ms 激活（激活前移动 >10px 视为滚动，自动取消）→ 卡片**原位抬起**（不跟随手指、无浮层、无任务名）→ 指针划过列高亮 → 松手落列 | `useColumnDrag`：Pointer Events + `setPointerCapture`（触摸/鼠标统一、捕获后不丢事件、天然吞掉 pointercancel）；`elementFromPoint` 命中 `[data-column-id]`；指针靠近容器边缘时 rAF 自动横滚，可拖到屏幕外的列 |
+| 列表移动 | 长按 500ms → 弹「移动到列」ActionSheet（当前列打勾） | `TaskRow` 长按计时 → `ProjectView.openMoveMenu`；列表是纵向滚动流，不做自由拖动 |
+| 转为子任务 | 不走拖拽（已移除「拖到卡片上」路径，误触率高） | 详情页「层级」区：选父任务转为子任务 / 一键转为顶层 |
+
+关键细节：卡片 `touch-action: pan-y`（纵向滚动留给浏览器，水平位移给拖动）；激活与提交都以同一元素的 pointer 事件为准；`pointercancel` 与 `pointerup` 同样清理状态。换列后的状态仍由服务端按目标列绑定统一裁决（§2.2 不变）。
+
+### 7.2 键盘遮挡统一方案
+
+多个底部弹层（任务详情、信息块编辑、人员选择、拷贝）都出现过"输入框被输入法遮挡"。逐个组件接键盘逻辑不可维护，统一为**一个全局信号 + 一个 CSS 类**：
+
+1. **信号源**：`App` 级唯一监听器 `useKeyboardInsetWatcher`，同时监听 `visualViewport` 的 resize/scroll 与 `window.resize`（配合 `index.html` 的 `interactive-widget=resizes-content`，Chromium 系 WebView 键盘弹出会整体收缩布局视口）；以"见过的最大视口高"为基线计算键盘插入量，写入 CSS 变量 **`--kb-inset`**（>90px 才视为键盘，过滤地址栏抖动）。
+2. **消费端**：底部弹层统一挂 **`.kb-safe`** 类 —— `padding-bottom: calc(安全区 + 20px + var(--kb-inset))`、`max-height` 用 `dvh` 随视口收缩并内部滚动。组件不再各自 import 键盘 hook、不再写内联 padding。
+3. **兜底**：长输入区（子任务输入、信息块 textarea）聚焦 300ms 后 `scrollIntoView({block:'center'})`，双保险。
+
+新增弹层只要挂 `.kb-safe` 即自动获得键盘避让，无需再处理。
@@ -0,0 +1,605 @@
+# iBoard V0.2 任务模块 需求文档 — 轻量任务 / 项目管理
+
+> 版本：V0.2 · 模块：任务（Task） · 日期：2026-10-24
+> 适用范围：iBoard APP 内的任务模块（沿用现有项目框架、路由体系与登录态实现）
+> 关联文档：《设计文档》《数据库设计文档》《界面设计》——接口清单在**设计阶段**重新设计，本文档不含接口定义
+
+---
+
+## 1. 总体需求
+
+### 1.1 一句话描述
+
+在 iBoard 现有 APP 内新增一个**轻量级的项目与任务管理模块**：界面交互参考 Todoist，以**项目**为隔离单位组织任务，提供**列表 / 看板**双视图，并允许**每个项目独立配置看板列与任务状态的对应关系、以及每列已完成任务的保留选项**，用最小认知成本覆盖「个人琐事记录」与「多人协作推进」两类场景。
+
+**「轻量」的含义**：不做需求管理、工时、甘特图、工作流引擎、审批流；字段克制、结构最多两层（任务 + 一级子任务）、权限不做细分角色。目标是用最少的配置让用户"打开就能记、记完就能推进"。
+
+### 1.2 核心概念
+
+| 概念 | 定义 |
+| --- | --- |
+| **项目（Project）** | 任务归属的隔离单位，**也是权限单位**。用户只能看到自己是成员的项目；项目内成员权限目前均等 |
+| **个人默认项目（Personal Project）** | 每个用户自动拥有且仅有一个的私有项目。**不可删除、不可添加其他成员**，名称以用户名开头且可自定义，用于个人琐碎事务 |
+| **普通协作项目（Shared Project）** | 用户新建的项目，可增删成员、可归档 |
+| **项目成员（Member）** | 用户与项目的多对多关联。成员的**存在**决定权限，「负责人 / 任务成员」字段只决定**展示** |
+| **任务（Task）** | 一条事务记录。归属唯一项目；含基础字段 + 内置可折叠的**扩展信息卡片**；特例：子任务 |
+| **一级子任务（Subtask）** | 挂在父任务下的任务。**最多一层**，不可再嵌套；必须与父任务同项目；完成状态与父任务**相互独立** |
+| **负责人（Assignee）** | 任务上的**单人**标记，字号更大、视觉突出。**新建任务时默认填入创建者本人**，可清空 |
+| **任务成员（Task Members）** | 任务上的**多人**标记，字号更小、弱化展示，位于卡片 / 条目下方 |
+| **扩展信息卡片** | 任务内置的可折叠信息区，承载**任意名称 / 值 / 链接**的扩展信息（来源不限、字段不固定），**默认收起、全部非必填** |
+| **看板列（Column）** | 项目级可配置的列，**默认 4 列** `Plan → Doing → Action → Done`；**可增删改、可调整顺序**，数量不固定 |
+| **任务状态（Status）** | 任务的处理阶段，取值为 `未开始` / `执行中` / `完成`。**与看板列是两个独立概念**，二者的对应关系由项目配置决定 |
+| **列-状态绑定（Column Status Binding）** | 项目级配置：**每一列独立**选择"是否绑定任务状态"以及"绑定到哪个状态"。绑定后列与状态双向联动；不绑定时二者完全独立 |
+| **已完成但未绑定状态** | 任务状态为「完成」、但其所在看板列未绑定到「完成」的情形——此时列保持不变 |
+| **看板列保留选项（Column Retention）** | 项目级配置：**每一列独立**设置已完成任务的保留时长，取值为「永不显示」/「当天」/「3 天」/「本周」/「本月」/「永久显示」六档，用于控制该列中已完成任务的可见性 |
+| **视图记忆** | 设备端按项目独立保存"上次选择的视图（列表 / 看板）"，进入项目自动恢复 |
+| **上下文** | 用户当前所处的视图位置（某个项目 / 某个父任务的子任务列表 / 某个列表分区），用于解释"本次修改"相对哪些任务生效 |
+
+### 1.3 完整功能
+
+1. **视图体系**：列表视图、看板视图，可随时互相切换，同源数据、实时双向同步；每个项目独立记忆上次使用的视图。列表只是不按列分组，**任务归属的看板列与看板视图完全一致**。**首屏**上部为「最近项目」（3 个卡片 + 更多入口，卡片可手动排序），下部直接展示**当前项目**的任务管理视图，不必先进项目列表。
+2. **看板与任务状态的绑定配置**：
+   - 看板列**默认 4 列** `Plan → Doing → Action → Done`；列**可增删改、可调整顺序**，数量不固定。
+   - **每一列独立**选择是否绑定任务状态，并可选择绑定到 `未开始 / 执行中 / 完成` 中的任一个；**允许多列绑定同一状态**。
+   - **列决定状态**：任务拖入某列时，该列绑定了状态则状态随之改变；该列未绑定则**保留原状态**。
+   - **状态与列不匹配时自动归位**：状态改变后若当前所在列未绑定该状态，则按**当前列顺序**移入第一个绑定该状态的列；**没有匹配列就不移动**，保留当前位置。
+   - **默认**：`Plan` 绑定「未开始」、`Doing` 绑定「执行中」、`Done` 绑定「完成」、`Action` **不绑定**。
+   - 配置是**项目级**的，项目内任意成员均可修改，不同项目互不影响。
+   - **子任务不受列-状态绑定约束**，其状态可与父任务不一致。
+3. **已完成任务显示控制**：**按看板列独立配置保留选项**——`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示` 六选一；超出保留选项的已完成任务在该列中自动隐藏。列表视图按其所属列的配置执行同样的显示控制。
+4. **任务字段体系**：基础字段（标题必填，负责人默认本人）+ 内置可折叠**扩展信息卡片**（默认收起、全非必填）；负责人（单人）与任务成员（多人）均为信息标记。
+5. **负责人 & 成员展示规则**：负责人大字号突出、成员小字号弱化并置于下方；二者只能从**当前项目成员**中选择；不改变项目统一读写权限。
+6. **子任务体系**：仅一级、必须同项目、父子完成状态互不联动；列表视图支持缩进与折叠展开；**看板卡片内以简洁形式嵌套展示子任务并可直接勾选**，完整详情在卡片弹窗内编辑；支持**长按拖拽把任务降为另一个任务的一级子任务**。
+7. **项目体系**：个人默认项目（不可删、不可加成员、名称以用户名开头且可改名）；普通协作项目（可增删成员）；创建人可主动退出；成员清空后静默保留，交后台维护。成员管理、列设置与项目信息（改名 / 归档 / 删除 / 退出）统一收进「**项目管理**」入口。
+8. **项目权限**：以项目为隔离单位，只能看到自己是成员的项目；项目内成员权限均等、全读写；预留权限分级入口但不实现细分角色；任意成员均可归档项目。
+9. **跨项目拷贝**：是**拷贝**不是移动；完整复制全部字段、扩展信息、子任务、负责人、成员、状态、看板列、标签；新任务创建人为执行拷贝者；拷贝后新旧任务完全独立。
+10. **UI 交互规范**：参考 Todoist 的列表交互与子任务折叠风格；看板卡片轻量化；列表与看板同源、切换无刷新、数据一致；具备空状态 / 加载状态 / 数据异常状态。
+11. **模块入口**：任务模块作为**顶级 Tab** 接入底部导航，位于**「打卡」之后**（顺序：打卡 → 任务 → 宏观 → 监控 → 我）。
+
+### 1.4 典型用法
+
+**场景 A · 个人琐事（个人默认项目）**
+用户打开模块 → 进入自己的个人默认项目（如「张三的琐事」）→ 列表视图输入标题回车新增，**负责人自动是本人**，也可清空 → 需要推进时切到看板，把任务从 `Plan` 拖到 `Doing`。
+因个人项目**不能加成员**，负责人 / 成员的可选范围只有自己，无需任何权限配置。
+
+**场景 B · 多人协作与列-状态绑定**
+用户新建普通项目「APP 改版」并加入 3 名同事。默认配置下：任务在 `Plan`=未开始、`Doing`=执行中、`Done`=完成；`Action` 不绑定状态，任务放进去后状态保持不变。
+成员 A 把任务拖入 `Done` ⇒ **状态自动变为「完成」**；成员 B 在列表视图把某任务状态改为「完成」⇒ 任务**自动出现在 `Done` 列**。
+若任务停留在 `Action`（不绑定）里被改成「完成」，因当前列与状态不匹配，系统**自动归位**到第一个绑定「完成」的列（默认即 `Done`）；若该项目把「完成」的绑定全部取消，则**无匹配列，任务留在 `Action` 不动**。若把 `Action` 也设为绑定「完成」，则按列序仍先进 `Done`——这是**项目级**配置，不影响其他项目。
+
+**场景 C · 扩展信息卡片**
+新增任务「登录接口返回 500」→ 展开默认收起的**扩展信息卡片** → 按需添加任意条目，如「仓库 = gitlab/app」「分支 = fix/login-500」或一条相关链接（全部非必填，不填不影响任务本身）。
+
+**场景 D · 跨项目复用**
+把「APP 改版」里的某任务跨项目拷贝到「APP 二期」→ 生成一条**全新任务**，字段、扩展信息、子任务、负责人、成员、状态、看板列、标签全部复制，创建人记为执行拷贝的用户；此后两任务互不影响。
+
+**场景 E · 按列控制已完成任务显示**
+某项目的 `Done` 列已完成任务过多影响阅读 → 把该列保留选项设为「当天」→ 更早的已完成任务自动隐藏；同时把 `Action` 列设为「永不显示」，该列不再展示已完成任务；`Plan` 列保持「永久显示」不受影响。列表视图同样按各任务所属列的配置隐藏它们，与看板一致。切到另一个项目时，该项目各列配置保持自己的设置（互不干扰）。
+
+**场景 F · 拖拽调整层级**
+列表视图中长按任务卡片，向上拖动到另一个任务上并停留 → 该任务成为目标任务的**一级子任务**（缩进显示）。若目标任务本身已是子任务，或被拖任务已带子任务，则拒绝并给出提示（仅支持一级）。降为子任务后，它原有的看板列与状态保持不变。
+
+**场景 G · 看板卡片内的子任务**
+看板中某任务卡片下方以简洁样式嵌套显示其子任务 → 直接在卡片内勾选子任务完成，**父任务状态不受影响**，子任务状态也不受该列绑定规则约束；每个嵌套子任务带**自身状态小标记**，便于识别与父任务不一致的状态；需要编辑子任务标题或负责人时，点开卡片弹窗操作。
+
+**场景 H · 从底部 Tab 进入（首屏）**
+底部导航顺序为「打卡 → **任务** → 宏观 → 监控 → 我」→ 点击「任务」进入首屏：**上部**是最近使用的 3 个项目卡片 + 「更多项目」入口（点卡片即切换当前项目，长按卡片可调整顺序）；**下部**直接是当前项目（上次访问的，记录在设备端；无记录则回到个人默认项目）的任务管理页，无需先进项目列表。点「更多项目」才进入完整的项目列表页。
+
+**场景 I · 项目管理**
+在项目页头部点「项目管理」→ 弹出统一管理页，内含三个分区：**成员**（查看 / 添加 / 移除）、**列设置**（列管理 / 状态绑定 / 保留选项）、**项目信息**（改名 / 归档 / 删除 / 退出，个人默认项目不出现删除与退出）。
+
+### 1.5 不在本期范围（明确排除）
+
+- 多层子任务（仅一级）。
+- 角色 / 权限分级（只预留入口，本期全部成员权限均等）。
+- 任务评论、@提及、附件上传、提醒通知、日历同步。
+- 列内拖拽排序的精细规则（本期为简单位置值）。
+- 甘特图、工时、报表统计。
+- 项目成员清空后的数据清理（由后台维护，前端不做特殊处理）。
+- 独立的 WebView / 登录态 / 返回键适配（**沿用现有项目框架**，不单独提出要求）。
+
+---
+
+## 2. 术语与概念定义
+
+| 术语 | 定义 |
+| --- | --- |
+| **项目（Project）** | 任务与权限的隔离单位；用户只能看到自己为成员的项目 |
+| **个人默认项目** | 每个用户唯一、自动创建、不可删除、不可添加成员的私有项目；`isPersonal = true` |
+| **普通协作项目** | 可增删成员、可归档的项目；`isPersonal = false` |
+| **项目成员（Member）** | `ProjectMember` 记录，决定**读写权限** |
+| **负责人（Assignee）** | 任务上的单人标记（须为项目成员），决定列表 / 卡片视觉上的突出位置；新建时默认为创建者，可清空 |
+| **任务成员（TaskMember）** | 任务上的多成员标记（须为项目成员），弱化展示，可为空 |
+| **任务状态（status）** | `todo`（未开始）/ `doing`（执行中）/ `done`（完成），三值枚举 |
+| **看板列（column）** | 项目级可配置的列实体，默认 `Plan` / `Doing` / `Action` / `Done` 四列；可增删改、可排序，数量不固定 |
+| **列-状态绑定（columnBindings）** | 项目级配置：每列独立声明「是否绑定」及「绑定到哪个状态」；默认 plan→todo、doing→doing、done→done、action→不绑定 |
+| **已完成但未绑定状态** | 状态为 `done` 但所在列未绑定到 `done`；此时拖拽/勾选只改状态不改列（见 T-EX-04） |
+| **看板列保留选项（columnRetention）** | 项目级配置：每列独立设置已完成任务的保留时长，`never` 永不显示 / `today` 当天 / `3d` 3 天 / `week` 本周 / `month` 本月 / `forever` 永久显示 |
+| **视图记忆（viewMode）** | `list` / `board`，**按项目独立记忆、保存在设备端** |
+| **扩展信息卡片** | 任务的折叠信息区，存任意 `[{label, value, url?}]` 条目，默认收起、全部非必填 |
+| **一级子任务** | `parentId` 非空的任务；其父任务必须为顶层任务，且同项目 |
+| **上下文** | 本次操作所处位置（项目 / 父任务 / 列表分区），用于界定"从该列拖出"等相对语义的作用范围 |
+| **拷贝（Copy）** | 跨项目生成新任务并复制全部内容；原任务不受影响 |
+
+---
+
+## 3. 需求点
+
+**编号规则**：`T-模块-序号`。前缀 `T` 表示本模块（Task / 任务）。模块：
+
+| 模块码 | 模块名 | 对应 §1.3 条目 |
+| --- | --- | --- |
+| `VW` | 视图体系 | 第 1 条 |
+| `COL` | 看板列管理 | 第 2 条 |
+| `BD` | 看板与列-状态绑定 | 第 2 条 |
+| `FL` | 已完成任务显示控制（按列保留选项） | 第 3 条 |
+| `TK` | 任务字段体系（含扩展信息卡片） | 第 4 条 |
+| `AS` | 负责人与成员 | 第 5 条 |
+| `ST` | 子任务体系 | 第 6 条 |
+| `PJ` | 项目体系 | 第 7 条 |
+| `PM` | 项目权限与模块入口 | 第 8 条、第 11 条 |
+| `CP` | 跨项目拷贝 | 第 9 条 |
+| `UI` | UI 交互规范 | 第 10 条 |
+| `DT` | 数据需求 | — |
+| `NF` | 非功能需求 | — |
+| `EX` | 异常与边界 | — |
+
+**优先级**：`P0` = 本期必须有；`P1` = 本期应该有；`P2` = 有则更好（可延后）。
+
+**验收要点写法**：统一采用「给什么输入 / 做什么操作 → 期望得到什么可观察结果」，可直接转写为测试用例。
+
+### 3.1 视图体系（T-VW）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-VW-01 | 项目内提供**列表视图**与**看板视图**两种呈现方式 | 同一项目的同一批任务，两种视图均能完整呈现，条数一致 | P0 |
+| T-VW-02 | 可在列表 / 看板之间**互相切换**，切换过程**无整页刷新** | 切换不触发页面重载、不出现白屏，切换后滚动位置或回到顶部行为明确 | P0 |
+| T-VW-03 | **视图记忆按单个项目独立保存**：A 项目选列表、B 项目选看板互不影响 | 项目 A 切到看板 → 进入项目 B → B 仍为 B 上次选择的视图；回到 A → 仍为看板 | P0 |
+| T-VW-04 | 进入项目时**自动恢复**该项目上次选择的视图 | 退出模块后重新进入某项目，视图与上次退出时一致 | P0 |
+| T-VW-05 | 从未选择过视图的新项目，**默认使用列表视图** | 新建项目首次进入为列表视图 | P1 |
+| T-VW-06 | 视图记忆保存在**设备端**，不要求跨设备同步；本机跨会话保持 | 杀进程重进某项目，视图仍为上次选择；换设备登录不要求一致 | P0 |
+| T-VW-07 | **上次访问的项目**记录在**设备端**；无记录时**一律回到个人默认项目** | 杀进程重进落在上次项目；首次使用或记录失效则进入个人默认项目 | P0 |
+| T-VW-08 | 任务**首屏上部**展示**最近使用的 3 个项目**卡片，末尾放「更多项目」入口；点击「更多项目」进入完整项目列表页 | 最近项目按访问时间倒序取前 3；点卡片切换当前项目并高亮；点「更多」进入项目列表 | P0 |
+| T-VW-09 | 任务**首屏下部**直接展示**当前选中项目**的任务管理视图（列表 / 看板，随该项目视图记忆）；当前项目默认为上次访问的项目，无记录时为个人默认项目 | 进入任务 Tab 即见当前项目的任务，**无需先进项目列表**；切换首屏项目卡片后下部随之切换 | P0 |
+| T-VW-10 | 首屏**最近项目卡片支持手动排序**（长按拖动调整顺序），排序结果存**设备端**；未手动排序时按最近使用时间自动排列 | 拖动后顺序持久化，杀进程重进保持；新近访问但未手动排序的项目不出现在固定卡位之外 | P1 |
+
+### 3.2 看板列管理（T-COL）
+
+> 看板列是**项目级可配置实体**：默认 4 列，允许增删改与排序。列与「状态绑定」「保留选项」是三条正交的配置。
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-COL-01 | 新建项目**默认生成 4 列**：`Plan` / `Doing` / `Action` / `Done`，顺序即此 | 新项目看板渲染 4 列且名称、顺序与默认一致 | P0 |
+| T-COL-02 | 支持**新增列**（自定义名称），新列默认追加在末尾 | 新增后看板多一列，位于最后一列之后，可正常拖入任务 | P0 |
+| T-COL-03 | 支持**重命名列** | 改名后看板、列设置、任务归属处同步显示新名称 | P0 |
+| T-COL-04 | 支持**删除列**；删除前需二次确认，并明确其中任务的处理方式 | 按 T-EX-16 约定迁移任务，不产生无归属任务 | P0 |
+| T-COL-05 | 支持**调整列顺序**（拖动排序），顺序即看板显示顺序 | 拖动后顺序持久化，重新进入保持新顺序 | P0 |
+| T-COL-06 | 列数量**不固定**，约束上下限：**至少 1 列、至多 10 列**（上限待确认） | 可增到多于 4 列；删到仅剩 1 列时禁止再删；达 10 列时禁止新增并提示 | P0 |
+| T-COL-07 | 列名需**非空**且有长度上限，同一项目内**不允许重名** | 提交空名 / 重名时拒绝保存并提示 | P0 |
+| T-COL-08 | 删除列时，若该列绑定了状态，绑定关系随之解除 | 删除绑定「完成」的列后，该状态不再有该列可归位 | P1 |
+| T-COL-09 | 列配置属**项目级**，项目内任意成员可修改，不影响其他项目 | 成员 A 改列名，成员 B 同步可见；其他项目列不受影响 | P0 |
+| T-COL-10 | 列表视图不展示列分组，但任务仍归属某一列（列可被增删后依然成立） | 删除/新增列后，列表视图中任务的列归属正确 | P0 |
+
+### 3.3 看板与列-状态绑定（T-BD）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-BD-01 | 看板以**列**为单位组织任务，列由项目配置（默认 4 列，支持增删改与排序，详见 T-COL） | 看板按项目当前列配置渲染；调整列后任务归属随之正确呈现 | P0 |
+| T-BD-02 | **每一列独立**配置是否绑定任务状态；绑定时可选择绑定到 `未开始` / `执行中` / `完成` 中任一个 | 每列都有独立的绑定开关与状态选择器；各列配置独立保存 | P0 |
+| T-BD-03 | 允许**多列绑定到同一个状态**（如 `Done` 与 `Action` 都绑定「完成」） | 同一项目配置两列均绑定「完成」后，两列均能触发完成联动 | P0 |
+| T-BD-04 | **绑定列 → 拖入即改状态**：任务落入绑定列时，任务状态改为该列所绑定的状态 | 把「未开始」任务拖入绑定「执行中」的列 → 状态变「执行中」；拖入绑定「完成」的列 → 状态变「完成」 | P0 |
+| T-BD-05 | **状态 → 自动移入列**：任务状态改为某状态时，任务自动移入绑定该状态的列 | 列表视图把状态改为「完成」→ 切到看板，任务位于绑定「完成」的列 | P0 |
+| T-BD-06 | 同一状态被多列绑定时，自动移入**按当前列顺序取第一个**匹配列，规则确定且可预期 | 两列均绑定「完成」时，任务状态改为「完成」后仅出现在列序靠前的那个绑定列，不重复出现 | P0 |
+| T-BD-07 | **列决定状态，不看来源列**：拖动任务时，一律以「**目标列**的绑定配置」决定任务状态——目标列绑定了状态，则状态改为所绑定状态；**目标列未绑定，则任务保留原状态** | ①从绑定「完成」的列拖到绑定「执行中」的列 → 状态变「执行中」；②从任意列拖到**未绑定**的 `Action` → 状态保持不变 | P0 |
+| T-BD-08 | **不绑定列**与任务状态**完全独立**：拖入、拖出该列以及在其他位置改变状态，均不改变该列归属以外的行为 | 把「执行中」任务拖入未绑定的 `Action` → 状态仍为「执行中」，仅列变化 | P0 |
+| T-BD-14 | **状态与所在列不匹配时自动归位**：任务状态改变后，若其**当前所在列未绑定该状态**，则自动查找绑定该状态的列并将其移入 | 在未绑定的 `Action` 中把任务改为「完成」→ 任务自动移入绑定「完成」的列 | P0 |
+| T-BD-15 | 自动归位时**按当前列的实际显示顺序取第一个匹配列**（列顺序可被用户调整） | 若两列都绑定「完成」，状态改为「完成」后移入排在前面那一列 | P0 |
+| T-BD-16 | **无匹配列时任务不移动**，保留在原列（状态照常改变） | 取消所有列对「完成」的绑定后，把任务改为「完成」→ 状态为完成，列保持不变 | P0 |
+| T-BD-09 | **默认配置**：`Plan` 绑定「未开始」、`Doing` 绑定「执行中」、`Done` 绑定「完成」、`Action` 不绑定 | 新建项目首次打开看板配置，四列取值与默认完全一致 | P0 |
+| T-BD-10 | 绑定配置是**项目级**的，项目内**任意成员**均可修改，不同项目互不影响 | 成员 A 修改项目一配置成功；项目二配置不受影响；成员 B 也能修改 | P0 |
+| T-BD-11 | 修改绑定配置**不批量改写**既有任务的状态与列，仅对之后的操作生效 | 把 `Action` 由不绑定改为绑定「完成」后，已在 `Action` 的任务状态保持原样 | P1 |
+| T-BD-12 | 绑定配置变更后，看板与列表**即时一致**，无需手动刷新 | 保存配置后，看板列徽标与完成态立即反映新规则 | P1 |
+| T-BD-13 | **子任务不受看板列-状态绑定影响**：子任务状态不因所在列而改写，也不触发「状态 → 移入列」 | 父任务在绑定「完成」的列，其子任务状态仍可为「执行中」且不被改写；修改子任务状态不使其离开当前列 | P0 |
+
+### 3.4 已完成任务显示控制（T-FL）
+
+> 本节的「保留选项」**以看板列为单位**配置，取代原先的「项目整体 5 档过滤」。
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-FL-01 | **每一列独立**配置已完成任务的保留选项，配置项属于项目级 | 各列（含新增列）都有独立配置入口，修改一列不影响其他列 | P0 |
+| T-FL-02 | 保留选项为**固定 6 档**：`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示` | 下拉仅此六项，不提供自由输入天数 | P0 |
+| T-FL-03 | 「永久显示」：该列已完成任务**始终展示**，不受时间限制 | 设为永久显示后，历史任意时间完成的任务均可见 | P0 |
+| T-FL-04 | 「永不显示」：该列已完成任务**始终不展示** | 设为永不显示后，该列无已完成任务卡片 | P0 |
+| T-FL-05 | 「当天」：仅展示**完成于今天（自然日）**的已完成任务 | 今天完成的可见；昨天完成的次日即不显示 | P0 |
+| T-FL-06 | 「3 天」：展示**完成于最近 3 个自然日（含今天）**的已完成任务 | 今天、昨天、前天完成可见，更早不显示 | P0 |
+| T-FL-07 | 「本周」：展示**完成于本周（周一 00:00 起，至今天）**的已完成任务 | 周一起算；下周一进来看，上周完成的任务不再显示 | P0 |
+| T-FL-08 | 「本月」：展示**完成于本月（当月 1 日起，至今天）**的已完成任务 | 当月 1 日起算；进入次月后，上月完成的任务不再显示 | P0 |
+| T-FL-09 | 超出所选档位范围的已完成任务**自动隐藏**（无需手动操作） | 某列设为「当天」，次日进入该列，昨日完成的任务自动消失 | P0 |
+| T-FL-10 | 保留判定以「该任务的**完成时间**」为准，与任务当前所在列无关 | 任务完成后再移动列，可见性仍按其完成时间与新列档位判定 | P0 |
+| T-FL-11 | **列表视图与看板视图行为一致**：列表只是不按看板列分组展示，任务归属哪一列仍是哪一列，显示控制同样按**其所属列**的配置执行 | 看板中某列已隐藏的已完成任务，在列表视图中同样不出现；两视图可见条数一致 | P0 |
+| T-FL-12 | 该配置仅影响**已完成任务**；未完成任务始终展示，不受保留选项影响 | 未完成任务在任何保留选项配置下均可见 | P0 |
+| T-FL-13 | 显示控制为**展示层过滤**，不改变任务数据与状态 | 修改保留选项后，任务数据、状态、计数口径不发生变化 | P0 |
+| T-FL-14 | 过滤后每列的计数与展示条数一致 | 列头显示 N 条时，该列实际可见卡片同为 N 条 | P1 |
+| T-FL-15 | 保留选项配置在**项目内所有成员间共享**（属项目配置，非个人偏好） | 成员 A 修改后，成员 B 进入即按新配置显示 | P0 |
+
+### 3.5 任务字段体系（T-TK）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-TK-01 | 任务包含**基础字段**：标题（必填）、描述、所属项目、看板列、任务状态、负责人、任务成员、标签、创建人、创建时间、更新时间 | 新建任务后上述字段均可正确保存与读取 | P0 |
+| T-TK-02 | 标题为**唯一必填**字段，其余字段均可为空 | 仅填标题即可保存成功；仅清空标题时拒绝保存并提示 | P0 |
+| T-TK-03 | 任务状态为三值枚举：`未开始` / `执行中` / `完成` | 任一任务的状态只能取这三个值之一，不存在第四种取值 | P0 |
+| T-TK-04 | ~~内置扩展信息卡片~~ **已移除**（2026-10-24 评审）：相关信息记录改由**项目信息块**承载（T-PJ-13） | — | 已取消 |
+| T-TK-05 | ~~扩展信息条目~~ **随 T-TK-04 一并移除** | — | 已取消 |
+| T-TK-06 | ~~扩展信息卡片折叠~~ **随 T-TK-04 一并移除** | — | 已取消 |
+| T-TK-07 | ~~扩展信息非必填~~ **随 T-TK-04 一并移除** | — | 已取消 |
+| T-TK-08 | 每条任务有**负责人（单人）** | 任务最多只有一个负责人，重复设置时以最后一次为准 | P0 |
+| T-TK-09 | 新建任务时**负责人默认填入创建者本人** | 新建任务后未手动修改时，负责人即为创建者 | P0 |
+| T-TK-10 | 负责人**允许清空为空** | 清空后任务可正常保存，展示为「未指派」 | P0 |
+| T-TK-11 | 每条任务有**任务成员（多人）** | 可设置 0 ~ 多个成员，成员不重复 | P0 |
+| T-TK-12 | 任务支持**标签** | 可添加多个标签，展示于条目 / 卡片 | P1 |
+| T-TK-13 | 任务的创建人、创建时间、更新时间由系统维护，用户不可直接编辑 | 编辑任务不改变创建人与创建时间；任何修改刷新更新时间 | P1 |
+| T-TK-14 | 任务标题收紧至**30 个汉字**；快速添加输入框允许输入 200 字，超过 30 字时自动在 30 字以内的**分隔符（空格/标点等）**处截断，前段作为标题，整体文本并入描述 | 输入长文本创建后：标题 ≤30 字且不在词中间切断；描述包含完整原文余文；直接编辑标题超 30 字时拒绝保存并提示 | P0 |
+| T-TK-15 | 任务可选**时间标记**（完整日期存储），设置了时间标记的任务在列表行与看板卡片上以 `MM-dd` 小标签展示 | 详情页可选择/清除时间标记；设置后卡片出现 MM-dd 标签，清除后消失 | P1 |
+| T-TK-16 | 快速添加输入框支持**时间词前缀**：以 今天/明天/后天/本周/下周/本月/下月 开头（后跟分隔符）时，自动为任务设置对应时间标记并把该前缀从标题中移除 | 输入「明天 交周报」→ 创建任务标题为「交周报」、时间标记为明天的日期；无匹配前缀时行为不变 | P1 |
+
+### 3.6 负责人 & 成员 UI 展示规则（T-AS）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-AS-01 | **负责人**字号更大、视觉突出，位于条目 / 卡片的主要信息区 | 同名负责人与成员并排时，负责人字号明显更大且位于主位 | P0 |
+| T-AS-02 | **任务成员**字号更小、弱化展示（低对比色），位于卡片 / 条目**下方** | 成员信息渲染在负责人 / 标题之下，视觉层次弱于负责人 | P0 |
+| T-AS-03 | 负责人只能从**当前项目的成员**中选择 | 选择器只列出本项目成员；项目外用户无法被选中 | P0 |
+| T-AS-04 | 任务成员只能从**当前项目的成员**中选择 | 选择器只列出本项目成员，不提供项目外用户 | P0 |
+| T-AS-05 | 负责人为空（已清空）时展示「未指派」占位，正常渲染 | 清空负责人后条目 / 卡片显示「未指派」，可再次指派 | P0 |
+| T-AS-06 | 人员被移出项目后，其负责人 / 成员标记按约定处理且不报错 | 见 T-EX-06 | P1 |
+| T-AS-07 | 负责人、任务成员**仅为信息标记**，不改变项目统一读写权限 | 仅为负责人或仅为成员的用户，对项目读写能力与其他成员完全相同 | P0 |
+
+### 3.7 子任务体系（T-ST）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-ST-01 | **仅支持一级子任务**，不支持多层嵌套 | 子任务上无「添加子任务」入口；后端拒绝以子任务为父任务创建任务 | P0 |
+| T-ST-02 | 子任务**必须与父任务归属同一项目** | 尝试将子任务置于其他项目时被拒绝（含跨项目拷贝场景） | P0 |
+| T-ST-03 | 父任务与子任务的**完成状态相互独立**、不自动联动 | 子任务全部完成，父任务状态不变；父任务完成，子任务状态不变 | P0 |
+| T-ST-04 | **列表视图**支持子任务**缩进**展示 | 子任务在父任务下方缩进渲染，层级一眼可辨 | P0 |
+| T-ST-05 | **列表视图**支持子任务**折叠 / 展开** | 折叠后子任务不显示且不占位；展开后恢复；折叠状态可感知 | P0 |
+| T-ST-06 | **看板卡片内嵌套展示子任务**：含子任务的卡片中，子任务以**简洁形式嵌套**显示在任务卡片内 | 卡片内可见子任务列表（如紧凑单行：复选框 + 标题），样式轻量、不喧宾夺主 | P0 |
+| T-ST-07 | 嵌套子任务可在**卡片内直接勾选完成**；完整详情（编辑标题 / 负责人 / 扩展信息等）在卡片弹窗内查看编辑 | 点击子任务复选框即切换其状态；点击卡片打开弹窗可编辑子任务全部字段 | P0 |
+| T-ST-08 | **子任务状态与父任务状态可以不一致**，且子任务**不受看板列-状态绑定约束** | 父任务在 `Done`（绑定「完成」）时，其子任务可为「未开始」且不被改写 | P0 |
+| T-ST-09 | 卡片内嵌套的子任务**显示自身状态小标记**（区分「未开始 / 执行中 / 完成」），以便识别与其父任务不一致的状态 | 父任务为完成、子任务为执行中时，卡片内可见子任务带「执行中」小标记 | P0 |
+| T-ST-10 | 子任务不可作为看板独立卡片出现，只在其父任务卡片内嵌套 | 看板上一个任务只占一张卡，子任务不会单独成卡 | P1 |
+| T-ST-11 | 删除父任务时**级联删除**其子任务 | 删除父任务后子任务一并删除，不产生孤儿数据 | P0 |
+| T-ST-12 | **支持长按拖拽把任务降为另一个任务的一级子任务** | 列表视图长按任务 A 拖到任务 B 上释放 → A 成为 B 的子任务并缩进显示 | P0 |
+| T-ST-13 | 拖拽成为子任务时，若目标任务**本身已是子任务**，则拒绝操作并提示 | 把任务拖到某个子任务上 → 操作被拒绝，给出「仅支持一级子任务」提示，数据不变 | P0 |
+| T-ST-14 | 拖拽成为子任务时，若被拖任务是**有子任务的父任务**，则拒绝并提示（父任务不可整体挂到别的任务下） | 拖动含子任务的任务到其他任务上 → 拒绝，避免形成二级嵌套 | P0 |
+| T-ST-15 | 拖拽成为子任务时，子任务的**看板列与状态保持自身原值**，仅改变父子归属 | 按 T-EX-13 约定处理，保证子任务与父任务同项目且层级合法 | P1 |
+
+### 3.8 项目体系（T-PJ）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-PJ-01 | 每个用户**自动拥有且仅有一个个人默认项目** | 新用户首次进入模块即已存在个人项目；不可再创建第二个 | P0 |
+| T-PJ-02 | 个人默认项目**不可删除** | 无删除入口；直接调用删除接口被拒绝 | P0 |
+| T-PJ-03 | 个人默认项目**不能添加其他成员** | 成员管理入口不存在或不可用；调用添加成员接口被拒绝 | P0 |
+| T-PJ-04 | 个人默认项目名称**以用户名开头**，且**整体名称可自定义修改** | 初始名称以用户名开头；改名后修改内容生效，仍保持「个人项目」性质 | P0 |
+| T-PJ-05 | 支持**新建普通协作项目** | 可创建多个普通项目，创建者为成员 | P0 |
+| T-PJ-06 | 普通项目**可以增删成员** | 添加 / 移除成员后，成员列表与可见性即时变化 | P0 |
+| T-PJ-07 | **项目创建人可以主动退出项目** | 创建人退出后不再是成员，该项目不再对其可见 | P0 |
+| T-PJ-08 | 项目**成员清空后静默保留**，交后台后续维护，前端不做特殊处理 | 成员全部退出后，前端不弹特殊提示、不出现错误；不可见 | P0 |
+| T-PJ-09 | 项目可**归档**，归档项目与进行中项目区分展示 | 归档后从进行中列表移出，可在归档区找回 | P1 |
+| T-PJ-10 | 项目列表按用户可见范围返回，仅含自己为成员的项目 | 非成员项目不出现在列表中 | P0 |
+| T-PJ-11 | 项目的**成员管理、成员新增、列设置**统一收进「**项目管理**」入口；项目页头部不再散置多个功能入口 | 项目管理内含 成员 / 列设置 / 项目信息 三个分区；头部仅保留「项目管理」一个入口 | P0 |
+| T-PJ-12 | 项目管理内提供**项目信息管理**：改名（T-PJ-04）、归档 / 取消归档（T-PJ-09）、删除项目（T-PJ-02，个人默认项目禁用）、退出项目（T-PJ-07，创建人可退） | 各操作在项目管理中可用且遵循既有约束；个人项目不出现删除与退出入口 | P0 |
+| T-PJ-13 | 项目支持**信息块**：可自由添加任意多个长文本信息块（标题 + 多行内容，如 Readme / 项目说明），每块**独立编辑与删除**；属项目级数据，全体成员可见可编辑 | 可增删改任意块；内容支持多行长文本；所有成员看到同一份信息块 | P0 |
+
+### 3.9 项目权限（T-PM）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-PM-01 | 权限**以项目为隔离单位**：用户只能看到自己是成员的项目及其任务 | 非成员访问某项目接口返回 403 / 404，列表不出现该项目 | P0 |
+| T-PM-02 | 项目内**所有成员权限均等**，具备**全读写**能力 | 任意成员均可新增 / 编辑 / 删除任务、管理成员、修改列-状态绑定与保留选项配置 | P0 |
+| T-PM-03 | 预留**权限分级入口**，本期**不实现**细分角色 | 数据结构或接口层保留扩展位；界面无角色分配功能 | P1 |
+| T-PM-04 | 项目内**所有成员都可以归档项目** | 任意成员执行归档均成功 | P0 |
+| T-PM-05 | 复用现有项目框架的登录态与鉴权，未登录访问被拒 | 无有效登录态访问返回 401 | P0 |
+| T-PM-06 | 任务模块作为**顶级 Tab** 接入底部导航，位置在**「打卡」之后** | 底部 Tab 顺序为「打卡 → 任务 → 宏观 → 监控 → 我」；点击该 Tab 进入任务模块 | P0 |
+| T-PM-07 | 进入任务模块后**默认落在上次访问的项目**（记录在**设备端**）；**无记录时一律回到个人默认项目** | 首次进入 / 记录失效 → 个人默认项目；再次进入 → 上次离开时的项目；换设备不继承 | P0 |
+
+### 3.10 跨项目拷贝（T-CP）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-CP-01 | 跨项目操作为**拷贝**，不是移动：源任务保留在原项目 | 拷贝后源任务仍存在于原项目且内容不变 | P0 |
+| T-CP-02 | 拷贝时**完整复制全部字段** | 标题、描述、负责人、成员、标签、任务状态、看板列、扩展信息卡片逐项比对一致 | P0 |
+| T-CP-03 | 拷贝时**完整复制子任务** | 子任务条数、标题、状态、列归属均与源任务一致 | P0 |
+| T-CP-04 | 拷贝后**新任务的创建人**为本次执行拷贝操作的用户 | 新任务创建人 = 操作者，非源任务创建人 | P0 |
+| T-CP-05 | 拷贝完成后**新旧任务互相独立**，后续修改互不影响 | 修改新任务标题 / 状态，源任务不变；反之亦然 | P0 |
+| T-CP-06 | 拷贝目标必须是操作者**有权限**的项目 | 目标项目非本人成员时拒绝并提示 | P0 |
+| T-CP-07 | 拷贝时负责人 / 成员若不属目标项目成员，按约定处理 | 按 T-EX-08 约定处理，不产生「项目外人」脏数据 | P1 |
+| T-CP-08 | 拷贝包含子任务时，子任务与父任务**同属目标项目** | 拷贝后子任务项目归属与父任务一致 | P0 |
+| T-CP-09 | 拷贝时若目标任务项目的**列-状态绑定规则不同**，按 T-EX-14 约定处理 | 状态与列不出现互相矛盾的组合 | P1 |
+
+### 3.11 UI 交互规范（T-UI）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-UI-01 | 整体界面、列表交互、子任务折叠风格**参考 Todoist** | 列表条目结构、快速新增、勾选完成、子任务折叠的交互与 Todoist 同类操作一致 | P0 |
+| T-UI-02 | **看板卡片轻量化**，样式简洁 | 卡片仅承载必要信息，无多余装饰；信息层级清晰 | P0 |
+| T-UI-03 | 列表与看板**同源数据**，修改**实时双向同步** | 列表改标题 / 状态 → 切到看板立即可见；看板改 → 切到列表立即可见 | P0 |
+| T-UI-04 | 视图切换**无刷新**、数据一致 | 切换过程中不发起整页加载，数据不发生丢失或错位 | P0 |
+| T-UI-05 | 移动端适配：复用现有样式体系与底部导航，安全区不遮挡内容 | 375~430px 视口无横向滚动、无内容被遮挡 | P0 |
+| T-UI-06 | 勾选完成有即时反馈（视觉状态变化），不阻塞后续操作 | 点击勾选后立即变化，无需等待接口返回才能继续操作 | P1 |
+| T-UI-07 | 看板拖拽在移动端支持**长按拖拽**，并提供卡片「移动到」快捷项作为兜底 | 长按可拖起卡片；无法拖拽的场景可用「移动到」菜单完成同效果 | P0 |
+| T-UI-08 | 具备**空状态**展示（无项目 / 无任务 / 无子任务等） | 各层级无数据时展示空态与引导入口，不出现空白页 | P0 |
+| T-UI-09 | 具备**加载状态**展示 | 首屏与切换视图时展示加载态，不出现闪烁或错乱 | P0 |
+| T-UI-10 | 具备**数据异常状态**展示，可重试 | 接口失败时展示异常态与重试入口，重试成功后恢复 | P0 |
+| T-UI-11 | 弹层（任务详情等）**底部按钮与屏幕底边保持安全距离**，不被安全区 / 手势条遮挡 | 底部留白 ≥ 安全区高度 + 12px；小屏下弹层内容可滚动，删除等底部按钮始终完整可见可点 | P0 |
+
+### 3.12 数据需求（T-DT）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-DT-01 | 新增 Prisma 模型：`Project`（含 `isPersonal`、列-状态绑定配置、列保留选项配置、`archived` 等）、`ProjectMember` | 字段见附录 A | P0 |
+| T-DT-02 | 列-状态绑定配置**按列存储**，每列独立保存「是否绑定 + 绑定状态」，支持多列指向同一状态 | 任意数量列的配置可独立读写；两列绑定同一状态可正确落库 | P0 |
+| T-DT-03 | 列保留选项配置**按列存储**，取值覆盖六档：`never` / `today` / `3d` / `week` / `month` / `forever` | 三档取值均可落库并正确读回 | P0 |
+| T-DT-04 | 新增 Prisma 模型：`Task`（含 `parentId` 自关联、`assigneeId`、`status`、看板列、扩展信息卡片、`sortOrder`） | 字段见附录 A | P0 |
+| T-DT-05 | 新增 Prisma 模型：`TaskMember`（任务成员关联）、扩展信息卡片结构、标签结构 | 字段见附录 A | P0 |
+| T-DT-06 | 视图记忆按**设备端**存储，不要求落库 | 换设备登录不要求视图一致 | P0 |
+| T-DT-07 | 建立必要索引：任务按项目查询、按父子关系查询、按状态查询 | 列表 / 看板 / 显示控制查询均走索引 | P0 |
+| T-DT-08 | 提供迁移 SQL 并纳入 `prisma migrate deploy` 流程 | 与现有迁移流程一致 | P0 |
+| T-DT-09 | 归档采用软删除语义，历史数据保留 | 归档不物理删除任务与项目数据 | P1 |
+
+### 3.13 非功能需求（T-NF）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-NF-01 | 项目内任务列表首屏加载 < 1.5s（正常网络），交互响应 < 300ms | 真机可感知流畅 | P0 |
+| T-NF-02 | 兼容当前 APP 的 WebView 运行环境与移动端浏览器 | 真机验证通过 | P0 |
+| T-NF-03 | 前端代码组织遵循现有约定：`src/pages/task/*` + `src/components/*` + `server/routes/task*.js` | 结构一致 | P0 |
+| T-NF-04 | 路由与接口挂载**沿用现有项目框架**的组织方式 | 与现有模块的组织方式一致 | P0 |
+| T-NF-05 | 数据量按「单项目千级任务 / 年」设计，无需分表 | 千级任务下列表与看板可用 | P1 |
+
+### 3.14 异常与边界（T-EX）
+
+| 编号 | 需求描述 | 处理约定 | 优先级 |
+| --- | --- | --- | --- |
+| T-EX-01 | 重复点击勾选 / 重复拖拽 | 前端防抖 + 后端幂等，状态最终一致 | P0 |
+| T-EX-02 | 接口失败 / 断网 | 乐观更新回滚 + 提示，可重试 | P0 |
+| T-EX-03 | 绑定配置被改为「不绑定」时，已在该列的已完成任务 | 保持当前列与状态不变，等待用户后续操作 | P0 |
+| T-EX-04 | 任务状态与所在列绑定不一致（如在不绑定的 `Action` 中改为「完成」） | 触发自动归位：移入第一个绑定该状态的列；**无匹配列则不移动**，保留原列（见 T-BD-14~16） | P0 |
+| T-EX-05 | 任务被拖到**未绑定状态**的列（如 `Action`），其原状态如何处理 | 原状态**保持不变**，不因离开原列而回退（不存在「拖出即回退」规则） | P0 |
+| T-EX-06 | 项目成员被移除，其仍担任某任务负责人 / 成员 | 保留历史标记，展示为「已退出」样式；不报错、不清空 | P1 |
+| T-EX-07 | 删除父任务 | 级联删除其子任务，确认弹窗提示「将一并删除 N 条子任务」 | P0 |
+| T-EX-08 | 跨项目拷贝时负责人 / 成员不属于目标项目 | 仅保留属于目标项目成员者，其余丢弃并在结果中提示 | P1 |
+| T-EX-09 | 个人默认项目尝试添加成员 / 尝试删除 | 接口返回明确错误，前端不提供入口 | P0 |
+| T-EX-10 | 某列设为「当天」等档位且该列无符合条件的已完成任务 | 展示该列空态，不报错 | P0 |
+| T-EX-11 | 项目成员清空后的项目 | 静默保留，前端不报错、不特殊提示 | P0 |
+| T-EX-12 | 子任务所属项目与父任务不一致（绕过前端直接调用） | 后端拒绝并返回错误 | P0 |
+| T-EX-13 | 拖拽成为子任务时，子任务的**看板列与状态**如何取值 | 保持自身原值不变，仅改变父子归属 | P1 |
+| T-EX-14 | 跨项目拷贝时，源任务的状态 / 列在目标项目绑定规则下无对应关系 | 沿用源值落库，不强行纠正；由后续用户操作自然修正 | P1 |
+| T-EX-15 | 拖拽将任务放到自身或其后代上 | 拒绝操作并提示，避免形成环形父子关系 | P0 |
+| T-EX-16 | 删除仍有任务的列 | 二次确认后，该列任务迁移至**相邻列**（或由用户指定目标列），不产生无归属任务 | P0 |
+| T-EX-17 | 删除唯一剩余的列 | **拒绝操作**并提示「至少保留一列」 | P0 |
+| T-EX-19 | 新增列时已达列数上限 | 拒绝新增并提示已达上限，不产生空列 | P1 |
+| T-EX-18 | 已完成任务跨周期（周一零点 / 月初零点）后应隐藏 | **当场消失**并带移除动画，其余任务平滑重排，不留空白 | P1 |
+
+### 3.15 任务归档（T-ARC）
+
+> 与「已完成显示控制（T-FL）」的关系：T-FL 决定任务**看不看得见**（可逆的展示过滤），
+> 归档决定任务**在不在主工作集**（数据层面的收纳）。隐藏是自动归档的前置条件，归档移出主列表，
+> 可通过「已归档查询」恢复。
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| T-ARC-01 | **手动归档**：任务 `⋯` 菜单增加「归档」；任意未归档任务（不限状态）均可归档；父任务归档时**连带全部子任务**一并归档；操作需二次确认（提示连带条数） | 归档后任务从列表/看板消失；子任务同步消失；确认弹窗条数正确 | P0 |
+| T-ARC-02 | **自动归档**：项目级配置「**隐藏的任务**多久归档」，可选 `3 天后 / 一周后 / 一月后 / 永不`（默认永不）；已隐藏（T-FL 保留窗口过期）的 done 任务到期后由系统自动归档 | 配置保存后生效；隐藏任务到期被自动归档；「永不」时永不自动归档；未隐藏的任务不受影响 | P1 |
+| T-ARC-03 | **归档排除**：已归档任务从任务列表、看板、列计数、项目任务数统计中排除 | 归档后各视图与计数立即减少；恢复后回到原位 | P0 |
+| T-ARC-04 | **已归档查询**：独立入口查看本项目已归档任务；支持关键词（标题）、任务类型、看板列、归档时间范围过滤；**游标分页**支撑大量数据（千级） | 过滤条件生效；分页可连续加载到底；千级数据下查询流畅 | P0 |
+| T-ARC-05 | **恢复**：已归档任务可取消归档，回到原看板列（列被删除的场景因外键 `ON DELETE RESTRICT` 不存在），状态保持不变；父任务恢复连带子任务 | 恢复后任务与子任务重新出现在列表/看板原列 | P0 |
+| T-ARC-06 | **彻底删除**：已归档任务可物理删除（含子任务），二次确认 | 删除后不再出现在已归档查询 | P1 |
+| T-ARC-07 | **配置入口**：项目管理新增「归档设置」分区，展示与修改自动归档档位 | 修改后即时保存并对全项目生效 | P1 |
+| T-ARC-08 | **权限口径**：项目成员均可归档/恢复/删除归档任务（权限均等口径同 T-PM-04） | 与其他写操作权限一致，无额外限制 | P1 |
+
+---
+
+## 4. 优先级汇总（本期交付范围）
+
+- **P0（必须）**：T-VW-01~04、T-VW-06~09；T-COL-01~07、T-COL-09、T-COL-10；T-BD-01~10、13~16；T-FL-01~13、15；T-TK-01~11；T-AS-01~05、07；T-ST-01~09、11~14；T-PJ-01~08、10~13；T-PM-01、02、04~07；T-CP-01~06、08；T-UI-01~05、07~11；T-DT-01~08；T-NF-01~04；T-EX-01~05、07、09~12、15~17；T-ARC-01、03、04、05。
+- **P1（应该）**：T-VW-05、10；T-COL-08；T-BD-11、12；T-FL-14；T-TK-12、13；T-AS-06；T-ST-10、15；T-PJ-09；T-PM-03；T-CP-07、09；T-UI-06；T-DT-09；T-NF-05；T-EX-06、08、13、14、18、19；T-ARC-02、06、07、08。
+
+---
+
+## 5. 已决策问题（评审记录）
+
+以下问题已在 2026-10-24 评审中确认，作为实现依据：
+
+| # | 问题 | 决策 |
+| --- | --- | --- |
+| 1 | 列-状态绑定是单列还是多列？ | **每列独立配置**，允许**多列绑定同一状态**；默认 plan→未开始、doing→执行中、done→完成、action→不绑定（T-BD-02、03、09） |
+| 2 | 保留档位的时间边界按自然日还是滚动小时？ | **自然日**（Asia/Shanghai，含今天 00:00 起）；本周按周一起算、本月按 1 日起算 |
+| 3 | 视图记忆 / 显示配置存在设备端还是服务端？ | 视图记忆**设备端**、不跨设备；保留选项**项目级共享**（T-VW-06、T-FL-12、T-DT-06） |
+| 4 | 删除父任务时子任务如何处理？ | **级联删除**，弹窗提示条数（T-EX-07） |
+| 5 | 已完成任务在看板中的呈现？ | 由**该列的保留选项**控制显示与隐藏（T-FL-01~10） |
+| 6 | 看板拖拽的移动端交互？ | **长按拖拽** + 「移动到」兜底；**允许拖拽降为子任务**（T-UI-07、T-ST-12） |
+| 7 | 项目成员清空后是否需要本模块的管理入口？ | **本期不承担**，交后台；前端静默（T-PJ-08） |
+| 8 | 扩展信息组的具体字段清单？ | **不固定字段**，改为**任意扩展信息卡片**（T-TK-04、05） |
+| 9 | 已完成显示策略的粒度？ | 改为**按看板列独立的保留选项**（T-FL-01、02） |
+| 10 | 是否单独要求 WebView / 登录态 / 返回键？ | **不单列**，沿用现有项目框架（T-NF-04、T-PM-05） |
+| 11 | 同一状态被多列绑定，状态变化时进哪一列？ | **按当前列顺序取第一个匹配**（T-BD-06、15、B-3） |
+| 12 | **从绑定列拖出**时状态是否回退？ | **不设「拖出即回退」规则**。只看**目标列**：目标列绑定了状态就按目标列改，未绑定则**保留原状态**（T-BD-07、B-4） |
+| 13 | 列表视图如何处理「按列」的显示控制？ | 列表只是**不按列分组**，任务归属仍是原看板列，行为与看板**完全一致**（T-FL-11、B-6） |
+| 14 | 看板卡片如何展示子任务？ | **在卡片内嵌套简洁展示**，可直接勾选；完整详情在卡片弹窗（T-ST-06、07） |
+| 15 | 子任务是否受列-状态绑定影响？ | **不受**。子任务状态可与父任务不一致，拖入列不改写其状态（T-BD-13、T-ST-08、B-7） |
+| 16 | 父任务能否整体挂到别的任务下？ | **不能**。含子任务的父任务不可被拖拽为子任务（T-ST-14） |
+| 17 | 保留选项的取值范围？ | 固定 **6 档**：`永不显示` / `当天` / `3 天` / `本周` / `本月` / `永久显示`，不做自由输入（T-FL-02、B-5） |
+| 18 | 任务状态与所在列绑定不一致时怎么处理？ | **触发自动归位**：查找绑定该状态的列并移入，按列序取第一个；**无匹配列则不移动**（T-BD-14~16、B-4b） |
+| 19 | 卡片内嵌套的子任务是否显示自身状态？ | **显示小状态标记**，以区分与父任务不一致的状态（T-ST-09） |
+| 20 | 任务模块入口放在哪里？ | 作为**顶级 Tab**，位置在**「打卡」之后**（T-PM-06） |
+
+| 21 | 5 个底部 Tab 是否影响既有布局与默认首页？ | **暂无障碍**；默认首页**仍为打卡**（T-PM-06） |
+| 22 | 任务状态为「完成」但所有列都未绑定「完成」时，列表视图按哪一列过滤？ | **保留在当前列**，按该列保留选项过滤。**不存在「已完成统一用 Done 列」的强制规则**，那只是默认配置下的自然效果，用户可完全自定义（T-FL-11） |
+| 23 | 「本周 / 本月」跨周跨月时是否要求实时隐藏？ | **当场消失并带移除动画，其余任务平滑重排**；以刷新方式实现也可接受（T-EX-18） |
+| 24 | 「上次访问的项目」记录在哪？无记录时如何？ | 记录在**设备端**；**无记录一律回个人默认项目**（T-VW-07、T-PM-07） |
+| 25 | 看板列是否固定 4 列？ | **非固定**：默认 4 列，支持增删改与排序，数量可变，至少保留 1 列（T-COL-01~07） |
+
+| 26 | 是否允许删除最后一个列？ | **不允许**。删除唯一剩余列时拒绝并提示，项目至少保留 1 列（T-COL-06、T-EX-17） |
+| 27 | 新增列的默认设置？ | 按**默认值**：保留选项 `永久显示`、不绑定状态，**不继承**相邻列设置（T-COL-02、B-18） |
+| 28 | 看板列数量上限？ | 暂定**上限 10 列**（`待确认`，见下） |
+| 29 | 任务首屏结构？ | **上部** = 最近使用的 3 个项目卡片 + 「更多项目」入口；**下部** = 当前选中项目的任务管理视图，默认上次访问的项目（T-VW-08/09） |
+| 30 | 首屏「任务卡片可以排序」的指代？ | 指**最近项目卡片**可长按拖动排序，结果存设备端；任务卡片的列内排序维持既有口径（T-VW-10） |
+| 31 | 成员 / 列设置入口的位置？ | 统一收进「**项目管理**」入口（含成员、列设置、项目信息三区），项目页头部不再散置（T-PJ-11） |
+| 32 | 项目信息管理包含什么？ | 改名、归档 / 取消归档、删除（个人项目禁用）、退出（创建人可退），入口在项目管理内（T-PJ-12） |
+| 33 | 任务详情底部按钮遮挡？ | 弹层底部预留**安全区 + 12px** 距离；小屏下弹层可滚动，底部按钮完整可见（T-UI-11） |
+| 34 | 项目相关长文本信息记录在哪？ | 项目管理内新增**信息块**分区：任意多个 {标题, 长文本} 块，独立编辑，属项目级数据（T-PJ-13） |
+| 35 | 任务级「扩展信息」的去留？ | **移除 UI**（2026-10-24 评审）：任务不再带扩展信息，项目相关长文本由项目信息块（T-PJ-13）承载；DB 字段保留不用 |
+
+**仍待评审确认（影响实现口径）：**
+
+| # | 问题 | 说明 |
+| --- | --- | --- |
+| A | 列数量上限是否按 10 列？ | 现按「至少 1 列、至多 10 列」写入（T-COL-06）。若无需上限，可去掉上限约束 |
+
+---
+
+## 附录 A：核心实体草案（供设计阶段参考，非最终表结构）
+
+```prisma
+// 项目
+model Project {
+  id        Int      @id @default(autoincrement())
+  name      String
+  ownerId   Int                          // 创建人 (可退出项目, 故与成员表分离)
+  isPersonal Boolean @default(false)     // true = 个人默认项目: 不可删、不可加成员
+  archived  Boolean  @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  members   ProjectMember[]
+  columns   BoardColumn[]
+  tasks     Task[]
+
+  @@index([archived])
+}
+
+// 看板列 (项目级实体: 默认 4 列, 可增删改与排序)
+model BoardColumn {
+  id           Int     @id @default(autoincrement())
+  projectId    Int
+  project      Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  name         String                      // 列名, 项目内唯一
+  sortOrder    Int     @default(0)         // 显示顺序, 决定自动归位时的"第一个匹配列"
+  boundStatus  String?                     // null = 不绑定; todo | doing | done
+  retention    String  @default("forever") // never | today | 3d | week | month | forever
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  tasks Task[]
+
+  @@unique([projectId, name])
+  @@index([projectId, sortOrder])
+}
+
+// 项目成员 (权限单位: 在表内即全读写)
+model ProjectMember {
+  id        Int      @id @default(autoincrement())
+  projectId Int
+  project   Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  userId    Int
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  permission String  @default("member")  // 预留权限分级入口, 本期恒为 member
+  createdAt DateTime @default(now())
+
+  @@unique([projectId, userId])
+  @@index([userId])
+}
+
+// 任务 / 子任务 (parentId 为空 = 顶层任务)
+model Task {
+  id         Int      @id @default(autoincrement())
+  projectId  Int
+  project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  parentId   Int?                        // 非空 = 一级子任务 (最多一层)
+  parent     Task?    @relation("Subtask", fields: [parentId], references: [id], onDelete: Cascade)
+  children   Task[]   @relation("Subtask")
+
+  title       String
+  description String  @default("")
+  status      String  @default("todo")   // todo | doing | done
+  columnId    Int                        // 所属看板列 (BoardColumn), 列可增删改故用 id 而非固定名
+  column      BoardColumn @relation(fields: [columnId], references: [id])
+
+  assigneeId Int?                        // 负责人 (可空; 新建默认 = 创建者)
+  assignee   User?    @relation("Assignee", fields: [assigneeId], references: [id], onDelete: SetNull)
+  creatorId  Int                         // 创建人 (跨项目拷贝时 = 操作者)
+  creator    User     @relation("Creator", fields: [creatorId], references: [id])
+
+  // 扩展信息卡片: 任意条目, 默认收起
+  extras     Json     @default("[]")     // [{ label: "仓库", value: "gitlab/app", url: "" }]
+
+  sortOrder  Int      @default(0)
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  members    TaskMember[]
+  tags       TaskTag[]
+
+  @@index([projectId, columnId])
+  @@index([projectId, status])
+  @@index([parentId])
+}
+
+// 任务成员 (多人, 须为项目成员)
+model TaskMember {
+  id     Int  @id @default(autoincrement())
+  taskId Int
+  task   Task @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  userId Int
+  user   User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([taskId, userId])
+}
+
+// 任务标签
+model TaskTag {
+  id     Int    @id @default(autoincrement())
+  taskId Int
+  task   Task   @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  name   String
+  @@index([taskId])
+}
+```
+
+> 说明：
+> 1. `status` 与 `columnId` **两个字段都落库**（而非互相推导），因为未绑定的列需要二者彼此独立；联动仅在项目配置了绑定的列/状态之间发生，由服务端统一裁决。
+> 2. 保留选项的判定依赖「在该列的完成时间」，建议在任务上记录完成时间或按列迁移时间计算，具体口径在设计阶段确定。
+> 3. 视图记忆存设备端（localStorage），不落库。
+
+---
+
+## 附录 B：实现约定（开发期补充，用于消除口径歧义）
+
+| # | 约定 | 说明 |
+| --- | --- | --- |
+| B-1 | **看板列** | 列是项目级实体（`BoardColumn`），含名称与顺序；默认 4 列 `Plan/Doing/Action/Done`；支持增删改与排序，至少保留 1 列 |
+| B-2 | **列-状态绑定** | `columnBindings` 为「列 → 状态或 null」映射；null 表示不绑定；**允许多列指向同一状态**；状态枚举 `todo` / `doing` / `done` |
+| B-3 | **多列绑定同一状态时的目标列** | 移入列时按**当前列顺序**取**第一个**绑定该状态的列（列顺序可被用户调整） |
+| B-4 | **列决定状态** | 拖动任务时只看**目标列**：目标列绑定了状态 ⇒ 状态 = 所绑定状态（含从任意列拖入）；目标列未绑定 ⇒ 状态保持原值。**不存在「从某列拖出即回退」的规则** |
+| B-4b | **状态与列不一致时的自动归位** | 状态改变后，若当前所在列未绑定该状态 ⇒ 按列序取第一个绑定该状态的列并移入；**无匹配列则不移动**，状态照常改变 |
+| B-5 | **列保留选项** | `columnRetention` 为「列 → 选项」映射，选项为固定 6 档：`never`（永不显示）/ `today`（当天）/ `3d`（3 天）/ `week`（本周）/ `month`（本月）/ `forever`（永久显示） |
+| B-5b | **各档位口径** | 均按 Asia/Shanghai 自然日：`today` = 今天；`3d` = 含今天在内的最近 3 天；`week` = 本周一 00:00 起；`month` = 本月 1 日 00:00 起；判定依据为任务的**完成时间** |
+| B-6 | **显示控制作用域** | 列表视图与看板视图**同样**按任务**当前所属列**的保留选项执行过滤；列表只是不按列分组，归属不变；未完成任务不受影响 |
+| B-7 | **子任务与绑定无关** | 子任务状态**不受**看板列-状态绑定影响：拖入列不改写子任务状态，修改子任务状态也不触发「移入列」 |
+| B-8 | **子任务约束** | `parentId` 非空时：父任务 `parentId` 必须为空（禁止二级）；`projectId` 必须与父任务一致；禁止指向自身或后代 |
+| B-9 | **拖拽降为子任务** | 长按拖动任务 A 到任务 B 上释放 ⇒ A.parentId = B.id；要求 B 为顶层任务且 A 本身无子任务，否则拒绝 |
+| B-10 | **负责人默认值** | 新建任务时若未显式指定，`assigneeId` 默认取创建者的 userId；显式传 null 表示清空 |
+| B-11 | **个人默认项目** | `isPersonal = true`；服务端拒绝「添加成员」「删除项目」；名称初始为 `{用户名}的任务`，可改名 |
+| B-12 | **成员清空** | 移除最后一名成员时不删除 `Project`，仅删除 `ProjectMember` 记录；前端不特判 |
+| B-13 | **跨项目拷贝** | 新建任务（新 id）+ 复制全部字段、扩展卡片与子任务；`creatorId` = 操作者；负责人 / 成员按 T-EX-08 过滤；状态与列按 T-EX-14 沿用 |
+| B-14 | **权限校验** | 所有项目 / 任务接口均先校验「请求者为该项目成员」，非成员返回 403 |
+| B-15 | **偏好存储** | 视图记忆与「上次访问的项目」存设备端；列定义、列-状态绑定、列保留选项属项目配置，存服务端、项目内共享 |
+| B-16 | **看板列实体** | 列为 `BoardColumn`（name / sortOrder / boundStatus / retention）；默认 4 列由新建项目时初始化；至少保留 1 列；列名项目内唯一 |
+| B-17 | **删除列的迁移** | 删除列前需二次确认；列内任务迁移至指定列（默认相邻列），迁移后任务状态按目标列绑定重新裁决；**唯一剩余列不可删除** |
+| B-18 | **新增列默认值** | 新增列取默认值：`retention = forever`、`boundStatus = null`，**不继承**相邻列配置；`sortOrder` 追加到末尾 |
+| B-19 | **列数上限** | 至少 1 列、至多 10 列（上限待确认） |
@@ -0,0 +1,108 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>设计稿 · 视图切换移入项目栏 (T-VW-02/03 调整)</title>
+<style>
+  :root { --primary:#1677ff; --text:#333; --muted:#999; --border:#eee; }
+  * { box-sizing: border-box; margin: 0; padding: 0; font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; }
+  body { background:#eceef1; padding: 24px; display:flex; gap:28px; flex-wrap:wrap; }
+  .phone { width:375px; background:#f5f5f5; border-radius:18px; overflow:hidden; box-shadow:0 8px 30px rgba(0,0,0,.15); }
+  .phone h3 { font-size:13px; color:#556; padding:10px 14px 0; font-weight:600; }
+  .phone .cap { font-size:11px; color:#889; padding:2px 14px 10px; }
+  .bar { display:flex; align-items:center; gap:8px; padding:10px 12px; background:#fff; border-bottom:1px solid #f0f0f0; }
+  .pname { font-size:15px; font-weight:700; color:var(--text); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; min-width:0; }
+  /* 紧凑分段切换: 高 26px, 内边距收窄, 选中项白底浮起 */
+  .vseg { display:flex; background:#f2f3f5; border-radius:8px; padding:2px; flex-shrink:0; }
+  .vseg div { font-size:12px; line-height:1; padding:5px 11px; border-radius:6px; color:var(--muted); cursor:pointer; white-space:nowrap; }
+  .vseg div.on { background:#fff; color:var(--text); font-weight:600; box-shadow:0 1px 2px rgba(0,0,0,.08); }
+  .mini { font-size:11px; color:var(--primary); background:#f0f5ff; border-radius:6px; padding:5px 8px; white-space:nowrap; flex-shrink:0; cursor:pointer; }
+  .mini.solid { background:var(--primary); color:#fff; }
+  .mini.ghost { background:#fff; border:1px solid #e3e6ea; color:#666; }
+  .bar-note { font-size:10px; color:#b0b6bf; padding:6px 12px; background:#fafbfc; border-bottom:1px dashed #e5e8ec; }
+  .demo-body { padding:12px; }
+  .card { background:#fff; border-radius:9px; padding:10px 12px; margin-bottom:7px; font-size:13px; color:#444; box-shadow:0 1px 2px rgba(0,0,0,.04); display:flex; gap:8px; align-items:center; }
+  .card .dot { width:8px; height:8px; border-radius:50%; background:#c9ced6; flex-shrink:0; }
+  .cols { display:flex; gap:8px; }
+  .col { flex:1; background:#fff; border-radius:9px; padding:8px; }
+  .col b { font-size:11px; color:#556; }
+  .col .ccard { background:#f6f7f9; border-radius:6px; font-size:11px; color:#555; padding:6px; margin-top:6px; }
+  .anno { font-size:11px; color:#7a828e; padding:8px 14px 14px; line-height:1.7; background:#fafbfc; }
+  .anno b { color:#43506b; }
+</style>
+</head>
+<body>
+
+<div class="phone">
+  <h3>状态 1 · 列表视图(默认)</h3>
+  <div class="cap">切换段控放在项目名右侧, 与名称同一行</div>
+  <div class="bar">
+    <div class="pname">我的看板项目</div>
+    <div class="vseg"><div class="on">列表</div><div>看板</div></div>
+    <div class="mini">已归档</div>
+    <div class="mini ghost">管理</div>
+    <div class="mini solid">+ 新增</div>
+  </div>
+  <div class="bar-note">「项目管理」按钮文案收窄为「管理」, 与「已归档」同为次级样式, 突出右侧主操作</div>
+  <div class="demo-body">
+    <div class="card"><span class="dot"></span>梳理 V0.2 归档需求</div>
+    <div class="card"><span class="dot"></span>OTA 发布说明样式修复</div>
+    <div class="card"><span class="dot"></span>看板列滚动条位置调整</div>
+  </div>
+  <div class="anno">
+    <b>规格</b><br/>
+    · 分段控件高 26px, 选中项白底浮起(复用现有 .seg 体系收窄版)<br/>
+    · 项目名 flex:1 + 单行省略, 最短保留 4 字符<br/>
+    · 段控始终紧贴名称右侧, 距离 8px
+  </div>
+</div>
+
+<div class="phone">
+  <h3>状态 2 · 看板视图</h3>
+  <div class="cap">点「看板」后段控选中项滑换, 其余布局不变</div>
+  <div class="bar">
+    <div class="pname">我的看板项目</div>
+    <div class="vseg"><div>列表</div><div class="on">看板</div></div>
+    <div class="mini">已归档</div>
+    <div class="mini ghost">管理</div>
+    <div class="mini solid">+ 新增</div>
+  </div>
+  <div class="demo-body">
+    <div class="cols">
+      <div class="col"><b>Plan · 2</b><div class="ccard">梳理归档需求</div><div class="ccard">OTA 说明修复</div></div>
+      <div class="col"><b>Doing · 1</b><div class="ccard">滚动条调整</div></div>
+      <div class="col"><b>Done · 1</b><div class="ccard">版本方案落地</div></div>
+    </div>
+  </div>
+  <div class="anno">
+    <b>交互</b><br/>
+    · 点按即切换并持久化(设备端记忆, T-VW-02/03 不变)<br/>
+    · 切换不引发项目栏高度变化, 下方视图平滑重排<br/>
+    · 长按/拖动手势不受影响(段控独立控件, 不在卡片上)
+  </div>
+</div>
+
+<div class="phone">
+  <h3>状态 3 · 长项目名</h3>
+  <div class="cap">名称被压缩时单行省略, 段控与按钮永不换行/收缩</div>
+  <div class="bar">
+    <div class="pname">经济数据整理与策略研究-2026年第一季度重点项目</div>
+    <div class="vseg"><div class="on">列表</div><div>看板</div></div>
+    <div class="mini">已归档</div>
+    <div class="mini ghost">管理</div>
+    <div class="mini solid">+ 新增</div>
+  </div>
+  <div class="demo-body">
+    <div class="card"><span class="dot"></span>完整项目名在详情/管理页仍可见</div>
+  </div>
+  <div class="anno">
+    <b>宽度预算 (375px)</b><br/>
+    · 左右内边距 24 + 段控 90 + 已归档 48 + 管理 42 + 新增 54 + 间距 32 ≈ 290<br/>
+    · 名称可用 ≈ 85px(约 6 个汉字)起, 不足部分省略<br/>
+    · 若仍嫌拥挤, 备选:「已归档」「管理」收进 ⋯ 溢出菜单(二期可选, 本稿未采用)
+  </div>
+</div>
+
+</body>
+</html>
@@ -0,0 +1,325 @@
+# iBoard V0.2 数据库设计文档
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2 |
+| 文档状态 | 已实现（与代码一致） |
+| 数据库 | MariaDB / MySQL 8（Prisma `provider = "mysql"`） |
+| 字符集 | `utf8mb4 / utf8mb4_unicode_ci` |
+| 时区约定 | 应用层统一 `Asia/Shanghai`，库内 `DATETIME` 存 UTC |
+| 相关文件 | `prisma/schema.prisma`、`prisma/migrations/20261022120000_add_checkin_checklist/migration.sql` |
+| 关联文档 | `需求文档.md`、`设计文档.md`、`界面设计.html` |
+
+---
+
+## 1. 概述
+
+V0.2 新增「打卡 / 日历 / 清单」三个功能域，共引入 **5 张表**：
+
+| 表 | 作用 | 归属域 |
+| --- | --- | --- |
+| `Habit` | 打卡项（每天/每周/每月/每年 n 次的目标定义） | 打卡 |
+| `CheckIn` | 打卡记录（一次打卡 = 一条） | 打卡 |
+| `CheckList` | 检查清单（出差/回老家等场景的一次性清单） | 清单 |
+| `CheckListItem` | 检查项（勾选即完成） | 清单 |
+| `CheckListTemplate` | 清单模板（系统预置 + 用户自定义） | 清单 |
+
+日历视图**不新增表**：完全由 `Habit` + `CheckIn` 按月聚合得出（见 §7.3）。
+
+### 1.1 设计原则
+
+1. **记录为真，进度不落库。** 环形进度、完成率、streak 一律由 `CheckIn` 现场聚合，不在 `Habit` 上冗余 `doneCount` 字段——避免并发计数不一致、以及用户中途把「每周 3 次」改成「每周 5 次」后需要回填历史的问题。
+2. **日期以本地日历日字符串存储。** `CheckIn.date` 用 `VARCHAR(10)` 存 `"YYYY-MM-DD"`（Asia/Shanghai 下的日历日），而不是 `DATETIME`：范围查询走索引、字典序等于时间序、天然幂等边界，且彻底规避「UTC 存 + 本地读」导致的跨零点归属错误。
+3. **软删除优先。** 打卡项删除默认走 `archived` 归档（保留历史统计），只有显式 `?hard=1` 才物理删除。
+4. **一切按 `userId` 隔离。** 所有业务表都带 `userId`，`Habit`/`CheckIn`/`CheckList`/`CheckListTemplate` 外键 `ON DELETE CASCADE` 到 `User`。
+5. **迁移只增不改。** 新增需求一律新迁移文件，不修改已执行的迁移（部署走 `prisma migrate deploy`）。
+
+---
+
+## 2. 概念模型（ER）
+
+```
+                    ┌──────────┐
+                    │   User   │   (既有表, 本次仅新增反向关系)
+                    └────┬─────┘
+         ┌───────────────┼────────────────────┬─────────────────┐
+         │               │                    │                 │
+    ┌────▼────┐     ┌────▼────┐         ┌─────▼─────┐    ┌──────▼──────┐
+    │  Habit  │1───*│ CheckIn │         │ CheckList │1─* │CheckListItem│
+    └─────────┘     └─────────┘         └───────────┘    └─────────────┘
+     打卡项           打卡记录            场景清单           检查项
+    (周期+目标n)   (habitId,date,seq)                     (done, doneAt)
+                                              ▲
+                                              │ 生成(复制条目, 不建外键)
+                                        ┌─────┴──────────┐
+                                        │CheckListTemplate│
+                                        │ (builtin/自定义) │
+                                        └────────────────┘
+```
+
+基数说明：
+
+| 关系 | 基数 | 级联 |
+| --- | --- | --- |
+| User → Habit | 1 : N | Cascade |
+| User → CheckIn | 1 : N | Cascade |
+| Habit → CheckIn | 1 : N | Cascade |
+| User → CheckList | 1 : N | Cascade |
+| CheckList → CheckListItem | 1 : N | Cascade |
+| User → CheckListTemplate | 1 : N（可空，系统预置为空） | Cascade |
+| CheckListTemplate → CheckList | 无外键，创建时**复制**条目内容 | — |
+
+---
+
+## 3. 表结构
+
+### 3.1 `Habit` — 打卡项
+
+周期目标的**定义**表，不含任何计数。
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | INT PK | 否 | AUTO_INCREMENT | 主键 |
+| `userId` | INT FK | 否 | — | 所属用户 |
+| `name` | VARCHAR(191) | 否 | — | 名称，接口校验 1~20 字 |
+| `period` | VARCHAR(191) | 否 | `'day'` | `day` \| `week` \| `month` \| `year` |
+| `target` | INT | 否 | `1` | 周期内目标次数 n（校验 ≥1） |
+| `color` | VARCHAR(191) | 否 | `'#1677ff'` | 环形与标记主色（7 色预设之一） |
+| `icon` | VARCHAR(191) | 否 | `''` | emoji / 图标名，**V0.2 预留不展示** |
+| `note` | VARCHAR(191) | 否 | `''` | 备注 |
+| `archived` | BOOLEAN | 否 | `false` | 归档后不出现在待办，历史保留 |
+| `sortOrder` | INT | 否 | `0` | 排序权重（升序） |
+| `createdAt` | DATETIME(3) | 否 | now() | 用于「创建之前的日期不计入月历期望」 |
+| `updatedAt` | DATETIME(3) | 否 | 自动 | — |
+
+索引：`INDEX(userId, archived, sortOrder)` — 覆盖「取当前用户未归档打卡项」主查询。
+
+### 3.2 `CheckIn` — 打卡记录
+
+**一次打卡 = 一条记录**，同日多次用 `seq` 递增。
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | INT PK | 否 | AUTO_INCREMENT | 主键 |
+| `habitId` | INT FK | 否 | — | 所属打卡项 |
+| `userId` | INT FK | 否 | — | 冗余用户（用于单用户全量区间查询，避免 join） |
+| `date` | VARCHAR(10) | 否 | — | 本地日历日 `"YYYY-MM-DD"` |
+| `seq` | INT | 否 | `1` | 当日第几次（1..n，超额继续累加） |
+| `note` | VARCHAR(191) | 否 | `''` | 单次备注（接口截断 200 字） |
+| `source` | VARCHAR(191) | 否 | `'user'` | `user` \| `backfill`（补打） |
+| `createdAt` | DATETIME(3) | 否 | now() | 打卡时刻（UTC） |
+
+约束与索引：
+
+| 名称 | 类型 | 字段 | 作用 |
+| --- | --- | --- | --- |
+| `CheckIn_habitId_date_seq_key` | **UNIQUE** | `(habitId, date, seq)` | 并发重复提交的幂等防线（冲突 → P2002 → 409） |
+| `CheckIn_userId_date_idx` | INDEX | `(userId, date)` | 月历按月区间扫全量记录 |
+| `CheckIn_habitId_date_idx` | INDEX | `(habitId, date)` | 单打卡项周期区间聚合 |
+
+### 3.3 `CheckList` — 检查清单
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | INT PK | 否 | AUTO_INCREMENT | 主键 |
+| `userId` | INT FK | 否 | — | 所属用户 |
+| `title` | VARCHAR(191) | 否 | — | 清单名，如「出差 · 杭州」 |
+| `scene` | VARCHAR(191) | 否 | `''` | 场景：`出差` \| `回老家` \| `其他` |
+| `note` | VARCHAR(191) | 否 | `''` | 备注 |
+| `archived` | BOOLEAN | 否 | `false` | 归档 |
+| `createdAt` / `updatedAt` | DATETIME(3) | 否 | — | 列表默认按 `updatedAt` 倒序 |
+
+索引：`INDEX(userId, archived)` — 对应「进行中 / 已归档」两个分段列表。
+
+### 3.4 `CheckListItem` — 检查项
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | INT PK | 否 | AUTO_INCREMENT | 主键 |
+| `listId` | INT FK | 否 | — | 所属清单 |
+| `title` | VARCHAR(191) | 否 | — | 条目名（校验 ≤40 字） |
+| `note` | VARCHAR(191) | 否 | `''` | 条目备注 |
+| `done` | BOOLEAN | 否 | `false` | 是否已完成 |
+| `doneAt` | DATETIME(3) | **是** | NULL | 勾选时刻；取消勾选置回 NULL |
+| `sortOrder` | INT | 否 | `0` | 排序（升序，同值按 id） |
+| `createdAt` / `updatedAt` | DATETIME(3) | 否 | — | — |
+
+索引：`INDEX(listId, sortOrder)`。
+
+### 3.5 `CheckListTemplate` — 清单模板
+
+| 字段 | 类型 | 空 | 默认 | 说明 |
+| --- | --- | --- | --- | --- |
+| `id` | INT PK | 否 | AUTO_INCREMENT | 主键 |
+| `userId` | INT FK | **是** | NULL | NULL = 系统预置（`builtin=true`） |
+| `name` | VARCHAR(191) | 否 | — | 模板名 |
+| `scene` | VARCHAR(191) | 否 | `''` | 场景标签 |
+| `items` | **JSON** | 否 | — | `[{ title, note }]`，创建清单时展开为 `CheckListItem` |
+| `builtin` | BOOLEAN | 否 | `false` | 系统预置：只读、不可删（接口层限制） |
+| `createdAt` / `updatedAt` | DATETIME(3) | 否 | — | — |
+
+索引：`INDEX(userId, builtin)` — 查询条件为 `builtin=true OR userId=me`。
+
+系统预置数据（首次访问 `GET /api/checklists/templates` 时**幂等写入**）：
+
+| 模板 | 条目数 | 条目 |
+| --- | --- | --- |
+| 出差 | 11 | 身份证/证件、手机充电器+充电宝、笔记本电脑+电源、耳机、换洗衣物、洗漱包、常用药、雨伞、车票/机票/酒店确认、工牌/名片、报销单据 |
+| 回老家 | 12 | 身份证/证件、钥匙、手机充电器+充电宝、换洗衣物、洗漱包、常用药、给家人的礼物/伴手礼、长辈的药品/营养品、口罩、现金零钱、车票/加油/行程确认、家里门窗水电检查 |
+
+---
+
+## 4. 外键与级联
+
+| 子表.字段 | 父表.字段 | ON DELETE | ON UPDATE |
+| --- | --- | --- | --- |
+| `Habit.userId` | `User.id` | CASCADE | CASCADE |
+| `CheckIn.habitId` | `Habit.id` | CASCADE | CASCADE |
+| `CheckIn.userId` | `User.id` | CASCADE | CASCADE |
+| `CheckList.userId` | `User.id` | CASCADE | CASCADE |
+| `CheckListItem.listId` | `CheckList.id` | CASCADE | CASCADE |
+| `CheckListTemplate.userId` | `User.id` | CASCADE | CASCADE |
+
+删除链路：删用户 → 级联清 Habit/CheckIn/CheckList/Template；删 Habit → 清其全部 CheckIn；删 CheckList → 清其全部 Item。业务层删打卡项默认只置 `archived=true`，物理删需 `?hard=1`（此时先 `deleteMany` 记录再删主表）。
+
+---
+
+## 5. 关键设计决策
+
+### 5.1 为什么 `date` 用 `VARCHAR(10)` 而不是 `DATETIME`
+
+| 维度 | VARCHAR(10) 本地日历日 | DATETIME(UTC) |
+| --- | --- | --- |
+| 跨零点归属 | 明确：由应用层按 Asia/Shanghai 计算一次，落库即定 | 读时需要再转时区，易错 |
+| 范围查询 | `date >= '2026-10-01' AND date <= '2026-10-31'` 直接走索引 | 需函数/边界换算，易失效 |
+| 幂等边界 | `UNIQUE(habitId, date, seq)` 天然按「日」收敛 | 需按日截取 |
+| 字典序 | 等于时间序，可安全字符串比较 | — |
+| 存储 | 10 字节 | 5 字节（略优，但不足以抵消上述成本） |
+
+代价：跨时区展示需自行换算——本项目全链路 Asia/Shanghai，不成为问题。
+
+### 5.2 为什么不冗余 `doneCount` / `streak`
+
+- **并发**：计数需事务 + 行锁，聚合查询天然一致。
+- **改配置**：用户把「每周 3 次」改成「每周 5 次」，冗余计数立刻失真，需要全量重算；现方案改 `target` 立即生效。
+- **撤销**：撤销即删一条记录，无需维护计数器。
+- **成本**：单个用户打卡项数量在 10~30 量级，月历查询一次拉取整月记录（≤ 数百行）在内存聚合，开销可接受。
+
+### 5.3 `seq` 与幂等
+
+同日多次打卡用 `seq = max(seq)+1`。唯一约束 `(habitId, date, seq)` 使并发重复提交必然撞 P2002，服务端转 409「该次打卡已记录」，前端幂等收敛，不会出现「点两下加两次」的体验事故。
+
+### 5.4 归档 vs 物理删除
+
+| 操作 | 语义 | 数据影响 |
+| --- | --- | --- |
+| `DELETE /api/checkin/habits/:id` | 归档（默认） | `archived=true`，记录全保留 |
+| `DELETE /api/checkin/habits/:id?hard=1` | 物理删除 | 先删 CheckIn，再删 Habit |
+| `DELETE /api/checklists/:id` | 物理删除（一次性清单，不留历史） | 先删 Item，再删 List |
+
+理由：打卡是长期行为数据，历史构成 streak 与完成率；清单是短期事务，用完即归档/删除。
+
+### 5.5 模板用 JSON 而非明细表
+
+模板条目结构固定（`title` + `note`）、只在「创建清单」时整体读取并展开、不需要按条目检索或统计 —— 用 `JSON` 列避免额外的 `TemplateItem` 表与 join。展开后落到 `CheckListItem`，之后模板改动不影响已生成清单。
+
+---
+
+## 6. 数据量估算
+
+单用户规模假设：打卡项 20 个，平均每天打卡 25 次；清单每月 4 份，每份 12 条。
+
+| 表 | 年增量（单用户） | 行大小（约） | 年占用（约） |
+| --- | --- | --- | --- |
+| `CheckIn` | 25 × 365 ≈ 9,100 | ~80 B | ~0.7 MB |
+| `CheckListItem` | 4 × 12 × 12 = 576 | ~90 B | ~0.05 MB |
+| `Habit` / `CheckList` / `CheckListTemplate` | < 100 | ~200 B | 忽略 |
+
+结论：**无需分区、无需归档策略**。10 用户 × 5 年 ≈ 45 万行 CheckIn，仍远低于单表瓶颈。若未来接入多租户或做年视图长周期统计，再考虑按月汇总表。
+
+---
+
+## 7. 典型查询
+
+### 7.1 今日待办 + 周期进度
+
+```sql
+-- 步骤 1: 取未归档打卡项 (走 Habit_userId_archived_sortOrder_idx)
+SELECT id, name, period, target, color FROM Habit
+WHERE userId = ? AND archived = 0 ORDER BY sortOrder, id;
+
+-- 步骤 2: 取覆盖所有周期窗口的最小区间内的记录 (走 CheckIn_userId_date_idx)
+SELECT habitId, date FROM CheckIn
+WHERE userId = ? AND date >= ? AND date <= ?;   -- 如 week: '2026-10-19' ~ '2026-10-25'
+-- 步骤 3: 内存按 habitId/date 分组 -> 计算 done/percent/streak
+```
+
+### 7.2 打一次卡
+
+```sql
+SELECT MAX(seq) FROM CheckIn WHERE habitId = ? AND date = ?;   -- -> seq
+INSERT INTO CheckIn (habitId, userId, date, seq, note, source) VALUES (?, ?, ?, ?, ?, 'user');
+-- 冲突 -> P2002 -> 409
+```
+
+撤销（撤销本周期最近一次）：
+
+```sql
+SELECT id FROM CheckIn WHERE habitId = ? AND date BETWEEN ? AND ?
+ORDER BY date DESC, seq DESC LIMIT 1;
+DELETE FROM CheckIn WHERE id = ?;
+```
+
+### 7.3 月历（日历视图数据来源）
+
+```sql
+SELECT habitId, date FROM CheckIn
+WHERE userId = ? AND date >= '2026-10-01' AND date <= '2026-10-31';
+```
+
+按天聚合后与 `Habit.expectedPerDay` 比较得出日状态：
+
+| 状态 | 条件 | 展示 |
+| --- | --- | --- |
+| `full` | 全部打卡项当日次数 ≥ 日均期望 | 绿点 |
+| `over` | 有任一打卡项当日次数 > 日均期望 | 紫点 |
+| `partial` | 有完成但未全完成 | 黄点 |
+| `empty` | 无记录或当天无打卡项 | 无点 |
+
+`Habit.createdAt` 早于该日的才计入期望，避免新建打卡项把历史日期标成「未完成」。
+
+### 7.4 清单列表（带进度）
+
+```sql
+SELECT l.*, i.* FROM CheckList l
+LEFT JOIN CheckListItem i ON i.listId = l.id
+WHERE l.userId = ? AND l.archived = ?
+ORDER BY l.updatedAt DESC, i.sortOrder, i.id;
+```
+
+---
+
+## 8. 迁移
+
+| 项 | 内容 |
+| --- | --- |
+| 迁移目录 | `prisma/migrations/20261022120000_add_checkin_checklist/` |
+| 内容 | 5 张 `CREATE TABLE` + 6 条 `ADD CONSTRAINT`（见 `migration.sql`） |
+| 生成方式 | 手写 SQL（与 `prisma migrate diff` 产出格式一致），已通过 `prisma migrate deploy` 验证 |
+| 部署命令 | `npx prisma migrate deploy && npx prisma generate` |
+| 回滚 | 无自动回滚。应急：`DROP TABLE CheckIn, CheckListItem, CheckList, CheckListTemplate, Habit;`（注意外键顺序）并把 `_prisma_migrations` 中该记录删除 |
+
+>V0.2 全为新增表与新增字段（`User` 侧仅新增 Prisma 反向关系，不产生 DDL），对既有数据零影响。
+
+---
+
+## 9. V0.3 预留
+
+| 方向 | 可能的表变更 |
+| --- | --- |
+| 打卡提醒 | `Habit` 增加 `remindAt TIME`、`remindDays` |
+| 打卡统计快照 | 新增 `HabitDailyStat(userId, date, done, expected)` 汇总表，用于年视图/热力图加速 |
+| 清单共享协作 | 新增 `CheckListShare(listId, userId, role)` |
+| 模板市场 | `CheckListTemplate` 增加 `visibility`、`useCount` |
+
+以上均可通过「新增表 / 新增可空字段」完成，不影响 V0.2 数据结构。
@@ -0,0 +1,103 @@
+# 0.2.1 实施方案：PostgreSQL 迁移 + 任务模块离线编辑 (PowerSync)
+
+| 项 | 内容 |
+| --- | --- |
+| 分支 | `dev-0.2.1`（worktree `iboard-dev-0.2.1`，独立临时分支，与 master / dev-0.2 隔离） |
+| 日期 | 2026-10-25 |
+| 依据 | [PowerSync可行性研究报告](./PowerSync可行性研究报告.md)，按其 5.2.2 路线执行 |
+| 目标 | 在现网应用与数据不受影响的前提下，验证任务模块离线编辑 + 联网后自动双向同步；数据库由 MariaDB 迁移至 PostgreSQL |
+
+## 1. 已确认决策（2026-10-25 与需求方对齐）
+
+| 决策点 | 结论 |
+| --- | --- |
+| 技术路线 | PowerSync 全链路（自部署 powersync-service） |
+| 离线范围 | 仅任务模块（Project / ProjectMember / BoardColumn / Task / TaskMember / TaskTag）；打卡、清单本阶段不纳入；新闻/指标/监控等时序域仅做普通缓存 |
+| 客户端 | 先 Web / Windows 外壳（WebView2）跑通全链路；Android 真机后续验证 |
+| 编号 | 项目短前缀由用户自拟（2~8 位，全局唯一）；任务号 = 项目内自增整数，展示 `前缀-序号`；编号由服务端统一分配，离线创建的任务在同步定号前显示临时标识 |
+| 初始数据 | 从现网 MariaDB 只读快照导出并转换导入新 PG；0.2.1 期间产生的新数据不回写现网 |
+| 端口 | Web/API 13001、PowerSync WebSocket 13002、PG 仅容器内网（调试绑 127.0.0.1:15432） |
+| 部署 | 源码上传 baihu `/app/iboard-0.2.1`，服务器上 `docker compose build`；不使用原 CI/CD |
+| 现网保护 | `/app/iboard`、宿主 3306 MySQL、3001 端口、原 CI/CD 一律不使用（快照导出仅 SELECT） |
+| 磁盘 | 允许在 baihu 执行 docker 悬空镜像/构建缓存的安全清理（磁盘仅剩 9.9G） |
+
+## 2. 目标架构
+
+```
+[Web / Tauri WebView2]
+  React + @powersync/react
+  本地 WASM SQLite (OPFS 持久化)
+      │  离线: 直接读写本地库; 写操作进入 upload queue
+      │  联网: 批量 POST 上行到 Express API (按 uuid 幂等 upsert)
+      ▼
+[iboard-0.2.1 Express :13001]  ── Prisma (adapter-pg) ──┐
+  + /api/powersync/token (为登录用户签发同步 JWT)        ▼
+                                        [PostgreSQL 容器] (wal_level=logical)
+                                              ▲ 逻辑复制 (publication + replication slot)
+[powersync-service :13002] ── Sync Rules: 任务域 6 表 + User 只读引用, 按 ProjectMember 过滤
+```
+
+- 写路径：客户端本地写 → upload queue → 上行 API → Prisma 写 PG → 逻辑复制捕获 → 广播各端；
+- 读路径：任务模块页面全部改读本地 SQLite（@powersync/react 响应式查询），其余页面维持 axios REST；
+- 认证：复用现有 jsonwebtoken 体系，新增 `/api/powersync/token` 签发 PowerSync 校验的 JWT。
+
+## 3. 数据模型改造（原则：只增不改）
+
+采用报告 3.2 中的「新增 uuid 列 + 应用层幂等 upsert」选项，不做全表主键 UUID 化：外键关系全部保留，存量数据迁移风险最小。
+
+- 任务域 6 表各加 `uuid varchar(36) unique`（客户端创建时生成；存量行导入时回填）；
+- `Project` 加 `code varchar(8) unique`（用户自拟短前缀；存量项目导入时回填自动码，后续可改）；
+- `Task` 加 `number int`，`@@unique([projectId, number])`（服务端按项目 max+1 分配；离线创建的任务上行时定号，本地未定号行显示临时标识）；
+- 主键仍为自增 Int，业务外键不动；客户端上行一律以 uuid 引用父子行，服务端解析为内部 id；
+- Prisma datasource: `mysql` → `postgresql`；本分支重建基线迁移（旧 MySQL 迁移文件移除，历史保留在 git）。
+
+### 3.1 Sequential ID Mapping（落地时按官方模式补充）
+
+按 PowerSync 官方 [Sequential ID Mapping](https://docs.powersync.com/client-sdks/advanced/sequential-id-mapping) 模式实施，解决"离线新建行同步回填后本地 id 变化"问题：
+
+- 任务域 6 表再加**外键 uuid 镜像列**（`Task.projectUuid/columnUuid/parentUuid`、`BoardColumn.projectUuid`、`ProjectMember.projectUuid`、`TaskMember/TaskTag.taskUuid`），由 **PG 触发器**在写入时按 int 外键自动回填（迁移 `20261026010000_uuid_fk_mapping`），库级 NOT NULL；
+- Sync Streams 以 **`uuid` 作为客户端主键**（`SELECT "uuid" AS "id"`），镜像列别名输出回 `projectId/columnId/parentId/taskId` —— 客户端 schema 与页面代码**零改动**；
+- 服务端 upload 处理器按 uuid 解析父行（`findUnique({ where: { uuid } })`），解析后再写 int 外键 → 触发器回填镜像，两侧闭环一致；
+- 镜像列在 Prisma 模型中声明为可空（触发器保证库级非空），避免 create 校验拦截。
+
+## 4. 同步与冲突
+
+- Sync Rules 仅下发任务域 6 表 + `User`（展示名称/头像用），按 `ProjectMember.userId = auth.parameters.userId` 过滤项目可见性；时序/监控/米家等表不纳入；
+- 上行：`POST /api/powersync/upload` 批处理客户端 CRUD 操作，按 uuid 幂等 upsert，更新时以服务端时间戳做 LWW 仲裁；
+- 冲突：字段级 LWW 为主；`BoardColumn.sortOrder` / `Task.sortOrder` 由服务端重排仲裁；并发唯一冲突（项目前缀、看板列名）返回明确错误，客户端提示重试；
+- `Task.number` / `Project.code` 由服务端唯一分配，多端并发下天然无冲突。
+
+## 5. 部署拓扑（baihu `/app/iboard-0.2.1`）
+
+docker compose 三服务：
+
+| 服务 | 镜像 | 端口 | 说明 |
+| --- | --- | --- | --- |
+| `pg-021` | postgres:16-alpine | 仅容器内网 | `wal_level=logical`；数据卷 `./data/pg` |
+| `powersync-021` | powersync 官方镜像 | 13002 对外 | 连接 PG 逻辑复制 + WebSocket 下发 |
+| `app-021` | 本仓库 Dockerfile 构建 | 13001 对外 | `OTA_PUBLIC_BASE=http://bh.vps.honor3:13001` |
+
+- 环境变量由 compose 注入：`DATABASE_URL`（指向 pg-021）、`JWT_SECRET`（0.2.1 独立新设）、`PORT=13001`；
+- 0.2.1 容器内 cron/米家调度预计无凭证或产生重复外呼，部署时以环境开关关闭（实现于 M4）。
+
+## 6. 数据迁移（一次性）
+
+1. 在 baihu 上用仓库自带 `mariadb` 驱动以只读 SQL 从宿主 MySQL(3306) 导出全表 JSON（仅 SELECT）；
+2. 转换：回填 uuid / `Project.code`（按名称自动生成，可后改）/ `Task.number`（按项目内 createdAt 顺序）；时间字段转 PG 时间戳；
+3. PG 侧先 `prisma migrate deploy` 建基线表，再执行 ETL 写入；
+4. 校验：逐表行数比对 + 抽样字段比对，输出核对报告。
+
+## 7. 里程碑
+
+1. **M1** schema/适配层切 PG（本提交）：schema 字段、db.js 适配器、基线迁移重建、本地 `prisma generate` 通过；
+2. **M2** 服务端：powersync token 端点、upload 幂等上行端点、任务域路由幂等化与编号分配逻辑；
+3. **M3** 前端：任务模块数据层切 PowerSync（本地库 + useQuery + 上传队列），桌面端联调；
+4. **M4** compose 编排 + ETL 导数 + baihu 部署，端口/现网隔离验证；
+5. **M5** 离线-联网闭环验证（断网编辑 → 恢复自动同步 → 多端一致），Android 真机评估。
+
+## 8. 开放问题 / 风险
+
+- powersync-service 的元数据存储（bucket storage）对 MongoDB 的依赖需在部署阶段核实；若当前版本不支持用 PG 存元数据，则加一个 mongo 容器；
+- Android System WebView 的 OPFS/WASM SQLite 兼容性（M5 评估，先桌面）；
+- 项目前缀全局唯一在多端并发下的冲突提示体验（上行返回结构化错误码）；
+- 0.2.1 验证期数据与现网彻底隔离，不回迁；若验证后需并回主线，另行决策迁移口径。
@@ -0,0 +1,127 @@
+# 基于 PowerSync 的离线编辑可行性研究报告
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2 |
+| 日期 | 2026-10-25 |
+| 评估对象 | PowerSync（powersync.com，开源 self-hosted + 云服务） |
+| 评估目标 | 项目离线操作（本地编辑）+ 联网后自动同步 |
+| 结论（TL;DR） | **技术上可行，但落地成本高、风险中高。不建议全量接入；若确需离线，建议仅对「打卡 / 清单 / 任务」等用户编辑域做局部接入，且需要先解决 MariaDB 兼容与主键策略两个前置问题。** |
+
+---
+
+## 1. 项目现状约束（评估输入）
+
+结合代码库（`package.json`、`prisma/schema.prisma`、`server/index.js`）梳理：
+
+1. **前端**：React 18 SPA（antd-mobile），通过 axios 调 `/api/*` REST 接口；`src/api`、`src/hooks`、`src/pages` 均以"请求 → state → 渲染"模式组织，无任何本地持久化数据层。
+2. **桌面/移动端**：Tauri 2（Windows WebView2 桌面 + Android System WebView），意味着前端运行在 WebView 内，浏览器类 SDK 是候选。
+3. **后端**：Express + Prisma，数据库为 **MariaDB / MySQL**（`provider = "mysql"`）。
+4. **认证**：自签 JWT（jsonwebtoken），登录接口在 `/api/auth`。
+5. **写路径**：全部业务写操作走 REST（打卡、清单、任务模块）；同时存在大量**服务端定时写入**（cron：新闻、指标、监控、米家采样等，见 `server/cron.js`）。
+6. **数据模型**：约 25 张表，主键全部为 `Int @id @default(autoincrement())` 自增整数，多表带复合唯一约束（如 `CheckIn @@unique([habitId, date, seq])`）。
+7. **数据体量特征**：两类数据并存——
+   - **用户编辑域**（Habit / CheckIn / CheckList* / 任务模块 10 张表）：冲突敏感、离线价值高；
+   - **服务端只读时序域**（News / Indicator / ServerNodeHistory / MihomeEnv* 等）：append-only、量大、离线价值中等（缓存即可满足）。
+
+---
+
+## 2. PowerSync 是什么、怎么工作
+
+- 架构：客户端本地 **SQLite**（Web 端为 WASM SQLite，存 OPFS/IndexedDB）↔ **PowerSync Service**（self-hosted 开源组件或云服务）↔ 源数据库。服务端通过 **逻辑复制/变更流** 捕获源库写入，按 **Sync Rules** 定义的下推子集同步到每个客户端的本地 SQLite。
+- 写路径（官方推荐模式）：客户端离线写本地 SQLite → 进入 **upload queue** → 联网后由前端把变更批量 POST 到**现有后端 API** → 后端用原有方式（本项目即 Prisma）写库 → 变更流捕获 → 广播回各端。
+- 认证：客户端持后端签发的 JWT 连接同步服务；PowerSync 只做校验，不签发（可复用现有 jsonwebtoken 体系）。
+- 服务端直写的表（cron 产生）也能被变更流捕获并下推，不需要改造写入方。
+
+参考：[PowerSync Service（GitHub）](https://github.com/powersync-ja/powersync-service)、[源数据库支持](https://docs.powersync.com/configuration/source-db/setup)。
+
+---
+
+## 3. 逐项可行性分析
+
+### 3.1 数据库兼容性 —— ⚠️ 主要风险点
+
+- PowerSync 对源库支持：**PostgreSQL（GA）**、MongoDB、SQL Server；**MySQL 仍处于 Beta**（基于 binlog 复制，见 [MySQL Beta 公告](https://releases.powersync.com/announcements/mysql-backend-database-support-has-reached-beta)、[Alpha 公告](https://releases.powersync.com/announcements/announcing-mysql-as-a-source-database-alpha)）。
+- 本项目用的是 **MariaDB**。MariaDB 的 binlog 格式与 MySQL 8 有差异（GTID、行事件细节），PowerSync MySQL 插件（@powersync/mysql-zongji 系）对 MariaDB **没有官方兼容承诺，需要实测验证**，很可能踩坑。
+- **结论**：要么实测 MariaDB + MySQL-beta 通路（风险高），要么把数据库迁到 PostgreSQL（PowerSync 最成熟路径，Prisma 迁移成本可控但涉及全部表和线上数据）。这是"能不能用"的第一道门槛。
+
+### 3.2 数据模型适配 —— 改造成本大
+
+- PowerSync Sync Rules 要求同步表有稳定的行标识，**强烈建议 UUID 文本主键**；而本项目全部是自增整数主键，且客户端离线创建记录时无法预知自增 id。
+- 离线创建的通用解法：主键改为客户端生成的 UUID（`char(36)`），或新增 `uuid` 列 + 应用层幂等 upsert。对用户编辑域的 10 余张表意味着**一次不小的 schema 迁移 + 全部相关路由改造**（迁移原则"只增不改"仍可遵守，但外键列类型变更工作量大）。
+- `DateTime`、`Json` 类型可映射（客户端以 ISO 文本/JSON 文本存储），但 `BigInt`（监控表）在 JS 端需按文本处理，注意精度。
+- 复合唯一约束（`CheckIn(habitId,date,seq)`、`BoardColumn(projectId,name)` 等）在离线多端并发下会冲突，需在 upload 处理端路由里做服务端仲裁（如 seq 重排、重名加后缀），现有路由大多不具备幂等/仲裁语义。
+
+### 3.3 写路径（离线编辑 + 上行同步）—— 模式契合，但需逐路由改造
+
+- PowerSync 的 upload-queue → 后端 API 模式与现有 Express 架构**天然契合**：不需要后端暴露直接写库的通口，各业务路由补成"接收客户端 UUID + 幂等 upsert"即可。
+- 打卡/清单/任务的路由数量约 3 个 router 文件（checkin / checklists / projects / tasks），逐个改造为幂等是可控的。
+- 服务端 cron 写入的表（新闻/指标/监控/米家）无需改造写入方，只需在 Sync Rules 里定义是否下推。
+
+### 3.4 读路径与前端数据层 —— 全面前重写
+
+这是**工作量最大**的部分：
+
+- 现有 `src/api` + axios + useEffect 模式必须替换为 PowerSync 本地 SQLite 查询 + `@powersync/react` 的响应式 hooks（useQuery 等），否则离线读不到数据。
+- 涉及 `src/pages` 下全部用户编辑域页面（checkin、task），以及若要离线浏览还需覆盖 news/macro/monitor 的只读缓存页。
+- 工作量量级：相当于把前端数据层重构一遍；可与"离线只读缓存（HTTP 缓存）"分层实施以降低风险。
+
+### 3.5 客户端运行环境 —— 大体可行，Android 需验证
+
+- **浏览器 / Tauri 桌面（WebView2）**：PowerSync Web SDK（WASM SQLite + OPFS）在 Chromium 系 WebView 已被官方支持，可行。
+- **Tauri Android（System WebView）**：WASM SQLite 性能与 OPFS 在部分国产/旧版 WebView 上存在兼容性风险，需真机验证；备选方案是封装原生 SQLite（官方 Capacitor 插件思路可借鉴，但 Tauri 无官方插件，需自研 Rust 命令桥接，成本额外增加）。
+- 时序大表（ServerNodeHistory 每分钟一条、MihomeEnv*）不建议纳入同步——Sync Rules 需做时间窗过滤（如仅近 7 天），否则客户端存储和同步流量都会失控。
+
+### 3.6 认证与部署 —— 可行
+
+- JWT 可复用：新增一个 `/api/powersync/token` 端点为已登录用户签发 PowerSync 接受的 token，改造小。
+- 部署：self-hosted 需在现有 Express 之外多跑一个 powersync-service 进程（含 Mongo 存储元数据或云实例），并暴露 WebSocket 端口；或使用 PowerSync Cloud。运维面增加一个组件。
+
+### 3.7 冲突解决
+
+- PowerSync 本身不做自动合并，只提供上传队列与冲突回调；对"最后写入胜出"友好的字段（清单勾选、任务标题/状态）默认策略够用；对 `CheckIn.seq`、`BoardColumn.sortOrder` 这类"位置/序号型"数据需要自定义仲裁逻辑（上传端或同步流中处理），设计上可解，但要专门做。
+
+---
+
+## 4. 风险与成本汇总
+
+| # | 风险/成本项 | 等级 | 说明 |
+| --- | --- | --- | --- |
+| 1 | MariaDB 兼容性未验证，MySQL 支持仅 Beta | 高 | 很可能需要迁移 PostgreSQL |
+| 2 | 前端数据层全面重构（axios → 本地 SQLite 查询） | 高 | 涉及所有相关页面 |
+| 3 | 用户编辑域主键整数自增 → UUID 迁移 | 中高 | schema + 路由幂等改造 |
+| 4 | 复合唯一约束的离线冲突仲裁 | 中 | CheckIn.seq、列名、排序等 |
+| 5 | Android WebView WASM SQLite/OPFS 兼容 | 中 | 需真机验证 |
+| 6 | 新增 self-hosted 组件的运维 | 中 | 多一个常驻服务 |
+| 7 | 时序大表同步范围控制 | 低 | Sync Rules 时间窗过滤即可 |
+
+对照收益：真正需要离线**编辑**的只有打卡 / 清单 / 任务三个域（数据量小、单用户为主、冲突场景有限）；其余域离线**只读缓存**即可满足。
+
+---
+
+## 5. 结论与建议
+
+### 5.1 结论
+
+**可行，但不建议以"全项目接入 PowerSync"的方式落地。** PowerSync 的同步模型与项目的 Express API 写路径契合、认证可复用、桌面端可行；但 MariaDB/MySQL-beta 兼容、整数自增主键、前端数据层全面重构三座大山使总成本明显高于当前阶段的收益。
+
+### 5.2 建议（按优先序）
+
+1. **首选（低成本方案）**：不引入 PowerSync，为用户编辑域实现轻量离线队列——前端把写请求落到 localStorage/IndexedDB 待发队列（含客户端生成的 UUID），联网后重放到现有 REST API（路由补幂等 upsert）；只读页用 HTTP 缓存 + SW。可覆盖约 80% 的离线诉求，改动局限在 `src/api` 层与少量路由。
+2. **若决定采用 PowerSync**：
+   - 前置 1：源库迁移 PostgreSQL（避开 MySQL Beta + MariaDB 兼容雷区）；
+   - 前置 2：仅将用户编辑域（Habit/CheckIn/CheckList*/任务模块）纳入 Sync Rules，时序与监控表排除或做时间窗过滤；
+   - 前置 3：这些表的主键/唯一标识改造为客户端可生成的 UUID；
+   - 分阶段：先桌面端（WebView2）验证全链路，再攻 Android WebView 兼容性；
+   - 冲突策略：字段级 LWW 为主，seq/sortOrder 类服务端仲裁。
+3. **不建议**：为离线只读域（新闻/指标/监控）上 PowerSync——用简单缓存即可，同步引擎属于过度设计。
+
+---
+
+## 6. 参考资料
+
+- [PowerSync Service（GitHub，self-hosted 开源）](https://github.com/powersync-ja/powersync-service)
+- [PowerSync 源数据库配置文档](https://docs.powersync.com/configuration/source-db/setup)
+- [MySQL 后端支持 Beta 公告](https://releases.powersync.com/announcements/mysql-backend-database-support-has-reached-beta)
+- [MySQL 后端支持 Alpha 公告](https://releases.powersync.com/announcements/announcing-mysql-as-a-source-database-alpha)
+- 本项目：`prisma/schema.prisma`、`server/index.js`、`docs/V0.2/数据库设计文档.md`、`docs/V0.2/任务模块/任务模块数据库设计文档.md`
@@ -0,0 +1,516 @@
+# iBoard V0.2 设计文档 — 打卡 / 日历 / 清单
+
+| 项 | 内容 |
+| --- | --- |
+| 版本 | V0.2（对应分支 `dev-0.2`，应用版本 `0.2.0`） |
+| 文档状态 | 已实现（与代码一致；含 2026-10-22 设计变更，见 §10） |
+| 上游文档 | `需求文档.md`（需求编号 F-CK / F-CL / F-LS / F-SY / U / D / N / E 沿用本文） |
+| 配套文档 | `数据库设计文档.md`、`界面设计.html` |
+| 技术栈 | Tauri 2 + React 18 + antd-mobile + React Router v6 + Express 4 + Prisma/MariaDB |
+| 设计基线 | 移动端优先，视口 420×820，375~430px 自适应；时区统一 `Asia/Shanghai` |
+
+---
+
+## 1. 总体设计
+
+### 1.1 目标与范围
+
+在既有 iBoard 之上**新增「打卡」模块并升为默认首页**（底部 Tab 由 5 个精简为 4 个：打卡 / 宏观 / 监控 / 我），页面内以三个子视图承载三类需求：
+
+| 子视图 | 解决问题 | 核心隐喻 |
+| --- | --- | --- |
+| **打卡** | 周期性习惯的量化坚持 | 环形进度，点环即打卡 |
+| **日历** | 回看昨天、执行今天、预知明天 | 月历网格 + 日状态点 |
+| **清单** | 出差/回老家等一次性场景的漏项检查 | 勾选清单 + 进度条 |
+
+> **Tab 结构（V0.2 终态）**
+>
+> | 顺序 | Tab | 路由 | 说明 |
+> | --- | --- | --- | --- |
+> | 1 | **打卡（默认）** | `/checkin` | 根路径 `/` 重定向到此；`/checkin` 内含 打卡/日历/清单 三视图 |
+> | 2 | 宏观 | `/macro/*` | 油价 / 经济数据 / 策略研究 / 经济文章 / **报警** / **新闻**（后两者由原「首页」并入） |
+> | 3 | 监控 | `/monitor` | 服务器 + 米家环境 |
+> | 4 | 我 | `/me` | 用户信息 + 前端 OTA 升级 |
+>
+> 原「首页」Tab 已移除：其中的**报警**、**新闻** 两个模块并入宏观，作为其第 5、6 个子 Tab（`/macro/alerts`、`/macro/news`），新闻详情改为 `/macro/news/:id` 以保持宏观 Tab 高亮。
+
+**不纳入 V0.2**：多用户共享清单、提醒推送、数据导出、打卡项分组、年视图热力图（见 §9 演进）。
+
+### 1.2 架构总览
+
+```
+┌──────────────────────── 前端 (React + antd-mobile, 打包进 Tauri / OTA) ────────────────────────┐
+│  App.jsx 路由 (默认 / → /checkin)                                                               │
+│    └ /checkin  ──► CheckinPage ── SwipeTabs ──┬── HabitView    (打卡)                           │
+│                                              ├── CalendarView (日历)                           │
+│                                              └── ListView     (清单)                           │
+│    └ /macro/*  ──► MacroPage ── 油价/经济数据/策略研究/经济文章/报警/新闻                        │
+│  组件: RingProgress(环形) / Celebrate(特效, 恒开) / BottomNav / TabIcon                          │
+│  工具: src/pages/checkin/date.js (本地日期, 与后端同口径)  apiClient: src/api/checkin.js         │
+└──────────────────────────────────┬─────────────────────────────────────────────────────────────┘
+                                   │ HTTPS + JWT (Authorization: Bearer)
+┌──────────────────────────────────▼─────────────────────────────────────────────────────────────┐
+│ Express (server/index.js)                                                                      │
+│   /api/checkin   ─► routes/checkin.js    ─┐                                                    │
+│   /api/checklists─► routes/checklists.js ─┤─► middleware.authRequired ─► Prisma Client          │
+│                                           └─► checkin/period.js (周期口径唯一来源)               │
+└──────────────────────────────────┬─────────────────────────────────────────────────────────────┘
+                                   ▼
+                      MariaDB: Habit / CheckIn / CheckList / CheckListItem / CheckListTemplate
+```
+
+### 1.3 分层与职责
+
+| 层 | 位置 | 职责 |
+| --- | --- | --- |
+| 页面 | `src/pages/checkin/*.jsx` | 视图编排、本地状态、乐观更新与回滚 |
+| 组件 | `src/components/RingProgress.jsx` | 纯展示：SVG 环形 + 完成特效（恒开，无开关） |
+| 日期工具 | `src/pages/checkin/date.js` | 与后端同口径的本地日期运算（**改一处需同步另一处**） |
+| API 封装 | `src/api/checkin.js` | 统一走 `api()`（自带 token / 错误解析） |
+| 路由 | `server/routes/checkin.js`、`checklists.js` | 参数校验、鉴权、组装展示态 |
+| 领域逻辑 | `server/checkin/period.js` | 周期窗口、日均期望、streak 判定 |
+| 持久化 | Prisma Client（`generated/prisma`） | 表操作 |
+
+### 1.4 目录结构（本次新增/修改）
+
+```
+prisma/
+  schema.prisma                                     # +5 个 model，User 加反向关系
+  migrations/20261022120000_add_checkin_checklist/  # 新建表 + 外键
+server/
+  checkin/period.js                                 # 周期计算（唯一口径）
+  routes/checkin.js                                 # /api/checkin/*
+  routes/checklists.js                              # /api/checklists/*
+  index.js                                          # 挂载两个路由
+src/
+  api/checkin.js                                    # checkinApi / checklistApi
+  api/ota.js                                        # OTA 封装 + 判新模式(version/sequence)
+  utils/version.js                                  # 版本号字段比较(纯函数, 可单测)
+  utils/format.js                                   # 日期格式化
+  components/RingProgress.jsx                       # 环形进度 + Celebrate 特效
+  components/BottomNav.jsx                          # Tab: 打卡(默认)/宏观/监控/我
+  components/TabIcon.jsx                            # 图标集(移除 home)
+  pages/checkin/CheckinPage.jsx                     # 容器：三视图切换
+  pages/checkin/HabitView.jsx                       # 打卡视图
+  pages/checkin/CalendarView.jsx                    # 日历视图
+  pages/checkin/ListView.jsx                        # 清单视图
+  pages/checkin/date.js                             # 前端日期工具
+  pages/MacroPage.jsx                               # 宏观: 6 个子 Tab(含报警/新闻)
+  pages/macro/AlertsView.jsx                        # 报警(原首页)
+  pages/macro/NewsView.jsx                          # 新闻(原首页)
+  pages/MePage.jsx                                  # 我: OTA 组内「开发版本」开关
+  App.jsx                                           # / → /checkin; /macro/*; 移除 /news/:id
+  styles/globals.css                                # 打卡相关样式段
+scripts/ci/check-version.mjs                        # CI: 校验分支名 ↔ package.json 版本
+docs/V0.2/                                          # 需求 / 设计 / 数据库设计 / 界面设计
+```
+
+---
+
+## 2. 领域模型与核心口径
+
+### 2.1 实体
+
+`Habit`（打卡项定义）· `CheckIn`（一次打卡）· `CheckList`（场景清单）· `CheckListItem`（检查项）· `CheckListTemplate`（模板）。字段与索引见《数据库设计文档》。
+
+### 2.2 周期口径（唯一来源：`server/checkin/period.js`）
+
+| 概念 | 定义 |
+| --- | --- |
+| 本地日历日 | `Intl.DateTimeFormat('en-CA', { timeZone: 'Asia/Shanghai' })` → `"YYYY-MM-DD"` |
+| 周起始 | **周一**（`startOfWeek` 把周日映射到第 7 天） |
+| 周期窗口 | day = [d, d]；week = [周一, 周日]；month = [1 号, 月末]；year = [1/1, 12/31] |
+| **环形进度** | `percent = 周期内累计次数 / n`，上限 1 —— 回答「这周期做了多少」 |
+| **日均期望次数** | day→n；week→`ceil(n/7)`；month→`ceil(n/当月天数)`；year→`ceil(n/365)` —— 回答「今天该做多少」 |
+| 完成 | `done >= target`（超额允许，`over = done - target` 继续累加） |
+| streak | 从当前周期向前回溯：达标 +1；**当前周期未结束且未达标 → 跳过而非中断**；已结束周期未达标 → 终止 |
+
+>两种口径并存是有意为之：环形看「周期整体」，日历日标记看「当天份额」。例如「每周 3 次」，周三打 1 次 → 环形 33.3%，当天已达标（1 ≥ ceil(3/7)=1）。
+
+### 2.3 边界规则
+
+| 场景 | 规则 | 编号 |
+| --- | --- | --- |
+| 提前打卡（未来日期） | 拒绝，返回 400「不能为未来日期打卡」 | F-CK-11 |
+| 补打 | 仅限最近 **7 天**，记录 `source='backfill'` | F-CK-10 |
+| 跨零点 | 以服务端 Asia/Shanghai 日历日为准，前端不自行判断 | E-02 |
+| 周期中途新建 | 按完整 n 计算，不按剩余天数折算 | E-01 |
+| 编辑 `target` | 立即生效，历史记录不改动 | F-CK-13 |
+| 删除打卡项 | 默认归档（`archived=true`），`?hard=1` 物理删并清记录 | E-05 |
+| 清单删除 | 物理删（一次性场景不留历史） | F-LS-10 |
+
+---
+
+## 3. 前端设计
+
+### 3.1 路由与容器
+
+```
+底部 Tab (BottomNav)  打卡(默认) ─ 宏观 ─ 监控 ─ 我
+  /                → <Navigate to="/checkin" replace />
+/checkin  →  CheckinPage
+               ├─ NavBar「打卡」
+               └─ SwipeTabs（左右滑动切换，与既有模块交互一致）
+                    ├─ habit    → HabitView    （受 date 影响）
+                    ├─ calendar → CalendarView （持有选中 date，可回写容器）
+                    └─ list     → ListView     （独立）
+/macro/*  →  MacroPage （油价 / 经济数据 / 策略研究 / 经济文章 / 报警 / 新闻）
+```
+
+`activeKeyFromPath()` 对未匹配路径兜底返回**第一个 Tab（`/checkin`）**，与默认路由保持一致。
+
+`date` 状态提升到 `CheckinPage`：日历里点某天 → 切回打卡视图时即为该日，实现「日历与打卡联动」。
+
+### 3.2 组件树与关键状态
+
+```
+CheckinPage
+├── useState: active('habit'|'calendar'|'list'), date('YYYY-MM-DD')
+HabitView(date)
+├── data: { today, date, items[], summary:{total,done} }
+├── bursts: { habitId: n }        // 特效触发计数（+1 即播放一次）
+└── form / showForm               // 新建/编辑弹窗
+CalendarView(date, onDateChange)
+├── month, cal(月历), detail(当日), bursts
+└── quickValue: -1|0|1|null       // 昨天/今天/明天 分段控件
+ListView()
+├── archived, lists, openId(展开的清单), newItem, templates, form/showForm
+└── bursts
+```
+
+统一约定：
+- 加载中 → `DotLoading`；错误 → `error-banner` + 重试；空 → antd-mobile `Empty` + 引导按钮（三态齐全，U-06）。
+- 页面重新可见时静默刷新（`useRefreshOnVisible`），与既有模块一致。
+
+### 3.3 环形进度组件 `RingProgress`
+
+| 项 | 设计 |
+| --- | --- |
+| 实现 | 双 `<circle>`：灰底环 + `stroke-dasharray/dashoffset` 进度环，`rotate(-90)` 从 12 点顺时针 |
+| 尺寸 | `size=58`，`stroke=6`，`r=26`，周长 `2πr≈163.4` |
+| 动画 | `transition: stroke-dashoffset .45s cubic-bezier(.4,0,.2,1)`（400ms 级，U-01） |
+| 中心内容 | 未达标 → `done / target` 数字；**达标 → 对勾 SVG**（`ring-check-in` 缩放入场）；超额 → 右上角 `+n` 徽标 |
+| 交互 | 整个环可点 = 打卡（`clickable`），同时卡片右侧保留显式「打卡」按钮，降低发现成本 |
+| 无障碍/降级 | `disabled` 态半透明；**完成特效恒开**（V0.2 设计变更：取消页面内特效开关，无任何关闭入口） |
+
+**完成特效 `Celebrate`**（F-CK-07 / U-02）：`fire` 计数器 +1 即触发一次 → 14 个粒子沿圆周角度扩散（`--a/--d` CSS 变量）+ 主色光环脉冲 0.7s，总时长 ≤900ms，`pointer-events:none` 不阻塞后续操作；同时 `navigator.vibrate(18)` 轻震动（U-03）。**特效永远播放**，不再读 `localStorage.iboard_celebrate`，也不再响应 `prefers-reduced-motion` 关闭（用户明确要求「特效永远打开」）。
+
+### 3.4 交互清单
+
+| 视图 | 主要交互 |
+| --- | --- |
+| 打卡 | 点环/点按钮打卡（乐观更新，失败回滚 + Toast）、撤销、编辑、归档、新建弹窗（名称/周期/目标次数/颜色/备注） |
+| 日历 | 月份左右切换、回到今天、「昨天/今天/明天」分段切换、点日期选中、当日详情内打卡（未来日期只读显示「计划」）、本月完成率 |
+| 清单 | 进行中/已归档切换、展开/收起、逐条勾选、添加检查项、全选/全不选、复制、存为模板、归档/恢复、删除、从模板新建 |
+
+排序：打卡项列表**未完成在前**（F-CK-16）；清单按 `updatedAt` 倒序。
+
+### 3.5 视觉规范
+
+| 类别 | 取值 |
+| --- | --- |
+| 主色 | `#1677ff`；成功 `#00b578`；警告/部分 `#ffc53d`；超额 `#a855f7`；危险 `#ff3141` |
+| 背景 / 卡片 | `#f5f5f5` / `#ffffff`，卡片 `radius 10px` + `0 1px 2px rgba(0,0,0,.04)` |
+| 文字 | 主 `#333`、次 `#666`、弱 `#999` |
+| 日历日状态点 | full 绿 / partial 黄 / over 紫 / empty 无 |
+| 打卡项预设色 | `#1677ff #00b578 #ff8f1f #ff3141 #a855f7 #14b8a6 #f43f9e` |
+
+完整高保真稿见 `界面设计.html`。
+
+---
+
+## 4. 后端设计
+
+### 4.1 通用约定
+
+- 两个路由文件首行 `router.use(authRequired)`，**全部接口需登录**；用户维度一律取 `req.user.sub`，不信任 body 中的 `userId`。
+- 响应统一 `{ item }` / `{ items }` / `{ ok }`；错误统一 `{ error: '中文提示' }` + 语义化状态码。
+- 展示态（percent / completed / streak / dayDone …）由服务端计算后下发，前端不做二次口径推导，避免两端不一致。
+
+### 4.2 接口清单
+
+#### 打卡 `/api/checkin`
+
+| 方法 | 路径 | 说明 | 关键响应字段 |
+| --- | --- | --- | --- |
+| GET | `/habits?date=` | 指定日待办 + 周期进度 | `items[]`（含 `done/target/percent/completed/over/streak/expectedPerDay/periodStart,End`）、`summary` |
+| POST | `/habits` | 新建打卡项 | `item` |
+| PUT | `/habits/:id` | 编辑（名称/周期/目标/颜色/备注/归档/排序） | `item` |
+| DELETE | `/habits/:id?hard=1` | 默认归档；`hard=1` 物理删 | `{ ok, removed }` |
+| POST | `/habits/:id/check` | 打一次卡（`{ date?, note? }`） | `item`（最新展示态） |
+| DELETE | `/habits/:id/check?date=` | 撤销本周期最近一次 | `item` |
+| GET | `/day?date=` | 某日每个打卡项明细 | `items[]`（含 `canCheck`）、`isToday`、`isFuture` |
+| GET | `/calendar?month=YYYY-MM` | 月历 + 完成率 | `days[]`（`status/expected/actual/isToday/isFuture/habits[]`）、`rate`、`habits[]` |
+
+#### 清单 `/api/checklists`
+
+| 方法 | 路径 | 说明 |
+| --- | --- | --- |
+| GET | `/?archived=0|1` | 清单列表（带 `done/total/percent/completed`） |
+| POST | `/` | 新建（`{ title, scene, note?, items?, templateId? }`） |
+| GET | `/:id` | 单条详情 |
+| PUT | `/:id` | 改名称/场景/备注/归档 |
+| DELETE | `/:id` | 物理删除（连带检查项） |
+| POST | `/:id/duplicate` | 复制为新清单（勾选状态重置） |
+| POST | `/:id/items` | 新增检查项 |
+| PUT | `/items/:id` | 改标题/备注/勾选（`done` 变更时写 `doneAt`） |
+| DELETE | `/items/:id` | 删除检查项 |
+| POST | `/:id/check-all` | 一键全选/全不选（`{ done }`） |
+| GET | `/templates` | 模板列表（含系统预置，首次访问幂等写入） |
+| POST | `/templates` | 另存为模板 |
+| DELETE | `/templates/:id` | 删除**自建**模板（预置模板拒绝） |
+
+### 4.3 关键流程：打卡
+
+```
+用户点环
+  │
+  ├─ 前端: 本地 +1，重算 percent/completed/over（乐观更新）
+  │
+  └─ POST /api/checkin/habits/:id/check
+        ├─ 校验 habit 归属 → 404
+        ├─ date > today → 400 不能为未来日期打卡
+        ├─ date < today-7 → 400 最多只能补打最近 7 天
+        ├─ seq = max(seq)+1 → insert
+        │    └─ P2002 → 409 该次打卡已记录（幂等）
+        └─ 返回最新 item
+              │
+              ├─ 成功: 用服务端 item 覆盖本地；若 completed → fire 特效
+              └─ 失败: setData(before) 回滚 + Toast
+```
+
+### 4.4 关键流程：月历聚合
+
+1. 取全部 Habit（含归档）→ 过滤 `archived=false` 得 `active`。
+2. 一次查询当月 `[01, 月末]` 全部 CheckIn，按 `habitId → date → count` 分组。
+3. 逐日遍历：仅统计 `Habit.createdAt <= 该日` 的项；累加 `expected += expectedPerDay(...)`、`actual += min(count, expected)`；任一 `count > expected` 记 `over`。
+4. `status`：全完成且无超额 → `full`；全完成且有超额 → `over`；有完成未全完成 → `partial`；否则 `empty`。
+5. 完成率 `rate = Σactual / Σexpected`（**只统计非未来日期**）。
+
+复杂度：`O(天数 × 打卡项数)`，30×20=600 次内存运算，无 N+1 查询。
+
+### 4.5 校验与错误码
+
+| 状态码 | 场景 |
+| --- | --- |
+| 400 | 名称为空/超长、周期非法、target < 1、未来日期打卡、超出补打窗口、本周期无记录可撤销、模板缺条目 |
+| 404 | 资源不存在或不属于当前用户 |
+| 409 | 并发重复打卡（P2002） |
+| 401 | 未登录 / token 失效（`authRequired`） |
+
+所有写操作均用 `prisma.xxx.findFirst({ where: { id, userId } })` 或 `where: { id, list: { userId } }` 做归属校验，杜绝越权改他人数据。
+
+---
+
+## 5. 非功能设计
+
+| 维度 | 设计 |
+| --- | --- |
+| 首屏 | 三视图懒切换，只有激活视图发请求；单视图首屏 ≤ 1 次列表请求（N-01） |
+| 弱网/失败 | 乐观更新 + 失败回滚 + Toast；错误横幅带重试；`useRefreshOnVisible` 静默刷新 |
+| 幂等 | 唯一约束 `(habitId, date, seq)` + 前端按钮 loading，防连点重复计次 |
+| 时区 | 全链路 Asia/Shanghai；库内 `DATETIME` 存 UTC，业务日期用 `VARCHAR(10)` 本地日历日 |
+| 兼容 | 375~430px 自适应；Tauri Android WebView 支持 `navigator.vibrate`，不支持时静默跳过 |
+| 性能 | 月历/周期统计均为「一次范围查询 + 内存聚合」，避免逐项查询 |
+| 安全 | 全接口 `authRequired`；输入长度截断（名称 20、检查项 40、备注 200）；无 SQL 拼接（Prisma 参数化） |
+| 可维护 | 周期口径单点（`server/checkin/period.js`），前端 `date.js` 与之对齐，改动需同步两处（已在文档与注释中标注） |
+
+---
+
+## 6. 测试与验证
+
+| 层级 | 内容 | 结果 |
+| --- | --- | --- |
+| 单元 | 周期工具 23 条断言（窗口边界、周一起始、月末、闰年、日均期望、streak 跳过未结束周期） | 全通过 |
+| 单元 | 版本比较 10 条断言（`-ota` 后缀、`v` 前缀、缺位补 0、`0.10 > 0.9`、`beta.3 < beta.10`、空串） | 全通过 |
+| 接口冒烟 | 自签 JWT 端到端：每天 1 次闭合、每周 3 次 33.3%、超额 +1、撤销归零、未来日期 400、月历 31 天、模板生成 11 项、全选完成、复制重置 | 全通过，测试数据已清理 |
+| 构建 | `npm run build` | 通过 |
+| 迁移 | `prisma migrate deploy` 到目标库 | 成功 |
+
+---
+
+## 7. 里程碑（对应需求文档 M1~M5）
+
+| 里程碑 | 内容 | 状态 |
+| --- | --- | --- |
+| M1 | 数据模型 + 迁移 + 周期模块 + 全部后端接口 | 完成 |
+| M2 | 打卡视图：环形进度、特效、撤销/补打、新建编辑 | 完成 |
+| M3 | 日历视图：月历 + 昨天/今天/明天 + 完成率 | 完成 |
+| M4 | 清单视图：CRUD、勾选、进度、模板复用 | 完成 |
+| M5 | 文档（需求/设计/数据库/界面）+ 构建校验 + 提交 | 完成 |
+
+---
+
+## 8. 风险与权衡
+
+| 项 | 权衡 | 缓解 |
+| --- | --- | --- |
+| 周期口径前后端各实现一份 | 前端需离线即时反馈，不能等接口 | 两端算法同源同注释；口径变更必须同步 `period.js` 与 `date.js`（已写入项目记忆） |
+| 进度实时聚合而非冗余计数 | 换取一致性与配置即时生效，牺牲少量 CPU | 单用户数据量极小（月历 30 天 × 20 项），实测无感；V0.3 可加汇总表 |
+| 未来日期禁止打卡 | 防止「提前打完一周」刷进度，符合「日历看明天=计划」语义 | 明天视图只读展示「计划」，明确文案 |
+| 特效恒开可能打扰 | 用户明确要求「特效永远打开」，不再提供开关 | 单次特效 ≤900ms 且 `pointer-events:none`，不影响连续打卡；若后续需要再评估恢复开关 |
+| Tab 调整为 4 个（打卡置左并默认） | 首页被取消，报警/新闻并入宏观后宏观有 6 个子 Tab | 子 Tab 可横向滚动；报警角标保留在子 Tab 上；底部 4 项在 375px 下热区充足（≥44px） |
+
+---
+
+## 9. 后续演进（V0.3+）
+
+1. **提醒与通知**：`Habit.remindAt` + Tauri 本地通知，解决「忘打卡」。
+2. **补打放宽 / 历史编辑**：当前 7 天限制可配置化。
+3. **统计视图**：连续天数榜单、月/年热力图（届时引入 `HabitDailyStat` 汇总表）。
+4. **打卡项分组与排序拖拽**：现有 `sortOrder` 已预留，仅需交互。
+5. **清单协作/分享**：引入 `CheckListShare`。
+6. **数据导出**：清单完成后导出为图片或文本（便于发群里确认）。
+
+---
+
+## 10. 设计变更记录（2026-10-22）
+
+### 10.1 变更清单
+
+| # | 类型 | 变更 | 影响文件 |
+| --- | --- | --- | --- |
+| 1 | Bug | OTA 包版本与分支不对应：`dev-0.2` 上仍是 `0.1.0` → OTA 报成 `0.1.0-ota`。统一升到 `0.2.0`，OTA 包变为 **`0.2.0-ota`**，并加 CI 强校验 | `package.json`、`src-tauri/tauri.conf.json`、`src-tauri/Cargo.toml`、`Cargo.lock`、`scripts/ci/check-version.mjs`、`docker-build.yml` |
+| 2 | 功能 | 我的页 OTA 组新增**「开发版本」Switch**（默认关），切换判新口径：开=`build sequence`，关=版本号字段比较；开关值持久化在设备端 | `src/api/ota.js`、`src/utils/version.js`、`src/pages/MePage.jsx` |
+| 3 | 设计 | 打卡 Tab 移到**最左边并默认选中**；打卡页移除**特效开关**，特效永远打开 | `BottomNav.jsx`、`App.jsx`、`TabIcon.jsx`、`HabitView.jsx`、`RingProgress.jsx`、`globals.css` |
+| 4 | 设计 | 取消「首页」Tab，其**报警 / 新闻**并入宏观，成为宏观的第 5、6 个子 Tab | `MacroPage.jsx`、新增 `macro/AlertsView.jsx`、`macro/NewsView.jsx`、删除 `HomePage.jsx` |
+
+### 10.2 版本号为什么必须跟分支走
+
+`scripts/build-ota.mjs` 里 `manifest.version = package.json.version + '-ota'`，也就是**版本号的唯一来源仍是 `package.json`**。
+分支按版本命名（`dev-0.2`），但版本号是手工改的，一旦忘改就会出现「分支 0.2、包版本 0.1」的错位，客户端判新逻辑全部失准。
+
+**同一版本号的两种产物写法**（2026-10-22 补充确认）：
+
+```
+分支 dev-0.2  →  0.2.0
+                 ├─ APK / 桌面安装包  0.2.0       裸版本号，无后缀
+                 ├─ 前端运行时        0.2.0       裸版本号，无后缀
+                 └─ OTA 热更包        0.2.0-ota   多一个 -ota 标记
+```
+
+即 APK 与 OTA 的版本主体完全一致，唯一差别是 OTA 多 `-ota` 后缀；`package.json` 只写裸版本号，后缀由打包脚本追加。
+
+| 环节 | 取值 | 现状 |
+| --- | --- | --- |
+| `package.json` `version` | `0.2.0` | 唯一手动管理点，**不得带 `-ota`** |
+| `src-tauri/tauri.conf.json` `version` | `0.2.0` | 决定 **APK `versionName`**（经 `tauri android init` 写入 `tauri.properties`）与桌面包版本 |
+| `src-tauri/Cargo.toml` / `Cargo.lock` | `0.2.0` | Rust 包版本，与上两者保持一致 |
+| OTA `latest.json.version` | `0.2.0-ota` | 打包脚本自动拼 `-ota` 后缀 |
+| `src/version.js` `APP_VERSION` | `0.2.0` | 前端展示与版本比较的基准 |
+| APK `versionCode` | `2000` | `major*1000000 + minor*1000 + patch`，必须单调递增才能覆盖安装（`0.1.0` = 1000） |
+| OTA `latest.json.min_binary_version` | `0.1.0` | **与前端版本解耦**：前端 bundle 要求的最低原生二进制版本。现有 APK 原生层仍是 0.1.0，跟着抬会导致旧 APK 收不到更新，CI 固定传 `--min-binary 0.1.0` |
+| CI 守卫 | `scripts/ci/check-version.mjs` | ① 四处版本必须完全相等且不含 `-ota`（`main`/`master` 也查）；② 从 `GITHUB_REF_NAME` 解析 `dev-<major>.<minor>`，要求 `version` 以该前缀开头；任一不满足**构建直接失败**。`docker-build.yml` 与 `android-build.yml` 都在构建前执行 |
+
+### 10.3 判新口径：版本号 vs build sequence
+
+「我的 → 前端升级 (OTA)」组内新增 `开发版本` 开关（antd-mobile `Switch`），默认**关闭**：
+
+| 开关 | 判新依据 | 实现路径 | 适用场景 |
+| --- | --- | --- | --- |
+| **关（默认）** | **版本号字段大小** | `GET /api/ota/check/0` 取 `manifest.version` → `compareVersion(manifest.version, 当前运行版本) > 0` 才算新 | 生产口径。旧分支被重新构建（sequence 变大但版本更小）时不会把设备拉回旧版 |
+| **开** | **build sequence** | `tauri-plugin-hotswap` 的 `checkUpdate()`（内部拿本地 sequence 请求 `/api/ota/check/:seq`，服务端只回比它大的） | 开发联调。每次构建 sequence 都变，保证任何一次提交都能推到设备上 |
+
+补充约定：
+
+- **持久化**：`localStorage['iboard_ota_dev_mode'] = '1' | '0'`（默认 `'0'`）。值只存在设备端 WebView 存储里，不进数据库、不上报，换设备/清数据即回默认。
+- **当前运行版本**：已应用过 OTA 覆盖包时取覆盖包 `version`（插件 `getVersionInfo()`），否则取内置包 `APP_VERSION`；避免「内置包 0.1.0 + 覆盖包 0.2.0」时永远判定有新版本。
+- **切换开关会重置检查结果**（`otaState='idle'`、清空 `otaInfo`），避免上一种口径的结论误导用户。
+- **Web 端**：浏览器里拿不到本地 sequence。默认口径按版本号比较；开发口径退化为「服务端版本 ≠ 本地版本即算新」（近似 sequence 语义）。Web 端只提示刷新，不下载不替换，与原设计一致。
+
+**版本比较算法**（`src/utils/version.js`，纯函数可单测）：
+
+```js
+parseVersionFields('0.2.0-ota')  // → [0, 2, 0]
+compareVersion('0.2.0-ota','0.1.0')  // → 1  (0.2.0 更新)
+compareVersion('0.2','0.2.0')        // → 0  (缺位补 0)
+```
+
+规则：按非数字字符切段 → 过滤空段 → 转数字 → 逐段比较，位数不足补 0。单测 10 条覆盖 `-ota` 后缀、`v` 前缀、多位段（`0.10 > 0.9`）、空串、`beta.3 < beta.10`，全部通过。
+
+### 10.4 交互与信息架构变更
+
+| 项 | 变更前 | 变更后 |
+| --- | --- | --- |
+| 底部 Tab | 首页 / 宏观 / 监控 / 打卡 / 我（5 个） | **打卡 / 宏观 / 监控 / 我（4 个）**，打卡在最左 |
+| 默认落地 | `/` → 首页（默认选中新闻） | `/` → **`/checkin`**；`RedirectIfAuthed` 与 404 兜底同样指向 `/checkin` |
+| 报警 / 新闻 | 首页内的 2 个 Tab | 宏观的第 5、6 个子 Tab（`/macro/alerts`、`/macro/news`），报警角标保留 |
+| 新闻详情 | `/news/:id`（底部无 Tab 高亮） | **`/macro/news/:id`**（宏观 Tab 保持高亮） |
+| 打卡页头部 | `[特效开/关]` + `[+ 新建]` | 只保留 `[+ 新建]`；特效恒开 |
+| 特效实现 | `effectsEnabled()` 读 `localStorage.iboard_celebrate` + `prefers-reduced-motion` 降级 | 删除开关与降级判断，`Celebrate` 只要 `fire` 变化就播放 |
+
+### 10.5 界面设计同步
+
+`界面设计.html` 已同步：底部 Tab 改为 4 项且「打卡」高亮在首位、打卡页去掉特效开关按钮、新增「我的 · OTA 开发版本开关」屏、宏观新增「报警 / 新闻」子 Tab 与合并后的 6 Tab 导航。
+
+---
+
+## 11. 界面调整（2026-10-23）
+
+### 11.1 变更清单
+
+| # | 范围 | 变更 | 状态 |
+| --- | --- | --- | --- |
+| 1 | 页面头部 | 打卡 NavBar 高度减半（45 → 23px）、标题改主色 12px；宏观 / 监控补标题；「我」页整条去掉 | **已实现** |
+| 2 | 打卡页 | 日历与打卡合并为一个视图（上日历、下打卡，按天/周/月分组、去掉年分组、卡片紧凑化） | **待确认**（设计稿已出，见《界面设计.html》2.12 ②节） |
+| 3 | 清单页 | 新增「模板」分类（与进行中 / 已归档并列），独立 CRUD + 字母序；新建清单去掉场景、模板改右侧滑出选择 | **已实现** |
+| 4 | 宏观页 | 报警 / 新闻移到最左并默认选中新闻；tab 条增加右侧溢出提示 | **已实现** |
+
+### 11.2 页面头部统一
+
+新增组件 `src/components/PageHeader.jsx`（高度 23px、标题 12px/600 主色、字距 1px、背景取页面底色 `#f5f5f5`），只被 **打卡 / 宏观 / 监控** 三页引用：
+
+| 页 | 变更前 | 变更后 |
+| --- | --- | --- |
+| 打卡 | `NavBar` 45px，标题 17px 深色 | `PageHeader` 23px，标题主色 |
+| 宏观 | `NavBar` 45px，空白 | `PageHeader` + 标题「宏观」 |
+| 监控 | `NavBar` 45px，空白 | `PageHeader` + 标题「监控」 |
+| 我 | `NavBar` 45px 空白条 | **移除**，`me-profile` 直接贴顶 |
+
+> 「我」页不引用该组件，因此调整打卡/宏观/监控的头部不会波及「我」；反之亦然。三个页面之间也各自持有独立实例，互不影响。
+
+### 11.3 清单模板分类
+
+**接口**（`server/routes/checklists.js`）：
+
+| 方法 | 路径 | 说明 |
+| --- | --- | --- |
+| GET | `/api/checklists/templates` | 列表，**服务端按名称字母顺序排序**（原为 `builtin desc, id asc`） |
+| GET | `/api/checklists/templates/:id` | 详情（新增） |
+| POST | `/api/checklists/templates` | 新建（名称 ≤20 字，≥1 条检查项） |
+| PUT | `/api/checklists/templates/:id` | 改名称 / 检查项（新增；`builtin=true` 拒绝，404） |
+| DELETE | `/api/checklists/templates/:id` | 删自建模板（`builtin=true` 拒绝） |
+
+排序口径：`Intl.Collator('zh-Hans-CN', { numeric: true, sensitivity: 'base' })` —— 中文按拼音、数字按数值。前端 `ListView` 拿到列表后再排一次，保证与后端一致（网络返回顺序不可控时也不乱）。
+
+**前端**（`src/pages/checkin/ListView.jsx`）：
+
+- 分段由 2 项扩为 3 项：`active`（进行中）/ `archived`（已归档）/ `template`（模板）；右上角按钮随分段切换为「+ 新建」/「+ 新建模板」。
+- 模板卡片：名称 + 「预置」标记 + 项数；最多展示 4 条检查项摘要，超出折叠为 `+n`；操作「由此新建 / 编辑 / 删除」，预置模板只保留「由此新建」。
+- 新建 / 编辑模板共用底部弹层：名称 + 检查项逐条编辑（≤40 字，可删可加）。
+- **新建清单表单**：仅「名称」+「模板」两项 —— **场景选择器已移除**（`scene` 改为沿用所选模板自带的场景，无模板则为空；数据库字段保留，历史数据照常展示）。
+- **模板选择**：点击模板行从**右侧滑出** `78vw` 面板（antd-mobile `Popup position="right"`），首项固定「不使用模板」，其后为字母序模板列表（预置带标记 + 项数），选中项主色高亮。
+
+### 11.4 宏观 tab 顺序与溢出提示
+
+- Tab 顺序改为 **报警 → 新闻 → 油价 → 经济数据 → 策略研究 → 经济文章**，默认选中 **新闻**；`/macro` 由路由直接 `Navigate` 到 `/macro/news`（`App.jsx`），`activeFromPath` 兜底同样返回 `news`。
+- `SwipeTabs` 增加溢出提示层：测量 `.adm-tabs-tab-list` 的 `scrollLeft + clientWidth < scrollWidth`，为真时在顶部右侧渲染 `.tab-more-hint`（白色渐变 + 主色圆底箭头「›」，1.5s 轻微摆动动画，点击向右翻页 60% 视宽），滚到末尾自动消失。
+- 切换 tab 时把激活项平滑滚到可视区中央，避免选中项藏在屏幕外。
+- 为什么不用框架自带的：antd-mobile Tabs 自带 `.adm-tabs-header-mask-right` 只有 30px 纯渐变、无箭头、无交互，用户难以判断"右侧还有内容"，故叠加此提示层。
+
+### 11.5 待确认项：日历与打卡合并
+
+方案已写入《界面设计.html》2.12 ②节（含主视图、未来日期计划态、卡片「⋯」操作面板三屏）。要点：
+
+| 项 | 方案 |
+| --- | --- |
+| 结构 | SwipeTabs 由 3 个减为 2 个：`日历（含打卡）` / `清单` |
+| 日历 | 月历 + 月份切换 + 回到今天；**去掉「昨天/今天/明天」分段**；日期格 38 → 31px |
+| 打卡 | 沿用现有卡片样式，紧凑化：内边距 12→8px、环形 58→42px（环宽 6→5）、间距 10→7px |
+| 操作 | 撤销 / 编辑 / 归档收进「⋯」底部面板（原为卡片底部三个文字链接） |
+| 分组 | **每天 → 每周 → 每月**，组标题左侧主色竖条；**去掉「每年」分组** |
+| 联动 | 点日期即切换当日数据；未来日期只读，按钮灰显「计划」 |
+
+确认后再落地：`CheckinPage` 收敛为 2 个 tab、`CalendarView` 与 `HabitView` 合成新视图组件、`HabitView` 的循环/编辑逻辑抽出复用、样式新增 `.mv-*` 段。
+
+
@@ -0,0 +1,348 @@
+# iBoard V0.2 需求文档 — 打卡 / 日历 / 清单
+
+> 版本：V0.2 · 分支：`dev-0.2` · 日期：2026-10-22
+> 目标项目：iboard（Tauri 2 + React 18 + antd-mobile + Express + Prisma/MariaDB，移动端优先）
+> 基线版本：V0.1（`dev-0.1`）
+
+---
+
+## 1. 总体描述
+
+在 iBoard 移动端新增一个「打卡」模块一个「清单」模块，满足两类日常需求：
+### 打卡
+1. **周期性打卡**（习惯养成）：用户定义"每天 n 次 / 每周 n 次 / 每月 n 次 / 每年 n 次"的目标，
+   每次打卡后卡片上的**环形进度**按 `已完成次数 / 目标次数` 增长，达标时环形闭合并播放完成特效；
+2. **日历回看**：以日历为载体，快速查看**今天**（要做什么）、**昨天**（做得怎样）、
+   **明天**（计划做什么），日期上以圆点/实心标记完成情况；
+
+### 清单
+1. **清单**（场景化一次性事项）：面向**出差、回老家**等临时场景，逐条勾选确认，
+   避免遗漏；清单可复用为模板，下次一键生成。
+
+### 1.1 本期范围
+
+- 单用户使用，数据按登录用户隔离（复用现有 JWT 鉴权）。
+- 移动端优先（`MobileShell` + 底部 TabBar 体系），桌面浏览器兼容可用即可。
+- 数据落库 MariaDB，通过现有 Express `/api/*` 提供接口。
+
+### 1.2 不在本期范围（明确排除）
+
+- 多人协作 / 共享打卡 / 打卡排行榜。
+- 系统通知、推送提醒、定时提醒（V0.2 不引入通知能力）。
+- 复杂统计报表（周报/月报/趋势图），本期只提供完成率概览。
+- 桌面端专用布局、横屏适配。
+- 清单的周期性重复（如"每次出差都生成"），本期只做**临时清单 + 模板手动复用**。
+
+---
+
+## 2. 术语与概念定义
+
+| 术语 | 定义 |
+| --- | --- |
+| **打卡项（Habit）** | 一个被跟踪的周期性目标，如"喝水 每天 8 次""健身 每周 3 次" |
+| **周期类型** | `day` / `week` / `month` / `year`，决定进度统计窗口 |
+| **目标次数 n** | 一个周期内需要完成的打卡次数，n ≥ 1 |
+| **周期窗口** | 日=自然日；周=自然周（周一 00:00 至周日 23:59）；月=自然月；年=自然年。时区统一 Asia/Shanghai |
+| **打卡记录（CheckIn）** | 一次打卡动作，归属到某个**本地日历日**（可补打到过去日期） |
+| **环形进度** | 卡片上的圆环组件，`进度 = min(已完成次数 / n, 1)`；达标=闭合 |
+| **清单（CheckList）** | 一次性检查清单，如"出差 · 10月杭州"，含若干检查项 |
+| **检查项（CheckItem）** | 清单中的单条待检查事项，勾选即完成 |
+| **模板（Template）** | 可被复用的清单结构（一组检查项标题），用于一键生成新清单 |
+| **日期状态** | 某日的打卡完成情况：全部完成 / 部分完成 / 未开始 / 超额完成 |
+
+---
+
+## 3. 需求点
+
+**编号规则**：`类型-模块-序号`。类型：F=功能需求、U=交互与体验、D=数据、N=非功能、E=异常与边界。
+模块：CK=打卡、CL=日历、LS=清单、SY=通用。
+
+**优先级**：P0 = 本期必须有；P1 = 本期应该有；P2 = 有则更好（可延后）。
+
+### 3.1 功能需求 — 打卡（F-CK）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| F-CK-01 | 支持新建打卡项：名称、周期类型、目标次数 n、颜色、图标、备注 | 表单校验：名称必填且 ≤ 20 字；n 为 ≥1 的整数 | P0 |
+| F-CK-02 | 周期类型支持**每天 n 次 / 每周 n 次 / 每月 n 次 / 每年 n 次**四种 | 四种类型均可创建并正确统计 | P0 |
+| F-CK-03 | 卡片以**环形进度**展示当前周期完成情况，环中心显示 `已完成/n` | 进度 = 已完成次数 / n，上限 100% | P0 |
+| F-CK-04 | **每天 1 次**的打卡项：打卡后环形**直接闭合**（100%），卡片进入"已完成"态 | 一次点击即闭合，不出现 50% 之类的中间态 | P0 |
+| F-CK-05 | **每周 n 次**（及月/年）：每打卡一次环形闭合对应百分比（如 n=3，打 1 次=33.3%、2 次=66.7%、3 次=100% 闭合） | 进度随每次打卡实时刷新，带过渡动画 | P0 |
+| F-CK-06 | 打卡主操作：点击卡片上的打卡按钮即完成一次打卡 | 单击即生效，响应 < 300ms（乐观更新） | P0 |
+| F-CK-07 | 打卡**完成特效**：达标（进度达 100%）时播放特效——环形闭合动画 + 光晕/粒子扩散 + 轻量触感反馈 | 特效时长 ≤ 800ms，不阻塞后续操作 | P0 |
+| F-CK-08 | 打卡记录需记录**发生日期**（本地日历日）与时间戳 | 支持按日回看，跨零点归属正确 | P0 |
+| F-CK-09 | 支持**撤销**：可撤销本周期内最近一次打卡（主要是误触场景） | 撤销后进度回退，记录物理删除或标记撤销 | P1 |
+| F-CK-10 | 支持**补打卡**：对过去日期补记一次打卡，默认允许回溯 7 天 | 补打后对应日期的状态与进度同步更新 | P1 |
+| F-CK-11 | **不允许提前打卡**（未来日期不可打卡） | 明天的项只展示为"计划"，按钮置灰 | P0 |
+| F-CK-12 | 展示**连续完成天数/周期数（streak）** | 如"已连续 5 天"，断签归零 | P1 |
+| F-CK-13 | 打卡项可**编辑**（改名/改 n/改颜色/改周期）与**停用（归档）** | 归档后不出现在今日待办，历史保留 | P1 |
+| F-CK-14 | 修改目标次数 n 后，**当前周期**进度按新 n 重算展示，不改写历史记录 | 例如 n 由 3 改 5，已完成 3 次 → 显示 3/5（60%） | P1 |
+| F-CK-15 | **超额打卡**：周期内超过 n 仍可继续打卡，环形保持闭合，中心显示 `n+k`（如 3+1） | 不清零、不报错 | P2 |
+| F-CK-16 | 打卡项支持**排序**（拖动或置顶）与分组展示 | 今日列表按"未完成在前、已完成在后"默认排序 | P2 |
+| F-CK-17 | 打卡时可附带**备注**（可选，纯文本） | 列表详情中可查看 | P2 |
+
+### 3.2 功能需求 — 日历（F-CL）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| F-CL-01 | 提供**月历视图**：当月日历网格，可切换上/下月，点击日期查看当日详情 | 周一起始，周一~周日七列 | P0 |
+| F-CL-02 | **今天**视图（默认）：列出今天应打卡的项及完成状态，可直接打卡 | 打开页面默认定位今天 | P0 |
+| F-CL-03 | **昨天**视图：展示昨天各打卡项的**已完成结果**（完成/未完成/超额），未完成项可进行补打 | 以回看为主，标记为"已完成的历史" | P0 |
+| F-CL-04 | **明天**视图：展示**明天计划要打卡的项**（按周期规则推算），只读，不可打卡 | 明确标注"计划"，打卡按钮不可用 | P0 |
+| F-CL-05 | 今天/昨天/明天**快捷切换**（顶部 Segmented 或左右滑动） | 一键切换，切换有过渡动画 | P0 |
+| F-CL-06 | **日期标记**：月历中每个日期按完成情况标记——全部完成（实心）、部分完成（半填充）、未开始（空心/无标记）、超额完成（特殊标记） | 一眼能看出当月坚持情况 | P0 |
+| F-CL-07 | **日期详情**：点击某日期，展示当天每个打卡项的"目标次数 / 已完成次数 / 状态" | 过去日期可补打，未来日期只读 | P0 |
+| F-CL-08 | 日历与打卡**数据同源**：打卡操作在日历视图与打卡列表视图中即时一致 | 任一处打卡，另一处刷新 | P0 |
+| F-CL-09 | 月历顶部展示**当月完成率**（完成次数 / 应完成次数） | 百分比展示 | P1 |
+| F-CL-10 | 支持左右**滑动手势**切换月份 | 与按钮切换等价 | P2 |
+| F-CL-11 | 月视图支持简单的**完成热力**（按完成率深浅着色） | 可选展示，默认关闭 | P2 |
+
+### 3.3 功能需求 — 清单（F-LS）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| F-LS-01 | 支持新建**检查清单**：名称、场景标签（出差 / 回老家 / 自定义）、备注 | 名称必填，场景标签可空 | P0 |
+| F-LS-02 | 清单内可**增删改检查项**，支持排序 | 单条 ≤ 40 字 | P0 |
+| F-LS-03 | **勾选完成**：点击检查项前的复选框即打勾，已完成项置灰 + 删除线；可取消勾选 | 单击切换，状态即时保存 | P0 |
+| F-LS-04 | 清单头部显示**进度**：`已完成 / 总数` + 进度条；全部完成时显示完成态 | 全部勾完触发完成提示 | P0 |
+| F-LS-05 | 清单**全部完成**时播放完成特效（与 F-CK-07 同一套特效组件） | 复用，风格统一 | P1 |
+| F-LS-06 | **模板**：系统预置常用模板（出差、回老家），一键基于模板生成新清单 | 至少 2 个预置模板 | P1 |
+| F-LS-07 | **另存为模板**：用户可将自己的清单保存为自定义模板，后续复用 | 自定义模板可删除 | P1 |
+| F-LS-08 | **复用历史清单**：从历史清单复制生成一份新清单（勾选状态重置） | 原清单保持不变 | P1 |
+| F-LS-09 | 清单**归档/删除**：完成的清单可归档（不出现在进行中列表），可查看历史 | 删除需二次确认 | P1 |
+| F-LS-10 | 清单项支持**备注/数量**说明（如"充电器 ×1"） | 展示在标题下方，弱色小字 | P2 |
+| F-LS-11 | 清单支持**一键全部勾选 / 全部取消** | 批量操作入口 | P2 |
+
+### 3.4 功能需求 — 通用（F-SY）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| F-SY-01 | 底部 TabBar 新增**「打卡」页**，并作为**默认首页放在最左**；「清单」不单独占 Tab，作为打卡页内的第三个子视图 | 图标风格与现有 TabIcon 一致；启动即进入 `/checkin` | P0 |
+| F-SY-02 | 「打卡」页内集成 打卡/日历 两个功能，日历放在上半截，默认显示一行为周视图，下拉显示为月视图。 | 日历中选择时间与下部打卡任务联动 | P0 |
+| F-SY-03 | 所有接口复用现有鉴权（`authRequired`，JWT），数据按 `userId` 隔离 | 未登录跳转 `/login` | P0 |
+| F-SY-04 | 后端新增 REST 路由（建议 `/api/checkin/*`、`/api/checklist/*`），挂载到 `server/index.js` | 与现有路由风格一致 | P0 |
+| F-SY-05 | 时间处理统一 **Asia/Shanghai**，前端与后端对"日历日"的判定一致 | 跨零点打卡归属当天 | P0 |
+| F-SY-06 | 打卡/勾选操作采用**乐观更新**，接口失败时回滚并 Toast 提示 | 失败可见、状态不失真 | P1 |
+| F-SY-07 | 写接口**幂等/防抖**：同一打卡项 1 秒内重复点击只记一次 | 前端防抖 + 后端唯一约束双保险 | P1 |
+| F-SY-08 | 页面可见性变化时刷新数据（复用 `useRefreshOnVisible`） | 从后台切回自动同步 | P1 |
+
+### 3.5 交互与体验需求（U）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| U-01 | **环形进度组件**：SVG 圆环，背景环 + 进度环，进度变化带 400ms ease-out 动画 | 组件可复用（打卡卡片、清单进度共用） | P0 |
+| U-02 | **完成特效**：达标瞬间环形闭合 + 光晕/粒子扩散，约 600ms；可重复观看不烦扰 | 不阻塞操作，动画结束自动清理 | P0 |
+| U-03 | **触感反馈**：完成打卡时轻量震动（Web Vibration API / Tauri） | 固定开启，与特效一同触发 | P1 |
+| U-04 | 移动端适配：375~430px 视口，复用 `globals.css` 的 `.card` 体系，安全区与底部 TabBar 不遮挡内容 | 真机无横向滚动、无遮挡 | P0 |
+| U-05 | 空态 / 加载态 / 错误态三态齐全（首次使用引导"创建第一个打卡项"） | 空态有明确 CTA | P0 |
+| U-06 | 打卡按钮足够大（点击热区 ≥ 44×44），符合移动端触控规范 | 误触率低 | P1 |
+| U-07 | 动效**性能降级**：特效保持轻量（单次 ≤900ms、`pointer-events:none`），不给低端机造成卡顿 | 不卡顿、不阻塞操作 | P1 |
+| U-08 | 深浅色：跟随现有浅色主题，卡片/分割线风格与首页、监控页一致 | 视觉统一 | P1 |
+| U-09 | 清单勾选有明确的勾选动画（勾形描边动画） | 反馈即时 | P2 |
+
+### 3.6 数据需求（D）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| D-01 | 新增 Prisma 模型：`Habit`（打卡项）、`CheckIn`（打卡记录） | 字段见附录 A | P0 |
+| D-02 | 新增 Prisma 模型：`CheckList`（清单）、`CheckListItem`（检查项）、`CheckListTemplate`（模板，P1） | 字段见附录 A | P0 |
+| D-03 | `Habit` / `CheckList` 均带 `userId` 外键，删除用户级联删除 | 数据隔离 | P0 |
+| D-04 | `CheckIn` 建立 `(habitId, date)` 索引，支持按日期范围查询 | 日历月查询走索引 | P0 |
+| D-05 | 提供迁移 SQL 并纳入 `prisma migrate deploy` 流程 | 与 V0.1 迁移流程一致 | P0 |
+| D-06 | 软删除语义：`Habit.archived`、`CheckList.archived`，历史记录保留 | 不物理删除历史 | P1 |
+
+### 3.7 非功能需求（N）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| N-01 | 页面首屏数据加载 < 1.5s（内网/正常网络），交互响应 < 300ms（乐观更新） | 真机可感知流畅 | P0 |
+| N-02 | 兼容 Android WebView（Tauri 打包）与移动端浏览器，不依赖桌面专有 API | 真机验证 | P0 |
+| N-03 | 单用户数据量按"千级记录/年"设计，无需分表；月查询一次请求返回 | 日历切月无等待感 | P1 |
+| N-04 | 所有接口 `authRequired`，越权访问返回 401 | 安全基线 | P0 |
+| N-05 | 前端代码组织遵循现有约定：`src/pages/checkin/*` + `src/components/*` + `server/routes/*` | 结构一致 | P0 |
+
+### 3.8 异常与边界需求（E）
+
+| 编号 | 需求描述 | 处理约定 | 优先级 |
+| --- | --- | --- | --- |
+| E-01 | 重复点击打卡 | 前端防抖 + 后端唯一约束，只记一次 | P0 |
+| E-02 | 接口失败 / 断网 | 乐观更新回滚 + Toast 提示，可重试 | P0 |
+| E-03 | **周期中途新建**打卡项（如周三创建"每周 3 次"） | 本期按**完整目标 n** 计算，不按剩余天数折算 | P1 |
+| E-04 | 每月 n 次在天数不同的月份 | 按**自然月**窗口，不折算 | P0 |
+| E-05 | 每年 n 次跨年 | 按**自然年**窗口，年末清零 | P0 |
+| E-06 | 删除打卡项 | 归档（软删除）为主；硬删除需二次确认并提示"历史记录将一并删除" | P1 |
+| E-07 | 清单项全部删除后清单进度为 0/0 | 显示空清单，不显示 100% | P1 |
+| E-08 | 跨零点打卡（23:59 → 00:00） | 以**提交时刻的本地日历日**归属 | P0 |
+
+### 3.9 功能需求 — 版本与升级（F-OT，2026-10-22 追加）
+
+| 编号 | 需求描述 | 验收要点 | 优先级 |
+| --- | --- | --- | --- |
+| F-OT-01 | **OTA 包版本必须与分支对应**：`dev-0.2` 分支上 OTA 包版本应为 `0.2.0-ota` | `GET /api/ota/check/0` 返回 `version = 0.2.0-ota` | P0 |
+| F-OT-01a | **APK 版本与 OTA 版本同源**：APK（含桌面包）版本为裸版本号 `0.2.0`，无后缀；OTA 版本为同一版本号加 `-ota`。两者都跟代码分支保持一致 | APK 系统信息里 versionName=`0.2.0`（versionCode=2000），OTA manifest=`0.2.0-ota` | P0 |
+| F-OT-02 | 版本号错位在 CI 阶段就拦住：①`package.json`/`tauri.conf.json`/`Cargo.toml`/`Cargo.lock` 四处必须完全一致且不含 `-ota`；②分支名 `dev-x.y` 与版本主次号不一致时构建失败 | CI 输出明确报错并中断 | P0 |
+| F-OT-03 | 「我」页 OTA 组内新增**「开发版本」开关**，默认**关闭** | 关闭=按版本号比较；打开=按 build sequence 比较 | P0 |
+| F-OT-04 | 开关值**持久化在设备端**，重启 App 后保持上次选择 | 杀进程重进仍为上次状态 | P0 |
+| F-OT-05 | 版本号比较规则：按非数字字符切成数字字段，逐段比较大小（`0.2.0 > 0.1.0`，`0.10 > 0.9`） | 单测覆盖后缀/前缀/缺位/多位段 | P0 |
+| F-OT-06 | 切换开关后清空上一次的检查结果，避免误判 | 切换即回到「未检查」状态 | P1 |
+
+---
+
+## 4. 优先级汇总（本期交付范围）
+
+- **P0（必须）**：F-CK-01~08、F-CK-11；F-CL-01~08；F-LS-01~04；F-SY-01~05；F-OT-01、F-OT-01a、F-OT-02~05；U-01、U-02、U-04、U-05；D-01~05；N-01、N-02、N-04、N-05；E-01、E-02、E-04、E-05、E-08。
+- **P1（应该）**：F-CK-09、10、12~14；F-CL-09；F-LS-05~09；F-SY-06~08；F-OT-06；U-03、U-06~08；D-06；N-03；E-03、E-06、E-07。
+- **P2（可选/延后）**：F-CK-15~17；F-CL-10、11；F-LS-10、11；U-09。
+
+---
+
+## 5. 里程碑建议
+
+| 里程碑 | 内容 |
+| --- | --- |
+| **M1 数据与接口** | Prisma 模型 + 迁移；`server/routes/checkin.js`、`checklist.js`；周期进度计算与日期查询 |
+| **M2 打卡视图** | 环形进度组件 + 打卡卡片列表 + 打卡/撤销/补打 + 完成特效 |
+| **M3 日历视图** | 月历网格 + 今天/昨天/明天三视图 + 日期标记 + 日期详情 |
+| **M4 清单视图** | 清单 CRUD + 勾选交互 + 进度条 + 模板与复用 |
+| **M5 联调打磨** | 真机验证、动效降级、空态/错误态、性能与跨天边界 |
+
+---
+
+## 6. 待确认问题（评审时决策）
+
+| # | 问题 | 建议 |
+| --- | --- | --- |
+| 1 | 是否新增第 5 个底部 Tab「打卡」，还是放在首页入口？ | ✅ **已决策（2026-10-22）**：「打卡」作为**默认首页放在最左**；原来的「首页」取消，报警/新闻并入宏观 |
+| 2 | 周起始日是周一还是周日？ | 建议周一（国内习惯） |
+| 3 | 是否允许"明天提前打卡"？ | 建议**不允许**（F-CK-11），保持统计口径干净 |
+| 4 | 删除打卡项时历史是否保留？ | 建议默认归档保留，硬删除才清历史 |
+| 5 | 预置模板具体包含哪些项？ | 评审时列出"出差/回老家"各 8~12 条初始项 |
+| 6 | 完成特效是否可全局关闭？ | ✅ **已决策（2026-10-22）**：不提供关闭入口，**特效永远打开**；页面内不再有特效开关 |
+
+---
+
+## 附录 A：核心实体草案（供设计阶段参考，非最终表结构）
+
+```prisma
+// 打卡项
+model Habit {
+  id        Int      @id @default(autoincrement())
+  userId    Int
+  name      String
+  period    String   // day | week | month | year
+  target    Int      @default(1)      // 周期内目标次数 n
+  color     String   @default("#1677ff")
+  icon      String   @default("")
+  note      String   @default("")
+  archived  Boolean  @default(false)
+  sortOrder Int      @default(0)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  records   CheckIn[]
+
+  @@index([userId, archived])
+}
+
+// 打卡记录（一次打卡 = 一条；同日多次为多条）
+model CheckIn {
+  id        Int      @id @default(autoincrement())
+  habitId   Int
+  habit     Habit    @relation(fields: [habitId], references: [id], onDelete: Cascade)
+  userId    Int
+  date      String                    // 本地日历日 "YYYY-MM-DD" (Asia/Shanghai)
+  seq       Int      @default(1)      // 当日第几次 (1..n, 超额继续累加)
+  note      String   @default("")
+  source    String   @default("user") // user | backfill(补打)
+  createdAt DateTime @default(now())
+
+  @@unique([habitId, date, seq])
+  @@index([userId, date])
+  @@index([habitId, date])
+}
+
+// 检查清单
+model CheckList {
+  id        Int             @id @default(autoincrement())
+  userId    Int
+  title     String
+  scene     String   @default("")     // 出差 | 回老家 | 自定义
+  note      String   @default("")
+  archived  Boolean  @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  items     CheckListItem[]
+
+  @@index([userId, archived])
+}
+
+// 检查项
+model CheckListItem {
+  id        Int       @id @default(autoincrement())
+  listId    Int
+  list      CheckList @relation(fields: [listId], references: [id], onDelete: Cascade)
+  title     String
+  note      String    @default("")
+  done      Boolean   @default(false)
+  doneAt    DateTime?
+  sortOrder Int       @default(0)
+  createdAt DateTime  @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([listId, sortOrder])
+}
+
+// 清单模板（P1）
+model CheckListTemplate {
+  id        Int      @id @default(autoincrement())
+  userId    Int?                      // null = 系统预置
+  name      String
+  scene     String   @default("")
+  items     Json                      // [{ title, note }]
+  builtin   Boolean  @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+```
+
+> 说明：周期进度由 `CheckIn` 按周期窗口现场聚合（不冗余计数字段），避免并发与修改 n 后的一致性问题。
+
+---
+
+## 附录 B：实现约定（开发期补充，用于消除口径歧义）
+
+| # | 约定 | 说明 |
+| --- | --- | --- |
+| B-1 | **周期窗口** | 日=自然日；周=周一 00:00 ~ 周日 23:59；月=自然月；年=自然年；时区 Asia/Shanghai |
+| B-2 | **环形进度** | 周期完成度 = 周期内累计打卡次数 / n（每周 n 次：打 1 次=1/n 环；每天 1 次：打 1 次直接闭合） |
+| B-3 | **日历日期标记** | 用"当日完成度"：当日次数 / **日均期望次数**（每天 n 次→n；每周 n 次→ceil(n/7)；每月→ceil(n/当月天数)；每年→ceil(n/365)）。全完成=实心绿点，部分=黄点，超额=紫点，无记录=不显示 |
+| B-4 | **streak** | 从当前周期往回数连续达标的周期数；**当前周期未结束且未达标不算断签**（跳过继续往前数） |
+| B-5 | **补打限制** | 只能补打最近 7 天（`BACKFILL_DAYS`），未来日期禁止打卡 |
+| B-6 | **撤销语义** | 撤销删除本周期内"最近一次"打卡（按 date desc、seq desc 取第一条） |
+| B-7 | **删除打卡项** | 默认归档（`archived=true`，历史保留）；`?hard=1` 才物理删除并清记录 |
+| B-8 | **接口前缀** | 打卡 `/api/checkin/*`、清单 `/api/checklists/*`，全部 `authRequired`，数据按 `userId` 隔离 |
+| B-9 | **前端入口** | 底部 Tab 4 个：**打卡（最左，默认选中）** / 宏观 / 监控 / 我；`/` 重定向到 `/checkin`，页内三视图：打卡 / 日历 / 清单。原「首页」取消，报警/新闻并入宏观 |
+| B-10 | **特效** | 完成特效 + 触感反馈**恒开**，页面内不提供开关（2026-10-22 变更，原 `localStorage iboard_celebrate` 机制已移除） |
+| B-11 | **OTA 版本** | OTA 包 `version = package.json.version + '-ota'`，必须与分支一致（`dev-0.2` → `0.2.0-ota`），CI 有强校验 |
+| B-12 | **OTA 判新** | 我的页「开发版本」开关（默认关，持久化 `localStorage.iboard_ota_dev_mode`）：关=版本号字段比较，开=build sequence 比较 |
+
+### 接口清单
+
+| 方法 | 路径 | 说明 |
+| --- | --- | --- |
+| GET | `/api/checkin/habits?date=` | 打卡项列表 + 当前周期进度 + streak |
+| POST | `/api/checkin/habits` | 新建打卡项 |
+| PUT | `/api/checkin/habits/:id` | 编辑（改 n / 周期 / 归档） |
+| DELETE | `/api/checkin/habits/:id?hard=1` | 归档（默认）/ 物理删除 |
+| POST | `/api/checkin/habits/:id/check` | 打卡一次（可带 `date` 补打、`note`） |
+| DELETE | `/api/checkin/habits/:id/check?date=` | 撤销本周期最近一次 |
+| GET | `/api/checkin/day?date=` | 某日详情（今天可打卡 / 昨天可补打 / 明天只读） |
+| GET | `/api/checkin/calendar?month=YYYY-MM` | 月历：每日状态 + 当月完成率 |
+| GET | `/api/checklists?archived=0\|1` | 清单列表（含进度） |
+| POST | `/api/checklists` | 新建清单（可带 `templateId` 从模板生成） |
+| GET/PUT/DELETE | `/api/checklists/:id` | 详情 / 编辑 / 删除 |
+| POST | `/api/checklists/:id/duplicate` | 复制为新清单（勾选重置） |
+| POST | `/api/checklists/:id/items` | 新增检查项 |
+| PUT/DELETE | `/api/checklists/items/:id` | 改标题 / 勾选（`done`） / 删除 |
+| POST | `/api/checklists/:id/check-all` | 一键全选 / 全不选 |
+| GET/POST | `/api/checklists/templates` | 模板列表（含系统预置）/ 另存为模板 |
+| DELETE | `/api/checklists/templates/:id` | 删除自定义模板 |
@@ -107,3 +107,58 @@ export type MihomeEnvSample = Prisma.MihomeEnvSampleModel
 * 
 */
 export type MihomeEnvHour = Prisma.MihomeEnvHourModel
+/**
+ * Model Habit
+ * 
+ */
+export type Habit = Prisma.HabitModel
+/**
+ * Model CheckIn
+ * 
+ */
+export type CheckIn = Prisma.CheckInModel
+/**
+ * Model CheckList
+ * 
+ */
+export type CheckList = Prisma.CheckListModel
+/**
+ * Model CheckListItem
+ * 
+ */
+export type CheckListItem = Prisma.CheckListItemModel
+/**
+ * Model CheckListTemplate
+ * 
+ */
+export type CheckListTemplate = Prisma.CheckListTemplateModel
+/**
+ * Model Project
+ * 
+ */
+export type Project = Prisma.ProjectModel
+/**
+ * Model ProjectMember
+ * 
+ */
+export type ProjectMember = Prisma.ProjectMemberModel
+/**
+ * Model BoardColumn
+ * 
+ */
+export type BoardColumn = Prisma.BoardColumnModel
+/**
+ * Model Task
+ * 
+ */
+export type Task = Prisma.TaskModel
+/**
+ * Model TaskMember
+ * 
+ */
+export type TaskMember = Prisma.TaskMemberModel
+/**
+ * Model TaskTag
+ * 
+ */
+export type TaskTag = Prisma.TaskTagModel
@@ -131,3 +131,58 @@ export type MihomeEnvSample = Prisma.MihomeEnvSampleModel
 * 
 */
 export type MihomeEnvHour = Prisma.MihomeEnvHourModel
+/**
+ * Model Habit
+ * 
+ */
+export type Habit = Prisma.HabitModel
+/**
+ * Model CheckIn
+ * 
+ */
+export type CheckIn = Prisma.CheckInModel
+/**
+ * Model CheckList
+ * 
+ */
+export type CheckList = Prisma.CheckListModel
+/**
+ * Model CheckListItem
+ * 
+ */
+export type CheckListItem = Prisma.CheckListItemModel
+/**
+ * Model CheckListTemplate
+ * 
+ */
+export type CheckListTemplate = Prisma.CheckListTemplateModel
+/**
+ * Model Project
+ * 
+ */
+export type Project = Prisma.ProjectModel
+/**
+ * Model ProjectMember
+ * 
+ */
+export type ProjectMember = Prisma.ProjectMemberModel
+/**
+ * Model BoardColumn
+ * 
+ */
+export type BoardColumn = Prisma.BoardColumnModel
+/**
+ * Model Task
+ * 
+ */
+export type Task = Prisma.TaskModel
+/**
+ * Model TaskMember
+ * 
+ */
+export type TaskMember = Prisma.TaskMemberModel
+/**
+ * Model TaskTag
+ * 
+ */
+export type TaskTag = Prisma.TaskTagModel
@@ -16,8 +16,8 @@ import type * as Prisma from "./internal/prismaNamespace.ts"

 export type IntFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -27,8 +27,8 @@ export type IntFilter<$PrismaModel = never> = {

 export type StringFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  in?: string[]
-  notIn?: string[]
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -36,14 +36,14 @@ export type StringFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
+  mode?: Prisma.QueryMode
  not?: Prisma.NestedStringFilter<$PrismaModel> | string
 }

 export type DateTimeFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
-  in?: Date[] | string[]
-  notIn?: Date[] | string[]
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -53,8 +53,8 @@ export type DateTimeFilter<$PrismaModel = never> = {

 export type IntWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -69,8 +69,8 @@ export type IntWithAggregatesFilter<$PrismaModel = never> = {

 export type StringWithAggregatesFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  in?: string[]
-  notIn?: string[]
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -78,7 +78,7 @@ export type StringWithAggregatesFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
+  mode?: Prisma.QueryMode
  not?: Prisma.NestedStringWithAggregatesFilter<$PrismaModel> | string
  _count?: Prisma.NestedIntFilter<$PrismaModel>
  _min?: Prisma.NestedStringFilter<$PrismaModel>
@@ -87,8 +87,8 @@ export type StringWithAggregatesFilter<$PrismaModel = never> = {

 export type DateTimeWithAggregatesFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
-  in?: Date[] | string[]
-  notIn?: Date[] | string[]
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -108,7 +108,7 @@ export type JsonFilter<$PrismaModel = never> =

 export type JsonFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -116,10 +116,10 @@ export type JsonFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
 }

@@ -132,7 +132,7 @@ export type JsonWithAggregatesFilter<$PrismaModel = never> =

 export type JsonWithAggregatesFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -140,10 +140,10 @@ export type JsonWithAggregatesFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
  _count?: Prisma.NestedIntFilter<$PrismaModel>
  _min?: Prisma.NestedJsonFilter<$PrismaModel>
@@ -165,8 +165,8 @@ export type BoolWithAggregatesFilter<$PrismaModel = never> = {

 export type FloatFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -176,8 +176,8 @@ export type FloatFilter<$PrismaModel = never> = {

 export type FloatWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -192,8 +192,8 @@ export type FloatWithAggregatesFilter<$PrismaModel = never> = {

 export type StringNullableFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel> | null
-  in?: string[] | null
-  notIn?: string[] | null
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -201,7 +201,7 @@ export type StringNullableFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
+  mode?: Prisma.QueryMode
  not?: Prisma.NestedStringNullableFilter<$PrismaModel> | string | null
 }

@@ -212,8 +212,8 @@ export type SortOrderInput = {

 export type StringNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel> | null
-  in?: string[] | null
-  notIn?: string[] | null
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -221,7 +221,7 @@ export type StringNullableWithAggregatesFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
+  mode?: Prisma.QueryMode
  not?: Prisma.NestedStringNullableWithAggregatesFilter<$PrismaModel> | string | null
  _count?: Prisma.NestedIntNullableFilter<$PrismaModel>
  _min?: Prisma.NestedStringNullableFilter<$PrismaModel>
@@ -230,8 +230,8 @@ export type StringNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type BigIntFilter<$PrismaModel = never> = {
  equals?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
-  in?: bigint[] | number[]
-  notIn?: bigint[] | number[]
+  in?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
+  notIn?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
  lt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  lte?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  gt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
@@ -241,8 +241,8 @@ export type BigIntFilter<$PrismaModel = never> = {

 export type BigIntWithAggregatesFilter<$PrismaModel = never> = {
  equals?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
-  in?: bigint[] | number[]
-  notIn?: bigint[] | number[]
+  in?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
+  notIn?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
  lt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  lte?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  gt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
@@ -264,7 +264,7 @@ export type JsonNullableFilter<$PrismaModel = never> =

 export type JsonNullableFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -272,10 +272,10 @@ export type JsonNullableFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
 }

@@ -288,7 +288,7 @@ export type JsonNullableWithAggregatesFilter<$PrismaModel = never> =

 export type JsonNullableWithAggregatesFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -296,10 +296,10 @@ export type JsonNullableWithAggregatesFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
  _count?: Prisma.NestedIntNullableFilter<$PrismaModel>
  _min?: Prisma.NestedJsonNullableFilter<$PrismaModel>
@@ -308,8 +308,8 @@ export type JsonNullableWithAggregatesFilterBase<$PrismaModel = never> = {

 export type IntNullableFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -319,8 +319,8 @@ export type IntNullableFilter<$PrismaModel = never> = {

 export type DateTimeNullableFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel> | null
-  in?: Date[] | string[] | null
-  notIn?: Date[] | string[] | null
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -330,8 +330,8 @@ export type DateTimeNullableFilter<$PrismaModel = never> = {

 export type IntNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -346,8 +346,8 @@ export type IntNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type DateTimeNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel> | null
-  in?: Date[] | string[] | null
-  notIn?: Date[] | string[] | null
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -360,8 +360,8 @@ export type DateTimeNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type FloatNullableFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -371,8 +371,8 @@ export type FloatNullableFilter<$PrismaModel = never> = {

 export type FloatNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -387,8 +387,8 @@ export type FloatNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedIntFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -398,8 +398,8 @@ export type NestedIntFilter<$PrismaModel = never> = {

 export type NestedStringFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  in?: string[]
-  notIn?: string[]
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -407,14 +407,13 @@ export type NestedStringFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
  not?: Prisma.NestedStringFilter<$PrismaModel> | string
 }

 export type NestedDateTimeFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
-  in?: Date[] | string[]
-  notIn?: Date[] | string[]
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -424,8 +423,8 @@ export type NestedDateTimeFilter<$PrismaModel = never> = {

 export type NestedIntWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel>
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -440,8 +439,8 @@ export type NestedIntWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedFloatFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -451,8 +450,8 @@ export type NestedFloatFilter<$PrismaModel = never> = {

 export type NestedStringWithAggregatesFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  in?: string[]
-  notIn?: string[]
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel>
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -460,7 +459,6 @@ export type NestedStringWithAggregatesFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
  not?: Prisma.NestedStringWithAggregatesFilter<$PrismaModel> | string
  _count?: Prisma.NestedIntFilter<$PrismaModel>
  _min?: Prisma.NestedStringFilter<$PrismaModel>
@@ -469,8 +467,8 @@ export type NestedStringWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedDateTimeWithAggregatesFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
-  in?: Date[] | string[]
-  notIn?: Date[] | string[]
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel>
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -490,7 +488,7 @@ export type NestedJsonFilter<$PrismaModel = never> =

 export type NestedJsonFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -498,10 +496,10 @@ export type NestedJsonFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
 }

@@ -520,8 +518,8 @@ export type NestedBoolWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedFloatWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel>
-  in?: number[]
-  notIn?: number[]
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel>
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -536,8 +534,8 @@ export type NestedFloatWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedStringNullableFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel> | null
-  in?: string[] | null
-  notIn?: string[] | null
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -545,14 +543,13 @@ export type NestedStringNullableFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
  not?: Prisma.NestedStringNullableFilter<$PrismaModel> | string | null
 }

 export type NestedStringNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: string | Prisma.StringFieldRefInput<$PrismaModel> | null
-  in?: string[] | null
-  notIn?: string[] | null
+  in?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
+  notIn?: string[] | Prisma.ListStringFieldRefInput<$PrismaModel> | null
  lt?: string | Prisma.StringFieldRefInput<$PrismaModel>
  lte?: string | Prisma.StringFieldRefInput<$PrismaModel>
  gt?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -560,7 +557,6 @@ export type NestedStringNullableWithAggregatesFilter<$PrismaModel = never> = {
  contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  startsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
  endsWith?: string | Prisma.StringFieldRefInput<$PrismaModel>
-  search?: string
  not?: Prisma.NestedStringNullableWithAggregatesFilter<$PrismaModel> | string | null
  _count?: Prisma.NestedIntNullableFilter<$PrismaModel>
  _min?: Prisma.NestedStringNullableFilter<$PrismaModel>
@@ -569,8 +565,8 @@ export type NestedStringNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedIntNullableFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -580,8 +576,8 @@ export type NestedIntNullableFilter<$PrismaModel = never> = {

 export type NestedBigIntFilter<$PrismaModel = never> = {
  equals?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
-  in?: bigint[] | number[]
-  notIn?: bigint[] | number[]
+  in?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
+  notIn?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
  lt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  lte?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  gt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
@@ -591,8 +587,8 @@ export type NestedBigIntFilter<$PrismaModel = never> = {

 export type NestedBigIntWithAggregatesFilter<$PrismaModel = never> = {
  equals?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
-  in?: bigint[] | number[]
-  notIn?: bigint[] | number[]
+  in?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
+  notIn?: bigint[] | number[] | Prisma.ListBigIntFieldRefInput<$PrismaModel>
  lt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  lte?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
  gt?: bigint | number | Prisma.BigIntFieldRefInput<$PrismaModel>
@@ -614,7 +610,7 @@ export type NestedJsonNullableFilter<$PrismaModel = never> =

 export type NestedJsonNullableFilterBase<$PrismaModel = never> = {
  equals?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
-  path?: string
+  path?: string[]
  mode?: Prisma.QueryMode | Prisma.EnumQueryModeFieldRefInput<$PrismaModel>
  string_contains?: string | Prisma.StringFieldRefInput<$PrismaModel>
  string_starts_with?: string | Prisma.StringFieldRefInput<$PrismaModel>
@@ -622,17 +618,17 @@ export type NestedJsonNullableFilterBase<$PrismaModel = never> = {
  array_starts_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_ends_with?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
  array_contains?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | null
-  lt?: runtime.InputJsonValue
-  lte?: runtime.InputJsonValue
-  gt?: runtime.InputJsonValue
-  gte?: runtime.InputJsonValue
+  lt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  lte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gt?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
+  gte?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel>
  not?: runtime.InputJsonValue | Prisma.JsonFieldRefInput<$PrismaModel> | Prisma.JsonNullValueFilter
 }

 export type NestedDateTimeNullableFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel> | null
-  in?: Date[] | string[] | null
-  notIn?: Date[] | string[] | null
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -642,8 +638,8 @@ export type NestedDateTimeNullableFilter<$PrismaModel = never> = {

 export type NestedIntNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.IntFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListIntFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.IntFieldRefInput<$PrismaModel>
  lte?: number | Prisma.IntFieldRefInput<$PrismaModel>
  gt?: number | Prisma.IntFieldRefInput<$PrismaModel>
@@ -658,8 +654,8 @@ export type NestedIntNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedFloatNullableFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -669,8 +665,8 @@ export type NestedFloatNullableFilter<$PrismaModel = never> = {

 export type NestedDateTimeNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel> | null
-  in?: Date[] | string[] | null
-  notIn?: Date[] | string[] | null
+  in?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
+  notIn?: Date[] | string[] | Prisma.ListDateTimeFieldRefInput<$PrismaModel> | null
  lt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  lte?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
  gt?: Date | string | Prisma.DateTimeFieldRefInput<$PrismaModel>
@@ -683,8 +679,8 @@ export type NestedDateTimeNullableWithAggregatesFilter<$PrismaModel = never> = {

 export type NestedFloatNullableWithAggregatesFilter<$PrismaModel = never> = {
  equals?: number | Prisma.FloatFieldRefInput<$PrismaModel> | null
-  in?: number[] | null
-  notIn?: number[] | null
+  in?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
+  notIn?: number[] | Prisma.ListFloatFieldRefInput<$PrismaModel> | null
  lt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  lte?: number | Prisma.FloatFieldRefInput<$PrismaModel>
  gt?: number | Prisma.FloatFieldRefInput<$PrismaModel>
@@ -68,7 +68,18 @@ export const ModelName = {
  MihomeHome: 'MihomeHome',
  MihomeDevice: 'MihomeDevice',
  MihomeEnvSample: 'MihomeEnvSample',
-  MihomeEnvHour: 'MihomeEnvHour'
+  MihomeEnvHour: 'MihomeEnvHour',
+  Habit: 'Habit',
+  CheckIn: 'CheckIn',
+  CheckList: 'CheckList',
+  CheckListItem: 'CheckListItem',
+  CheckListTemplate: 'CheckListTemplate',
+  Project: 'Project',
+  ProjectMember: 'ProjectMember',
+  BoardColumn: 'BoardColumn',
+  Task: 'Task',
+  TaskMember: 'TaskMember',
+  TaskTag: 'TaskTag'
 } as const

 export type ModelName = (typeof ModelName)[keyof typeof ModelName]
@@ -363,6 +374,181 @@ export const MihomeEnvHourScalarFieldEnum = {
 export type MihomeEnvHourScalarFieldEnum = (typeof MihomeEnvHourScalarFieldEnum)[keyof typeof MihomeEnvHourScalarFieldEnum]


+export const HabitScalarFieldEnum = {
+  id: 'id',
+  userId: 'userId',
+  name: 'name',
+  period: 'period',
+  target: 'target',
+  color: 'color',
+  icon: 'icon',
+  note: 'note',
+  archived: 'archived',
+  sortOrder: 'sortOrder',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type HabitScalarFieldEnum = (typeof HabitScalarFieldEnum)[keyof typeof HabitScalarFieldEnum]
+
+
+export const CheckInScalarFieldEnum = {
+  id: 'id',
+  habitId: 'habitId',
+  userId: 'userId',
+  date: 'date',
+  seq: 'seq',
+  note: 'note',
+  source: 'source',
+  createdAt: 'createdAt'
+} as const
+
+export type CheckInScalarFieldEnum = (typeof CheckInScalarFieldEnum)[keyof typeof CheckInScalarFieldEnum]
+
+
+export const CheckListScalarFieldEnum = {
+  id: 'id',
+  userId: 'userId',
+  title: 'title',
+  scene: 'scene',
+  note: 'note',
+  archived: 'archived',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type CheckListScalarFieldEnum = (typeof CheckListScalarFieldEnum)[keyof typeof CheckListScalarFieldEnum]
+
+
+export const CheckListItemScalarFieldEnum = {
+  id: 'id',
+  listId: 'listId',
+  title: 'title',
+  note: 'note',
+  done: 'done',
+  doneAt: 'doneAt',
+  sortOrder: 'sortOrder',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type CheckListItemScalarFieldEnum = (typeof CheckListItemScalarFieldEnum)[keyof typeof CheckListItemScalarFieldEnum]
+
+
+export const CheckListTemplateScalarFieldEnum = {
+  id: 'id',
+  userId: 'userId',
+  name: 'name',
+  scene: 'scene',
+  items: 'items',
+  builtin: 'builtin',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type CheckListTemplateScalarFieldEnum = (typeof CheckListTemplateScalarFieldEnum)[keyof typeof CheckListTemplateScalarFieldEnum]
+
+
+export const ProjectScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  code: 'code',
+  name: 'name',
+  ownerId: 'ownerId',
+  isPersonal: 'isPersonal',
+  archived: 'archived',
+  notes: 'notes',
+  taskKinds: 'taskKinds',
+  icon: 'icon',
+  autoArchive: 'autoArchive',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type ProjectScalarFieldEnum = (typeof ProjectScalarFieldEnum)[keyof typeof ProjectScalarFieldEnum]
+
+
+export const ProjectMemberScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  projectUuid: 'projectUuid',
+  projectId: 'projectId',
+  userId: 'userId',
+  permission: 'permission',
+  createdAt: 'createdAt'
+} as const
+
+export type ProjectMemberScalarFieldEnum = (typeof ProjectMemberScalarFieldEnum)[keyof typeof ProjectMemberScalarFieldEnum]
+
+
+export const BoardColumnScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  projectUuid: 'projectUuid',
+  projectId: 'projectId',
+  name: 'name',
+  sortOrder: 'sortOrder',
+  boundStatus: 'boundStatus',
+  retention: 'retention',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt'
+} as const
+
+export type BoardColumnScalarFieldEnum = (typeof BoardColumnScalarFieldEnum)[keyof typeof BoardColumnScalarFieldEnum]
+
+
+export const TaskScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  projectUuid: 'projectUuid',
+  columnUuid: 'columnUuid',
+  parentUuid: 'parentUuid',
+  projectId: 'projectId',
+  columnId: 'columnId',
+  parentId: 'parentId',
+  title: 'title',
+  description: 'description',
+  kind: 'kind',
+  markDate: 'markDate',
+  status: 'status',
+  doneAt: 'doneAt',
+  assigneeId: 'assigneeId',
+  creatorId: 'creatorId',
+  extras: 'extras',
+  sortOrder: 'sortOrder',
+  archived: 'archived',
+  archivedAt: 'archivedAt',
+  archiveSource: 'archiveSource',
+  createdAt: 'createdAt',
+  updatedAt: 'updatedAt',
+  number: 'number'
+} as const
+
+export type TaskScalarFieldEnum = (typeof TaskScalarFieldEnum)[keyof typeof TaskScalarFieldEnum]
+
+
+export const TaskMemberScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  taskUuid: 'taskUuid',
+  taskId: 'taskId',
+  userId: 'userId'
+} as const
+
+export type TaskMemberScalarFieldEnum = (typeof TaskMemberScalarFieldEnum)[keyof typeof TaskMemberScalarFieldEnum]
+
+
+export const TaskTagScalarFieldEnum = {
+  id: 'id',
+  uuid: 'uuid',
+  taskUuid: 'taskUuid',
+  taskId: 'taskId',
+  name: 'name'
+} as const
+
+export type TaskTagScalarFieldEnum = (typeof TaskTagScalarFieldEnum)[keyof typeof TaskTagScalarFieldEnum]
+
+
 export const SortOrder = {
  asc: 'asc',
  desc: 'desc'
@@ -386,23 +572,12 @@ export const NullableJsonNullValueInput = {
 export type NullableJsonNullValueInput = (typeof NullableJsonNullValueInput)[keyof typeof NullableJsonNullValueInput]


-export const UserOrderByRelevanceFieldEnum = {
-  name: 'name',
-  email: 'email',
-  password: 'password'
+export const QueryMode = {
+  default: 'default',
+  insensitive: 'insensitive'
 } as const

-export type UserOrderByRelevanceFieldEnum = (typeof UserOrderByRelevanceFieldEnum)[keyof typeof UserOrderByRelevanceFieldEnum]
-
-
-export const ArticleOrderByRelevanceFieldEnum = {
-  title: 'title',
-  slug: 'slug',
-  content: 'content',
-  date: 'date'
-} as const
-
-export type ArticleOrderByRelevanceFieldEnum = (typeof ArticleOrderByRelevanceFieldEnum)[keyof typeof ArticleOrderByRelevanceFieldEnum]
+export type QueryMode = (typeof QueryMode)[keyof typeof QueryMode]


 export const JsonNullValueFilter = {
@@ -414,41 +589,6 @@ export const JsonNullValueFilter = {
 export type JsonNullValueFilter = (typeof JsonNullValueFilter)[keyof typeof JsonNullValueFilter]


-export const QueryMode = {
-  default: 'default',
-  insensitive: 'insensitive'
-} as const
-
-export type QueryMode = (typeof QueryMode)[keyof typeof QueryMode]
-
-
-export const StrategyOrderByRelevanceFieldEnum = {
-  name: 'name',
-  description: 'description'
-} as const
-
-export type StrategyOrderByRelevanceFieldEnum = (typeof StrategyOrderByRelevanceFieldEnum)[keyof typeof StrategyOrderByRelevanceFieldEnum]
-
-
-export const IndicatorOrderByRelevanceFieldEnum = {
-  name: 'name',
-  groupName: 'groupName',
-  title: 'title',
-  unit: 'unit',
-  source: 'source',
-  frequency: 'frequency'
-} as const
-
-export type IndicatorOrderByRelevanceFieldEnum = (typeof IndicatorOrderByRelevanceFieldEnum)[keyof typeof IndicatorOrderByRelevanceFieldEnum]
-
-
-export const IndicatorPointOrderByRelevanceFieldEnum = {
-  period: 'period'
-} as const
-
-export type IndicatorPointOrderByRelevanceFieldEnum = (typeof IndicatorPointOrderByRelevanceFieldEnum)[keyof typeof IndicatorPointOrderByRelevanceFieldEnum]
-
-
 export const NullsOrder = {
  first: 'first',
  last: 'last'
@@ -456,113 +596,3 @@ export const NullsOrder = {

 export type NullsOrder = (typeof NullsOrder)[keyof typeof NullsOrder]

-
-export const NewsOrderByRelevanceFieldEnum = {
-  title: 'title',
-  summary: 'summary',
-  content: 'content',
-  source: 'source',
-  url: 'url'
-} as const
-
-export type NewsOrderByRelevanceFieldEnum = (typeof NewsOrderByRelevanceFieldEnum)[keyof typeof NewsOrderByRelevanceFieldEnum]
-
-
-export const AlertOrderByRelevanceFieldEnum = {
-  indicatorName: 'indicatorName',
-  period: 'period',
-  sourceA: 'sourceA',
-  sourceB: 'sourceB'
-} as const
-
-export type AlertOrderByRelevanceFieldEnum = (typeof AlertOrderByRelevanceFieldEnum)[keyof typeof AlertOrderByRelevanceFieldEnum]
-
-
-export const ServerNodeOrderByRelevanceFieldEnum = {
-  uuid: 'uuid',
-  name: 'name',
-  cpuName: 'cpuName',
-  os: 'os',
-  region: 'region',
-  status: 'status'
-} as const
-
-export type ServerNodeOrderByRelevanceFieldEnum = (typeof ServerNodeOrderByRelevanceFieldEnum)[keyof typeof ServerNodeOrderByRelevanceFieldEnum]
-
-
-export const ServerNodeHistoryOrderByRelevanceFieldEnum = {
-  uuid: 'uuid'
-} as const
-
-export type ServerNodeHistoryOrderByRelevanceFieldEnum = (typeof ServerNodeHistoryOrderByRelevanceFieldEnum)[keyof typeof ServerNodeHistoryOrderByRelevanceFieldEnum]
-
-
-export const ServiceCheckOrderByRelevanceFieldEnum = {
-  name: 'name',
-  url: 'url',
-  status: 'status',
-  message: 'message'
-} as const
-
-export type ServiceCheckOrderByRelevanceFieldEnum = (typeof ServiceCheckOrderByRelevanceFieldEnum)[keyof typeof ServiceCheckOrderByRelevanceFieldEnum]
-
-
-export const Econ_SowInventoryOrderByRelevanceFieldEnum = {
-  month: 'month'
-} as const
-
-export type Econ_SowInventoryOrderByRelevanceFieldEnum = (typeof Econ_SowInventoryOrderByRelevanceFieldEnum)[keyof typeof Econ_SowInventoryOrderByRelevanceFieldEnum]
-
-
-export const ScraperCacheOrderByRelevanceFieldEnum = {
-  scraperName: 'scraperName',
-  lastDataHash: 'lastDataHash'
-} as const
-
-export type ScraperCacheOrderByRelevanceFieldEnum = (typeof ScraperCacheOrderByRelevanceFieldEnum)[keyof typeof ScraperCacheOrderByRelevanceFieldEnum]
-
-
-export const OilPriceHistoryOrderByRelevanceFieldEnum = {
-  province: 'province',
-  fuel: 'fuel',
-  source: 'source'
-} as const
-
-export type OilPriceHistoryOrderByRelevanceFieldEnum = (typeof OilPriceHistoryOrderByRelevanceFieldEnum)[keyof typeof OilPriceHistoryOrderByRelevanceFieldEnum]
-
-
-export const MihomeAccountOrderByRelevanceFieldEnum = {
-  key: 'key',
-  userId: 'userId',
-  status: 'status',
-  lastError: 'lastError'
-} as const
-
-export type MihomeAccountOrderByRelevanceFieldEnum = (typeof MihomeAccountOrderByRelevanceFieldEnum)[keyof typeof MihomeAccountOrderByRelevanceFieldEnum]
-
-
-export const MihomeHomeOrderByRelevanceFieldEnum = {
-  homeId: 'homeId',
-  name: 'name'
-} as const
-
-export type MihomeHomeOrderByRelevanceFieldEnum = (typeof MihomeHomeOrderByRelevanceFieldEnum)[keyof typeof MihomeHomeOrderByRelevanceFieldEnum]
-
-
-export const MihomeDeviceOrderByRelevanceFieldEnum = {
-  did: 'did',
-  homeId: 'homeId',
-  model: 'model',
-  name: 'name',
-  alias: 'alias'
-} as const
-
-export type MihomeDeviceOrderByRelevanceFieldEnum = (typeof MihomeDeviceOrderByRelevanceFieldEnum)[keyof typeof MihomeDeviceOrderByRelevanceFieldEnum]
-
-
-export const MihomeEnvSampleOrderByRelevanceFieldEnum = {
-  origin: 'origin'
-} as const
-
-export type MihomeEnvSampleOrderByRelevanceFieldEnum = (typeof MihomeEnvSampleOrderByRelevanceFieldEnum)[keyof typeof MihomeEnvSampleOrderByRelevanceFieldEnum]
-
@@ -26,4 +26,15 @@ export type * from './models/MihomeHome.ts'
 export type * from './models/MihomeDevice.ts'
 export type * from './models/MihomeEnvSample.ts'
 export type * from './models/MihomeEnvHour.ts'
+export type * from './models/Habit.ts'
+export type * from './models/CheckIn.ts'
+export type * from './models/CheckList.ts'
+export type * from './models/CheckListItem.ts'
+export type * from './models/CheckListTemplate.ts'
+export type * from './models/Project.ts'
+export type * from './models/ProjectMember.ts'
+export type * from './models/BoardColumn.ts'
+export type * from './models/Task.ts'
+export type * from './models/TaskMember.ts'
+export type * from './models/TaskTag.ts'
 export type * from './commonInputTypes.ts'
@@ -285,7 +285,6 @@ export type AlertOrderByWithRelationInput = {
  diff?: Prisma.SortOrder
  diffRatio?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
-  _relevance?: Prisma.AlertOrderByRelevanceInput
 }

 export type AlertWhereUniqueInput = Prisma.AtLeast<{
@@ -426,12 +425,6 @@ export type AlertUncheckedUpdateManyInput = {
  createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type AlertOrderByRelevanceInput = {
-  fields: Prisma.AlertOrderByRelevanceFieldEnum | Prisma.AlertOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type AlertCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  indicatorName?: Prisma.SortOrder
@@ -502,7 +495,31 @@ export type AlertSelect<ExtArgs extends runtime.Types.Extensions.InternalArgs =
  createdAt?: boolean
 }, ExtArgs["result"]["alert"]>

+export type AlertSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  indicatorName?: boolean
+  period?: boolean
+  valueA?: boolean
+  valueB?: boolean
+  sourceA?: boolean
+  sourceB?: boolean
+  diff?: boolean
+  diffRatio?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["alert"]>

+export type AlertSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  indicatorName?: boolean
+  period?: boolean
+  valueA?: boolean
+  valueB?: boolean
+  sourceA?: boolean
+  sourceB?: boolean
+  diff?: boolean
+  diffRatio?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["alert"]>

 export type AlertSelectScalar = {
  id?: boolean
@@ -650,6 +667,30 @@ export interface AlertDelegate<ExtArgs extends runtime.Types.Extensions.Internal
   */
  createMany<T extends AlertCreateManyArgs>(args?: Prisma.SelectSubset<T, AlertCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many Alerts and returns the data saved in the database.
+   * @param {AlertCreateManyAndReturnArgs} args - Arguments to create many Alerts.
+   * @example
+   * // Create many Alerts
+   * const alert = await prisma.alert.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many Alerts and only return the `id`
+   * const alertWithIdOnly = await prisma.alert.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends AlertCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, AlertCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$AlertPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a Alert.
   * @param {AlertDeleteArgs} args - Arguments to delete one Alert.
@@ -714,6 +755,36 @@ export interface AlertDelegate<ExtArgs extends runtime.Types.Extensions.Internal
   */
  updateMany<T extends AlertUpdateManyArgs>(args: Prisma.SelectSubset<T, AlertUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more Alerts and returns the data updated in the database.
+   * @param {AlertUpdateManyAndReturnArgs} args - Arguments to update many Alerts.
+   * @example
+   * // Update many Alerts
+   * const alert = await prisma.alert.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more Alerts and only return the `id`
+   * const alertWithIdOnly = await prisma.alert.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends AlertUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, AlertUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$AlertPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one Alert.
   * @param {AlertUpsertArgs} args - Arguments to update or create a Alert.
@@ -1125,6 +1196,25 @@ export type AlertCreateManyArgs<ExtArgs extends runtime.Types.Extensions.Interna
  skipDuplicates?: boolean
 }

+/**
+ * Alert createManyAndReturn
+ */
+export type AlertCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Alert
+   */
+  select?: Prisma.AlertSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Alert
+   */
+  omit?: Prisma.AlertOmit<ExtArgs> | null
+  /**
+   * The data used to create many Alerts.
+   */
+  data: Prisma.AlertCreateManyInput | Prisma.AlertCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * Alert update
 */
@@ -1165,6 +1255,32 @@ export type AlertUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.Interna
  limit?: number
 }

+/**
+ * Alert updateManyAndReturn
+ */
+export type AlertUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Alert
+   */
+  select?: Prisma.AlertSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Alert
+   */
+  omit?: Prisma.AlertOmit<ExtArgs> | null
+  /**
+   * The data used to update Alerts.
+   */
+  data: Prisma.XOR<Prisma.AlertUpdateManyMutationInput, Prisma.AlertUncheckedUpdateManyInput>
+  /**
+   * Filter which Alerts to update
+   */
+  where?: Prisma.AlertWhereInput
+  /**
+   * Limit how many Alerts to update.
+   */
+  limit?: number
+}
+
 /**
 * Alert upsert
 */
@@ -242,7 +242,6 @@ export type ArticleOrderByWithRelationInput = {
  date?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.ArticleOrderByRelevanceInput
 }

 export type ArticleWhereUniqueInput = Prisma.AtLeast<{
@@ -353,12 +352,6 @@ export type ArticleUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type ArticleOrderByRelevanceInput = {
-  fields: Prisma.ArticleOrderByRelevanceFieldEnum | Prisma.ArticleOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type ArticleCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  title?: Prisma.SortOrder
@@ -409,7 +402,25 @@ export type ArticleSelect<ExtArgs extends runtime.Types.Extensions.InternalArgs
  updatedAt?: boolean
 }, ExtArgs["result"]["article"]>

+export type ArticleSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  title?: boolean
+  slug?: boolean
+  content?: boolean
+  date?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["article"]>

+export type ArticleSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  title?: boolean
+  slug?: boolean
+  content?: boolean
+  date?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["article"]>

 export type ArticleSelectScalar = {
  id?: boolean
@@ -551,6 +562,30 @@ export interface ArticleDelegate<ExtArgs extends runtime.Types.Extensions.Intern
   */
  createMany<T extends ArticleCreateManyArgs>(args?: Prisma.SelectSubset<T, ArticleCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many Articles and returns the data saved in the database.
+   * @param {ArticleCreateManyAndReturnArgs} args - Arguments to create many Articles.
+   * @example
+   * // Create many Articles
+   * const article = await prisma.article.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many Articles and only return the `id`
+   * const articleWithIdOnly = await prisma.article.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends ArticleCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, ArticleCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ArticlePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a Article.
   * @param {ArticleDeleteArgs} args - Arguments to delete one Article.
@@ -615,6 +650,36 @@ export interface ArticleDelegate<ExtArgs extends runtime.Types.Extensions.Intern
   */
  updateMany<T extends ArticleUpdateManyArgs>(args: Prisma.SelectSubset<T, ArticleUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more Articles and returns the data updated in the database.
+   * @param {ArticleUpdateManyAndReturnArgs} args - Arguments to update many Articles.
+   * @example
+   * // Update many Articles
+   * const article = await prisma.article.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more Articles and only return the `id`
+   * const articleWithIdOnly = await prisma.article.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends ArticleUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, ArticleUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ArticlePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one Article.
   * @param {ArticleUpsertArgs} args - Arguments to update or create a Article.
@@ -1023,6 +1088,25 @@ export type ArticleCreateManyArgs<ExtArgs extends runtime.Types.Extensions.Inter
  skipDuplicates?: boolean
 }

+/**
+ * Article createManyAndReturn
+ */
+export type ArticleCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Article
+   */
+  select?: Prisma.ArticleSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Article
+   */
+  omit?: Prisma.ArticleOmit<ExtArgs> | null
+  /**
+   * The data used to create many Articles.
+   */
+  data: Prisma.ArticleCreateManyInput | Prisma.ArticleCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * Article update
 */
@@ -1063,6 +1147,32 @@ export type ArticleUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.Inter
  limit?: number
 }

+/**
+ * Article updateManyAndReturn
+ */
+export type ArticleUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Article
+   */
+  select?: Prisma.ArticleSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Article
+   */
+  omit?: Prisma.ArticleOmit<ExtArgs> | null
+  /**
+   * The data used to update Articles.
+   */
+  data: Prisma.XOR<Prisma.ArticleUpdateManyMutationInput, Prisma.ArticleUncheckedUpdateManyInput>
+  /**
+   * Filter which Articles to update
+   */
+  where?: Prisma.ArticleWhereInput
+  /**
+   * Limit how many Articles to update.
+   */
+  limit?: number
+}
+
 /**
 * Article upsert
 */
@@ -228,7 +228,6 @@ export type Econ_SowInventoryOrderByWithRelationInput = {
  inventory?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.Econ_SowInventoryOrderByRelevanceInput
 }

 export type Econ_SowInventoryWhereUniqueInput = Prisma.AtLeast<{
@@ -319,12 +318,6 @@ export type Econ_SowInventoryUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type Econ_SowInventoryOrderByRelevanceInput = {
-  fields: Prisma.Econ_SowInventoryOrderByRelevanceFieldEnum | Prisma.Econ_SowInventoryOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type Econ_SowInventoryCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  month?: Prisma.SortOrder
@@ -369,7 +362,21 @@ export type Econ_SowInventorySelect<ExtArgs extends runtime.Types.Extensions.Int
  updatedAt?: boolean
 }, ExtArgs["result"]["econ_SowInventory"]>

+export type Econ_SowInventorySelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  month?: boolean
+  inventory?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["econ_SowInventory"]>

+export type Econ_SowInventorySelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  month?: boolean
+  inventory?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["econ_SowInventory"]>

 export type Econ_SowInventorySelectScalar = {
  id?: boolean
@@ -507,6 +514,30 @@ export interface Econ_SowInventoryDelegate<ExtArgs extends runtime.Types.Extensi
   */
  createMany<T extends Econ_SowInventoryCreateManyArgs>(args?: Prisma.SelectSubset<T, Econ_SowInventoryCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many Econ_SowInventories and returns the data saved in the database.
+   * @param {Econ_SowInventoryCreateManyAndReturnArgs} args - Arguments to create many Econ_SowInventories.
+   * @example
+   * // Create many Econ_SowInventories
+   * const econ_SowInventory = await prisma.econ_SowInventory.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many Econ_SowInventories and only return the `id`
+   * const econ_SowInventoryWithIdOnly = await prisma.econ_SowInventory.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends Econ_SowInventoryCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, Econ_SowInventoryCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$Econ_SowInventoryPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a Econ_SowInventory.
   * @param {Econ_SowInventoryDeleteArgs} args - Arguments to delete one Econ_SowInventory.
@@ -571,6 +602,36 @@ export interface Econ_SowInventoryDelegate<ExtArgs extends runtime.Types.Extensi
   */
  updateMany<T extends Econ_SowInventoryUpdateManyArgs>(args: Prisma.SelectSubset<T, Econ_SowInventoryUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more Econ_SowInventories and returns the data updated in the database.
+   * @param {Econ_SowInventoryUpdateManyAndReturnArgs} args - Arguments to update many Econ_SowInventories.
+   * @example
+   * // Update many Econ_SowInventories
+   * const econ_SowInventory = await prisma.econ_SowInventory.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more Econ_SowInventories and only return the `id`
+   * const econ_SowInventoryWithIdOnly = await prisma.econ_SowInventory.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends Econ_SowInventoryUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, Econ_SowInventoryUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$Econ_SowInventoryPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one Econ_SowInventory.
   * @param {Econ_SowInventoryUpsertArgs} args - Arguments to update or create a Econ_SowInventory.
@@ -977,6 +1038,25 @@ export type Econ_SowInventoryCreateManyArgs<ExtArgs extends runtime.Types.Extens
  skipDuplicates?: boolean
 }

+/**
+ * Econ_SowInventory createManyAndReturn
+ */
+export type Econ_SowInventoryCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Econ_SowInventory
+   */
+  select?: Prisma.Econ_SowInventorySelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Econ_SowInventory
+   */
+  omit?: Prisma.Econ_SowInventoryOmit<ExtArgs> | null
+  /**
+   * The data used to create many Econ_SowInventories.
+   */
+  data: Prisma.Econ_SowInventoryCreateManyInput | Prisma.Econ_SowInventoryCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * Econ_SowInventory update
 */
@@ -1017,6 +1097,32 @@ export type Econ_SowInventoryUpdateManyArgs<ExtArgs extends runtime.Types.Extens
  limit?: number
 }

+/**
+ * Econ_SowInventory updateManyAndReturn
+ */
+export type Econ_SowInventoryUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Econ_SowInventory
+   */
+  select?: Prisma.Econ_SowInventorySelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Econ_SowInventory
+   */
+  omit?: Prisma.Econ_SowInventoryOmit<ExtArgs> | null
+  /**
+   * The data used to update Econ_SowInventories.
+   */
+  data: Prisma.XOR<Prisma.Econ_SowInventoryUpdateManyMutationInput, Prisma.Econ_SowInventoryUncheckedUpdateManyInput>
+  /**
+   * Filter which Econ_SowInventories to update
+   */
+  where?: Prisma.Econ_SowInventoryWhereInput
+  /**
+   * Limit how many Econ_SowInventories to update.
+   */
+  limit?: number
+}
+
 /**
 * Econ_SowInventory upsert
 */
@@ -271,7 +271,6 @@ export type IndicatorOrderByWithRelationInput = {
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
  points?: Prisma.IndicatorPointOrderByRelationAggregateInput
-  _relevance?: Prisma.IndicatorOrderByRelevanceInput
 }

 export type IndicatorWhereUniqueInput = Prisma.AtLeast<{
@@ -417,12 +416,6 @@ export type IndicatorUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type IndicatorOrderByRelevanceInput = {
-  fields: Prisma.IndicatorOrderByRelevanceFieldEnum | Prisma.IndicatorOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type IndicatorCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  name?: Prisma.SortOrder
@@ -605,7 +598,31 @@ export type IndicatorSelect<ExtArgs extends runtime.Types.Extensions.InternalArg
  _count?: boolean | Prisma.IndicatorCountOutputTypeDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["indicator"]>

+export type IndicatorSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  groupName?: boolean
+  title?: boolean
+  unit?: boolean
+  source?: boolean
+  frequency?: boolean
+  hidden?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["indicator"]>

+export type IndicatorSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  groupName?: boolean
+  title?: boolean
+  unit?: boolean
+  source?: boolean
+  frequency?: boolean
+  hidden?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["indicator"]>

 export type IndicatorSelectScalar = {
  id?: boolean
@@ -625,6 +642,8 @@ export type IndicatorInclude<ExtArgs extends runtime.Types.Extensions.InternalAr
  points?: boolean | Prisma.Indicator$pointsArgs<ExtArgs>
  _count?: boolean | Prisma.IndicatorCountOutputTypeDefaultArgs<ExtArgs>
 }
+export type IndicatorIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {}
+export type IndicatorIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {}

 export type $IndicatorPayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "Indicator"
@@ -759,6 +778,30 @@ export interface IndicatorDelegate<ExtArgs extends runtime.Types.Extensions.Inte
   */
  createMany<T extends IndicatorCreateManyArgs>(args?: Prisma.SelectSubset<T, IndicatorCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many Indicators and returns the data saved in the database.
+   * @param {IndicatorCreateManyAndReturnArgs} args - Arguments to create many Indicators.
+   * @example
+   * // Create many Indicators
+   * const indicator = await prisma.indicator.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many Indicators and only return the `id`
+   * const indicatorWithIdOnly = await prisma.indicator.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends IndicatorCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, IndicatorCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$IndicatorPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a Indicator.
   * @param {IndicatorDeleteArgs} args - Arguments to delete one Indicator.
@@ -823,6 +866,36 @@ export interface IndicatorDelegate<ExtArgs extends runtime.Types.Extensions.Inte
   */
  updateMany<T extends IndicatorUpdateManyArgs>(args: Prisma.SelectSubset<T, IndicatorUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more Indicators and returns the data updated in the database.
+   * @param {IndicatorUpdateManyAndReturnArgs} args - Arguments to update many Indicators.
+   * @example
+   * // Update many Indicators
+   * const indicator = await prisma.indicator.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more Indicators and only return the `id`
+   * const indicatorWithIdOnly = await prisma.indicator.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends IndicatorUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, IndicatorUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$IndicatorPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one Indicator.
   * @param {IndicatorUpsertArgs} args - Arguments to update or create a Indicator.
@@ -1259,6 +1332,25 @@ export type IndicatorCreateManyArgs<ExtArgs extends runtime.Types.Extensions.Int
  skipDuplicates?: boolean
 }

+/**
+ * Indicator createManyAndReturn
+ */
+export type IndicatorCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Indicator
+   */
+  select?: Prisma.IndicatorSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Indicator
+   */
+  omit?: Prisma.IndicatorOmit<ExtArgs> | null
+  /**
+   * The data used to create many Indicators.
+   */
+  data: Prisma.IndicatorCreateManyInput | Prisma.IndicatorCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * Indicator update
 */
@@ -1303,6 +1395,32 @@ export type IndicatorUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.Int
  limit?: number
 }

+/**
+ * Indicator updateManyAndReturn
+ */
+export type IndicatorUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Indicator
+   */
+  select?: Prisma.IndicatorSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Indicator
+   */
+  omit?: Prisma.IndicatorOmit<ExtArgs> | null
+  /**
+   * The data used to update Indicators.
+   */
+  data: Prisma.XOR<Prisma.IndicatorUpdateManyMutationInput, Prisma.IndicatorUncheckedUpdateManyInput>
+  /**
+   * Filter which Indicators to update
+   */
+  where?: Prisma.IndicatorWhereInput
+  /**
+   * Limit how many Indicators to update.
+   */
+  limit?: number
+}
+
 /**
 * Indicator upsert
 */
@@ -243,7 +243,6 @@ export type IndicatorPointOrderByWithRelationInput = {
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
  indicator?: Prisma.IndicatorOrderByWithRelationInput
-  _relevance?: Prisma.IndicatorPointOrderByRelevanceInput
 }

 export type IndicatorPointWhereUniqueInput = Prisma.AtLeast<{
@@ -355,12 +354,6 @@ export type IndicatorPointOrderByRelationAggregateInput = {
  _count?: Prisma.SortOrder
 }

-export type IndicatorPointOrderByRelevanceInput = {
-  fields: Prisma.IndicatorPointOrderByRelevanceFieldEnum | Prisma.IndicatorPointOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type IndicatorPointIndicatorIdPeriodCompoundUniqueInput = {
  indicatorId: number
  period: string
@@ -551,7 +544,25 @@ export type IndicatorPointSelect<ExtArgs extends runtime.Types.Extensions.Intern
  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["indicatorPoint"]>

+export type IndicatorPointSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  indicatorId?: boolean
+  period?: boolean
+  value?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["indicatorPoint"]>

+export type IndicatorPointSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  indicatorId?: boolean
+  period?: boolean
+  value?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["indicatorPoint"]>

 export type IndicatorPointSelectScalar = {
  id?: boolean
@@ -566,6 +577,12 @@ export type IndicatorPointOmit<ExtArgs extends runtime.Types.Extensions.Internal
 export type IndicatorPointInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
 }
+export type IndicatorPointIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
+}
+export type IndicatorPointIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  indicator?: boolean | Prisma.IndicatorDefaultArgs<ExtArgs>
+}

 export type $IndicatorPointPayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "IndicatorPoint"
@@ -696,6 +713,30 @@ export interface IndicatorPointDelegate<ExtArgs extends runtime.Types.Extensions
   */
  createMany<T extends IndicatorPointCreateManyArgs>(args?: Prisma.SelectSubset<T, IndicatorPointCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many IndicatorPoints and returns the data saved in the database.
+   * @param {IndicatorPointCreateManyAndReturnArgs} args - Arguments to create many IndicatorPoints.
+   * @example
+   * // Create many IndicatorPoints
+   * const indicatorPoint = await prisma.indicatorPoint.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many IndicatorPoints and only return the `id`
+   * const indicatorPointWithIdOnly = await prisma.indicatorPoint.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends IndicatorPointCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, IndicatorPointCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$IndicatorPointPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a IndicatorPoint.
   * @param {IndicatorPointDeleteArgs} args - Arguments to delete one IndicatorPoint.
@@ -760,6 +801,36 @@ export interface IndicatorPointDelegate<ExtArgs extends runtime.Types.Extensions
   */
  updateMany<T extends IndicatorPointUpdateManyArgs>(args: Prisma.SelectSubset<T, IndicatorPointUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more IndicatorPoints and returns the data updated in the database.
+   * @param {IndicatorPointUpdateManyAndReturnArgs} args - Arguments to update many IndicatorPoints.
+   * @example
+   * // Update many IndicatorPoints
+   * const indicatorPoint = await prisma.indicatorPoint.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more IndicatorPoints and only return the `id`
+   * const indicatorPointWithIdOnly = await prisma.indicatorPoint.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends IndicatorPointUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, IndicatorPointUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$IndicatorPointPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one IndicatorPoint.
   * @param {IndicatorPointUpsertArgs} args - Arguments to update or create a IndicatorPoint.
@@ -1192,6 +1263,29 @@ export type IndicatorPointCreateManyArgs<ExtArgs extends runtime.Types.Extension
  skipDuplicates?: boolean
 }

+/**
+ * IndicatorPoint createManyAndReturn
+ */
+export type IndicatorPointCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the IndicatorPoint
+   */
+  select?: Prisma.IndicatorPointSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the IndicatorPoint
+   */
+  omit?: Prisma.IndicatorPointOmit<ExtArgs> | null
+  /**
+   * The data used to create many IndicatorPoints.
+   */
+  data: Prisma.IndicatorPointCreateManyInput | Prisma.IndicatorPointCreateManyInput[]
+  skipDuplicates?: boolean
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.IndicatorPointIncludeCreateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * IndicatorPoint update
 */
@@ -1236,6 +1330,36 @@ export type IndicatorPointUpdateManyArgs<ExtArgs extends runtime.Types.Extension
  limit?: number
 }

+/**
+ * IndicatorPoint updateManyAndReturn
+ */
+export type IndicatorPointUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the IndicatorPoint
+   */
+  select?: Prisma.IndicatorPointSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the IndicatorPoint
+   */
+  omit?: Prisma.IndicatorPointOmit<ExtArgs> | null
+  /**
+   * The data used to update IndicatorPoints.
+   */
+  data: Prisma.XOR<Prisma.IndicatorPointUpdateManyMutationInput, Prisma.IndicatorPointUncheckedUpdateManyInput>
+  /**
+   * Filter which IndicatorPoints to update
+   */
+  where?: Prisma.IndicatorPointWhereInput
+  /**
+   * Limit how many IndicatorPoints to update.
+   */
+  limit?: number
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.IndicatorPointIncludeUpdateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * IndicatorPoint upsert
 */
@@ -233,7 +233,6 @@ export type MihomeAccountOrderByWithRelationInput = {
  status?: Prisma.SortOrder
  lastError?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.MihomeAccountOrderByRelevanceInput
 }

 export type MihomeAccountWhereUniqueInput = Prisma.AtLeast<{
@@ -334,12 +333,6 @@ export type MihomeAccountUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type MihomeAccountOrderByRelevanceInput = {
-  fields: Prisma.MihomeAccountOrderByRelevanceFieldEnum | Prisma.MihomeAccountOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type MihomeAccountCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  key?: Prisma.SortOrder
@@ -386,7 +379,23 @@ export type MihomeAccountSelect<ExtArgs extends runtime.Types.Extensions.Interna
  updatedAt?: boolean
 }, ExtArgs["result"]["mihomeAccount"]>

+export type MihomeAccountSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  key?: boolean
+  userId?: boolean
+  status?: boolean
+  lastError?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["mihomeAccount"]>

+export type MihomeAccountSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  key?: boolean
+  userId?: boolean
+  status?: boolean
+  lastError?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["mihomeAccount"]>

 export type MihomeAccountSelectScalar = {
  id?: boolean
@@ -526,6 +535,30 @@ export interface MihomeAccountDelegate<ExtArgs extends runtime.Types.Extensions.
   */
  createMany<T extends MihomeAccountCreateManyArgs>(args?: Prisma.SelectSubset<T, MihomeAccountCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many MihomeAccounts and returns the data saved in the database.
+   * @param {MihomeAccountCreateManyAndReturnArgs} args - Arguments to create many MihomeAccounts.
+   * @example
+   * // Create many MihomeAccounts
+   * const mihomeAccount = await prisma.mihomeAccount.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many MihomeAccounts and only return the `id`
+   * const mihomeAccountWithIdOnly = await prisma.mihomeAccount.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends MihomeAccountCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, MihomeAccountCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeAccountPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a MihomeAccount.
   * @param {MihomeAccountDeleteArgs} args - Arguments to delete one MihomeAccount.
@@ -590,6 +623,36 @@ export interface MihomeAccountDelegate<ExtArgs extends runtime.Types.Extensions.
   */
  updateMany<T extends MihomeAccountUpdateManyArgs>(args: Prisma.SelectSubset<T, MihomeAccountUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more MihomeAccounts and returns the data updated in the database.
+   * @param {MihomeAccountUpdateManyAndReturnArgs} args - Arguments to update many MihomeAccounts.
+   * @example
+   * // Update many MihomeAccounts
+   * const mihomeAccount = await prisma.mihomeAccount.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more MihomeAccounts and only return the `id`
+   * const mihomeAccountWithIdOnly = await prisma.mihomeAccount.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends MihomeAccountUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, MihomeAccountUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeAccountPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one MihomeAccount.
   * @param {MihomeAccountUpsertArgs} args - Arguments to update or create a MihomeAccount.
@@ -997,6 +1060,25 @@ export type MihomeAccountCreateManyArgs<ExtArgs extends runtime.Types.Extensions
  skipDuplicates?: boolean
 }

+/**
+ * MihomeAccount createManyAndReturn
+ */
+export type MihomeAccountCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeAccount
+   */
+  select?: Prisma.MihomeAccountSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeAccount
+   */
+  omit?: Prisma.MihomeAccountOmit<ExtArgs> | null
+  /**
+   * The data used to create many MihomeAccounts.
+   */
+  data: Prisma.MihomeAccountCreateManyInput | Prisma.MihomeAccountCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * MihomeAccount update
 */
@@ -1037,6 +1119,32 @@ export type MihomeAccountUpdateManyArgs<ExtArgs extends runtime.Types.Extensions
  limit?: number
 }

+/**
+ * MihomeAccount updateManyAndReturn
+ */
+export type MihomeAccountUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeAccount
+   */
+  select?: Prisma.MihomeAccountSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeAccount
+   */
+  omit?: Prisma.MihomeAccountOmit<ExtArgs> | null
+  /**
+   * The data used to update MihomeAccounts.
+   */
+  data: Prisma.XOR<Prisma.MihomeAccountUpdateManyMutationInput, Prisma.MihomeAccountUncheckedUpdateManyInput>
+  /**
+   * Filter which MihomeAccounts to update
+   */
+  where?: Prisma.MihomeAccountWhereInput
+  /**
+   * Limit how many MihomeAccounts to update.
+   */
+  limit?: number
+}
+
 /**
 * MihomeAccount upsert
 */
@@ -366,7 +366,6 @@ export type MihomeDeviceOrderByWithRelationInput = {
  home?: Prisma.MihomeHomeOrderByWithRelationInput
  samples?: Prisma.MihomeEnvSampleOrderByRelationAggregateInput
  hours?: Prisma.MihomeEnvHourOrderByRelationAggregateInput
-  _relevance?: Prisma.MihomeDeviceOrderByRelevanceInput
 }

 export type MihomeDeviceWhereUniqueInput = Prisma.AtLeast<{
@@ -597,12 +596,6 @@ export type MihomeDeviceOrderByRelationAggregateInput = {
  _count?: Prisma.SortOrder
 }

-export type MihomeDeviceOrderByRelevanceInput = {
-  fields: Prisma.MihomeDeviceOrderByRelevanceFieldEnum | Prisma.MihomeDeviceOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type MihomeDeviceCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  did?: Prisma.SortOrder
@@ -1201,7 +1194,47 @@ export type MihomeDeviceSelect<ExtArgs extends runtime.Types.Extensions.Internal
  _count?: boolean | Prisma.MihomeDeviceCountOutputTypeDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["mihomeDevice"]>

+export type MihomeDeviceSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  did?: boolean
+  homeId?: boolean
+  model?: boolean
+  name?: boolean
+  alias?: boolean
+  tempSiid?: boolean
+  tempPiid?: boolean
+  humSiid?: boolean
+  humPiid?: boolean
+  battSiid?: boolean
+  battPiid?: boolean
+  battery?: boolean
+  batteryAt?: boolean
+  enabled?: boolean
+  lastSyncAt?: boolean
+  createdAt?: boolean
+  home?: boolean | Prisma.MihomeHomeDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeDevice"]>

+export type MihomeDeviceSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  did?: boolean
+  homeId?: boolean
+  model?: boolean
+  name?: boolean
+  alias?: boolean
+  tempSiid?: boolean
+  tempPiid?: boolean
+  humSiid?: boolean
+  humPiid?: boolean
+  battSiid?: boolean
+  battPiid?: boolean
+  battery?: boolean
+  batteryAt?: boolean
+  enabled?: boolean
+  lastSyncAt?: boolean
+  createdAt?: boolean
+  home?: boolean | Prisma.MihomeHomeDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeDevice"]>

 export type MihomeDeviceSelectScalar = {
  id?: boolean
@@ -1230,6 +1263,12 @@ export type MihomeDeviceInclude<ExtArgs extends runtime.Types.Extensions.Interna
  hours?: boolean | Prisma.MihomeDevice$hoursArgs<ExtArgs>
  _count?: boolean | Prisma.MihomeDeviceCountOutputTypeDefaultArgs<ExtArgs>
 }
+export type MihomeDeviceIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  home?: boolean | Prisma.MihomeHomeDefaultArgs<ExtArgs>
+}
+export type MihomeDeviceIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  home?: boolean | Prisma.MihomeHomeDefaultArgs<ExtArgs>
+}

 export type $MihomeDevicePayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "MihomeDevice"
@@ -1373,6 +1412,30 @@ export interface MihomeDeviceDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  createMany<T extends MihomeDeviceCreateManyArgs>(args?: Prisma.SelectSubset<T, MihomeDeviceCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many MihomeDevices and returns the data saved in the database.
+   * @param {MihomeDeviceCreateManyAndReturnArgs} args - Arguments to create many MihomeDevices.
+   * @example
+   * // Create many MihomeDevices
+   * const mihomeDevice = await prisma.mihomeDevice.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many MihomeDevices and only return the `id`
+   * const mihomeDeviceWithIdOnly = await prisma.mihomeDevice.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends MihomeDeviceCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, MihomeDeviceCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeDevicePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a MihomeDevice.
   * @param {MihomeDeviceDeleteArgs} args - Arguments to delete one MihomeDevice.
@@ -1437,6 +1500,36 @@ export interface MihomeDeviceDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  updateMany<T extends MihomeDeviceUpdateManyArgs>(args: Prisma.SelectSubset<T, MihomeDeviceUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more MihomeDevices and returns the data updated in the database.
+   * @param {MihomeDeviceUpdateManyAndReturnArgs} args - Arguments to update many MihomeDevices.
+   * @example
+   * // Update many MihomeDevices
+   * const mihomeDevice = await prisma.mihomeDevice.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more MihomeDevices and only return the `id`
+   * const mihomeDeviceWithIdOnly = await prisma.mihomeDevice.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends MihomeDeviceUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, MihomeDeviceUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeDevicePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one MihomeDevice.
   * @param {MihomeDeviceUpsertArgs} args - Arguments to update or create a MihomeDevice.
@@ -1882,6 +1975,29 @@ export type MihomeDeviceCreateManyArgs<ExtArgs extends runtime.Types.Extensions.
  skipDuplicates?: boolean
 }

+/**
+ * MihomeDevice createManyAndReturn
+ */
+export type MihomeDeviceCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeDevice
+   */
+  select?: Prisma.MihomeDeviceSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeDevice
+   */
+  omit?: Prisma.MihomeDeviceOmit<ExtArgs> | null
+  /**
+   * The data used to create many MihomeDevices.
+   */
+  data: Prisma.MihomeDeviceCreateManyInput | Prisma.MihomeDeviceCreateManyInput[]
+  skipDuplicates?: boolean
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeDeviceIncludeCreateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeDevice update
 */
@@ -1926,6 +2042,36 @@ export type MihomeDeviceUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.
  limit?: number
 }

+/**
+ * MihomeDevice updateManyAndReturn
+ */
+export type MihomeDeviceUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeDevice
+   */
+  select?: Prisma.MihomeDeviceSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeDevice
+   */
+  omit?: Prisma.MihomeDeviceOmit<ExtArgs> | null
+  /**
+   * The data used to update MihomeDevices.
+   */
+  data: Prisma.XOR<Prisma.MihomeDeviceUpdateManyMutationInput, Prisma.MihomeDeviceUncheckedUpdateManyInput>
+  /**
+   * Filter which MihomeDevices to update
+   */
+  where?: Prisma.MihomeDeviceWhereInput
+  /**
+   * Limit how many MihomeDevices to update.
+   */
+  limit?: number
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeDeviceIncludeUpdateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeDevice upsert
 */
@@ -566,7 +566,27 @@ export type MihomeEnvHourSelect<ExtArgs extends runtime.Types.Extensions.Interna
  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["mihomeEnvHour"]>

+export type MihomeEnvHourSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  deviceId?: boolean
+  hour?: boolean
+  temperatureAvg?: boolean
+  humidityAvg?: boolean
+  raw?: boolean
+  createdAt?: boolean
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeEnvHour"]>

+export type MihomeEnvHourSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  deviceId?: boolean
+  hour?: boolean
+  temperatureAvg?: boolean
+  humidityAvg?: boolean
+  raw?: boolean
+  createdAt?: boolean
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeEnvHour"]>

 export type MihomeEnvHourSelectScalar = {
  id?: boolean
@@ -582,6 +602,12 @@ export type MihomeEnvHourOmit<ExtArgs extends runtime.Types.Extensions.InternalA
 export type MihomeEnvHourInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
 }
+export type MihomeEnvHourIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}
+export type MihomeEnvHourIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}

 export type $MihomeEnvHourPayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "MihomeEnvHour"
@@ -713,6 +739,30 @@ export interface MihomeEnvHourDelegate<ExtArgs extends runtime.Types.Extensions.
   */
  createMany<T extends MihomeEnvHourCreateManyArgs>(args?: Prisma.SelectSubset<T, MihomeEnvHourCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many MihomeEnvHours and returns the data saved in the database.
+   * @param {MihomeEnvHourCreateManyAndReturnArgs} args - Arguments to create many MihomeEnvHours.
+   * @example
+   * // Create many MihomeEnvHours
+   * const mihomeEnvHour = await prisma.mihomeEnvHour.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many MihomeEnvHours and only return the `id`
+   * const mihomeEnvHourWithIdOnly = await prisma.mihomeEnvHour.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends MihomeEnvHourCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, MihomeEnvHourCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeEnvHourPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a MihomeEnvHour.
   * @param {MihomeEnvHourDeleteArgs} args - Arguments to delete one MihomeEnvHour.
@@ -777,6 +827,36 @@ export interface MihomeEnvHourDelegate<ExtArgs extends runtime.Types.Extensions.
   */
  updateMany<T extends MihomeEnvHourUpdateManyArgs>(args: Prisma.SelectSubset<T, MihomeEnvHourUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more MihomeEnvHours and returns the data updated in the database.
+   * @param {MihomeEnvHourUpdateManyAndReturnArgs} args - Arguments to update many MihomeEnvHours.
+   * @example
+   * // Update many MihomeEnvHours
+   * const mihomeEnvHour = await prisma.mihomeEnvHour.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more MihomeEnvHours and only return the `id`
+   * const mihomeEnvHourWithIdOnly = await prisma.mihomeEnvHour.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends MihomeEnvHourUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, MihomeEnvHourUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeEnvHourPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one MihomeEnvHour.
   * @param {MihomeEnvHourUpsertArgs} args - Arguments to update or create a MihomeEnvHour.
@@ -1210,6 +1290,29 @@ export type MihomeEnvHourCreateManyArgs<ExtArgs extends runtime.Types.Extensions
  skipDuplicates?: boolean
 }

+/**
+ * MihomeEnvHour createManyAndReturn
+ */
+export type MihomeEnvHourCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeEnvHour
+   */
+  select?: Prisma.MihomeEnvHourSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeEnvHour
+   */
+  omit?: Prisma.MihomeEnvHourOmit<ExtArgs> | null
+  /**
+   * The data used to create many MihomeEnvHours.
+   */
+  data: Prisma.MihomeEnvHourCreateManyInput | Prisma.MihomeEnvHourCreateManyInput[]
+  skipDuplicates?: boolean
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeEnvHourIncludeCreateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeEnvHour update
 */
@@ -1254,6 +1357,36 @@ export type MihomeEnvHourUpdateManyArgs<ExtArgs extends runtime.Types.Extensions
  limit?: number
 }

+/**
+ * MihomeEnvHour updateManyAndReturn
+ */
+export type MihomeEnvHourUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeEnvHour
+   */
+  select?: Prisma.MihomeEnvHourSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeEnvHour
+   */
+  omit?: Prisma.MihomeEnvHourOmit<ExtArgs> | null
+  /**
+   * The data used to update MihomeEnvHours.
+   */
+  data: Prisma.XOR<Prisma.MihomeEnvHourUpdateManyMutationInput, Prisma.MihomeEnvHourUncheckedUpdateManyInput>
+  /**
+   * Filter which MihomeEnvHours to update
+   */
+  where?: Prisma.MihomeEnvHourWhereInput
+  /**
+   * Limit how many MihomeEnvHours to update.
+   */
+  limit?: number
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeEnvHourIncludeUpdateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeEnvHour upsert
 */
@@ -348,7 +348,6 @@ export type MihomeEnvSampleOrderByWithRelationInput = {
  raw?: Prisma.SortOrderInput | Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  device?: Prisma.MihomeDeviceOrderByWithRelationInput
-  _relevance?: Prisma.MihomeEnvSampleOrderByRelevanceInput
 }

 export type MihomeEnvSampleWhereUniqueInput = Prisma.AtLeast<{
@@ -550,12 +549,6 @@ export type MihomeEnvSampleOrderByRelationAggregateInput = {
  _count?: Prisma.SortOrder
 }

-export type MihomeEnvSampleOrderByRelevanceInput = {
-  fields: Prisma.MihomeEnvSampleOrderByRelevanceFieldEnum | Prisma.MihomeEnvSampleOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type MihomeEnvSampleDeviceIdDateCompoundUniqueInput = {
  deviceId: number
  date: Date | string
@@ -857,7 +850,43 @@ export type MihomeEnvSampleSelect<ExtArgs extends runtime.Types.Extensions.Inter
  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["mihomeEnvSample"]>

+export type MihomeEnvSampleSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  deviceId?: boolean
+  date?: boolean
+  temperature?: boolean
+  humidity?: boolean
+  temperatureAvg?: boolean
+  humidityAvg?: boolean
+  temperatureMin?: boolean
+  temperatureMax?: boolean
+  humidityMin?: boolean
+  humidityMax?: boolean
+  origin?: boolean
+  sampledAt?: boolean
+  raw?: boolean
+  createdAt?: boolean
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeEnvSample"]>

+export type MihomeEnvSampleSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  deviceId?: boolean
+  date?: boolean
+  temperature?: boolean
+  humidity?: boolean
+  temperatureAvg?: boolean
+  humidityAvg?: boolean
+  temperatureMin?: boolean
+  temperatureMax?: boolean
+  humidityMin?: boolean
+  humidityMax?: boolean
+  origin?: boolean
+  sampledAt?: boolean
+  raw?: boolean
+  createdAt?: boolean
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}, ExtArgs["result"]["mihomeEnvSample"]>

 export type MihomeEnvSampleSelectScalar = {
  id?: boolean
@@ -881,6 +910,12 @@ export type MihomeEnvSampleOmit<ExtArgs extends runtime.Types.Extensions.Interna
 export type MihomeEnvSampleInclude<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
 }
+export type MihomeEnvSampleIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}
+export type MihomeEnvSampleIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  device?: boolean | Prisma.MihomeDeviceDefaultArgs<ExtArgs>
+}

 export type $MihomeEnvSamplePayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "MihomeEnvSample"
@@ -1020,6 +1055,30 @@ export interface MihomeEnvSampleDelegate<ExtArgs extends runtime.Types.Extension
   */
  createMany<T extends MihomeEnvSampleCreateManyArgs>(args?: Prisma.SelectSubset<T, MihomeEnvSampleCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many MihomeEnvSamples and returns the data saved in the database.
+   * @param {MihomeEnvSampleCreateManyAndReturnArgs} args - Arguments to create many MihomeEnvSamples.
+   * @example
+   * // Create many MihomeEnvSamples
+   * const mihomeEnvSample = await prisma.mihomeEnvSample.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many MihomeEnvSamples and only return the `id`
+   * const mihomeEnvSampleWithIdOnly = await prisma.mihomeEnvSample.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends MihomeEnvSampleCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, MihomeEnvSampleCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeEnvSamplePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a MihomeEnvSample.
   * @param {MihomeEnvSampleDeleteArgs} args - Arguments to delete one MihomeEnvSample.
@@ -1084,6 +1143,36 @@ export interface MihomeEnvSampleDelegate<ExtArgs extends runtime.Types.Extension
   */
  updateMany<T extends MihomeEnvSampleUpdateManyArgs>(args: Prisma.SelectSubset<T, MihomeEnvSampleUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more MihomeEnvSamples and returns the data updated in the database.
+   * @param {MihomeEnvSampleUpdateManyAndReturnArgs} args - Arguments to update many MihomeEnvSamples.
+   * @example
+   * // Update many MihomeEnvSamples
+   * const mihomeEnvSample = await prisma.mihomeEnvSample.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more MihomeEnvSamples and only return the `id`
+   * const mihomeEnvSampleWithIdOnly = await prisma.mihomeEnvSample.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends MihomeEnvSampleUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, MihomeEnvSampleUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeEnvSamplePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one MihomeEnvSample.
   * @param {MihomeEnvSampleUpsertArgs} args - Arguments to update or create a MihomeEnvSample.
@@ -1525,6 +1614,29 @@ export type MihomeEnvSampleCreateManyArgs<ExtArgs extends runtime.Types.Extensio
  skipDuplicates?: boolean
 }

+/**
+ * MihomeEnvSample createManyAndReturn
+ */
+export type MihomeEnvSampleCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeEnvSample
+   */
+  select?: Prisma.MihomeEnvSampleSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeEnvSample
+   */
+  omit?: Prisma.MihomeEnvSampleOmit<ExtArgs> | null
+  /**
+   * The data used to create many MihomeEnvSamples.
+   */
+  data: Prisma.MihomeEnvSampleCreateManyInput | Prisma.MihomeEnvSampleCreateManyInput[]
+  skipDuplicates?: boolean
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeEnvSampleIncludeCreateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeEnvSample update
 */
@@ -1569,6 +1681,36 @@ export type MihomeEnvSampleUpdateManyArgs<ExtArgs extends runtime.Types.Extensio
  limit?: number
 }

+/**
+ * MihomeEnvSample updateManyAndReturn
+ */
+export type MihomeEnvSampleUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeEnvSample
+   */
+  select?: Prisma.MihomeEnvSampleSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeEnvSample
+   */
+  omit?: Prisma.MihomeEnvSampleOmit<ExtArgs> | null
+  /**
+   * The data used to update MihomeEnvSamples.
+   */
+  data: Prisma.XOR<Prisma.MihomeEnvSampleUpdateManyMutationInput, Prisma.MihomeEnvSampleUncheckedUpdateManyInput>
+  /**
+   * Filter which MihomeEnvSamples to update
+   */
+  where?: Prisma.MihomeEnvSampleWhereInput
+  /**
+   * Limit how many MihomeEnvSamples to update.
+   */
+  limit?: number
+  /**
+   * Choose, which related nodes to fetch as well
+   */
+  include?: Prisma.MihomeEnvSampleIncludeUpdateManyAndReturn<ExtArgs> | null
+}
+
 /**
 * MihomeEnvSample upsert
 */
@@ -217,7 +217,6 @@ export type MihomeHomeOrderByWithRelationInput = {
  name?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  devices?: Prisma.MihomeDeviceOrderByRelationAggregateInput
-  _relevance?: Prisma.MihomeHomeOrderByRelevanceInput
 }

 export type MihomeHomeWhereUniqueInput = Prisma.AtLeast<{
@@ -303,12 +302,6 @@ export type MihomeHomeUncheckedUpdateManyInput = {
  createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type MihomeHomeOrderByRelevanceInput = {
-  fields: Prisma.MihomeHomeOrderByRelevanceFieldEnum | Prisma.MihomeHomeOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type MihomeHomeCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  homeId?: Prisma.SortOrder
@@ -439,7 +432,19 @@ export type MihomeHomeSelect<ExtArgs extends runtime.Types.Extensions.InternalAr
  _count?: boolean | Prisma.MihomeHomeCountOutputTypeDefaultArgs<ExtArgs>
 }, ExtArgs["result"]["mihomeHome"]>

+export type MihomeHomeSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  homeId?: boolean
+  name?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["mihomeHome"]>

+export type MihomeHomeSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  homeId?: boolean
+  name?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["mihomeHome"]>

 export type MihomeHomeSelectScalar = {
  id?: boolean
@@ -453,6 +458,8 @@ export type MihomeHomeInclude<ExtArgs extends runtime.Types.Extensions.InternalA
  devices?: boolean | Prisma.MihomeHome$devicesArgs<ExtArgs>
  _count?: boolean | Prisma.MihomeHomeCountOutputTypeDefaultArgs<ExtArgs>
 }
+export type MihomeHomeIncludeCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {}
+export type MihomeHomeIncludeUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {}

 export type $MihomeHomePayload<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
  name: "MihomeHome"
@@ -581,6 +588,30 @@ export interface MihomeHomeDelegate<ExtArgs extends runtime.Types.Extensions.Int
   */
  createMany<T extends MihomeHomeCreateManyArgs>(args?: Prisma.SelectSubset<T, MihomeHomeCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many MihomeHomes and returns the data saved in the database.
+   * @param {MihomeHomeCreateManyAndReturnArgs} args - Arguments to create many MihomeHomes.
+   * @example
+   * // Create many MihomeHomes
+   * const mihomeHome = await prisma.mihomeHome.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many MihomeHomes and only return the `id`
+   * const mihomeHomeWithIdOnly = await prisma.mihomeHome.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends MihomeHomeCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, MihomeHomeCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeHomePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a MihomeHome.
   * @param {MihomeHomeDeleteArgs} args - Arguments to delete one MihomeHome.
@@ -645,6 +676,36 @@ export interface MihomeHomeDelegate<ExtArgs extends runtime.Types.Extensions.Int
   */
  updateMany<T extends MihomeHomeUpdateManyArgs>(args: Prisma.SelectSubset<T, MihomeHomeUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more MihomeHomes and returns the data updated in the database.
+   * @param {MihomeHomeUpdateManyAndReturnArgs} args - Arguments to update many MihomeHomes.
+   * @example
+   * // Update many MihomeHomes
+   * const mihomeHome = await prisma.mihomeHome.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more MihomeHomes and only return the `id`
+   * const mihomeHomeWithIdOnly = await prisma.mihomeHome.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends MihomeHomeUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, MihomeHomeUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$MihomeHomePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one MihomeHome.
   * @param {MihomeHomeUpsertArgs} args - Arguments to update or create a MihomeHome.
@@ -1075,6 +1136,25 @@ export type MihomeHomeCreateManyArgs<ExtArgs extends runtime.Types.Extensions.In
  skipDuplicates?: boolean
 }

+/**
+ * MihomeHome createManyAndReturn
+ */
+export type MihomeHomeCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeHome
+   */
+  select?: Prisma.MihomeHomeSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeHome
+   */
+  omit?: Prisma.MihomeHomeOmit<ExtArgs> | null
+  /**
+   * The data used to create many MihomeHomes.
+   */
+  data: Prisma.MihomeHomeCreateManyInput | Prisma.MihomeHomeCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * MihomeHome update
 */
@@ -1119,6 +1199,32 @@ export type MihomeHomeUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.In
  limit?: number
 }

+/**
+ * MihomeHome updateManyAndReturn
+ */
+export type MihomeHomeUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the MihomeHome
+   */
+  select?: Prisma.MihomeHomeSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the MihomeHome
+   */
+  omit?: Prisma.MihomeHomeOmit<ExtArgs> | null
+  /**
+   * The data used to update MihomeHomes.
+   */
+  data: Prisma.XOR<Prisma.MihomeHomeUpdateManyMutationInput, Prisma.MihomeHomeUncheckedUpdateManyInput>
+  /**
+   * Filter which MihomeHomes to update
+   */
+  where?: Prisma.MihomeHomeWhereInput
+  /**
+   * Limit how many MihomeHomes to update.
+   */
+  limit?: number
+}
+
 /**
 * MihomeHome upsert
 */
@@ -264,7 +264,6 @@ export type NewsOrderByWithRelationInput = {
  publishedAt?: Prisma.SortOrder
  impactRank?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
-  _relevance?: Prisma.NewsOrderByRelevanceInput
 }

 export type NewsWhereUniqueInput = Prisma.AtLeast<{
@@ -396,12 +395,6 @@ export type NewsUncheckedUpdateManyInput = {
  createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type NewsOrderByRelevanceInput = {
-  fields: Prisma.NewsOrderByRelevanceFieldEnum | Prisma.NewsOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type NewsTitlePublishedAtCompoundUniqueInput = {
  title: string
  publishedAt: Date | string
@@ -471,7 +464,29 @@ export type NewsSelect<ExtArgs extends runtime.Types.Extensions.InternalArgs = r
  createdAt?: boolean
 }, ExtArgs["result"]["news"]>

+export type NewsSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  title?: boolean
+  summary?: boolean
+  content?: boolean
+  source?: boolean
+  url?: boolean
+  publishedAt?: boolean
+  impactRank?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["news"]>

+export type NewsSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  title?: boolean
+  summary?: boolean
+  content?: boolean
+  source?: boolean
+  url?: boolean
+  publishedAt?: boolean
+  impactRank?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["news"]>

 export type NewsSelectScalar = {
  id?: boolean
@@ -617,6 +632,30 @@ export interface NewsDelegate<ExtArgs extends runtime.Types.Extensions.InternalA
   */
  createMany<T extends NewsCreateManyArgs>(args?: Prisma.SelectSubset<T, NewsCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many News and returns the data saved in the database.
+   * @param {NewsCreateManyAndReturnArgs} args - Arguments to create many News.
+   * @example
+   * // Create many News
+   * const news = await prisma.news.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many News and only return the `id`
+   * const newsWithIdOnly = await prisma.news.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends NewsCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, NewsCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$NewsPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a News.
   * @param {NewsDeleteArgs} args - Arguments to delete one News.
@@ -681,6 +720,36 @@ export interface NewsDelegate<ExtArgs extends runtime.Types.Extensions.InternalA
   */
  updateMany<T extends NewsUpdateManyArgs>(args: Prisma.SelectSubset<T, NewsUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more News and returns the data updated in the database.
+   * @param {NewsUpdateManyAndReturnArgs} args - Arguments to update many News.
+   * @example
+   * // Update many News
+   * const news = await prisma.news.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more News and only return the `id`
+   * const newsWithIdOnly = await prisma.news.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends NewsUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, NewsUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$NewsPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one News.
   * @param {NewsUpsertArgs} args - Arguments to update or create a News.
@@ -1091,6 +1160,25 @@ export type NewsCreateManyArgs<ExtArgs extends runtime.Types.Extensions.Internal
  skipDuplicates?: boolean
 }

+/**
+ * News createManyAndReturn
+ */
+export type NewsCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the News
+   */
+  select?: Prisma.NewsSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the News
+   */
+  omit?: Prisma.NewsOmit<ExtArgs> | null
+  /**
+   * The data used to create many News.
+   */
+  data: Prisma.NewsCreateManyInput | Prisma.NewsCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * News update
 */
@@ -1131,6 +1219,32 @@ export type NewsUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.Internal
  limit?: number
 }

+/**
+ * News updateManyAndReturn
+ */
+export type NewsUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the News
+   */
+  select?: Prisma.NewsSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the News
+   */
+  omit?: Prisma.NewsOmit<ExtArgs> | null
+  /**
+   * The data used to update News.
+   */
+  data: Prisma.XOR<Prisma.NewsUpdateManyMutationInput, Prisma.NewsUncheckedUpdateManyInput>
+  /**
+   * Filter which News to update
+   */
+  where?: Prisma.NewsWhereInput
+  /**
+   * Limit how many News to update.
+   */
+  limit?: number
+}
+
 /**
 * News upsert
 */
@@ -246,7 +246,6 @@ export type OilPriceHistoryOrderByWithRelationInput = {
  price?: Prisma.SortOrder
  source?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
-  _relevance?: Prisma.OilPriceHistoryOrderByRelevanceInput
 }

 export type OilPriceHistoryWhereUniqueInput = Prisma.AtLeast<{
@@ -358,12 +357,6 @@ export type OilPriceHistoryUncheckedUpdateManyInput = {
  createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type OilPriceHistoryOrderByRelevanceInput = {
-  fields: Prisma.OilPriceHistoryOrderByRelevanceFieldEnum | Prisma.OilPriceHistoryOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type OilPriceHistoryDateProvinceFuelCompoundUniqueInput = {
  date: Date | string
  province: string
@@ -422,7 +415,25 @@ export type OilPriceHistorySelect<ExtArgs extends runtime.Types.Extensions.Inter
  createdAt?: boolean
 }, ExtArgs["result"]["oilPriceHistory"]>

+export type OilPriceHistorySelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  date?: boolean
+  province?: boolean
+  fuel?: boolean
+  price?: boolean
+  source?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["oilPriceHistory"]>

+export type OilPriceHistorySelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  date?: boolean
+  province?: boolean
+  fuel?: boolean
+  price?: boolean
+  source?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["oilPriceHistory"]>

 export type OilPriceHistorySelectScalar = {
  id?: boolean
@@ -564,6 +575,30 @@ export interface OilPriceHistoryDelegate<ExtArgs extends runtime.Types.Extension
   */
  createMany<T extends OilPriceHistoryCreateManyArgs>(args?: Prisma.SelectSubset<T, OilPriceHistoryCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many OilPriceHistories and returns the data saved in the database.
+   * @param {OilPriceHistoryCreateManyAndReturnArgs} args - Arguments to create many OilPriceHistories.
+   * @example
+   * // Create many OilPriceHistories
+   * const oilPriceHistory = await prisma.oilPriceHistory.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many OilPriceHistories and only return the `id`
+   * const oilPriceHistoryWithIdOnly = await prisma.oilPriceHistory.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends OilPriceHistoryCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, OilPriceHistoryCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$OilPriceHistoryPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a OilPriceHistory.
   * @param {OilPriceHistoryDeleteArgs} args - Arguments to delete one OilPriceHistory.
@@ -628,6 +663,36 @@ export interface OilPriceHistoryDelegate<ExtArgs extends runtime.Types.Extension
   */
  updateMany<T extends OilPriceHistoryUpdateManyArgs>(args: Prisma.SelectSubset<T, OilPriceHistoryUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more OilPriceHistories and returns the data updated in the database.
+   * @param {OilPriceHistoryUpdateManyAndReturnArgs} args - Arguments to update many OilPriceHistories.
+   * @example
+   * // Update many OilPriceHistories
+   * const oilPriceHistory = await prisma.oilPriceHistory.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more OilPriceHistories and only return the `id`
+   * const oilPriceHistoryWithIdOnly = await prisma.oilPriceHistory.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends OilPriceHistoryUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, OilPriceHistoryUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$OilPriceHistoryPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one OilPriceHistory.
   * @param {OilPriceHistoryUpsertArgs} args - Arguments to update or create a OilPriceHistory.
@@ -1036,6 +1101,25 @@ export type OilPriceHistoryCreateManyArgs<ExtArgs extends runtime.Types.Extensio
  skipDuplicates?: boolean
 }

+/**
+ * OilPriceHistory createManyAndReturn
+ */
+export type OilPriceHistoryCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the OilPriceHistory
+   */
+  select?: Prisma.OilPriceHistorySelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the OilPriceHistory
+   */
+  omit?: Prisma.OilPriceHistoryOmit<ExtArgs> | null
+  /**
+   * The data used to create many OilPriceHistories.
+   */
+  data: Prisma.OilPriceHistoryCreateManyInput | Prisma.OilPriceHistoryCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * OilPriceHistory update
 */
@@ -1076,6 +1160,32 @@ export type OilPriceHistoryUpdateManyArgs<ExtArgs extends runtime.Types.Extensio
  limit?: number
 }

+/**
+ * OilPriceHistory updateManyAndReturn
+ */
+export type OilPriceHistoryUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the OilPriceHistory
+   */
+  select?: Prisma.OilPriceHistorySelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the OilPriceHistory
+   */
+  omit?: Prisma.OilPriceHistoryOmit<ExtArgs> | null
+  /**
+   * The data used to update OilPriceHistories.
+   */
+  data: Prisma.XOR<Prisma.OilPriceHistoryUpdateManyMutationInput, Prisma.OilPriceHistoryUncheckedUpdateManyInput>
+  /**
+   * Filter which OilPriceHistories to update
+   */
+  where?: Prisma.OilPriceHistoryWhereInput
+  /**
+   * Limit how many OilPriceHistories to update.
+   */
+  limit?: number
+}
+
 /**
 * OilPriceHistory upsert
 */
@@ -238,7 +238,6 @@ export type ScraperCacheOrderByWithRelationInput = {
  metadata?: Prisma.SortOrderInput | Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.ScraperCacheOrderByRelevanceInput
 }

 export type ScraperCacheWhereUniqueInput = Prisma.AtLeast<{
@@ -349,12 +348,6 @@ export type ScraperCacheUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type ScraperCacheOrderByRelevanceInput = {
-  fields: Prisma.ScraperCacheOrderByRelevanceFieldEnum | Prisma.ScraperCacheOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type ScraperCacheCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  scraperName?: Prisma.SortOrder
@@ -403,7 +396,25 @@ export type ScraperCacheSelect<ExtArgs extends runtime.Types.Extensions.Internal
  updatedAt?: boolean
 }, ExtArgs["result"]["scraperCache"]>

+export type ScraperCacheSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  scraperName?: boolean
+  lastDataHash?: boolean
+  lastUpdateAt?: boolean
+  metadata?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["scraperCache"]>

+export type ScraperCacheSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  scraperName?: boolean
+  lastDataHash?: boolean
+  lastUpdateAt?: boolean
+  metadata?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["scraperCache"]>

 export type ScraperCacheSelectScalar = {
  id?: boolean
@@ -545,6 +556,30 @@ export interface ScraperCacheDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  createMany<T extends ScraperCacheCreateManyArgs>(args?: Prisma.SelectSubset<T, ScraperCacheCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many ScraperCaches and returns the data saved in the database.
+   * @param {ScraperCacheCreateManyAndReturnArgs} args - Arguments to create many ScraperCaches.
+   * @example
+   * // Create many ScraperCaches
+   * const scraperCache = await prisma.scraperCache.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many ScraperCaches and only return the `id`
+   * const scraperCacheWithIdOnly = await prisma.scraperCache.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends ScraperCacheCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, ScraperCacheCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ScraperCachePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a ScraperCache.
   * @param {ScraperCacheDeleteArgs} args - Arguments to delete one ScraperCache.
@@ -609,6 +644,36 @@ export interface ScraperCacheDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  updateMany<T extends ScraperCacheUpdateManyArgs>(args: Prisma.SelectSubset<T, ScraperCacheUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more ScraperCaches and returns the data updated in the database.
+   * @param {ScraperCacheUpdateManyAndReturnArgs} args - Arguments to update many ScraperCaches.
+   * @example
+   * // Update many ScraperCaches
+   * const scraperCache = await prisma.scraperCache.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more ScraperCaches and only return the `id`
+   * const scraperCacheWithIdOnly = await prisma.scraperCache.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends ScraperCacheUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, ScraperCacheUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ScraperCachePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one ScraperCache.
   * @param {ScraperCacheUpsertArgs} args - Arguments to update or create a ScraperCache.
@@ -1017,6 +1082,25 @@ export type ScraperCacheCreateManyArgs<ExtArgs extends runtime.Types.Extensions.
  skipDuplicates?: boolean
 }

+/**
+ * ScraperCache createManyAndReturn
+ */
+export type ScraperCacheCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ScraperCache
+   */
+  select?: Prisma.ScraperCacheSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ScraperCache
+   */
+  omit?: Prisma.ScraperCacheOmit<ExtArgs> | null
+  /**
+   * The data used to create many ScraperCaches.
+   */
+  data: Prisma.ScraperCacheCreateManyInput | Prisma.ScraperCacheCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * ScraperCache update
 */
@@ -1057,6 +1141,32 @@ export type ScraperCacheUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.
  limit?: number
 }

+/**
+ * ScraperCache updateManyAndReturn
+ */
+export type ScraperCacheUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ScraperCache
+   */
+  select?: Prisma.ScraperCacheSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ScraperCache
+   */
+  omit?: Prisma.ScraperCacheOmit<ExtArgs> | null
+  /**
+   * The data used to update ScraperCaches.
+   */
+  data: Prisma.XOR<Prisma.ScraperCacheUpdateManyMutationInput, Prisma.ScraperCacheUncheckedUpdateManyInput>
+  /**
+   * Filter which ScraperCaches to update
+   */
+  where?: Prisma.ScraperCacheWhereInput
+  /**
+   * Limit how many ScraperCaches to update.
+   */
+  limit?: number
+}
+
 /**
 * ScraperCache upsert
 */
@@ -464,7 +464,6 @@ export type ServerNodeOrderByWithRelationInput = {
  recordedAt?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.ServerNodeOrderByRelevanceInput
 }

 export type ServerNodeWhereUniqueInput = Prisma.AtLeast<{
@@ -755,12 +754,6 @@ export type ServerNodeUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type ServerNodeOrderByRelevanceInput = {
-  fields: Prisma.ServerNodeOrderByRelevanceFieldEnum | Prisma.ServerNodeOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type ServerNodeCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  uuid?: Prisma.SortOrder
@@ -921,7 +914,61 @@ export type ServerNodeSelect<ExtArgs extends runtime.Types.Extensions.InternalAr
  updatedAt?: boolean
 }, ExtArgs["result"]["serverNode"]>

+export type ServerNodeSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  uuid?: boolean
+  name?: boolean
+  cpuName?: boolean
+  os?: boolean
+  region?: boolean
+  memTotal?: boolean
+  diskTotal?: boolean
+  cpuCores?: boolean
+  cpuUsage?: boolean
+  ramUsed?: boolean
+  swapUsed?: boolean
+  load1?: boolean
+  load5?: boolean
+  load15?: boolean
+  diskUsed?: boolean
+  netIn?: boolean
+  netOut?: boolean
+  uptime?: boolean
+  process?: boolean
+  connections?: boolean
+  status?: boolean
+  recordedAt?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["serverNode"]>

+export type ServerNodeSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  uuid?: boolean
+  name?: boolean
+  cpuName?: boolean
+  os?: boolean
+  region?: boolean
+  memTotal?: boolean
+  diskTotal?: boolean
+  cpuCores?: boolean
+  cpuUsage?: boolean
+  ramUsed?: boolean
+  swapUsed?: boolean
+  load1?: boolean
+  load5?: boolean
+  load15?: boolean
+  diskUsed?: boolean
+  netIn?: boolean
+  netOut?: boolean
+  uptime?: boolean
+  process?: boolean
+  connections?: boolean
+  status?: boolean
+  recordedAt?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["serverNode"]>

 export type ServerNodeSelectScalar = {
  id?: boolean
@@ -1099,6 +1146,30 @@ export interface ServerNodeDelegate<ExtArgs extends runtime.Types.Extensions.Int
   */
  createMany<T extends ServerNodeCreateManyArgs>(args?: Prisma.SelectSubset<T, ServerNodeCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many ServerNodes and returns the data saved in the database.
+   * @param {ServerNodeCreateManyAndReturnArgs} args - Arguments to create many ServerNodes.
+   * @example
+   * // Create many ServerNodes
+   * const serverNode = await prisma.serverNode.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many ServerNodes and only return the `id`
+   * const serverNodeWithIdOnly = await prisma.serverNode.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends ServerNodeCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, ServerNodeCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServerNodePayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a ServerNode.
   * @param {ServerNodeDeleteArgs} args - Arguments to delete one ServerNode.
@@ -1163,6 +1234,36 @@ export interface ServerNodeDelegate<ExtArgs extends runtime.Types.Extensions.Int
   */
  updateMany<T extends ServerNodeUpdateManyArgs>(args: Prisma.SelectSubset<T, ServerNodeUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more ServerNodes and returns the data updated in the database.
+   * @param {ServerNodeUpdateManyAndReturnArgs} args - Arguments to update many ServerNodes.
+   * @example
+   * // Update many ServerNodes
+   * const serverNode = await prisma.serverNode.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more ServerNodes and only return the `id`
+   * const serverNodeWithIdOnly = await prisma.serverNode.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends ServerNodeUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, ServerNodeUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServerNodePayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one ServerNode.
   * @param {ServerNodeUpsertArgs} args - Arguments to update or create a ServerNode.
@@ -1589,6 +1690,25 @@ export type ServerNodeCreateManyArgs<ExtArgs extends runtime.Types.Extensions.In
  skipDuplicates?: boolean
 }

+/**
+ * ServerNode createManyAndReturn
+ */
+export type ServerNodeCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServerNode
+   */
+  select?: Prisma.ServerNodeSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServerNode
+   */
+  omit?: Prisma.ServerNodeOmit<ExtArgs> | null
+  /**
+   * The data used to create many ServerNodes.
+   */
+  data: Prisma.ServerNodeCreateManyInput | Prisma.ServerNodeCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * ServerNode update
 */
@@ -1629,6 +1749,32 @@ export type ServerNodeUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.In
  limit?: number
 }

+/**
+ * ServerNode updateManyAndReturn
+ */
+export type ServerNodeUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServerNode
+   */
+  select?: Prisma.ServerNodeSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServerNode
+   */
+  omit?: Prisma.ServerNodeOmit<ExtArgs> | null
+  /**
+   * The data used to update ServerNodes.
+   */
+  data: Prisma.XOR<Prisma.ServerNodeUpdateManyMutationInput, Prisma.ServerNodeUncheckedUpdateManyInput>
+  /**
+   * Filter which ServerNodes to update
+   */
+  where?: Prisma.ServerNodeWhereInput
+  /**
+   * Limit how many ServerNodes to update.
+   */
+  limit?: number
+}
+
 /**
 * ServerNode upsert
 */
@@ -319,7 +319,6 @@ export type ServerNodeHistoryOrderByWithRelationInput = {
  process?: Prisma.SortOrder
  connections?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
-  _relevance?: Prisma.ServerNodeHistoryOrderByRelevanceInput
 }

 export type ServerNodeHistoryWhereUniqueInput = Prisma.AtLeast<{
@@ -481,12 +480,6 @@ export type ServerNodeHistoryUncheckedUpdateManyInput = {
  createdAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type ServerNodeHistoryOrderByRelevanceInput = {
-  fields: Prisma.ServerNodeHistoryOrderByRelevanceFieldEnum | Prisma.ServerNodeHistoryOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type ServerNodeHistoryUuidPeriodCompoundUniqueInput = {
  uuid: string
  period: Date | string
@@ -578,7 +571,35 @@ export type ServerNodeHistorySelect<ExtArgs extends runtime.Types.Extensions.Int
  createdAt?: boolean
 }, ExtArgs["result"]["serverNodeHistory"]>

+export type ServerNodeHistorySelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  uuid?: boolean
+  period?: boolean
+  cpu?: boolean
+  ram?: boolean
+  load?: boolean
+  disk?: boolean
+  netIn?: boolean
+  netOut?: boolean
+  process?: boolean
+  connections?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["serverNodeHistory"]>

+export type ServerNodeHistorySelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  uuid?: boolean
+  period?: boolean
+  cpu?: boolean
+  ram?: boolean
+  load?: boolean
+  disk?: boolean
+  netIn?: boolean
+  netOut?: boolean
+  process?: boolean
+  connections?: boolean
+  createdAt?: boolean
+}, ExtArgs["result"]["serverNodeHistory"]>

 export type ServerNodeHistorySelectScalar = {
  id?: boolean
@@ -730,6 +751,30 @@ export interface ServerNodeHistoryDelegate<ExtArgs extends runtime.Types.Extensi
   */
  createMany<T extends ServerNodeHistoryCreateManyArgs>(args?: Prisma.SelectSubset<T, ServerNodeHistoryCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many ServerNodeHistories and returns the data saved in the database.
+   * @param {ServerNodeHistoryCreateManyAndReturnArgs} args - Arguments to create many ServerNodeHistories.
+   * @example
+   * // Create many ServerNodeHistories
+   * const serverNodeHistory = await prisma.serverNodeHistory.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many ServerNodeHistories and only return the `id`
+   * const serverNodeHistoryWithIdOnly = await prisma.serverNodeHistory.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends ServerNodeHistoryCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, ServerNodeHistoryCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServerNodeHistoryPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a ServerNodeHistory.
   * @param {ServerNodeHistoryDeleteArgs} args - Arguments to delete one ServerNodeHistory.
@@ -794,6 +839,36 @@ export interface ServerNodeHistoryDelegate<ExtArgs extends runtime.Types.Extensi
   */
  updateMany<T extends ServerNodeHistoryUpdateManyArgs>(args: Prisma.SelectSubset<T, ServerNodeHistoryUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more ServerNodeHistories and returns the data updated in the database.
+   * @param {ServerNodeHistoryUpdateManyAndReturnArgs} args - Arguments to update many ServerNodeHistories.
+   * @example
+   * // Update many ServerNodeHistories
+   * const serverNodeHistory = await prisma.serverNodeHistory.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more ServerNodeHistories and only return the `id`
+   * const serverNodeHistoryWithIdOnly = await prisma.serverNodeHistory.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends ServerNodeHistoryUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, ServerNodeHistoryUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServerNodeHistoryPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one ServerNodeHistory.
   * @param {ServerNodeHistoryUpsertArgs} args - Arguments to update or create a ServerNodeHistory.
@@ -1207,6 +1282,25 @@ export type ServerNodeHistoryCreateManyArgs<ExtArgs extends runtime.Types.Extens
  skipDuplicates?: boolean
 }

+/**
+ * ServerNodeHistory createManyAndReturn
+ */
+export type ServerNodeHistoryCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServerNodeHistory
+   */
+  select?: Prisma.ServerNodeHistorySelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServerNodeHistory
+   */
+  omit?: Prisma.ServerNodeHistoryOmit<ExtArgs> | null
+  /**
+   * The data used to create many ServerNodeHistories.
+   */
+  data: Prisma.ServerNodeHistoryCreateManyInput | Prisma.ServerNodeHistoryCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * ServerNodeHistory update
 */
@@ -1247,6 +1341,32 @@ export type ServerNodeHistoryUpdateManyArgs<ExtArgs extends runtime.Types.Extens
  limit?: number
 }

+/**
+ * ServerNodeHistory updateManyAndReturn
+ */
+export type ServerNodeHistoryUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServerNodeHistory
+   */
+  select?: Prisma.ServerNodeHistorySelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServerNodeHistory
+   */
+  omit?: Prisma.ServerNodeHistoryOmit<ExtArgs> | null
+  /**
+   * The data used to update ServerNodeHistories.
+   */
+  data: Prisma.XOR<Prisma.ServerNodeHistoryUpdateManyMutationInput, Prisma.ServerNodeHistoryUncheckedUpdateManyInput>
+  /**
+   * Filter which ServerNodeHistories to update
+   */
+  where?: Prisma.ServerNodeHistoryWhereInput
+  /**
+   * Limit how many ServerNodeHistories to update.
+   */
+  limit?: number
+}
+
 /**
 * ServerNodeHistory upsert
 */
@@ -264,7 +264,6 @@ export type ServiceCheckOrderByWithRelationInput = {
  lastCheckAt?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.ServiceCheckOrderByRelevanceInput
 }

 export type ServiceCheckWhereUniqueInput = Prisma.AtLeast<{
@@ -395,12 +394,6 @@ export type ServiceCheckUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type ServiceCheckOrderByRelevanceInput = {
-  fields: Prisma.ServiceCheckOrderByRelevanceFieldEnum | Prisma.ServiceCheckOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type ServiceCheckCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  name?: Prisma.SortOrder
@@ -461,7 +454,29 @@ export type ServiceCheckSelect<ExtArgs extends runtime.Types.Extensions.Internal
  updatedAt?: boolean
 }, ExtArgs["result"]["serviceCheck"]>

+export type ServiceCheckSelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  url?: boolean
+  status?: boolean
+  latencyMs?: boolean
+  message?: boolean
+  lastCheckAt?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["serviceCheck"]>

+export type ServiceCheckSelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  url?: boolean
+  status?: boolean
+  latencyMs?: boolean
+  message?: boolean
+  lastCheckAt?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["serviceCheck"]>

 export type ServiceCheckSelectScalar = {
  id?: boolean
@@ -607,6 +622,30 @@ export interface ServiceCheckDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  createMany<T extends ServiceCheckCreateManyArgs>(args?: Prisma.SelectSubset<T, ServiceCheckCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many ServiceChecks and returns the data saved in the database.
+   * @param {ServiceCheckCreateManyAndReturnArgs} args - Arguments to create many ServiceChecks.
+   * @example
+   * // Create many ServiceChecks
+   * const serviceCheck = await prisma.serviceCheck.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many ServiceChecks and only return the `id`
+   * const serviceCheckWithIdOnly = await prisma.serviceCheck.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends ServiceCheckCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, ServiceCheckCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServiceCheckPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a ServiceCheck.
   * @param {ServiceCheckDeleteArgs} args - Arguments to delete one ServiceCheck.
@@ -671,6 +710,36 @@ export interface ServiceCheckDelegate<ExtArgs extends runtime.Types.Extensions.I
   */
  updateMany<T extends ServiceCheckUpdateManyArgs>(args: Prisma.SelectSubset<T, ServiceCheckUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more ServiceChecks and returns the data updated in the database.
+   * @param {ServiceCheckUpdateManyAndReturnArgs} args - Arguments to update many ServiceChecks.
+   * @example
+   * // Update many ServiceChecks
+   * const serviceCheck = await prisma.serviceCheck.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more ServiceChecks and only return the `id`
+   * const serviceCheckWithIdOnly = await prisma.serviceCheck.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends ServiceCheckUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, ServiceCheckUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$ServiceCheckPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one ServiceCheck.
   * @param {ServiceCheckUpsertArgs} args - Arguments to update or create a ServiceCheck.
@@ -1081,6 +1150,25 @@ export type ServiceCheckCreateManyArgs<ExtArgs extends runtime.Types.Extensions.
  skipDuplicates?: boolean
 }

+/**
+ * ServiceCheck createManyAndReturn
+ */
+export type ServiceCheckCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServiceCheck
+   */
+  select?: Prisma.ServiceCheckSelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServiceCheck
+   */
+  omit?: Prisma.ServiceCheckOmit<ExtArgs> | null
+  /**
+   * The data used to create many ServiceChecks.
+   */
+  data: Prisma.ServiceCheckCreateManyInput | Prisma.ServiceCheckCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * ServiceCheck update
 */
@@ -1121,6 +1209,32 @@ export type ServiceCheckUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.
  limit?: number
 }

+/**
+ * ServiceCheck updateManyAndReturn
+ */
+export type ServiceCheckUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the ServiceCheck
+   */
+  select?: Prisma.ServiceCheckSelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the ServiceCheck
+   */
+  omit?: Prisma.ServiceCheckOmit<ExtArgs> | null
+  /**
+   * The data used to update ServiceChecks.
+   */
+  data: Prisma.XOR<Prisma.ServiceCheckUpdateManyMutationInput, Prisma.ServiceCheckUncheckedUpdateManyInput>
+  /**
+   * Filter which ServiceChecks to update
+   */
+  where?: Prisma.ServiceCheckWhereInput
+  /**
+   * Limit how many ServiceChecks to update.
+   */
+  limit?: number
+}
+
 /**
 * ServiceCheck upsert
 */
@@ -229,7 +229,6 @@ export type StrategyOrderByWithRelationInput = {
  data?: Prisma.SortOrder
  createdAt?: Prisma.SortOrder
  updatedAt?: Prisma.SortOrder
-  _relevance?: Prisma.StrategyOrderByRelevanceInput
 }

 export type StrategyWhereUniqueInput = Prisma.AtLeast<{
@@ -330,12 +329,6 @@ export type StrategyUncheckedUpdateManyInput = {
  updatedAt?: Prisma.DateTimeFieldUpdateOperationsInput | Date | string
 }

-export type StrategyOrderByRelevanceInput = {
-  fields: Prisma.StrategyOrderByRelevanceFieldEnum | Prisma.StrategyOrderByRelevanceFieldEnum[]
-  sort: Prisma.SortOrder
-  search: string
-}
-
 export type StrategyCountOrderByAggregateInput = {
  id?: Prisma.SortOrder
  name?: Prisma.SortOrder
@@ -380,7 +373,23 @@ export type StrategySelect<ExtArgs extends runtime.Types.Extensions.InternalArgs
  updatedAt?: boolean
 }, ExtArgs["result"]["strategy"]>

+export type StrategySelectCreateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  description?: boolean
+  data?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["strategy"]>

+export type StrategySelectUpdateManyAndReturn<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = runtime.Types.Extensions.GetSelect<{
+  id?: boolean
+  name?: boolean
+  description?: boolean
+  data?: boolean
+  createdAt?: boolean
+  updatedAt?: boolean
+}, ExtArgs["result"]["strategy"]>

 export type StrategySelectScalar = {
  id?: boolean
@@ -520,6 +529,30 @@ export interface StrategyDelegate<ExtArgs extends runtime.Types.Extensions.Inter
   */
  createMany<T extends StrategyCreateManyArgs>(args?: Prisma.SelectSubset<T, StrategyCreateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Create many Strategies and returns the data saved in the database.
+   * @param {StrategyCreateManyAndReturnArgs} args - Arguments to create many Strategies.
+   * @example
+   * // Create many Strategies
+   * const strategy = await prisma.strategy.createManyAndReturn({
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Create many Strategies and only return the `id`
+   * const strategyWithIdOnly = await prisma.strategy.createManyAndReturn({
+   *   select: { id: true },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  createManyAndReturn<T extends StrategyCreateManyAndReturnArgs>(args?: Prisma.SelectSubset<T, StrategyCreateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$StrategyPayload<ExtArgs>, T, "createManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Delete a Strategy.
   * @param {StrategyDeleteArgs} args - Arguments to delete one Strategy.
@@ -584,6 +617,36 @@ export interface StrategyDelegate<ExtArgs extends runtime.Types.Extensions.Inter
   */
  updateMany<T extends StrategyUpdateManyArgs>(args: Prisma.SelectSubset<T, StrategyUpdateManyArgs<ExtArgs>>): Prisma.PrismaPromise<Prisma.BatchPayload>

+  /**
+   * Update zero or more Strategies and returns the data updated in the database.
+   * @param {StrategyUpdateManyAndReturnArgs} args - Arguments to update many Strategies.
+   * @example
+   * // Update many Strategies
+   * const strategy = await prisma.strategy.updateManyAndReturn({
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * 
+   * // Update zero or more Strategies and only return the `id`
+   * const strategyWithIdOnly = await prisma.strategy.updateManyAndReturn({
+   *   select: { id: true },
+   *   where: {
+   *     // ... provide filter here
+   *   },
+   *   data: [
+   *     // ... provide data here
+   *   ]
+   * })
+   * Note, that providing `undefined` is treated as the value not being there.
+   * Read more here: https://pris.ly/d/null-undefined
+   * 
+   */
+  updateManyAndReturn<T extends StrategyUpdateManyAndReturnArgs>(args: Prisma.SelectSubset<T, StrategyUpdateManyAndReturnArgs<ExtArgs>>): Prisma.PrismaPromise<runtime.Types.Result.GetResult<Prisma.$StrategyPayload<ExtArgs>, T, "updateManyAndReturn", GlobalOmitOptions>>
+
  /**
   * Create or update one Strategy.
   * @param {StrategyUpsertArgs} args - Arguments to update or create a Strategy.
@@ -991,6 +1054,25 @@ export type StrategyCreateManyArgs<ExtArgs extends runtime.Types.Extensions.Inte
  skipDuplicates?: boolean
 }

+/**
+ * Strategy createManyAndReturn
+ */
+export type StrategyCreateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Strategy
+   */
+  select?: Prisma.StrategySelectCreateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Strategy
+   */
+  omit?: Prisma.StrategyOmit<ExtArgs> | null
+  /**
+   * The data used to create many Strategies.
+   */
+  data: Prisma.StrategyCreateManyInput | Prisma.StrategyCreateManyInput[]
+  skipDuplicates?: boolean
+}
+
 /**
 * Strategy update
 */
@@ -1031,6 +1113,32 @@ export type StrategyUpdateManyArgs<ExtArgs extends runtime.Types.Extensions.Inte
  limit?: number
 }

+/**
+ * Strategy updateManyAndReturn
+ */
+export type StrategyUpdateManyAndReturnArgs<ExtArgs extends runtime.Types.Extensions.InternalArgs = runtime.Types.Extensions.DefaultArgs> = {
+  /**
+   * Select specific fields to fetch from the Strategy
+   */
+  select?: Prisma.StrategySelectUpdateManyAndReturn<ExtArgs> | null
+  /**
+   * Omit specific fields from the Strategy
+   */
+  omit?: Prisma.StrategyOmit<ExtArgs> | null
+  /**
+   * The data used to update Strategies.
+   */
+  data: Prisma.XOR<Prisma.StrategyUpdateManyMutationInput, Prisma.StrategyUncheckedUpdateManyInput>
+  /**
+   * Filter which Strategies to update
+   */
+  where?: Prisma.StrategyWhereInput
+  /**
+   * Limit how many Strategies to update.
+   */
+  limit?: number
+}
+
 /**
 * Strategy upsert
 */
@@ -1,14 +1,14 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover" />
-    <meta name="theme-color" content="#1f2937" />
-    <title>iBoard - 经济数据与策略</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.jsx"></script>
-  </body>
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no, viewport-fit=cover" />
+    <meta name="theme-color" content="#1f2937" />
+    <title>iBoard - 经济数据与策略</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
 </html>
@@ -1,14 +1,17 @@
 {
  "name": "iboard",
-  "version": "1.0.0",
+  "version": "0.2.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "iboard",
-      "version": "1.0.0",
+      "version": "0.2.0",
      "dependencies": {
-        "@prisma/adapter-mariadb": "^7.9.1",
+        "@journeyapps/wa-sqlite": "^2.0.7",
+        "@powersync/react": "^2.1.0",
+        "@powersync/web": "^2.5.0",
+        "@prisma/adapter-pg": "^7.9.1",
        "@prisma/client": "^7.7.0",
        "@zythum02/mijia-api": "^0.1.4",
        "antd-mobile": "^5.42.3",
@@ -1187,6 +1190,11 @@
        "url": "https://opencollective.com/libvips"
      }
    },
+    "node_modules/@journeyapps/wa-sqlite": {
+      "version": "2.0.8",
+      "resolved": "https://registry.npmjs.org/@journeyapps/wa-sqlite/-/wa-sqlite-2.0.8.tgz",
+      "integrity": "sha512-WRXEms2515S/0DFSWzmlggHu9hSJomhugDUO17rWkL6VpokV/hfjIDLs954Egx/eqrk3WADmiOMzOc7MuJbznQ=="
+    },
    "node_modules/@jridgewell/gen-mapping": {
      "version": "0.3.13",
      "resolved": "https://registry.npmjs.org/@jridgewell/gen-mapping/-/gen-mapping-0.3.13.tgz",
@@ -1615,64 +1623,91 @@
        "node": "^22.20 || ^24.12 || >=25"
      }
    },
-    "node_modules/@prisma/adapter-mariadb": {
-      "version": "7.9.1",
-      "resolved": "https://registry.npmjs.org/@prisma/adapter-mariadb/-/adapter-mariadb-7.9.1.tgz",
-      "integrity": "sha512-4aZUbIg2av7XFSQyM9cQeAp9YP9HiPr8H7ehe2rDo375IZXILEzQrNXZ/zLetgRQ2ojlaUl/brArFdOVS3n1xA==",
+    "node_modules/@powersync/common": {
+      "version": "2.4.0",
+      "resolved": "https://registry.npmjs.org/@powersync/common/-/common-2.4.0.tgz",
+      "integrity": "sha512-ngVogy+B8NQeI5l+0Es8qMxnGozUie8Q6R4+0/AHA3oBAhDG5UmeYw/LquTzZJSOPnCmvGgFSqovblV+JKzxKQ==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/@powersync/react": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@powersync/react/-/react-2.1.0.tgz",
+      "integrity": "sha512-ADIpakSLhstv0F9xrUIF+oCArFnAQPrcB9mNql6xH0Nup9EgBug38Ks+mv3yqbc33z60pBm9tuHs8uSIbkhuqg==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "@powersync/common": "^2.4.0",
+        "react": "*"
+      }
+    },
+    "node_modules/@powersync/shared-internals": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@powersync/shared-internals/-/shared-internals-1.4.0.tgz",
+      "integrity": "sha512-OiqqDuW6tePW4Ed7C5IWutBKrtcqKuTMlVMQNwUZtKtqr7ZrqKlb+YP5l4niuz8mpqDYo3/HNU0dpc+3mneSBQ==",
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "@powersync/common": "^2.4.0"
+      }
+    },
+    "node_modules/@powersync/web": {
+      "version": "2.5.0",
+      "resolved": "https://registry.npmjs.org/@powersync/web/-/web-2.5.0.tgz",
+      "integrity": "sha512-/K2ZUjIdqvtFeoLfPetPcE+uioShBWzrTrOa8hpoZ7i62S8wgj47i+VPnKTXI7WQmXuxTGGZFUFnahinf6wjPg==",
      "license": "Apache-2.0",
      "dependencies": {
-        "@prisma/driver-adapter-utils": "7.9.1",
-        "mariadb": "3.4.5"
-      }
-    },
-    "node_modules/@prisma/adapter-mariadb/node_modules/@types/node": {
-      "version": "24.13.3",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.3.tgz",
-      "integrity": "sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==",
-      "license": "MIT",
-      "dependencies": {
-        "undici-types": "~7.18.0"
-      }
-    },
-    "node_modules/@prisma/adapter-mariadb/node_modules/iconv-lite": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
-      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
-      "license": "MIT",
-      "dependencies": {
-        "safer-buffer": ">= 2.1.2 < 3.0.0"
+        "@journeyapps/wa-sqlite": "2.0.7",
+        "@powersync/common": "2.4.0",
+        "@powersync/shared-internals": "1.4.0",
+        "comlink": "^4.4.2",
+        "commander": "^12.1.0"
      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
-    "node_modules/@prisma/adapter-mariadb/node_modules/lru-cache": {
-      "version": "10.4.3",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
-      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
-      "license": "ISC"
-    },
-    "node_modules/@prisma/adapter-mariadb/node_modules/mariadb": {
-      "version": "3.4.5",
-      "resolved": "https://registry.npmjs.org/mariadb/-/mariadb-3.4.5.tgz",
-      "integrity": "sha512-gThTYkhIS5rRqkVr+Y0cIdzr+GRqJ9sA2Q34e0yzmyhMCwyApf3OKAC1jnF23aSlIOqJuyaUFUcj7O1qZslmmQ==",
-      "license": "LGPL-2.1-or-later",
-      "dependencies": {
-        "@types/geojson": "^7946.0.16",
-        "@types/node": "^24.0.13",
-        "denque": "^2.1.0",
-        "iconv-lite": "^0.6.3",
-        "lru-cache": "^10.4.3"
+      "bin": {
+        "powersync-web": "bin/powersync.cjs"
      },
-      "engines": {
-        "node": ">= 14"
+      "peerDependencies": {
+        "@powersync/common": "^2.4.0",
+        "@powersync/shared-internals": "^1.4.0"
      }
    },
-    "node_modules/@prisma/adapter-mariadb/node_modules/undici-types": {
-      "version": "7.18.2",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz",
-      "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==",
-      "license": "MIT"
+    "node_modules/@powersync/web/node_modules/@journeyapps/wa-sqlite": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/@journeyapps/wa-sqlite/-/wa-sqlite-2.0.7.tgz",
+      "integrity": "sha512-mc6xUricl4QB2s8QTRGS+FofSr1cjwDtf6dPXAdMBuGWodjfEgkSJGDPWQ7zVqgc7hMfXYLT7WIfEBAxara8YA=="
+    },
+    "node_modules/@powersync/web/node_modules/commander": {
+      "version": "12.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+      "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@prisma/adapter-pg": {
+      "version": "7.10.1",
+      "resolved": "https://registry.npmjs.org/@prisma/adapter-pg/-/adapter-pg-7.10.1.tgz",
+      "integrity": "sha512-EP9ruPYHjKP80WZlb5qVaEXKgZjJieBFjAxcBtQnDAHD6+16UN4keVmBh6L/RUpuDQT2FQRbvKNgq5d4Ix+IkQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@prisma/driver-adapter-utils": "7.10.1",
+        "@types/pg": "^8.16.0",
+        "pg": "^8.16.3",
+        "postgres-array": "3.0.4"
+      }
+    },
+    "node_modules/@prisma/adapter-pg/node_modules/@prisma/debug": {
+      "version": "7.10.1",
+      "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-7.10.1.tgz",
+      "integrity": "sha512-eFCAkGZ13D/qPg48JBlG5IWi9cSBBOC7oG3abDPcAkYioDWlIjh0YJJLK2J7qo5S+xWWD8I6egAN/8KbCaiMCA==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/@prisma/adapter-pg/node_modules/@prisma/driver-adapter-utils": {
+      "version": "7.10.1",
+      "resolved": "https://registry.npmjs.org/@prisma/driver-adapter-utils/-/driver-adapter-utils-7.10.1.tgz",
+      "integrity": "sha512-DJ4c6xvVnm3s9ZUyql9nCUicADSqyvH+CjXRCM9L6m5zJxCNmebCElG6X4irICq3rosBwlX+S19Dxq/4IrZk3A==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@prisma/debug": "7.10.1"
+      }
    },
    "node_modules/@prisma/client": {
      "version": "7.7.0",
@@ -1747,21 +1782,6 @@
        "zeptomatch": "2.1.0"
      }
    },
-    "node_modules/@prisma/driver-adapter-utils": {
-      "version": "7.9.1",
-      "resolved": "https://registry.npmjs.org/@prisma/driver-adapter-utils/-/driver-adapter-utils-7.9.1.tgz",
-      "integrity": "sha512-vmHehG7nn/heW32DXXpp13DxxAxVVe6n250oEt3dOL2E/4bt3olktKZN0mzSuxMMronyMSkbeW2uCOn3F4g8RQ==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "@prisma/debug": "7.9.1"
-      }
-    },
-    "node_modules/@prisma/driver-adapter-utils/node_modules/@prisma/debug": {
-      "version": "7.9.1",
-      "resolved": "https://registry.npmjs.org/@prisma/debug/-/debug-7.9.1.tgz",
-      "integrity": "sha512-/cpVZ4itxtcgB8GHBvZtcmuEjq+lWsLrRJxFMbwZrT1RIdtuKmUm7PPGo/wzfbYpBrk+9WmmBE8CHJw2rybKDQ==",
-      "license": "Apache-2.0"
-    },
    "node_modules/@prisma/engines": {
      "version": "7.7.0",
      "resolved": "https://registry.npmjs.org/@prisma/engines/-/engines-7.7.0.tgz",
@@ -2867,6 +2887,17 @@
        "undici-types": "~8.3.0"
      }
    },
+    "node_modules/@types/pg": {
+      "version": "8.23.1",
+      "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.23.1.tgz",
+      "integrity": "sha512-fKVHpikPdg4GKks3JuLEhvwSyvwzF23hnabPy6DD8ljVbC7+6J5dQzdv4arV6jqq57djnMgs1HKBxX4P8aBI3A==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "pg-protocol": "*",
+        "pg-types": "^2.2.0"
+      }
+    },
    "node_modules/@types/react": {
      "version": "19.2.14",
      "resolved": "https://registry.npmjs.org/@types/react/-/react-19.2.14.tgz",
@@ -3193,6 +3224,21 @@
      "integrity": "sha512-YOf0VSj5nUPI27doTtXF+BBnsiRq3qY7avHqfIWnppxTLGyvkLq1QV2RTxkwoZwJ60ywLfZ0raFF4J/G886i7A==",
      "license": "MIT"
    },
+    "node_modules/better-sqlite3": {
+      "version": "13.0.3",
+      "resolved": "https://registry.npmjs.org/better-sqlite3/-/better-sqlite3-13.0.3.tgz",
+      "integrity": "sha512-RbOBxmLBG8uvFUc15X9+9SFemKcQ0WBuISBVkpuiaUB2qblC8UWlHEjdWVoZ8AdhSwmoEgsiXKfopX0CQxaACQ==",
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "dependencies": {
+        "node-addon-api": "^8.0.0"
+      },
+      "engines": {
+        "node": ">=22"
+      }
+    },
    "node_modules/body-parser": {
      "version": "1.20.6",
      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.6.tgz",
@@ -3575,6 +3621,12 @@
        "node": ">= 0.8"
      }
    },
+    "node_modules/comlink": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/comlink/-/comlink-4.4.2.tgz",
+      "integrity": "sha512-OxGdvBmJuNKSCMO4NTl1L47VRp6xn2wG4F/2hYzB6tiCb709otOxtEYCSvK80PtjODfXXZu8ds+Nw5kVCjqd2g==",
+      "license": "Apache-2.0"
+    },
    "node_modules/commander": {
      "version": "13.1.0",
      "resolved": "https://registry.npmjs.org/commander/-/commander-13.1.0.tgz",
@@ -5362,6 +5414,17 @@
        "node": ">= 0.6"
      }
    },
+    "node_modules/node-addon-api": {
+      "version": "8.9.2",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-8.9.2.tgz",
+      "integrity": "sha512-VijLXbi3UACN69I0JVXJsX4tjACjNoQDgv2gTF6sx2wWEi8tkSg2eX8p5gSIFi8z2+DL3oHmY6OyKce38SDolg==",
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": "^18 || ^20 || >= 21"
+      }
+    },
    "node_modules/node-cron": {
      "version": "3.0.3",
      "resolved": "https://registry.npmjs.org/node-cron/-/node-cron-3.0.3.tgz",
@@ -5579,6 +5642,104 @@
      "integrity": "sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA==",
      "license": "MIT"
    },
+    "node_modules/pg": {
+      "version": "8.23.1",
+      "resolved": "https://registry.npmjs.org/pg/-/pg-8.23.1.tgz",
+      "integrity": "sha512-aL96AHANtWjPLDOLqnhx+ngp9+UK7ETEU8VJrDCGvsSSi/mGLcWYsS6Herg7lmaBJe4uwrfqsa7gTEFaSizDoQ==",
+      "license": "MIT",
+      "dependencies": {
+        "pg-connection-string": "^2.14.1",
+        "pg-pool": "^3.14.0",
+        "pg-protocol": "^1.16.1",
+        "pg-types": "2.2.0",
+        "pgpass": "1.0.5"
+      },
+      "engines": {
+        "node": ">= 16.0.0"
+      },
+      "optionalDependencies": {
+        "pg-cloudflare": "^1.4.1"
+      },
+      "peerDependencies": {
+        "pg-native": ">=3.0.1"
+      },
+      "peerDependenciesMeta": {
+        "pg-native": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/pg-cloudflare": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.4.1.tgz",
+      "integrity": "sha512-6PQbsFWZcp9EmJEwy5cGQ2La+AMWpP46lgbb8X+U/XsHIUweYDNCpeuKck5RxL2MdVFi7krbbEi5nX4Zh7JhrQ==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/pg-connection-string": {
+      "version": "2.14.1",
+      "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.14.1.tgz",
+      "integrity": "sha512-qR3kGNPBLpCNtz0evbKA0Y/MRFXwSSdT+pTJvYp/bXTcReZbvX1kzF0IyTc1QnxqF7AZbOeBhNL8R5mYQZV/MA==",
+      "license": "MIT"
+    },
+    "node_modules/pg-int8": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz",
+      "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/pg-pool": {
+      "version": "3.14.0",
+      "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.14.0.tgz",
+      "integrity": "sha512-gKtPkFdQPU3DksooVLi9LsjZxrsBUZIpa+7aVx+LV5pNh0KzP4Zleud2po+ConrxbuXGBJ6Hfer6hdgpIBpBaw==",
+      "license": "MIT",
+      "peerDependencies": {
+        "pg": ">=8.0"
+      }
+    },
+    "node_modules/pg-protocol": {
+      "version": "1.16.1",
+      "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.16.1.tgz",
+      "integrity": "sha512-p9VOFMiHB/ZbJATetbg+99PxssTVSQRnyuPSQ67mN1+1KBOjZaZ83ZQzltnxPhJwSsC3nwVjJ10DVJlerbFzLg==",
+      "license": "MIT"
+    },
+    "node_modules/pg-types": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz",
+      "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==",
+      "license": "MIT",
+      "dependencies": {
+        "pg-int8": "1.0.1",
+        "postgres-array": "~2.0.0",
+        "postgres-bytea": "~1.0.0",
+        "postgres-date": "~1.0.4",
+        "postgres-interval": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/pg-types/node_modules/postgres-array": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz",
+      "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/pgpass": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz",
+      "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==",
+      "license": "MIT",
+      "dependencies": {
+        "split2": "^4.1.0"
+      }
+    },
    "node_modules/picocolors": {
      "version": "1.1.1",
      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
@@ -5619,6 +5780,45 @@
        "url": "https://github.com/sponsors/porsager"
      }
    },
+    "node_modules/postgres-array": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-3.0.4.tgz",
+      "integrity": "sha512-nAUSGfSDGOaOAEGwqsRY27GPOea7CNipJPOA7lPbdEpx5Kg3qzdP0AaWC5MlhTWV9s4hFX39nomVZ+C4tnGOJQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/postgres-bytea": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz",
+      "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-date": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz",
+      "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-interval": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz",
+      "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "xtend": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
    "node_modules/prisma": {
      "version": "7.7.0",
      "resolved": "https://registry.npmjs.org/prisma/-/prisma-7.7.0.tgz",
@@ -6470,6 +6670,15 @@
        "node": ">=0.10.0"
      }
    },
+    "node_modules/split2": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+      "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 10.x"
+      }
+    },
    "node_modules/sprintf-js": {
      "version": "1.0.3",
      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
@@ -6938,6 +7147,15 @@
        }
      }
    },
+    "node_modules/xtend": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
+      "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4"
+      }
+    },
    "node_modules/y18n": {
      "version": "5.0.8",
      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
@@ -1,6 +1,6 @@
 {
  "name": "iboard",
-  "version": "1.0.0",
+  "version": "0.2.1",
  "type": "module",
  "scripts": {
    "tauri": "tauri",
@@ -8,6 +8,9 @@
    "dev:server": "node --watch --experimental-strip-types --no-warnings server/index.js",
    "dev": "concurrently -n web,api -c blue,green \"npm run dev:web\" \"npm run dev:server\"",
    "build": "vite build",
+    "build:shell": "vite build --mode shell",
+    "build:win": "node scripts/build-windows.mjs",
+    "build:win:debug": "node scripts/build-windows.mjs --debug",
    "build:ota": "node scripts/build-ota.mjs",
    "preview": "vite preview",
    "start": "node --experimental-strip-types --no-warnings server/index.js",
@@ -30,7 +33,10 @@
    "publish": "bash scripts/wsl/build-apk.sh release"
  },
  "dependencies": {
-    "@prisma/adapter-mariadb": "^7.9.1",
+    "@journeyapps/wa-sqlite": "^2.0.7",
+    "@powersync/react": "^2.1.0",
+    "@powersync/web": "^2.5.0",
+    "@prisma/adapter-pg": "^7.9.1",
    "@prisma/client": "^7.7.0",
    "@zythum02/mijia-api": "^0.1.4",
    "antd-mobile": "^5.42.3",
@@ -52,8 +58,8 @@
    "ws": "^8.21.2"
  },
  "devDependencies": {
-    "@tauri-apps/api": "^2.0.0",
-    "@tauri-apps/cli": "^2.0.0",
+    "@tauri-apps/api": "^2.12.4",
+    "@tauri-apps/cli": "^2.12.4",
    "@vitejs/plugin-react": "^4.3.1",
    "cheerio": "^1.2.0",
    "concurrently": "^9.0.0",
@@ -1,62 +0,0 @@
-- CreateTable
-CREATE TABLE `User` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `name` VARCHAR(191) NOT NULL,
-    `email` VARCHAR(191) NOT NULL,
-    `password` VARCHAR(191) NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `User_email_key`(`email`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `Article` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `title` VARCHAR(191) NOT NULL,
-    `slug` VARCHAR(191) NOT NULL,
-    `content` VARCHAR(191) NOT NULL,
-    `date` VARCHAR(191) NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `Article_slug_key`(`slug`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `Strategy` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `name` VARCHAR(191) NOT NULL,
-    `description` VARCHAR(191) NOT NULL,
-    `data` JSON NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `Indicator` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `name` VARCHAR(191) NOT NULL,
-    `groupName` VARCHAR(191) NOT NULL,
-    `data` JSON NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `SowInventory` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `month` VARCHAR(191) NOT NULL,
-    `inventory` INTEGER NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `SowInventory_month_key`(`month`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,20 +0,0 @@
-/*
-  Warnings:
-
-  - You are about to drop the `SowInventory` table. If the table is not empty, all the data it contains will be lost.
-
-*/
-- DropTable
-DROP TABLE `SowInventory`;
-
-- CreateTable
-CREATE TABLE `Econ_SowInventory` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `month` VARCHAR(191) NOT NULL,
-    `inventory` INTEGER NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `Econ_SowInventory_month_key`(`month`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,13 +0,0 @@
-- CreateTable
-CREATE TABLE `ScraperCache` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `scraperName` VARCHAR(191) NOT NULL,
-    `lastDataHash` VARCHAR(191) NULL,
-    `lastUpdateAt` DATETIME(3) NOT NULL,
-    `metadata` JSON NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `ScraperCache_scraperName_key`(`scraperName`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,5 +0,0 @@
-- Add unique constraint on Strategy.name to enable idempotent upsert in seed script
-ALTER TABLE `Strategy` ADD UNIQUE INDEX `Strategy_name_key`(`name`);
-
-- Add unique constraint on Indicator.name to enable idempotent upsert in seed script
-ALTER TABLE `Indicator` ADD UNIQUE INDEX `Indicator_name_key`(`name`);
@@ -1,24 +0,0 @@
-- 经济指标: 明细数据拆到独立表, 兼容年/季/月/日频率
-- 第一步: 建 IndicatorPoint 表 + Indicator 加元数据列 (data 列暂保留, 由迁移脚本搬运后删除)
-
-- CreateTable
-CREATE TABLE `IndicatorPoint` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `indicatorId` INTEGER NOT NULL,
-    `period` VARCHAR(191) NOT NULL,
-    `value` DOUBLE NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `IndicatorPoint_indicatorId_period_key`(`indicatorId`, `period`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- AlterTable: 元数据列 (data JSON 拆出)
-ALTER TABLE `Indicator` ADD COLUMN `title` VARCHAR(191) NOT NULL DEFAULT '',
-ADD COLUMN `unit` VARCHAR(191) NOT NULL DEFAULT '',
-ADD COLUMN `source` VARCHAR(191) NOT NULL DEFAULT '',
-ADD COLUMN `frequency` VARCHAR(191) NOT NULL DEFAULT 'month';
-
-- AddForeignKey
-ALTER TABLE `IndicatorPoint` ADD CONSTRAINT `IndicatorPoint_indicatorId_fkey` FOREIGN KEY (`indicatorId`) REFERENCES `Indicator`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;
@@ -1,3 +0,0 @@
-- 第二步: 明细数据已迁移到 IndicatorPoint, 删除 Indicator.data JSON 列
-- AlterTable
-ALTER TABLE `Indicator` DROP COLUMN `data`;
@@ -1,2 +0,0 @@
-- 指标隐藏标记: 数据与获取脚本保留, 前端展示过滤 hidden=true
-ALTER TABLE `Indicator` ADD COLUMN `hidden` BOOLEAN NOT NULL DEFAULT false;
@@ -1,32 +0,0 @@
-- CreateTable
-CREATE TABLE `News` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `title` VARCHAR(191) NOT NULL,
-    `summary` VARCHAR(191) NOT NULL DEFAULT '',
-    `source` VARCHAR(191) NOT NULL DEFAULT '',
-    `url` VARCHAR(191) NOT NULL DEFAULT '',
-    `publishedAt` DATETIME(3) NOT NULL,
-    `impactRank` INTEGER NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    UNIQUE INDEX `News_title_publishedAt_key`(`title`, `publishedAt`),
-    INDEX `News_publishedAt_idx`(`publishedAt`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `Alert` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `indicatorName` VARCHAR(191) NOT NULL,
-    `period` VARCHAR(191) NOT NULL,
-    `valueA` DOUBLE NOT NULL,
-    `valueB` DOUBLE NOT NULL,
-    `sourceA` VARCHAR(191) NOT NULL,
-    `sourceB` VARCHAR(191) NOT NULL,
-    `diff` DOUBLE NOT NULL,
-    `diffRatio` DOUBLE NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    INDEX `Alert_createdAt_idx`(`createdAt`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,68 +0,0 @@
-- 服务器监控 + 服务健康检查
-- CreateTable
-CREATE TABLE `ServerNode` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `uuid` VARCHAR(191) NOT NULL,
-    `name` VARCHAR(191) NOT NULL,
-    `cpuName` VARCHAR(191) NOT NULL DEFAULT '',
-    `os` VARCHAR(191) NOT NULL DEFAULT '',
-    `region` VARCHAR(191) NOT NULL DEFAULT '',
-    `memTotal` BIGINT NOT NULL DEFAULT 0,
-    `diskTotal` BIGINT NOT NULL DEFAULT 0,
-    `cpuCores` INTEGER NOT NULL DEFAULT 0,
-    `cpuUsage` DOUBLE NOT NULL DEFAULT 0,
-    `ramUsed` BIGINT NOT NULL DEFAULT 0,
-    `swapUsed` BIGINT NOT NULL DEFAULT 0,
-    `load1` DOUBLE NOT NULL DEFAULT 0,
-    `load5` DOUBLE NOT NULL DEFAULT 0,
-    `load15` DOUBLE NOT NULL DEFAULT 0,
-    `diskUsed` BIGINT NOT NULL DEFAULT 0,
-    `netIn` BIGINT NOT NULL DEFAULT 0,
-    `netOut` BIGINT NOT NULL DEFAULT 0,
-    `uptime` BIGINT NOT NULL DEFAULT 0,
-    `process` INTEGER NOT NULL DEFAULT 0,
-    `connections` INTEGER NOT NULL DEFAULT 0,
-    `status` VARCHAR(191) NOT NULL DEFAULT 'unknown',
-    `recordedAt` DATETIME(3) NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `ServerNode_uuid_key`(`uuid`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `ServerNodeHistory` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `uuid` VARCHAR(191) NOT NULL,
-    `period` DATETIME(3) NOT NULL,
-    `cpu` DOUBLE NOT NULL DEFAULT 0,
-    `ram` BIGINT NOT NULL DEFAULT 0,
-    `load` DOUBLE NOT NULL DEFAULT 0,
-    `disk` BIGINT NOT NULL DEFAULT 0,
-    `netIn` BIGINT NOT NULL DEFAULT 0,
-    `netOut` BIGINT NOT NULL DEFAULT 0,
-    `process` INTEGER NOT NULL DEFAULT 0,
-    `connections` INTEGER NOT NULL DEFAULT 0,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    UNIQUE INDEX `ServerNodeHistory_uuid_period_key`(`uuid`, `period`),
-    INDEX `ServerNodeHistory_uuid_period_idx`(`uuid`, `period`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `ServiceCheck` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `name` VARCHAR(191) NOT NULL,
-    `url` VARCHAR(191) NOT NULL,
-    `status` VARCHAR(191) NOT NULL DEFAULT 'unknown',
-    `latencyMs` INTEGER NOT NULL DEFAULT 0,
-    `message` VARCHAR(191) NOT NULL DEFAULT '',
-    `lastCheckAt` DATETIME(3) NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `ServiceCheck_name_key`(`name`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,2 +0,0 @@
-- AlterTable (news.content 全文, 须在 news_and_alerts 建表之后执行)
-ALTER TABLE `News` ADD COLUMN `content` TEXT NULL;
@@ -1,17 +0,0 @@
-- 浙江省油价历史表
--   - date: 调价日次日 (即数据实际抓取日, 便于按时间排序)
--   - province + fuel: 浙江 / 92/95/0
--   - unique (date, province, fuel): 防 cron 重复入库
--   - DOUBLE 容纳 999.999 元/升
-CREATE TABLE OilPriceHistory (
-    id INT NOT NULL AUTO_INCREMENT,
-    date DATETIME(3) NOT NULL,
-    province VARCHAR(191) NOT NULL,
-    fuel VARCHAR(8) NOT NULL,
-    price DOUBLE NOT NULL,
-    source VARCHAR(191) NOT NULL DEFAULT 'apizero',
-    createdAt DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-    PRIMARY KEY (id),
-    UNIQUE INDEX OilPriceHistory_date_province_fuel_key(date, province, fuel),
-    INDEX OilPriceHistory_province_fuel_date_idx(province, fuel, date)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
@@ -1,95 +0,0 @@
-- CreateTable
-CREATE TABLE `MihomeAccount` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `key` VARCHAR(191) NOT NULL DEFAULT 'default',
-    `userId` VARCHAR(191) NOT NULL DEFAULT '',
-    `status` VARCHAR(191) NOT NULL DEFAULT 'unknown',
-    `lastError` VARCHAR(191) NOT NULL DEFAULT '',
-    `updatedAt` DATETIME(3) NOT NULL,
-
-    UNIQUE INDEX `MihomeAccount_key_key`(`key`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `MihomeHome` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `homeId` VARCHAR(191) NOT NULL,
-    `name` VARCHAR(191) NOT NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    UNIQUE INDEX `MihomeHome_homeId_key`(`homeId`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `MihomeDevice` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `did` VARCHAR(191) NOT NULL,
-    `homeId` VARCHAR(191) NOT NULL,
-    `model` VARCHAR(191) NOT NULL,
-    `name` VARCHAR(191) NOT NULL,
-    `alias` VARCHAR(191) NULL,
-    `tempSiid` INTEGER NOT NULL,
-    `tempPiid` INTEGER NOT NULL,
-    `humSiid` INTEGER NOT NULL,
-    `humPiid` INTEGER NOT NULL,
-    `battSiid` INTEGER NOT NULL,
-    `battPiid` INTEGER NOT NULL,
-    `battery` INTEGER NULL,
-    `batteryAt` DATETIME(3) NULL,
-    `enabled` BOOLEAN NOT NULL DEFAULT true,
-    `lastSyncAt` DATETIME(3) NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    UNIQUE INDEX `MihomeDevice_did_key`(`did`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `MihomeEnvSample` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `deviceId` INTEGER NOT NULL,
-    `date` DATETIME(3) NOT NULL,
-    `temperature` DOUBLE NULL,
-    `humidity` DOUBLE NULL,
-    `temperatureAvg` DOUBLE NULL,
-    `humidityAvg` DOUBLE NULL,
-    `temperatureMin` DOUBLE NULL,
-    `temperatureMax` DOUBLE NULL,
-    `humidityMin` DOUBLE NULL,
-    `humidityMax` DOUBLE NULL,
-    `origin` VARCHAR(191) NOT NULL DEFAULT 'live',
-    `sampledAt` DATETIME(3) NULL,
-    `raw` JSON NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    INDEX `MihomeEnvSample_deviceId_date_idx`(`deviceId`, `date`),
-    UNIQUE INDEX `MihomeEnvSample_deviceId_date_key`(`deviceId`, `date`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- CreateTable
-CREATE TABLE `MihomeEnvHour` (
-    `id` INTEGER NOT NULL AUTO_INCREMENT,
-    `deviceId` INTEGER NOT NULL,
-    `hour` DATETIME(3) NOT NULL,
-    `temperatureAvg` DOUBLE NULL,
-    `humidityAvg` DOUBLE NULL,
-    `raw` JSON NULL,
-    `createdAt` DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-
-    INDEX `MihomeEnvHour_deviceId_hour_idx`(`deviceId`, `hour`),
-    UNIQUE INDEX `MihomeEnvHour_deviceId_hour_key`(`deviceId`, `hour`),
-    PRIMARY KEY (`id`)
-) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-
-- AddForeignKey
-ALTER TABLE `MihomeDevice` ADD CONSTRAINT `MihomeDevice_homeId_fkey` FOREIGN KEY (`homeId`) REFERENCES `MihomeHome`(`homeId`) ON DELETE RESTRICT ON UPDATE CASCADE;
-
-- AddForeignKey
-ALTER TABLE `MihomeEnvSample` ADD CONSTRAINT `MihomeEnvSample_deviceId_fkey` FOREIGN KEY (`deviceId`) REFERENCES `MihomeDevice`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;
-
-- AddForeignKey
-ALTER TABLE `MihomeEnvHour` ADD CONSTRAINT `MihomeEnvHour_deviceId_fkey` FOREIGN KEY (`deviceId`) REFERENCES `MihomeDevice`(`id`) ON DELETE CASCADE ON UPDATE CASCADE;
-
@@ -0,0 +1,655 @@
+-- CreateSchema
+CREATE SCHEMA IF NOT EXISTS "public";
+
+-- CreateTable
+CREATE TABLE "User" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+    "email" TEXT NOT NULL,
+    "password" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "User_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Article" (
+    "id" SERIAL NOT NULL,
+    "title" TEXT NOT NULL,
+    "slug" TEXT NOT NULL,
+    "content" TEXT NOT NULL,
+    "date" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Article_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Strategy" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+    "description" TEXT NOT NULL,
+    "data" JSONB NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Strategy_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Indicator" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+    "groupName" TEXT NOT NULL,
+    "title" TEXT NOT NULL DEFAULT '',
+    "unit" TEXT NOT NULL DEFAULT '',
+    "source" TEXT NOT NULL DEFAULT '',
+    "frequency" TEXT NOT NULL DEFAULT 'month',
+    "hidden" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Indicator_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "IndicatorPoint" (
+    "id" SERIAL NOT NULL,
+    "indicatorId" INTEGER NOT NULL,
+    "period" TEXT NOT NULL,
+    "value" DOUBLE PRECISION NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "IndicatorPoint_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "News" (
+    "id" SERIAL NOT NULL,
+    "title" TEXT NOT NULL,
+    "summary" TEXT NOT NULL DEFAULT '',
+    "content" TEXT,
+    "source" TEXT NOT NULL DEFAULT '',
+    "url" TEXT NOT NULL DEFAULT '',
+    "publishedAt" TIMESTAMP(3) NOT NULL,
+    "impactRank" INTEGER NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "News_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Alert" (
+    "id" SERIAL NOT NULL,
+    "indicatorName" TEXT NOT NULL,
+    "period" TEXT NOT NULL,
+    "valueA" DOUBLE PRECISION NOT NULL,
+    "valueB" DOUBLE PRECISION NOT NULL,
+    "sourceA" TEXT NOT NULL,
+    "sourceB" TEXT NOT NULL,
+    "diff" DOUBLE PRECISION NOT NULL,
+    "diffRatio" DOUBLE PRECISION NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "Alert_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ServerNode" (
+    "id" SERIAL NOT NULL,
+    "uuid" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "cpuName" TEXT NOT NULL DEFAULT '',
+    "os" TEXT NOT NULL DEFAULT '',
+    "region" TEXT NOT NULL DEFAULT '',
+    "memTotal" BIGINT NOT NULL DEFAULT 0,
+    "diskTotal" BIGINT NOT NULL DEFAULT 0,
+    "cpuCores" INTEGER NOT NULL DEFAULT 0,
+    "cpuUsage" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "ramUsed" BIGINT NOT NULL DEFAULT 0,
+    "swapUsed" BIGINT NOT NULL DEFAULT 0,
+    "load1" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "load5" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "load15" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "diskUsed" BIGINT NOT NULL DEFAULT 0,
+    "netIn" BIGINT NOT NULL DEFAULT 0,
+    "netOut" BIGINT NOT NULL DEFAULT 0,
+    "uptime" BIGINT NOT NULL DEFAULT 0,
+    "process" INTEGER NOT NULL DEFAULT 0,
+    "connections" INTEGER NOT NULL DEFAULT 0,
+    "status" TEXT NOT NULL DEFAULT 'unknown',
+    "recordedAt" TIMESTAMP(3) NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ServerNode_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ServerNodeHistory" (
+    "id" SERIAL NOT NULL,
+    "uuid" TEXT NOT NULL,
+    "period" TIMESTAMP(3) NOT NULL,
+    "cpu" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "ram" BIGINT NOT NULL DEFAULT 0,
+    "load" DOUBLE PRECISION NOT NULL DEFAULT 0,
+    "disk" BIGINT NOT NULL DEFAULT 0,
+    "netIn" BIGINT NOT NULL DEFAULT 0,
+    "netOut" BIGINT NOT NULL DEFAULT 0,
+    "process" INTEGER NOT NULL DEFAULT 0,
+    "connections" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ServerNodeHistory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ServiceCheck" (
+    "id" SERIAL NOT NULL,
+    "name" TEXT NOT NULL,
+    "url" TEXT NOT NULL,
+    "status" TEXT NOT NULL DEFAULT 'unknown',
+    "latencyMs" INTEGER NOT NULL DEFAULT 0,
+    "message" TEXT NOT NULL DEFAULT '',
+    "lastCheckAt" TIMESTAMP(3) NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ServiceCheck_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Econ_SowInventory" (
+    "id" SERIAL NOT NULL,
+    "month" TEXT NOT NULL,
+    "inventory" INTEGER NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Econ_SowInventory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ScraperCache" (
+    "id" SERIAL NOT NULL,
+    "scraperName" TEXT NOT NULL,
+    "lastDataHash" TEXT,
+    "lastUpdateAt" TIMESTAMP(3) NOT NULL,
+    "metadata" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "ScraperCache_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "OilPriceHistory" (
+    "id" SERIAL NOT NULL,
+    "date" TIMESTAMP(3) NOT NULL,
+    "province" TEXT NOT NULL,
+    "fuel" TEXT NOT NULL,
+    "price" DOUBLE PRECISION NOT NULL,
+    "source" TEXT NOT NULL DEFAULT 'apizero',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "OilPriceHistory_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "MihomeAccount" (
+    "id" SERIAL NOT NULL,
+    "key" TEXT NOT NULL DEFAULT 'default',
+    "userId" TEXT NOT NULL DEFAULT '',
+    "status" TEXT NOT NULL DEFAULT 'unknown',
+    "lastError" TEXT NOT NULL DEFAULT '',
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "MihomeAccount_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "MihomeHome" (
+    "id" SERIAL NOT NULL,
+    "homeId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "MihomeHome_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "MihomeDevice" (
+    "id" SERIAL NOT NULL,
+    "did" TEXT NOT NULL,
+    "homeId" TEXT NOT NULL,
+    "model" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "alias" TEXT,
+    "tempSiid" INTEGER NOT NULL,
+    "tempPiid" INTEGER NOT NULL,
+    "humSiid" INTEGER NOT NULL,
+    "humPiid" INTEGER NOT NULL,
+    "battSiid" INTEGER NOT NULL,
+    "battPiid" INTEGER NOT NULL,
+    "battery" INTEGER,
+    "batteryAt" TIMESTAMP(3),
+    "enabled" BOOLEAN NOT NULL DEFAULT true,
+    "lastSyncAt" TIMESTAMP(3),
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "MihomeDevice_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "MihomeEnvSample" (
+    "id" SERIAL NOT NULL,
+    "deviceId" INTEGER NOT NULL,
+    "date" TIMESTAMP(3) NOT NULL,
+    "temperature" DOUBLE PRECISION,
+    "humidity" DOUBLE PRECISION,
+    "temperatureAvg" DOUBLE PRECISION,
+    "humidityAvg" DOUBLE PRECISION,
+    "temperatureMin" DOUBLE PRECISION,
+    "temperatureMax" DOUBLE PRECISION,
+    "humidityMin" DOUBLE PRECISION,
+    "humidityMax" DOUBLE PRECISION,
+    "origin" TEXT NOT NULL DEFAULT 'live',
+    "sampledAt" TIMESTAMP(3),
+    "raw" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "MihomeEnvSample_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "MihomeEnvHour" (
+    "id" SERIAL NOT NULL,
+    "deviceId" INTEGER NOT NULL,
+    "hour" TIMESTAMP(3) NOT NULL,
+    "temperatureAvg" DOUBLE PRECISION,
+    "humidityAvg" DOUBLE PRECISION,
+    "raw" JSONB,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "MihomeEnvHour_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Habit" (
+    "id" SERIAL NOT NULL,
+    "userId" INTEGER NOT NULL,
+    "name" TEXT NOT NULL,
+    "period" TEXT NOT NULL DEFAULT 'day',
+    "target" INTEGER NOT NULL DEFAULT 1,
+    "color" TEXT NOT NULL DEFAULT '#1677ff',
+    "icon" TEXT NOT NULL DEFAULT '',
+    "note" TEXT NOT NULL DEFAULT '',
+    "archived" BOOLEAN NOT NULL DEFAULT false,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Habit_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CheckIn" (
+    "id" SERIAL NOT NULL,
+    "habitId" INTEGER NOT NULL,
+    "userId" INTEGER NOT NULL,
+    "date" VARCHAR(10) NOT NULL,
+    "seq" INTEGER NOT NULL DEFAULT 1,
+    "note" TEXT NOT NULL DEFAULT '',
+    "source" TEXT NOT NULL DEFAULT 'user',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "CheckIn_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CheckList" (
+    "id" SERIAL NOT NULL,
+    "userId" INTEGER NOT NULL,
+    "title" TEXT NOT NULL,
+    "scene" TEXT NOT NULL DEFAULT '',
+    "note" TEXT NOT NULL DEFAULT '',
+    "archived" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "CheckList_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CheckListItem" (
+    "id" SERIAL NOT NULL,
+    "listId" INTEGER NOT NULL,
+    "title" TEXT NOT NULL,
+    "note" TEXT NOT NULL DEFAULT '',
+    "done" BOOLEAN NOT NULL DEFAULT false,
+    "doneAt" TIMESTAMP(3),
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "CheckListItem_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "CheckListTemplate" (
+    "id" SERIAL NOT NULL,
+    "userId" INTEGER,
+    "name" TEXT NOT NULL,
+    "scene" TEXT NOT NULL DEFAULT '',
+    "items" JSONB NOT NULL,
+    "builtin" BOOLEAN NOT NULL DEFAULT false,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "CheckListTemplate_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Project" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "code" VARCHAR(8) NOT NULL,
+    "name" VARCHAR(50) NOT NULL,
+    "ownerId" INTEGER NOT NULL,
+    "isPersonal" BOOLEAN NOT NULL DEFAULT false,
+    "archived" BOOLEAN NOT NULL DEFAULT false,
+    "notes" JSONB NOT NULL DEFAULT '[]',
+    "taskKinds" JSONB,
+    "icon" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "Project_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "ProjectMember" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "projectId" INTEGER NOT NULL,
+    "userId" INTEGER NOT NULL,
+    "permission" TEXT NOT NULL DEFAULT 'member',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "ProjectMember_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "BoardColumn" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "projectId" INTEGER NOT NULL,
+    "name" VARCHAR(20) NOT NULL,
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "boundStatus" VARCHAR(8),
+    "retention" VARCHAR(8) NOT NULL DEFAULT 'forever',
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "BoardColumn_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "Task" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "projectId" INTEGER NOT NULL,
+    "columnId" INTEGER NOT NULL,
+    "parentId" INTEGER,
+    "title" VARCHAR(200) NOT NULL,
+    "description" TEXT NOT NULL DEFAULT '',
+    "kind" VARCHAR(20),
+    "markDate" TIMESTAMP(3),
+    "status" VARCHAR(8) NOT NULL DEFAULT 'todo',
+    "doneAt" TIMESTAMP(3),
+    "assigneeId" INTEGER,
+    "creatorId" INTEGER NOT NULL,
+    "extras" JSONB NOT NULL DEFAULT '[]',
+    "sortOrder" INTEGER NOT NULL DEFAULT 0,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+    "number" INTEGER,
+
+    CONSTRAINT "Task_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "TaskMember" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "taskId" INTEGER NOT NULL,
+    "userId" INTEGER NOT NULL,
+
+    CONSTRAINT "TaskMember_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateTable
+CREATE TABLE "TaskTag" (
+    "id" SERIAL NOT NULL,
+    "uuid" VARCHAR(36) NOT NULL,
+    "taskId" INTEGER NOT NULL,
+    "name" VARCHAR(20) NOT NULL,
+
+    CONSTRAINT "TaskTag_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "User_email_key" ON "User"("email");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Article_slug_key" ON "Article"("slug");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Indicator_name_key" ON "Indicator"("name");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "IndicatorPoint_indicatorId_period_key" ON "IndicatorPoint"("indicatorId", "period");
+
+-- CreateIndex
+CREATE INDEX "News_publishedAt_idx" ON "News"("publishedAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "News_title_publishedAt_key" ON "News"("title", "publishedAt");
+
+-- CreateIndex
+CREATE INDEX "Alert_createdAt_idx" ON "Alert"("createdAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ServerNode_uuid_key" ON "ServerNode"("uuid");
+
+-- CreateIndex
+CREATE INDEX "ServerNodeHistory_uuid_period_idx" ON "ServerNodeHistory"("uuid", "period");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ServerNodeHistory_uuid_period_key" ON "ServerNodeHistory"("uuid", "period");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ServiceCheck_name_key" ON "ServiceCheck"("name");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Econ_SowInventory_month_key" ON "Econ_SowInventory"("month");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ScraperCache_scraperName_key" ON "ScraperCache"("scraperName");
+
+-- CreateIndex
+CREATE INDEX "OilPriceHistory_province_fuel_date_idx" ON "OilPriceHistory"("province", "fuel", "date");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "OilPriceHistory_date_province_fuel_key" ON "OilPriceHistory"("date", "province", "fuel");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "MihomeAccount_key_key" ON "MihomeAccount"("key");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "MihomeHome_homeId_key" ON "MihomeHome"("homeId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "MihomeDevice_did_key" ON "MihomeDevice"("did");
+
+-- CreateIndex
+CREATE INDEX "MihomeEnvSample_deviceId_date_idx" ON "MihomeEnvSample"("deviceId", "date");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "MihomeEnvSample_deviceId_date_key" ON "MihomeEnvSample"("deviceId", "date");
+
+-- CreateIndex
+CREATE INDEX "MihomeEnvHour_deviceId_hour_idx" ON "MihomeEnvHour"("deviceId", "hour");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "MihomeEnvHour_deviceId_hour_key" ON "MihomeEnvHour"("deviceId", "hour");
+
+-- CreateIndex
+CREATE INDEX "Habit_userId_archived_sortOrder_idx" ON "Habit"("userId", "archived", "sortOrder");
+
+-- CreateIndex
+CREATE INDEX "CheckIn_userId_date_idx" ON "CheckIn"("userId", "date");
+
+-- CreateIndex
+CREATE INDEX "CheckIn_habitId_date_idx" ON "CheckIn"("habitId", "date");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "CheckIn_habitId_date_seq_key" ON "CheckIn"("habitId", "date", "seq");
+
+-- CreateIndex
+CREATE INDEX "CheckList_userId_archived_idx" ON "CheckList"("userId", "archived");
+
+-- CreateIndex
+CREATE INDEX "CheckListItem_listId_sortOrder_idx" ON "CheckListItem"("listId", "sortOrder");
+
+-- CreateIndex
+CREATE INDEX "CheckListTemplate_userId_builtin_idx" ON "CheckListTemplate"("userId", "builtin");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Project_uuid_key" ON "Project"("uuid");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Project_code_key" ON "Project"("code");
+
+-- CreateIndex
+CREATE INDEX "Project_ownerId_idx" ON "Project"("ownerId");
+
+-- CreateIndex
+CREATE INDEX "Project_archived_idx" ON "Project"("archived");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ProjectMember_uuid_key" ON "ProjectMember"("uuid");
+
+-- CreateIndex
+CREATE INDEX "ProjectMember_userId_idx" ON "ProjectMember"("userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "ProjectMember_projectId_userId_key" ON "ProjectMember"("projectId", "userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "BoardColumn_uuid_key" ON "BoardColumn"("uuid");
+
+-- CreateIndex
+CREATE INDEX "BoardColumn_projectId_sortOrder_idx" ON "BoardColumn"("projectId", "sortOrder");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "BoardColumn_projectId_name_key" ON "BoardColumn"("projectId", "name");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Task_uuid_key" ON "Task"("uuid");
+
+-- CreateIndex
+CREATE INDEX "Task_projectId_columnId_idx" ON "Task"("projectId", "columnId");
+
+-- CreateIndex
+CREATE INDEX "Task_projectId_status_idx" ON "Task"("projectId", "status");
+
+-- CreateIndex
+CREATE INDEX "Task_parentId_idx" ON "Task"("parentId");
+
+-- CreateIndex
+CREATE INDEX "Task_projectId_doneAt_idx" ON "Task"("projectId", "doneAt");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "Task_projectId_number_key" ON "Task"("projectId", "number");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "TaskMember_uuid_key" ON "TaskMember"("uuid");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "TaskMember_taskId_userId_key" ON "TaskMember"("taskId", "userId");
+
+-- CreateIndex
+CREATE UNIQUE INDEX "TaskTag_uuid_key" ON "TaskTag"("uuid");
+
+-- CreateIndex
+CREATE INDEX "TaskTag_taskId_idx" ON "TaskTag"("taskId");
+
+-- AddForeignKey
+ALTER TABLE "IndicatorPoint" ADD CONSTRAINT "IndicatorPoint_indicatorId_fkey" FOREIGN KEY ("indicatorId") REFERENCES "Indicator"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "MihomeDevice" ADD CONSTRAINT "MihomeDevice_homeId_fkey" FOREIGN KEY ("homeId") REFERENCES "MihomeHome"("homeId") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "MihomeEnvSample" ADD CONSTRAINT "MihomeEnvSample_deviceId_fkey" FOREIGN KEY ("deviceId") REFERENCES "MihomeDevice"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "MihomeEnvHour" ADD CONSTRAINT "MihomeEnvHour_deviceId_fkey" FOREIGN KEY ("deviceId") REFERENCES "MihomeDevice"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Habit" ADD CONSTRAINT "Habit_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CheckIn" ADD CONSTRAINT "CheckIn_habitId_fkey" FOREIGN KEY ("habitId") REFERENCES "Habit"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CheckIn" ADD CONSTRAINT "CheckIn_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CheckList" ADD CONSTRAINT "CheckList_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CheckListItem" ADD CONSTRAINT "CheckListItem_listId_fkey" FOREIGN KEY ("listId") REFERENCES "CheckList"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "CheckListTemplate" ADD CONSTRAINT "CheckListTemplate_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Project" ADD CONSTRAINT "Project_ownerId_fkey" FOREIGN KEY ("ownerId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ProjectMember" ADD CONSTRAINT "ProjectMember_projectId_fkey" FOREIGN KEY ("projectId") REFERENCES "Project"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "ProjectMember" ADD CONSTRAINT "ProjectMember_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "BoardColumn" ADD CONSTRAINT "BoardColumn_projectId_fkey" FOREIGN KEY ("projectId") REFERENCES "Project"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Task" ADD CONSTRAINT "Task_projectId_fkey" FOREIGN KEY ("projectId") REFERENCES "Project"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Task" ADD CONSTRAINT "Task_columnId_fkey" FOREIGN KEY ("columnId") REFERENCES "BoardColumn"("id") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Task" ADD CONSTRAINT "Task_parentId_fkey" FOREIGN KEY ("parentId") REFERENCES "Task"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Task" ADD CONSTRAINT "Task_assigneeId_fkey" FOREIGN KEY ("assigneeId") REFERENCES "User"("id") ON DELETE SET NULL ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "Task" ADD CONSTRAINT "Task_creatorId_fkey" FOREIGN KEY ("creatorId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TaskMember" ADD CONSTRAINT "TaskMember_taskId_fkey" FOREIGN KEY ("taskId") REFERENCES "Task"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TaskMember" ADD CONSTRAINT "TaskMember_userId_fkey" FOREIGN KEY ("userId") REFERENCES "User"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "TaskTag" ADD CONSTRAINT "TaskTag_taskId_fkey" FOREIGN KEY ("taskId") REFERENCES "Task"("id") ON DELETE CASCADE ON UPDATE CASCADE;
@@ -0,0 +1,7 @@
+-- 任务归档 (T-ARC): 项目自动归档档位 + 任务归档三字段与查询索引
+ALTER TABLE `Project` ADD COLUMN `autoArchive` VARCHAR(8) NOT NULL DEFAULT 'never';
+ALTER TABLE `Task` ADD COLUMN `archived` BOOLEAN NOT NULL DEFAULT false;
+ALTER TABLE `Task` ADD COLUMN `archivedAt` DATETIME(3) NULL;
+ALTER TABLE `Task` ADD COLUMN `archiveSource` VARCHAR(8) NULL;
+ALTER TABLE `Task` ADD INDEX `idx_task_project_archived` (`projectId`, `archived`, `archivedAt`);
+ALTER TABLE `Task` ADD INDEX `idx_task_project_status_arch` (`projectId`, `status`, `archived`);
@@ -0,0 +1,96 @@
+-- uuid 外键镜像 (PowerSync Sequential ID Mapping, 见 docs/V0.2/离线编辑模块/0.2.1实施方案.md §3)
+-- 目的: 同步流以 uuid 作为客户端主键 (离线新建行同步回填后本地 id 稳定不变),
+--       外键列同步输出 uuid 镜像 (别名回 projectId/columnId/parentId/taskId), 客户端零改动。
+-- 镜像列由触发器维护: REST/Prisma 写 int 外键 -> 触发器回填 uuid; upload 端在应用层解析 uuid -> int。
+
+-- 1) 加列 (先可空)
+ALTER TABLE "BoardColumn"   ADD COLUMN "projectUuid" VARCHAR(36);
+ALTER TABLE "Task"          ADD COLUMN "projectUuid" VARCHAR(36), ADD COLUMN "columnUuid" VARCHAR(36), ADD COLUMN "parentUuid" VARCHAR(36);
+ALTER TABLE "ProjectMember" ADD COLUMN "projectUuid" VARCHAR(36);
+ALTER TABLE "TaskMember"    ADD COLUMN "taskUuid" VARCHAR(36);
+ALTER TABLE "TaskTag"       ADD COLUMN "taskUuid" VARCHAR(36);
+
+-- 2) 存量回填
+UPDATE "BoardColumn"   c SET "projectUuid" = p."uuid" FROM "Project" p WHERE c."projectId" = p."id";
+UPDATE "Task"          t SET "projectUuid" = p."uuid" FROM "Project" p WHERE t."projectId" = p."id";
+UPDATE "Task"          t SET "columnUuid"  = c."uuid" FROM "BoardColumn" c WHERE t."columnId" = c."id";
+UPDATE "Task"          t SET "parentUuid"  = pt."uuid" FROM "Task" pt WHERE t."parentId" = pt."id";
+UPDATE "ProjectMember" pm SET "projectUuid" = p."uuid" FROM "Project" p WHERE pm."projectId" = p."id";
+UPDATE "TaskMember"    tm SET "taskUuid"    = t."uuid" FROM "Task" t WHERE tm."taskId" = t."id";
+UPDATE "TaskTag"       tt SET "taskUuid"    = t."uuid" FROM "Task" t WHERE tt."taskId" = t."id";
+
+-- 3) 非空约束
+ALTER TABLE "BoardColumn"   ALTER COLUMN "projectUuid" SET NOT NULL;
+ALTER TABLE "Task"          ALTER COLUMN "projectUuid" SET NOT NULL;
+ALTER TABLE "Task"          ALTER COLUMN "columnUuid" SET NOT NULL;
+ALTER TABLE "ProjectMember" ALTER COLUMN "projectUuid" SET NOT NULL;
+ALTER TABLE "TaskMember"    ALTER COLUMN "taskUuid" SET NOT NULL;
+ALTER TABLE "TaskTag"       ALTER COLUMN "taskUuid" SET NOT NULL;
+
+-- 4) 外键 (级联与 int 外键一致)
+ALTER TABLE "BoardColumn"   ADD CONSTRAINT "BoardColumn_projectUuid_fkey" FOREIGN KEY ("projectUuid") REFERENCES "Project"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "Task"          ADD CONSTRAINT "Task_projectUuid_fkey" FOREIGN KEY ("projectUuid") REFERENCES "Project"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "Task"          ADD CONSTRAINT "Task_columnUuid_fkey" FOREIGN KEY ("columnUuid") REFERENCES "BoardColumn"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "Task"          ADD CONSTRAINT "Task_parentUuid_fkey" FOREIGN KEY ("parentUuid") REFERENCES "Task"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "ProjectMember" ADD CONSTRAINT "ProjectMember_projectUuid_fkey" FOREIGN KEY ("projectUuid") REFERENCES "Project"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "TaskMember"    ADD CONSTRAINT "TaskMember_taskUuid_fkey" FOREIGN KEY ("taskUuid") REFERENCES "Task"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+ALTER TABLE "TaskTag"       ADD CONSTRAINT "TaskTag_taskUuid_fkey" FOREIGN KEY ("taskUuid") REFERENCES "Task"("uuid") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- 5) 触发器: 写入时按 int 外键回填 uuid 镜像
+CREATE OR REPLACE FUNCTION "func_projectmember_uuid_map"() RETURNS TRIGGER AS $$
+BEGIN
+  SELECT "uuid" INTO NEW."projectUuid" FROM "Project" WHERE "id" = NEW."projectId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'Project % 不存在', NEW."projectId"; END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+CREATE TRIGGER "trg_projectmember_uuid_map" BEFORE INSERT OR UPDATE ON "ProjectMember"
+  FOR EACH ROW EXECUTE FUNCTION "func_projectmember_uuid_map"();
+
+CREATE OR REPLACE FUNCTION "func_boardcolumn_uuid_map"() RETURNS TRIGGER AS $$
+BEGIN
+  SELECT "uuid" INTO NEW."projectUuid" FROM "Project" WHERE "id" = NEW."projectId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'Project % 不存在', NEW."projectId"; END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+CREATE TRIGGER "trg_boardcolumn_uuid_map" BEFORE INSERT OR UPDATE ON "BoardColumn"
+  FOR EACH ROW EXECUTE FUNCTION "func_boardcolumn_uuid_map"();
+
+CREATE OR REPLACE FUNCTION "func_task_uuid_map"() RETURNS TRIGGER AS $$
+BEGIN
+  SELECT "uuid" INTO NEW."projectUuid" FROM "Project" WHERE "id" = NEW."projectId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'Project % 不存在', NEW."projectId"; END IF;
+  SELECT "uuid" INTO NEW."columnUuid" FROM "BoardColumn" WHERE "id" = NEW."columnId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'BoardColumn % 不存在', NEW."columnId"; END IF;
+  IF NEW."parentId" IS NULL THEN
+    NEW."parentUuid" := NULL;
+  ELSE
+    SELECT "uuid" INTO NEW."parentUuid" FROM "Task" WHERE "id" = NEW."parentId";
+    IF NOT FOUND THEN RAISE EXCEPTION 'Task % 不存在', NEW."parentId"; END IF;
+  END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+CREATE TRIGGER "trg_task_uuid_map" BEFORE INSERT OR UPDATE ON "Task"
+  FOR EACH ROW EXECUTE FUNCTION "func_task_uuid_map"();
+
+CREATE OR REPLACE FUNCTION "func_taskmember_uuid_map"() RETURNS TRIGGER AS $$
+BEGIN
+  SELECT "uuid" INTO NEW."taskUuid" FROM "Task" WHERE "id" = NEW."taskId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'Task % 不存在', NEW."taskId"; END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+CREATE TRIGGER "trg_taskmember_uuid_map" BEFORE INSERT OR UPDATE ON "TaskMember"
+  FOR EACH ROW EXECUTE FUNCTION "func_taskmember_uuid_map"();
+
+CREATE OR REPLACE FUNCTION "func_tasktag_uuid_map"() RETURNS TRIGGER AS $$
+BEGIN
+  SELECT "uuid" INTO NEW."taskUuid" FROM "Task" WHERE "id" = NEW."taskId";
+  IF NOT FOUND THEN RAISE EXCEPTION 'Task % 不存在', NEW."taskId"; END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+CREATE TRIGGER "trg_tasktag_uuid_map" BEFORE INSERT OR UPDATE ON "TaskTag"
+  FOR EACH ROW EXECUTE FUNCTION "func_tasktag_uuid_map"();
@@ -1,3 +1,3 @@
 # Please do not edit this file manually
 # It should be added in your version-control system (e.g., Git)
-provider = "mysql"
+provider = "postgresql"
@@ -9,7 +9,7 @@ generator client {
 }

 datasource db {
-  provider = "mysql"
+  provider = "postgresql"
 }

 model User {
@@ -19,6 +19,19 @@ model User {
  password  String
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
+
+  // V0.2 打卡 / 清单: 用户删除时级联清理
+  habits     Habit[]
+  checkIns   CheckIn[]
+  checkLists CheckList[]
+  templates  CheckListTemplate[]
+
+  // V0.2 任务模块
+  ownedProjects  Project[]       @relation("ProjectOwner")
+  projectMembers ProjectMember[]
+  assignedTasks  Task[]          @relation("TaskAssignee")
+  createdTasks   Task[]          @relation("TaskCreator")
+  taskMembers    TaskMember[]
 }

 model Article {
@@ -281,4 +294,223 @@ model MihomeEnvHour {
  @@index([deviceId, hour])
 }

+// ==================== 打卡 / 日历 / 清单 (V0.2) ====================

+// 打卡项: 周期性目标 (每天 / 每周 / 每月 / 每年 n 次)
+model Habit {
+  id        Int      @id @default(autoincrement())
+  userId    Int
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  name      String
+  period    String   @default("day")  // day | week | month | year
+  target    Int      @default(1)      // 周期内目标次数 n (>=1)
+  color     String   @default("#1677ff")
+  icon      String   @default("")     // emoji 或图标名, 预留
+  note      String   @default("")
+  archived  Boolean  @default(false)  // 归档: 不出现在今日待办, 历史保留
+  sortOrder Int      @default(0)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  records   CheckIn[]
+
+  @@index([userId, archived, sortOrder])
+}
+
+// 打卡记录: 一次打卡 = 一条; 同日多次 => seq 递增 (1..n, 超额继续累加)
+model CheckIn {
+  id        Int      @id @default(autoincrement())
+  habitId   Int
+  habit     Habit    @relation(fields: [habitId], references: [id], onDelete: Cascade)
+  userId    Int
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  date      String   @db.VarChar(10)  // 本地日历日 "YYYY-MM-DD" (Asia/Shanghai)
+  seq       Int      @default(1)      // 当日第几次
+  note      String   @default("")
+  source    String   @default("user") // user | backfill (补打)
+  createdAt DateTime @default(now())
+
+  @@unique([habitId, date, seq])
+  @@index([userId, date])
+  @@index([habitId, date])
+}
+
+// 检查清单: 出差 / 回老家 等场景的一次性清单
+model CheckList {
+  id        Int             @id @default(autoincrement())
+  userId    Int
+  user      User            @relation(fields: [userId], references: [id], onDelete: Cascade)
+  title     String
+  scene     String          @default("")  // 出差 | 回老家 | 自定义
+  note      String          @default("")
+  archived  Boolean         @default(false)
+  createdAt DateTime        @default(now())
+  updatedAt DateTime        @updatedAt
+  items     CheckListItem[]
+
+  @@index([userId, archived])
+}
+
+// 检查项: 勾选即完成
+model CheckListItem {
+  id        Int       @id @default(autoincrement())
+  listId    Int
+  list      CheckList @relation(fields: [listId], references: [id], onDelete: Cascade)
+  title     String
+  note      String    @default("")
+  done      Boolean   @default(false)
+  doneAt    DateTime?
+  sortOrder Int       @default(0)
+  createdAt DateTime  @default(now())
+  updatedAt DateTime  @updatedAt
+
+  @@index([listId, sortOrder])
+}
+
+// 清单模板: builtin = 系统预置 (userId 为空); 否则为用户自定义
+model CheckListTemplate {
+  id        Int      @id @default(autoincrement())
+  userId    Int?
+  user      User?    @relation(fields: [userId], references: [id], onDelete: Cascade)
+  name      String
+  scene     String   @default("")
+  items     Json                      // [{ title, note }]
+  builtin   Boolean  @default(false)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([userId, builtin])
+}
+
+// ================== 任务模块 (V0.2 任务模块需求文档 T-*) ==================
+// 口径见 docs/V0.2/任务模块/任务模块数据库设计文档.md
+//   项目 = 隔离 + 权限单位; 看板列是实体(可增删改排序);
+//   任务状态(todo/doing/done) 与 看板列 是两个正交维度, 由列的 boundStatus 决定是否联动.
+
+model Project {
+  id         Int      @id @default(autoincrement())
+  uuid       String   @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑, 见 docs/V0.2/离线编辑模块)
+  code       String   @unique @db.VarChar(8)  // 项目短编号: 用户自拟 2~8 位前缀, 全局唯一, 服务端分配
+  name       String   @db.VarChar(50)
+  ownerId    Int
+  owner      User     @relation("ProjectOwner", fields: [ownerId], references: [id], onDelete: Cascade)
+  isPersonal Boolean  @default(false)
+  archived   Boolean  @default(false)
+  notes      Json     @default("[]") // 项目信息块 [{ title, content }] (T-PJ-13)
+  taskKinds  Json?    // 任务类型标签列表 (未配置时服务端回落默认四类)
+  icon       String?  @db.Text // 项目图标 (data URL, 客户端裁剪为 96x96 JPEG)
+  autoArchive String  @default("never") @db.VarChar(8) // 自动归档档位: 3d/1w/1m/never (T-ARC-02)
+  createdAt  DateTime @default(now())
+  updatedAt  DateTime @updatedAt
+
+  members ProjectMember[]
+  columns BoardColumn[]
+  tasks   Task[]
+
+  @@index([ownerId])
+  @@index([archived])
+}
+
+model ProjectMember {
+  id          Int      @id @default(autoincrement())
+  uuid        String   @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑)
+  projectUuid String?  @db.VarChar(36) // 外键 uuid 镜像 (触发器维护, 库级 NOT NULL)
+  projectId   Int
+  project    Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  userId     Int
+  user       User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  permission String   @default("member")
+  createdAt  DateTime @default(now())
+
+  @@unique([projectId, userId])
+  @@index([userId])
+}
+
+model BoardColumn {
+  id          Int      @id @default(autoincrement())
+  uuid        String   @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑)
+  projectUuid String?  @db.VarChar(36) // projectId 的 uuid 镜像 (触发器维护, 库级 NOT NULL; Prisma 侧可空以便触发器填充)
+  projectId   Int
+  project     Project  @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  name        String   @db.VarChar(20)
+  sortOrder   Int      @default(0)
+  boundStatus String?  @db.VarChar(8)
+  retention   String   @default("forever") @db.VarChar(8)
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+
+  tasks Task[]
+
+  @@unique([projectId, name])
+  @@index([projectId, sortOrder])
+}
+
+model Task {
+  id          Int       @id @default(autoincrement())
+  uuid        String    @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑)
+  projectUuid String?   @db.VarChar(36) // 外键 uuid 镜像 (触发器维护, 库级 NOT NULL)
+  columnUuid  String?   @db.VarChar(36)
+  parentUuid  String?   @db.VarChar(36)
+  projectId   Int
+  project     Project   @relation(fields: [projectId], references: [id], onDelete: Cascade)
+  columnId    Int
+  column      BoardColumn @relation(fields: [columnId], references: [id], onDelete: Restrict)
+  parentId    Int?
+  parent      Task?     @relation("Subtask", fields: [parentId], references: [id], onDelete: Cascade)
+  children    Task[]    @relation("Subtask")
+
+  title       String    @db.VarChar(200)
+  description String    @default("") @db.Text
+  kind        String?   @db.VarChar(20) // 任务类型标签 (项目 taskKinds 之一)
+  markDate    DateTime? // 时间标记 (完整日期存储, 展示为 MM-dd)
+  status      String    @default("todo") @db.VarChar(8)
+  doneAt      DateTime?
+
+  assigneeId  Int?
+  assignee    User?     @relation("TaskAssignee", fields: [assigneeId], references: [id], onDelete: SetNull)
+  creatorId   Int
+  creator     User      @relation("TaskCreator", fields: [creatorId], references: [id], onDelete: Cascade)
+
+  extras      Json      @default("[]")
+  sortOrder   Int       @default(0)
+  archived    Boolean   @default(false)
+  archivedAt  DateTime?
+  archiveSource String? @db.VarChar(8) // manual | auto (T-ARC)
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  members TaskMember[]
+  tags    TaskTag[]
+
+  number      Int?      // 项目内自增编号 (服务端分配, 展示为 `code-number`); 本地未定号的离线新建任务为空
+
+  @@unique([projectId, number])
+  @@index([projectId, columnId])
+  @@index([projectId, status])
+  @@index([parentId])
+  @@index([projectId, doneAt])
+  @@index([projectId, archived, archivedAt])
+  @@index([projectId, status, archived])
+}
+
+model TaskMember {
+  id      Int  @id @default(autoincrement())
+  uuid    String @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑)
+  taskUuid String? @db.VarChar(36) // 外键 uuid 镜像 (触发器维护, 库级 NOT NULL)
+  taskId Int
+  task   Task @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  userId Int
+  user   User @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+  @@unique([taskId, userId])
+}
+
+model TaskTag {
+  id       Int    @id @default(autoincrement())
+  uuid     String @unique @db.VarChar(36) // 同步标识: 客户端生成 (0.2.1 离线编辑)
+  taskUuid String? @db.VarChar(36) // 外键 uuid 镜像 (触发器维护, 库级 NOT NULL)
+  taskId   Int
+  task   Task   @relation(fields: [taskId], references: [id], onDelete: Cascade)
+  name   String @db.VarChar(20)
+
+  @@index([taskId])
+}
@@ -0,0 +1,34 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <!-- 悬浮球 (W-SNP-02): 半圆形贴边图标, 圆弧朝屏幕内侧, 由 Rust 控制位置与主题 -->
+  <style>
+    html, body {
+      margin: 0; padding: 0; width: 100%; height: 100%;
+      background: transparent; overflow: hidden; user-select: none;
+    }
+    #ball { position: fixed; inset: 0; cursor: pointer; transition: transform .12s ease; }
+    /* 半圆: 直边贴屏幕边缘, 圆弧朝内 (四边方向) */
+    .dock-left #ball   { border-radius: 0 28px 28px 0; }   /* 左缘 → 凸向右 */
+    .dock-right #ball  { border-radius: 28px 0 0 28px; }   /* 右缘 → 凸向左 */
+    .dock-top #ball    { border-radius: 0 0 28px 28px; }   /* 上缘 → 凸向下 */
+    .dock-bottom #ball { border-radius: 28px 28px 0 0; }   /* 下缘 → 凸向上 */
+    /* 深浅色 (W-THE-01): 跟随系统应用模式 */
+    .theme-light #ball { background: rgba(28, 28, 30, 0.92); box-shadow: inset 0 0 0 1px rgba(255, 255, 255, 0.35); }
+    .theme-dark #ball  { background: rgba(245, 245, 245, 0.95); box-shadow: inset 0 0 0 1px rgba(0, 0, 0, 0.25); }
+    #ball::after {
+      content: ""; position: absolute; left: 50%; top: 50%;
+      width: 8px; height: 8px; border-radius: 50%;
+      transform: translate(-50%, -50%);
+    }
+    .theme-light #ball::after { background: rgba(255, 255, 255, 0.85); }
+    .theme-dark #ball::after  { background: rgba(30, 30, 30, 0.75); }
+    #ball:hover { transform: scale(1.06); }
+  </style>
+</head>
+<body class="dock-left theme-light">
+  <div id="ball"></div>
+  <script src="./dock.js"></script>
+</body>
+</html>
@@ -0,0 +1,65 @@
+// 悬浮球交互 (W-SNP-04/05/12/13/14):
+//   mouseenter/leave → hover 延时恢复 (Rust 侧计时 150ms)
+//   单击 (位移 ≤4px)  → 立即恢复, 触屏点按等效
+//   拖动              → dock_drag_move 增量移动, 结束时按最近边停靠/换边/拖出
+const { invoke } = window.__TAURI__.core
+const ball = document.getElementById('ball')
+
+let dragging = false
+let moved = 0
+let lastX = 0
+let lastY = 0
+
+ball.addEventListener('mouseenter', () => invoke('dock_hover_start'))
+ball.addEventListener('mouseleave', () => invoke('dock_hover_end'))
+ball.addEventListener('contextmenu', (e) => e.preventDefault())
+
+ball.addEventListener('pointerdown', (e) => {
+  dragging = true
+  moved = 0
+  lastX = e.clientX
+  lastY = e.clientY
+  ball.setPointerCapture(e.pointerId)
+  invoke('dock_drag_start')
+})
+
+ball.addEventListener('pointermove', (e) => {
+  if (!dragging) return
+  const dx = e.clientX - lastX
+  const dy = e.clientY - lastY
+  if (dx === 0 && dy === 0) return
+  lastX = e.clientX
+  lastY = e.clientY
+  moved += Math.abs(dx) + Math.abs(dy)
+  if (moved > 4) {
+    // clientX 为逻辑像素, 增量按 DPI 缩放换算成物理像素 (Rust 注入 __SCALE)
+    const s = window.__SCALE || 1
+    invoke('dock_drag_move', { dx: Math.round(dx * s), dy: Math.round(dy * s) })
+  }
+})
+
+ball.addEventListener('pointerup', (e) => {
+  if (!dragging) return
+  dragging = false
+  try { ball.releasePointerCapture(e.pointerId) } catch { /* 已释放 */ }
+  if (moved <= 4) {
+    invoke('dock_click')
+  } else {
+    invoke('dock_drag_end')
+  }
+})
+
+ball.addEventListener('pointercancel', () => {
+  dragging = false
+  invoke('dock_drag_end')
+})
+
+// Rust 在停靠/换边/主题变化时调用
+window.applyDock = (edge, theme) => {
+  document.body.className = 'dock-' + edge + ' theme-' + theme
+}
+window.applyTheme = (theme) => {
+  const edge = [...document.body.classList].find((c) => c.startsWith('dock-')) || 'dock-left'
+  document.body.className = edge + ' theme-' + theme
+}
+window.__SCALE = 1
--- a/Show More
+++ b/Show More