Files
jinniu-daikuan/部署说明.md
T
梁铭洋 97fea48393 Initial commit: 金牛集团贷款档案管理系统
导入现有代码与文档,排除 data/uploads 运行时数据。
2026-08-29 11:52:22 +08:00

2.7 KiB
Executable File
Raw Blame History

金牛集团贷款档案管理系统 - 部署说明

1. 环境要求

  • 宝塔面板(Linux
  • Nginx 或 Apache
  • PHP 8.0+(建议 8.2
  • 必需扩展:pdo_sqlitesqlite3mbstringfileinfo
  • 推荐扩展:zipxml(用于 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
  • 页面可自由选择格式
  • 若服务器安装了 PhpSpreadsheetxlsx 可直接使用:
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. 双管理员删除闭环流程