# 金牛集团贷款档案管理系统 - 功能说明（当前版本）

## 系统概述

本系统面向贷款档案管理场景，提供目录管理、档案管理、文件管理、分期还款计划、结息与逾期管理、提醒中心、模板导入导出、用户与权限、双管理员删除审批等能力。

---

## 1. 用户与权限

### 1.1 登录

- 用户名 + 密码登录
- 默认管理员账号：`admin / jinniu123`

### 1.2 角色

- 管理员：可新建/编辑/导入/上传/提交删除申请/审核删除
- 普通用户：可查看、搜索、筛选、导出、下载文件

### 1.3 展示优化

- 顶部用户名脱敏显示（首字母+***+尾字母）
- 角色显示中文（管理员 / 普通用户）

---

## 2. 目录管理（三级）

- 仅支持三级目录
- 档案仅允许挂在三级目录
- 目录树支持折叠与路径高亮
- 管理员可在节点后执行：编辑 / 新增子目录（三级不显示）/ 删除（仅空目录）

---

## 3. 档案管理

### 3.1 基础字段

- 档案名称
- 所属目录（三级）
- 贷款机构、借款主体
- 授信额度、剩余额度（自动计算）
- 起止日、到期日
- 年利率、担保类型、担保人

### 3.2 页面结构

- 首页默认显示档案列表
- 新建档案使用独立页面
- 编辑档案使用独立页面
- 查看档案页面为只读

### 3.3 列表能力

- 搜索字段选择：全部 / 借款主体 / 担保人
- 状态筛选：履行中 / 逾期中 / 已完成 / 未设置
- 排序：按创建时间 / 到期日 / 贷款机构
- 分页：10 / 15 / 30 / 50

---

## 4. 文件管理

### 4.1 上传入口

- 新建档案页面支持直接选择文件，创建后自动关联上传
- 编辑档案页面下方“文件管理（编辑页）”支持上传并刷新列表

### 4.2 查看页面限制

- 查看页仅保留预览/下载，不提供上传/删除

### 4.3 编辑页文件操作

- 上传、预览、下载、删除
- 支持重命名文件：数据库与 `uploads` 真实文件名同步更新

### 4.4 存储规则

- 文件按目录层级自动分文件夹存储，不混放到根目录

---

## 5. 分期还款计划

- 编辑页可选“是否有分期还款计划”
- 选“是”后展开录入区（默认6期，可增删）
- 每期字段：还款日期、还款金额、状态（未还款/提前还款或按期还款/延期）
- 到期前后状态联动：
  - 到期前：可提前还款，不可延期
  - 到期后：可按期还款或延期
- 剩余额度由“授信额度 - 已还款计划总额”自动计算

---

## 6. 结息与逾期

### 6.1 结息方式

- 按月计息
- 按季计息
- 到期一次性付清

### 6.2 结息日

- 当结息方式为按月/按季时：输入1-28日
- 当结息方式为到期一次性付清时：结息日自动禁用并显示一次性付息语义

### 6.3 逾期判断

- 是否逾期默认“否”
- 若当前日期未超过到期日：不可手动选择逾期
- 若超过到期日：可手动选择是否逾期
- 支持逾期利率上浮（默认 50%）

### 6.4 状态与利息

- 状态：履行中 / 逾期中（红色）/ 已完成 / 未设置
- 详情页显示“当前应付利息”
- 利息计算支持分段本金（结合已还款计划）

---

## 7. 提醒中心

### 7.1 首页看板（仅数量）

- 当前结果总数
- 履行中
- 已完成
- 未设置
- 贷款到期
- 还款计划
- 贷款逾期

### 7.2 提醒详情页

- 独立页面展示具体提醒内容
- 可按类型筛选：贷款到期 / 还款计划 / 贷款逾期
- 支持导出当前筛选结果（xlsx/csv）

---

## 8. 导出

- 导出全部：可选 xlsx / csv
- 导出选中：可选 xlsx / csv
- 普通用户可导出

---

## 9. 模板导入

### 9.1 模板下载

- 支持下载 xlsx 模板
- 若存在 `data/import_template.xlsx`，优先下载该手工模板

### 9.2 导入能力

- 支持 csv/xlsx（xlsx 需安装 PhpSpreadsheet）
- 导入时可自动创建目录并批量创建档案
- 必填与选填规则以模板内说明为准

---

## 10. 双管理员删除流程

- 第一步：管理员A提交删除申请
- 第二步：管理员B在“删除审核”页面审批
- 限制：申请人不能审核自己的申请
- 审核通过后执行真实删除

---

## 11. 当前技术实现说明

- 主数据：SQLite
- 扩展业务配置：`data/*.json`（免迁移兼容方案）
- 前后端：PHP 单体应用

---

## 12. 注意事项

- 若启用 xlsx 导入/导出，建议安装 `PhpSpreadsheet`
- 上线后请立即修改默认管理员密码
- 建议定期备份 `data/` 与 `uploads/`