# 12 日志、审计与安全

## 日志和审计

必须考虑：

- 登录日志
- 操作日志
- API 日志
- 库存变更日志
- 订单状态变更日志
- 入库状态变更
- 出库状态变更
- 用户权限变更

库存、订单等重要数据的关键变更必须能够追踪：

| 字段 | 含义 |
| --- | --- |
| 谁 | 操作用户 / 系统任务 |
| 什么时候 | 操作时间 |
| 做了什么 | 操作类型 |
| 修改前 | 变更前数据 |
| 修改后 | 变更后数据 |
| 来源 IP | 请求 IP |
| 请求 ID | 全链路请求标识 |

## 安全要求

必须考虑：

- SQL Injection
- XSS
- CSRF
- API Authentication
- API Authorization
- Rate Limit
- Tenant Isolation
- 文件上传安全
- Webhook 签名
- 密钥加密
- 敏感信息保护
- 日志脱敏

## 密钥管理

任何第三方 API Token、Secret：**禁止直接写入 Git。**

- 使用 `.env`（不提交）与 `.env.example`（仅占位）。
- 租户级第三方凭证在数据库中加密存储。
- 日志中不得输出 Token、密码、完整地址电话等敏感信息。