docs: 整理仓库结构——新增根 README(当前架构)、客户端 README 与部署手册更新至服务器权威模型,文档归位 docs/,清理误提交的打包产物
This commit is contained in:
+26
-7
@@ -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(默认即是)。
|
||||
登录即自动绑定云端并全量拉取;本机仅存加密的自动登录凭据,退出登录后需重新输入密码。
|
||||
|
||||
Reference in New Issue
Block a user