صفحهٔ اصلی گشت‌و‌گذار راهنما
ثبت نام ورود
AI-Special-Project-Team
/
document-management
2
0
انشعاب 0
پرونده‌ها مشکلات 0 درخواست واکشی 0 ویکی
شاخه: master
شاخه‌ها تگ‌ها
document-manage...
/
build
/
README.txt

README.txt 3.4 KB
لینک دائمی تاريخچه خام

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980 
  1. ========================================
    2. 

  2.   DMS 文档管理系统 - 使用说明
    3. 

  3. ========================================
    4. 

  4. 

  5. 【系统要求】
    6. 

  6.   - Windows 10/11 (64 位)
    7. 

  7.   - MySQL 8.x（自备，需自行安装并初始化数据库）
    8. 

  8.   -（可选）LibreOffice：用于 Word 文档转 PDF 预览
    9. 

  9. 

  10. ------------------------------------------------------------------------
    11. 

  11. 【首次启动步骤】
    12. 

  12. ------------------------------------------------------------------------
    13. 

  13. 

  14. ■ 步骤 1：准备 MySQL 数据库
    15. 

  15.    1) 安装 MySQL 8（如已安装可跳过）
    16. 

  16.    2) 创建数据库（utf8mb4 字符集）：
    17. 

  17.         CREATE DATABASE dms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    18. 

  18.    3) 如果发行包内附带 database-init.sql，则导入它：
    19. 

  19.         mysql -u root -p dms < database-init.sql
    20. 

  20.       这会同时创建表结构并写入示例数据。
    21. 

  21.       若没有该文件，请向分发者索取（或自行从源码项目执行导出工具生成）。
    22. 

  22. 

  23. ■ 步骤 2：修改配置文件
    24. 

  24.    1) 用记事本（或 VSCode）打开本目录下的 .env 文件
    25. 

  25.       （首次启动会自动从 .env.example 生成）
    26. 

  26.    2) 修改以下关键项：
    27. 

  27.         DMS_DATABASE_URL=mysql+pymysql://用户名:密码@主机:3306/dms?charset=utf8mb4
    28. 

  28.         DMS_JWT_SECRET=请改成一串随机字符（建议 32 位以上）
    29. 

  29. 

  30. ■ 步骤 3：启动服务
    31. 

  31.    双击 dms-server.exe
    32. 

  32.    看到控制台输出 "Running on http://127.0.0.1:9345" 即启动成功
    33. 

  33. 

  34. ■ 步骤 4：访问系统
    35. 

  35.    在浏览器打开：http://localhost:9345
    36. 

  36. 

  37. ------------------------------------------------------------------------
    38. 

  38. 【默认登录账号】（仅当导入了示例数据时）
    39. 

  39. ------------------------------------------------------------------------
    40. 

  40.    管理员：admin / Admin@1234
    41. 

  41.    普通用户：user / User@1234
    42. 

  42.    （密码来源于示例数据，可在登录后修改）
    43. 

  43. 

  44. ------------------------------------------------------------------------
    45. 

  45. 【常见问题】
    46. 

  46. ------------------------------------------------------------------------
    47. 

  47. 

  48. Q: 启动后浏览器无法访问？
    49. 

  49. A: 1) 检查控制台是否有错误信息（特别是数据库连接错误）
    50. 

  50.    2) 确认 .env 中的 DMS_DATABASE_URL 配置正确
    51. 

  51.    3) 确认 MySQL 服务已启动
    52. 

  52.    4) 确认已执行步骤 1 的 SQL 导入
    53. 

  53. 

  54. Q: 端口冲突？
    55. 

  55. A: 编辑 .env，添加一行：
    56. 

  56.    DMS_PORT=9350（或其他端口），重启 exe
    57. 

  57. 

  58. Q: Word 文档预览失败？
    59. 

  59. A: 安装 LibreOffice，并确认 .env 中 DMS_LIBREOFFICE_EXECUTABLE
    60. 

  60.    路径正确（默认 C:\Program Files\LibreOffice\program\soffice.exe）
    61. 

  61.    或在 .env 中设置 DMS_OFFICE_PREVIEW_ENABLED=false 关闭该功能。
    62. 

  62. 

  63. Q: 上传的文件存储在哪？
    64. 

  64. A: 程序同级目录的 dms-storage/ 下，请勿删除。
    65. 

  65. 

  66. Q: 如何停止服务？
    67. 

  67. A: 在 dms-server.exe 的控制台窗口按 Ctrl+C，或直接关闭窗口。
    68. 

  68. 

  69. ------------------------------------------------------------------------
    70. 

  70. 【目录结构】
    71. 

  71. ------------------------------------------------------------------------
    72. 

  72.   dms-server.exe              主程序
    73. 

  73.   _internal/                  PyInstaller 运行时依赖（请勿删除）
    74. 

  74.   .env                        配置文件（首次启动生成）
    75. 

  75.   .env.example                配置模板
    76. 

  76.   database-init.sql           数据库初始化脚本（如已导出）
    77. 

  77.   dms-storage/                运行时文件存储目录
    78. 

  78.   README.txt                  本说明文件
    79. 

  79. 

  80. ========================================
    81.