从零搭建轻量化可落地卫生许可证数字档案馆系统实操

准备阶段：3分钟完成基础环境配置

我们选免费开源的组合方案：Windows Server 2019/Windows 10 专业版及以上系统（社区/机构常用办公环境无需换服务器）、PHPStudy小皮面板（Windows版）（一键部署Web+数据库）、Mayan EDMS社区版（专门做轻量级文档管理的开源系统，自带归档、OCR、权限功能）。

1.1 安装PHPStudy小皮面板

• 下载地址：https://www.xp.cn/download.html，选择“Windows客户端版”，下载.exe安装包
• 双击安装包，一路点击“下一步”，默认安装路径（D:\phpstudy_pro）不要改，避免后续配置路径出错
• 安装完成后启动，点击左侧“网站”→“创建网站”，弹出窗口按以下填写：
  • 域名：随便填个本地测试用的，比如wsxk-dag.com
  • 根目录：自动生成即可
  • FTP：不创建
  • 数据库：选择MySQL，版本选8.0.30（Mayan EDMS 4.7.x适配最好），用户名填wsxk_admin，密码填Wsxk123456!（含大小写、数字、符号符合安全要求），数据库名填wsxk_dag
  • PHP版本：选8.1.27
• 点击“创建”，等待10秒左右提示创建成功

1.2 安装Mayan EDMS的前置依赖

• 点击PHPStudy左侧“软件商店”，搜索并安装Redis 7.0.11（用于缓存队列）、Imagick PHP扩展（PHP8.1版本）（用于文档预览）、Tesseract OCR（中文简体版）（用于识别许可证上的文字）
• 配置Tesseract：打开D:\phpstudy_pro\Extensions\tesseract\tessdata目录，确保有chi_sim.traineddata（没有的话去https://github.com/tesseract-ocr/tessdata_fast/raw/main/chi_sim.traineddata下载放进去）

部署阶段：5分钟完成Mayan EDMS社区版安装

2.1 下载并解压Mayan EDMS

• 下载地址：https://gitlab.com/mayan-edms/mayan-edms/-/releases/4.7.11，找到Source code (zip)点击下载
• 解压压缩包，将解压后的mayan-edms-4.7.11文件夹里的所有内容复制到刚才创建的网站根目录：D:\phpstudy_pro\WWW\wsxk-dag.com

2.2 配置Mayan EDMS

• 打开网站根目录下的.env.example文件，重命名为.env
• 用记事本或VS Code打开.env文件，修改以下内容（其他保持默认）：
  • MAYAN_DATABASES_DEFAULT_ENGINE=django.db.backends.mysql
  • MAYAN_DATABASES_DEFAULT_NAME=wsxk_dag
  • MAYAN_DATABASES_DEFAULT_USER=wsxk_admin
  • MAYAN_DATABASES_DEFAULT_PASSWORD=Wsxk123456!
  • MAYAN_DATABASES_DEFAULT_HOST=127.0.0.1
  • MAYAN_DATABASES_DEFAULT_PORT=3306
  • MAYAN_CACHES_DEFAULT_BACKEND=django_redis.cache.RedisCache
  • MAYAN_CACHES_DEFAULT_LOCATION=redis://127.0.0.1:6379/1
  • MAYAN_OCR_BACKEND=mayan.apps.ocr.backends.tesseract.Tesseract
  • MAYAN_OCR_BACKEND_ARGUMENTS={"language": "chi_sim+eng", "path": "D:\\phpstudy_pro\\Extensions\\tesseract\\tesseract.exe"}
  • MAYAN_SECRET_KEY=随便改一串32位以上的字母数字符号，比如WsxkDag202X1020!SecretKeyForCommunity

2.3 执行安装脚本

• 点击PHPStudy左侧“网站”，找到刚才的wsxk-dag.com，点击右侧“管理”→“打开命令行”
• 在弹出的命令行窗口依次执行以下命令（每执行完一行等提示完成再下一行）：
  • ``` composer install --no-dev --optimize-autoloader ```
  • ``` php artisan mayan:initialsetup ```
  • 提示创建管理员用户时，按要求输入：用户名admin，邮箱随便填（比如admin@wsxk-dag.com），密码WsxkAdmin123!
  • ``` php artisan mayan:platform:create_default_groups ```
  • ``` php artisan mayan:document_indexes:create_default_templates ```
• 点击PHPStudy左侧“软件商店”，找到Redis 7.0.11，点击“设置”→“服务”→“启动”（确保服务状态是运行中）
• 点击PHPStudy左侧“网站”，找到wsxk-dag.com，点击右侧“启动”（确保Apache/Nginx、MySQL都是运行中）

使用阶段：0门槛完成卫生许可证归档与查询

3.1 本地访问系统

打开浏览器，输入刚才设置的本地域名：wsxk-dag.com，如果跳转到登录页面说明部署成功，用刚才创建的admin用户登录。

3.2 创建卫生许可证专属归档模板

• 点击左侧导航栏“文档类型”→“创建”，弹出窗口填写：
  • 标签：卫生许可证
  • 缩略语：WSXKZ
  • 其他保持默认，点击“保存”
• 点击刚创建的“卫生许可证”文档类型右侧的“元数据”→“添加元数据类型”，依次添加以下必填元数据（后续上传许可证时必须填写）：
  • 标签：许可证编号，类型：文本，勾选“必填”、“可搜索”
  • 标签：经营单位名称，类型：文本，勾选“必填”、“可搜索”
  • 标签：法定代表人，类型：文本，勾选“可搜索”
  • 标签：经营地址，类型：文本，勾选“可搜索”
  • 标签：有效期至，类型：日期，勾选“必填”、“可搜索”
  • 标签：许可项目，类型：多行文本，勾选“可搜索”

3.3 上传并归档卫生许可证

• 点击左侧导航栏“文档”→“上传”
• 选择“卫生许可证”文档类型，点击“选择文件”上传许可证的PDF/图片文件（支持批量上传）
• 填写刚才创建的必填元数据，点击“保存并继续”或“保存并上传更多”
• 上传后系统会自动生成预览、自动OCR识别文字、自动按照元数据分类归档

3.4 快速查询与导出卫生许可证

• 快速查询：点击左侧导航栏“搜索”，在搜索框输入许可证编号、经营单位名称等任意可搜索元数据，系统1秒内返回结果
• 高级查询：点击“高级搜索”，可以组合多个元数据条件（比如“有效期至2025-12-31且经营地址在XX街道”）
• 导出：勾选需要导出的许可证，点击顶部“批量操作”→“导出文档”或“导出元数据为CSV”

收尾阶段：1分钟开启内网访问

如果需要让其他同事访问，只需要做1步：

• 打开Windows防火墙，点击左侧“高级设置”→“入站规则”→“新建规则”
• 选择“端口”→“TCP”→特定本地端口填80,443→一路点击“下一步”→名称填“卫生许可证数字档案馆”→点击“完成”
• 其他同事浏览器输入部署电脑的内网IP地址（比如192.168.1.100）即可访问