## 背景与确认

* 备注为“用户维度”，按指示在 `app_user` 增加备注字段并贯通列表与配额调整流程。

* 操作记录需补充时间字段以便前端展示。

* 交易管理列表需支持“提交时间区间、状态、手机号、公司名称、公司税号”搜索。

* 上传接口从两个合并为一个，统一入参与返回结构。

## 改动总览

* 模型：为 `AppUser` 增加 `notes: CharField(256, null=True)`。

* 接口：

  * `admin-App用户管理`：列表返回 `notes`；配额调整将 `remark` 同步写入 `AppUser.notes`；配额日志返回 `created_at`。

  * `交易管理`：对公转账列表增加“提交时间区间”筛选。

  * `上传`：新增统一上传接口 `/api/v1/upload/upload`（或 `/api/v1/upload`），老接口内部复用统一实现保留兼容。

* 迁移：使用现有 Aerich 流程生成并升级迁移。

## 详细实施

### 1. App 用户备注（用户维度）

* 文件：`app/models/user.py`

  * 在 `AppUser` 增加字段 `notes = fields.CharField(max_length=256, null=True, description="备注")`。

* 文件：`app/api/v1/app_users/admin_manage.py`

  * `/list`：返回 `notes = u.notes or ""`。

  * `/quota`：接收 `remark` 后，除写入 `AppUserQuotaLog`

### 2. 操作记录时间字段

* 文件：`app/schemas/app_user.py`

  * `AppUserQuotaLogOut` 增加 `created_at: str`。

* 文件：`app/api/v1/app_users/admin_manage.py`

  * `/ {user_id}/quota-logs`：为每条日志填充 `created_at = r.created_at.isoformat()` 返回。

### 3. 交易管理列表搜索增强

* 文件：`app/controllers/invoice.py`

  * `list_receipts(...)`：增加对 `PaymentReceipt.created_at` 的区间筛选：

    * 支持 `created_at`（数组，毫秒时间戳）或 `submitted_start/submitted_end`（ISO 或毫秒）。

* 文件：`app/api/v1/transactions/transactions.py`

  * `list_receipts`：路由签名增加上述可选查询参数并传入控制器。

### 4. 上传接口统一

* 文件：`app/controllers/upload.py`

  * 新增 `upload_any(file: UploadFile)`：

    * `image/*` 保存到 `static/images`；其他受支持类型保存到 `static/files`。

    * 返回 `{ url, filename, content_type }`。

* 文件：`app/api/v1/upload/upload.py`

  * 新增 `/upload`（或 `/upload/upload` 按路由前缀安排）：统一入口；

  * 旧 `/image`、`/file` 内部调用 `upload_any` 保持兼容。

* 文件：`app/schemas/upload.py`

  * 若需要，补充统一响应模型，或复用 `FileUploadResponse`（包含 `content_type`）。

## 迁移与兼容

* Aerich：`init_db` 已集成迁移流程，生成迁移后执行 `upgrade`，自动创建 `app_user.notes` 列。

* 旧接口兼容：上传旧路径保留；交易列表与日志返回仅新增字段，不影响既有消费逻辑。

## 验证与测试

* 备注更新：调用 `/app-user-admin/quota` 传 `remark`，再查 `/app-user-admin/list` 验证 `notes`；查 `/app-user-admin/{id}/quota-logs` 验证 `created_at` 存在。

* 交易筛选：造两条不同日期的凭证，分别用时间区间查询命中与不命中。

* 上传统一：上传 PNG 与 PDF 验证保存路径与返回结构；旧接口路由到统一实现成功。

## 交付

* 提交代码与迁移；更新接口文档的路由说明与字段变化；前端无需大改即可使用新返回的 `notes` 与日志 `created_at`，交易列表按“凭证时间”筛选可用。