微信小程序端部署企业级文书档案系统全流程实操指南

一、前置环境准备

1.1 必备工具与材料

提前准备以下工具和材料，避免后续操作卡壳：

• 微信开发者工具：官方下载地址 https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html，选择稳定版安装即可
• 微信小程序账号：需完成企业认证，个人账号无法开通完整的云开发权限
• 文书档案小程序源码：中小团队可直接使用开源轻量版，拉取命令 git clone https://gitee.com/opensrc/mini-document-archive.git，自研项目可直接跳过拉取步骤
• 已开通的微信云开发环境：基础版免费额度足够100人以下团队使用

1.2 账号权限开通

1. 登录微信公众平台 https://mp.weixin.qq.com/，进入「开发-开发管理-开发设置」，记录小程序AppID

2. 左侧菜单栏找到「云开发」入口，点击开通，选择按量付费模式（基础额度免费，无超额使用不会产生费用），创建云环境后记录环境ID

3. 进入「设置-服务类目」，添加「工具-文档管理」类目，提交企业资质等待审核通过

二、源码配置与本地调试

2.1 项目导入

打开微信开发者工具，选择「导入项目」，选择源码本地目录，输入之前记录的小程序AppID，项目名称自定义，点击确认进入开发界面

2.2 核心配置修改

1. 找到根目录下的app.js文件，替换云环境ID为你自己的环境ID，完整配置如下：

```js App({ onLaunch: function () { if (!wx.cloud) { console.error('请使用 2.2.3 或以上的基础库以使用云能力') } else { wx.cloud.init({ env: '替换为你的云环境ID', traceUser: true, }) } this.globalData = { version: '1.0.0' } } }) ```

2. 打开project.config.json文件，确认appid字段为你自己的小程序AppID，不要使用测试号

3. 若你的档案系统对接了外部后台接口，需到微信公众平台「开发-开发管理-开发设置-服务器域名」中，将后台接口地址添加到request合法域名列表

2.3 本地功能验证

点击开发者工具顶部的「编译」按钮，等待项目启动后依次测试以下功能：

• 用户微信授权登录，正常获取openid
• 档案分类查询、预览下载
• 管理员权限下的档案上传、删除、分类编辑
• 超过10MB的大文件上传、断点续传

所有功能测试通过后再进行后续部署操作，常见错误为云环境ID填写错误、云服务权限未开通，可根据控制台报错信息直接修正

三、云服务端部署配置

3.1 云数据库配置

进入开发者工具的「云开发控制台-数据库」，创建以下3个集合：

• document：存储档案元数据，包括名称、分类、上传时间、存储地址、上传人信息
• category：存储档案分类树结构
• user_role：存储用户权限标识，区分普通用户、管理员

依次设置集合权限：document设置为「仅创建者可读写、管理员可读写」，category设置为「所有用户可读、管理员可写」，user_role设置为「仅管理员可读写」。最后在user_role集合中新增一条管理员权限数据，替换为你自己的openid：

```json { "user_openid": "替换为管理员的微信openid", "role": "admin", "create_time": "2024-01-01 00:00:00", "status": 1 } ```

3.2 云函数部署

找到项目根目录下的cloudfunctions文件夹，右键每个云函数，选择「上传并部署：云端安装依赖」，必须部署的云函数包括：checkRole（权限校验）、uploadDoc（档案上传处理）、getDocList（档案列表查询）、deleteDoc（档案删除）。部署完成后到云开发控制台「云函数」板块确认所有云函数状态为正常

3.3 云存储配置

进入云开发控制台「存储」板块，创建document_files文件夹，设置文件夹权限为「仅认证用户可读写」，禁止匿名用户访问档案文件，保障数据安全

四、小程序上线发布

4.1 提交审核

在开发者工具顶部点击「上传」按钮，填写版本号和更新说明，上传完成后登录微信公众平台，进入「版本管理」，找到刚才上传的开发版本，点击「提交审核」。审核说明填写「本小程序为企业内部文书档案管理工具，仅对企业内部员工开放使用，不对外提供服务」，可大幅提升审核通过率

4.2 上线验证

审核通过后点击「发布」，正式上线后用手机微信搜索小程序名称，登录后测试所有核心功能，重点验证不同权限用户的访问范围是否符合预期、大文件上传下载是否正常。如有错误可通过云开发控制台的「运维-日志查询」排查具体问题

五、常见问题排查

• 档案上传失败：优先检查云存储容量是否超出免费额度，其次确认uploadDoc云函数是否部署成功，最后检查网络是否限制大文件传输
• 普通用户看不到档案：检查document集合的权限设置是否正确，确认对应用户的权限信息已经录入user_role集合
• 审核被驳回：确认服务类目已添加「工具-文档管理」，若提示涉及公共信息服务，可提交企业内部使用的证明材料申诉
• 云函数调用报错：检查云函数的运行环境是否为Node.js 16及以上版本，确认云环境ID配置正确