chore: 初始化文档站仓库

2026-09-21 13:38:20 +08:00
commit a4ae7ac979
58 changed files with 4622 additions and 0 deletions
@@ -0,0 +1,40 @@
+# 系统日志
+
+系统日志通过右上角用户菜单 →「系统日志」进入，包含三个标签页：**访问日志**、**登录日志**、**运行日志**。页头右上角可选择日志保留时长（30 天 / 90 天 / 180 天 / 永久保留）。
+
+## 访问日志
+
+![访问日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-http.png)
+
+记录每一次接口访问：
+
+- 筛选：关键字（路径/参数/IP）、请求方法、状态码。
+- 表格列：时间、方法、路径、参数、状态码、耗时、用户、IP。
+- 支持分页与刷新。
+
+## 登录日志
+
+![登录日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-login.png)
+
+记录每次登录尝试（成功与失败）：
+
+- 筛选：关键字（用户名等）、结果（成功/失败）。
+- 表格列：时间、用户名、结果、说明、IP、User-Agent。
+
+## 运行日志
+
+![运行日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-app.png)
+
+在线查看后端运行日志：
+
+- 筛选：日期、时间范围（最近 1/6/24 小时或全部）、级别（ERROR/WARN/INFO/DEBUG）、关键字、行数。
+- 开启「实时」后通过 SSE 订阅新增日志，先回放最近内容再增量推送。
+- 页面显示当前日志文件名与命中行数。
+
+## 日志清理
+
+访问日志与登录日志会按配置的保留天数自动清理（默认 30 天，设为永久保留则不清理），无需手动维护。
+
+::: tip 排查问题
+接口报错时，可先在「访问日志」定位失败请求（状态码 4xx/5xx），再到「运行日志」按时间与关键字查看异常堆栈。
+:::