Initial commit: 金牛集团贷款档案管理系统

导入现有代码与文档，排除 data/uploads 运行时数据。

部署说明.md

@@ -0,0 +1,104 @@
+# 金牛集团贷款档案管理系统 - 部署说明
+
+## 1. 环境要求
+
+- 宝塔面板（Linux）
+- Nginx 或 Apache
+- PHP 8.0+（建议 8.2）
+- 必需扩展：`pdo_sqlite`、`sqlite3`、`mbstring`、`fileinfo`
+- 推荐扩展：`zip`、`xml`（用于 xlsx 导出/导入）
+
+## 2. 目录结构
+
+- `public/`：网站入口目录（宝塔运行目录设置到这里）
+- `app/`：配置与基础逻辑
+- `data/`：业务数据（SQLite + JSON配置）
+- `uploads/`：上传文件目录（按目录层级自动分文件夹）
+
+### `data/` 下的关键文件
+
+- `archive.sqlite`：主业务数据库
+- `repayment_plans.json`：分期还款计划（免迁移方案）
+- `archive_finance.json`：结息/逾期配置（免迁移方案）
+- `delete_approvals.json`：双管理员删除审批记录
+- `import_template.xlsx`：可选，自定义导入模板（手工放置）
+
+## 3. 宝塔部署步骤
+
+1. 新建 PHP 站点
+2. 上传项目到站点目录
+3. 网站运行目录设置为：`/public`
+4. 在 PHP 扩展中启用上面的必需扩展
+5. 给 `data/` 与 `uploads/` 赋予可写权限
+6. 访问域名初始化系统
+
+## 4. 默认账号
+
+- 用户名：`admin`
+- 密码：`jinniu123`
+
+> 登录后建议立即修改默认密码。
+
+## 5. 导出说明
+
+- 导出支持：`xlsx` / `csv`
+- 页面可自由选择格式
+- 若服务器安装了 `PhpSpreadsheet`，`xlsx` 可直接使用：
+
+```bash
+composer require phpoffice/phpspreadsheet
+```
+
+## 6. 导入说明
+
+### 6.1 下载模板
+
+- 点击页面“模板下载”
+- 系统优先下载：`data/import_template.xlsx`（如果你手工放了该文件）
+- 若该文件不存在，系统会动态生成模板（需要 `PhpSpreadsheet`）
+
+### 6.2 模板字段规则
+
+#### 必填字段
+
+- 一级目录
+- 二级目录
+- 三级目录
+- 档案名称
+- 贷款机构
+- 借款主体
+- 授信额度
+- 起止日
+- 到期日
+- 年利率
+- 担保类型
+- 担保人
+
+#### 选填字段
+
+- 计息方式（按月计息 / 按季付息 / 到期一次性付清）
+- 结息日（1-28）
+- 是否有分期还款计划（是/否）
+
+## 7. 文件上传与存储
+
+文件上传后按“目录层级 + 档案”自动存储，例如：
+
+`uploads/一级目录/二级目录/三级目录/archive_档案ID_档案名/文件`
+
+## 8. 删除审批（双管理员）
+
+- 管理员A点击删除 -> 仅提交申请
+- 管理员B在“删除审核”页面审批通过后才执行真实删除
+- 申请人本人不能审批自己的删除申请
+
+## 9. 试运行建议
+
+上线前建议至少验证：
+
+1. 新建/编辑/查看档案
+2. 新建页上传文件、编辑页文件管理（上传/重命名/删除）
+3. 分期计划与剩余额度联动
+4. 到期提醒详情页筛选与导出
+5. 模板导入（先用 2-3 条测试数据）
+6. 双管理员删除闭环流程