AI 润色配置（可选）
diff --git a/server/DEPLOY.md b/server/DEPLOY.md
new file mode 100644
index 0000000..b78187d
--- /dev/null
+++ b/server/DEPLOY.md
@@ -0,0 +1,32 @@
+# 同步服务端部署指南
+
+## 部署（在 124.221.192.176 上执行）
+
+1. 上传 server 目录到服务器（如 ~/internlog-sync/）
+2. 启动：
+
+ cd ~/internlog-sync
+ docker compose up -d --build
+
+3. 验证：curl http://127.0.0.1:3780/api/health 应返回 {"ok":true}
+
+数据保存在 ./data/（用户注册表 + 每用户数据文件），直接打包该目录即备份。
+
+## 建议：启用 HTTPS
+
+客户端在手机浏览器使用时，建议用 nginx 反向代理复用现有证书：
+
+ location /sync-api/ {
+ proxy_pass http://127.0.0.1:3780/;
+ proxy_set_header Host $host;
+ }
+
+客户端同步地址填 https://gitea.linyux.cn/sync-api 即可全程加密。
+不加代理时客户端可临时填 http://124.221.192.176:3780（明文，仅建议内网或过渡期使用）。
+
+## 接口
+
+- POST /api/auth/register {username, password}
+- POST /api/auth/login {username, password}
+- POST /api/sync Authorization: Bearer ，body: {tables, tombstones}
+- GET /api/health
diff --git a/server/Dockerfile b/server/Dockerfile
new file mode 100644
index 0000000..d380d84
--- /dev/null
+++ b/server/Dockerfile
@@ -0,0 +1,6 @@
+FROM node:22-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+COPY package.json index.js ./
+EXPOSE 3780
+CMD ["node", "index.js"]
diff --git a/server/docker-compose.yml b/server/docker-compose.yml
new file mode 100644
index 0000000..385d042
--- /dev/null
+++ b/server/docker-compose.yml
@@ -0,0 +1,9 @@
+services:
+ internlog-sync:
+ build: .
+ container_name: internlog-sync
+ ports:
+ - "3780:3780"
+ volumes:
+ - ./data:/app/data
+ restart: unless-stopped
diff --git a/server/index.js b/server/index.js
new file mode 100644
index 0000000..b1f4574
--- /dev/null
+++ b/server/index.js
@@ -0,0 +1,206 @@
+// 实习工作日志 · 多端同步服务端
+// 零依赖：node:http + node:crypto + JSON 文件存储（个人规模足够，便于备份）
+import http from 'node:http'
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DATA_DIR = process.env.DATA_DIR || path.join(__dirname, 'data')
+const PORT = Number(process.env.PORT || 3780)
+const TOKEN_TTL_MS = 30 * 24 * 60 * 60 * 1000 // 30 天
+const ITER = 150000
+
+const TABLES = ['project', 'work_log', 'log_item', 'attendance', 'weekly_note', 'setting', 'memo', 'credential', 'transaction']
+
+fs.mkdirSync(DATA_DIR, { recursive: true })
+
+// ---------- 存储辅助 ----------
+function readJson(file, fallback) {
+ try {
+ return JSON.parse(fs.readFileSync(path.join(DATA_DIR, file), 'utf-8'))
+ } catch {
+ return fallback
+ }
+}
+function writeJson(file, data) {
+ const tmp = path.join(DATA_DIR, file + '.tmp')
+ fs.writeFileSync(tmp, JSON.stringify(data))
+ fs.renameSync(tmp, path.join(DATA_DIR, file))
+}
+
+if (!fs.existsSync(path.join(DATA_DIR, 'secret.key'))) {
+ writeJson('secret.key', { secret: crypto.randomBytes(32).toString('hex') })
+}
+const SECRET = readJson('secret.key', { secret: 'fallback-secret' }).secret
+
+const registryFile = 'registry.json'
+let registry = readJson(registryFile, { users: [] })
+function saveRegistry() { writeJson(registryFile, registry) }
+
+function userFile(userId) { return path.join(DATA_DIR, 'users', userId + '.json') }
+function loadUserData(userId) {
+ return readJson('users/' + userId + '.json', { userId, cursor: 0, tables: {}, tombstones: {} })
+}
+function saveUserData(userId, data) {
+ fs.mkdirSync(path.join(DATA_DIR, 'users'), { recursive: true })
+ writeJson('users/' + userId + '.json', data)
+}
+
+// ---------- 认证 ----------
+function pbkdf2Hash(password, salt) {
+ return crypto.pbkdf2Sync(password, salt, ITER, 32, 'sha256').toString('hex')
+}
+function makeToken(userId) {
+ const payload = base64url(JSON.stringify({ userId, exp: Date.now() + TOKEN_TTL_MS }))
+ const sig = crypto.createHmac('sha256', SECRET).update(payload).digest('base64url')
+ return payload + '.' + sig
+}
+function verifyToken(token) {
+ const parts = String(token || '').split('.')
+ if (parts.length !== 2) return null
+ const expect = crypto.createHmac('sha256', SECRET).update(parts[0]).digest('base64url')
+ const a = Buffer.from(parts[1])
+ const b = Buffer.from(expect)
+ if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) return null
+ try {
+ const payload = JSON.parse(Buffer.from(parts[0], 'base64url').toString('utf-8'))
+ if (!payload.userId || payload.exp < Date.now()) return null
+ return payload
+ } catch {
+ return null
+ }
+}
+function base64url(s) {
+ return Buffer.from(s).toString('base64url')
+}
+
+// ---------- HTTP 基础 ----------
+function json(res, status, data) {
+ const body = JSON.stringify(data)
+ res.writeHead(status, {
+ 'Content-Type': 'application/json; charset=utf-8',
+ 'Access-Control-Allow-Origin': '*',
+ 'Access-Control-Allow-Methods': 'GET,POST,OPTIONS',
+ 'Access-Control-Allow-Headers': 'Content-Type, Authorization'
+ })
+ res.end(body)
+}
+function readBody(req, limit = 20 * 1024 * 1024) {
+ return new Promise((resolve, reject) => {
+ let size = 0
+ const chunks = []
+ req.on('data', c => {
+ size += c.length
+ if (size > limit) { reject(new Error('body too large')); req.destroy(); return }
+ chunks.push(c)
+ })
+ req.on('end', () => {
+ try { resolve(JSON.parse(Buffer.concat(chunks).toString('utf-8') || '{}')) }
+ catch { reject(new Error('invalid json')) }
+ })
+ req.on('error', reject)
+ })
+}
+
+// ---------- 路由 ----------
+async function handle(req, res) {
+ const url = new URL(req.url, 'http://localhost')
+ const route = url.pathname
+
+ if (req.method === 'OPTIONS') { json(res, 204, {}); return }
+
+ if (req.method === 'GET' && route === '/api/health') { json(res, 200, { ok: true }); return }
+
+ if (req.method === 'POST' && route === '/api/auth/register') {
+ const body = await readBody(req)
+ const username = String(body.username || '').trim()
+ const password = String(body.password || '')
+ if (username.length < 2 || username.length > 20) { json(res, 400, { error: '用户名需 2 到 20 个字符' }); return }
+ if (password.length < 6) { json(res, 400, { error: '密码至少 6 位' }); return }
+ if (registry.users.find(u => u.username === username)) { json(res, 409, { error: '用户名已存在' }); return }
+ const salt = crypto.randomBytes(16).toString('hex')
+ const userId = 'cu_' + crypto.randomBytes(6).toString('hex')
+ registry.users.push({ id: userId, username, pwd_hash: pbkdf2Hash(password, salt), pwd_salt: salt, created_at: new Date().toISOString() })
+ saveRegistry()
+ json(res, 200, { userId, username, token: makeToken(userId) })
+ return
+ }
+
+ if (req.method === 'POST' && route === '/api/auth/login') {
+ const body = await readBody(req)
+ const username = String(body.username || '').trim()
+ const rec = registry.users.find(u => u.username === username)
+ if (!rec) { json(res, 401, { error: '用户不存在' }); return }
+ if (pbkdf2Hash(String(body.password || ''), rec.pwd_salt) !== rec.pwd_hash) { json(res, 401, { error: '密码不正确' }); return }
+ json(res, 200, { userId: rec.id, username: rec.username, token: makeToken(rec.id) })
+ return
+ }
+
+ if (req.method === 'POST' && route === '/api/sync') {
+ const auth = verifyToken(String(req.headers['authorization'] || '').replace(/^Bearer\s+/i, '').trim())
+ if (!auth) { json(res, 401, { error: '未认证' }); return }
+ const body = await readBody(req)
+ const userData = loadUserData(auth.userId)
+ if (!userData.cursor) userData.cursor = 0
+ if (!userData.tables) userData.tables = {}
+ if (!userData.tombstones) userData.tombstones = {}
+
+ // 应用推送的变更（新者胜）
+ const incomingTables = body.tables || {}
+ for (const t of TABLES) {
+ const rows = incomingTables[t] || []
+ userData.tables[t] = userData.tables[t] || {}
+ for (const row of rows) {
+ if (!row || !row.uuid) continue
+ const clean = {}
+ for (const k of Object.keys(row)) if (k !== 'id') clean[k] = row[k]
+ const existing = userData.tables[t][row.uuid]
+ if (!existing || String(clean.updated_at || '') >= String(existing.updated_at || '')) {
+ userData.tables[t][row.uuid] = clean
+ }
+ }
+ }
+ // 应用墓碑
+ const incomingTombs = body.tombstones || []
+ for (const tb of incomingTombs) {
+ if (!TABLES.includes(tb.table) || !tb.uuid) continue
+ userData.tombstones[tb.table] = userData.tombstones[tb.table] || {}
+ const prev = userData.tombstones[tb.table][tb.uuid]
+ if (!prev || tb.deleted_at > prev) userData.tombstones[tb.table][tb.uuid] = tb.deleted_at
+ }
+ // 墓碑生效：清除被删数据
+ for (const t of TABLES) {
+ const tombs = userData.tombstones[t] || {}
+ for (const [u, deletedAt] of Object.entries(tombs)) {
+ const row = userData.tables[t][u]
+ if (row && String(row.updated_at || '') <= String(deletedAt)) delete userData.tables[t][u]
+ }
+ }
+ saveUserData(auth.userId, userData)
+
+ // 返回权威全量
+ const outTables = {}
+ const outTombs = []
+ for (const t of TABLES) {
+ outTables[t] = Object.values(userData.tables[t] || {})
+ const tombs = userData.tombstones[t] || {}
+ for (const [u, deletedAt] of Object.entries(tombs)) outTombs.push({ table: t, uuid: u, deleted_at: deletedAt })
+ }
+ json(res, 200, { tables: outTables, tombstones: outTombs, serverTime: new Date().toISOString() })
+ return
+ }
+
+ json(res, 404, { error: 'not found' })
+}
+
+const server = http.createServer((req, res) => {
+ handle(req, res).catch(err => {
+ json(res, 500, { error: err.message || 'server error' })
+ })
+})
+
+server.listen(PORT, () => {
+ console.log('internlog sync server listening on ' + PORT)
+})
diff --git a/server/package.json b/server/package.json
new file mode 100644
index 0000000..ee46e70
--- /dev/null
+++ b/server/package.json
@@ -0,0 +1,9 @@
+{
+ "name": "internlog-sync-server",
+ "private": true,
+ "version": "1.0.0",
+ "type": "module",
+ "scripts": {
+ "start": "node index.js"
+ }
+}
diff --git a/实习工作日志系统-设计方案.md b/实习工作日志系统-设计方案.md
index ba86fa5..3ed4319 100644
--- a/实习工作日志系统-设计方案.md
+++ b/实习工作日志系统-设计方案.md
@@ -1,6 +1,6 @@
# 实习工作日志系统 设计方案
-- 版本：v1.11（记账系统）
+- 版本：v1.13（多端同步与安卓应用）
- 范围：个人版全量功能；团队版仅作扩展预留
## 1. 产品定位
@@ -163,6 +163,30 @@ AI 润色为可选进阶：将统计、成果、周记交给大模型按四段
| 汇总 | 按月展示收入、支出、结余、待报销四卡片；支出分类分布条形图 |
| 明细 | 月度流水表格，类型与报销状态筛选，支持弹窗编辑、删除确认、标记已报销 |
+### 3.13 多端同步与安卓应用
+
+**同步服务端**（server 目录，零依赖 Node，Docker 部署于自有服务器）：
+
+| 项 | 说明 |
+|---|---|
+| 存储 | JSON 文件按用户隔离（users/用户ID.json），注册表独立；整目录复制即备份 |
+| 认证 | 登录密码 PBKDF2 哈希；HMAC 签名 token（30 天有效期） |
+| 接口 | 注册 / 登录 / 全量同步 / 健康检查；CORS 开放以支持手机浏览器 |
+| 同步模型 | 客户端全量差异对比 + 记录级新者胜（updated_at）+ 软删除墓碑；本地 IndexedDB 始终为主存储，离线可用 |
+
+**客户端同步引擎**（src/sync/engine.ts）：
+
+- 一次性补齐每行 uuid 与 updated_at；镜像表（sync_mirror）做哈希差异检测
+- 删除通过墓碑表传播到服务端与其他端
+- 设置页配置同步地址与云端账号；登录后自动同步（5 分钟间隔，静默），支持立即手动同步
+- 密码库以密文同步，主密码永不出本机；本地临时设置（上次项目、分类等）不同步
+
+**安卓应用（Capacitor）**：
+
+- 复用全部前端代码；npx cap add android 生成工程，pnpm cap:sync 同步资源
+- 本机构建 APK 需 Android Studio（SDK + JDK 17）：进入 android 目录执行 gradlew assembleDebug，产物在 app/build/outputs/apk/debug/
+- 分发：apk 直接安装（允许未知来源），或上架应用市场
+
## 4. 数据模型（SQLite）
### 4.1 建表语句
@@ -506,3 +530,4 @@ src/
- v1.10：Electron 桌面应用——pnpm dist 一键产出 NSIS 安装包与免安装目录；主进程加载本地构建产物，数据存于系统用户目录；窗口禁用菜单栏、外部链接交由系统浏览器打开
- v1.11：新增记账系统——支出/收入录入（金额以分存储）、固定分类枚举、报销跟踪（待报销/已报销与待报销金额汇总）、月度汇总卡片与支出分类分布、月度流水筛选与弹窗编辑；备份格式升级至 v3 并向下兼容
- v1.12：「今日」视图升级为「详情」——支持前后翻页、日期选择器自由切换日期，对任意一天进行查看、打卡、记录与修改
+- v1.13：多端同步与安卓应用——自建零依赖同步服务端（Docker 部署、按用户 JSON 隔离、HMAC token）；客户端同步引擎（uuid 与 updated_at 补齐、镜像哈希差异、墓碑传播、记录级新者胜）；设置页同步配置与自动同步；Capacitor 安卓工程脚手架与移动端 UI 适配（安全区、输入字号）