docs: 整理仓库结构——新增根 README(当前架构)、客户端 README 与部署手册更新至服务器权威模型,文档归位 docs/,清理误提交的打包产物

This commit is contained in:
root
2026-10-16 22:35:55 +08:00
parent aa773062fe
commit 344e70bf50
10 changed files with 151 additions and 78471 deletions
+26 -7
View File
@@ -1,5 +1,8 @@
# 同步服务端部署(daywk.linyux.cn 子域名方案)
服务端是整个系统的**唯一数据权威**:认证、九张业务表、用户管理、每日自动备份都在这里。
客户端(桌面 / 网页 / 安卓)只是实时缓存,详见仓库根 README。
## 一、DNS 解析(先做)
在域名服务商处添加 A 记录:
@@ -40,16 +43,32 @@ Caddy 会自动为 daywk.linyux.cn 申请并续期 HTTPS 证书(需 DNS 已生
## 重要:该域名同时是应用入口
同步服务容器同时托管了网页应用本体(daywork 仓库中的构建产物)。手机与电脑浏览器直接打开
https://daywk.linyux.cn 就是应用(可添加到主屏幕作为 PWA),无需另外部署前端;/api 路径为数据接口。
同步服务容器同时托管了网页应用本体(daywork 仓库 intern-log/dist 的构建产物,随仓库提交以便容器直接 COPY)。
手机与电脑浏览器直接打开 https://daywk.linyux.cn 就是应用(可添加到主屏幕作为 PWA);/api 路径为数据接口。
## 五、客户端
## 五、账号体系
应用 → 设置 → 多端数据同步:地址填 https://daywk.linyux.cn,注册云端账号后同步。
手机浏览器打开同一地址登录,添加到主屏幕后即为手机端应用。
- 注册 / 登录全部经由服务端(POST /api/auth/register、/api/auth/login),密码仅存 PBKDF2 哈希
- **管理员:用户名 xionglin**(服务启动时自动赋予 role=admin,存量注册表也会自动迁移)
- 管理员专用接口(客户端「用户管理」页使用,非管理员一律 403):
- GET /api/admin/users 用户列表(含数据量)
- POST /api/admin/users/create 新建账号
- POST /api/admin/users/password 重置任意用户密码
- POST /api/admin/users/delete 删除账号及其全部数据(不能删自己)
- 客户端"登录密码修改"对应 POST /api/auth/password;"删除此用户"对应 POST /api/auth/delete
## 六、数据与运维
- 数据目录:/opt/daywork/server/data(用户注册表 + 每用户数据),打包即备份
- 数据目录:/opt/daywork/server/data
- registry.json 用户注册表(用户名 / 角色 / PBKDF2 哈希)
- users/<id>.json 每用户九张表数据 + 墓碑
- backups/<日期>/ **每日自动备份**(启动与每次注册表变更也会触发,保留最近 14 天)
- 更新版本:cd /opt/daywork && git pull && cd server && docker compose up -d --build
- 接口:POST /api/auth/register、POST /api/auth/login、POST /api/sync、GET /api/health
- 同步协议:POST /api/sync(Bearer token;推送差异并返回权威全量快照)
- 实时通知:GET /api/events?token=...(SSE,同账号任意端有变更即广播 change)
- 手工备份:直接打包 server/data 目录即可(纯 JSON 文件)
## 七、客户端
应用 → 设置 → 多端数据同步:地址填 https://daywk.linyux.cn(默认即是)。
登录即自动绑定云端并全量拉取;本机仅存加密的自动登录凭据,退出登录后需重新输入密码。