疾控中心档案管理系统本地从零搭建落地实操全指南
前置准备
本指南基于预设开源轻量方案搭建，无需专业后端开发经验，所有步骤可复制操作，零门槛完成落地，所有数据存储在本地，符合疾控数据安全管理要求。
环境依赖安装
- 安装Python 3.9，直接下载安装包：https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe，安装时必须勾选「Add Python 3.9 to PATH」选项，再点击下一步完成安装。
- 安装项目依赖，按Win+R输入cmd回车打开命令提示符，复制执行以下命令： ``` pip install django==4.2 django-filter django-crispy-bootstrap5 pillow ``` 如果安装超时，替换为国内镜像命令： ``` pip install -i https://pypi.tuna.tsinghua.edu.cn/simple django==4.2 django-filter django-crispy-bootstrap5 pillow ```
项目代码获取与初始化
- 获取项目代码，可直接下载压缩包：https://github.com/CSC-Dev/cdc-archive-management/archive/refs/heads/main.zip，下载后解压到纯英文路径，比如D盘根目录的cdc-system，路径禁止包含中文，否则会出现乱码或启动错误。
- 在命令提示符中进入项目根目录，比如项目解压在D:\cdc-system，执行命令：
cd D:\cdc-system - 初始化数据库，依次执行以下两条命令： ``` python manage.py makemigrations python manage.py migrate ```
- 创建超级管理员账号，执行命令后按提示输入信息： ``` python manage.py createsuperuser ``` 输入用户名后回车，邮箱可以直接回车跳过，输入密码（输入时不会显示字符，输入完成回车即可），密码要求至少8位，确认密码后完成创建。
核心配置修改
系统基础信息配置
用记事本打开项目根目录下的cdc_config.py文件，直接替换为以下内容，修改对应参数即可：
```
系统名称，修改为你单位的名称
SYSTEM_TITLE = "XX区疾控中心档案管理系统"
允许访问的IP，本地搭建填127.0.0.1，服务器部署填对应IP
ALLOW_ACCESS_IPS = ["127.0.0.1"]
档案本地存储路径，无需修改，保持默认即可
STORAGE_PATH = "./archive_storage/"
预设角色，无需修改
ROLE_CONFIG = [
("admin", "系统管理员"),
("archivist", "档案管理员"),
("viewer", "档案查询人员")
]
```
修改完成后保存文件即可，权限已经预设完成，无需额外修改：系统管理员拥有全权限，档案管理员可上传修改档案，查询人员仅可查阅公开档案。
启动系统与功能配置实操
在命令提示符中执行启动命令： ``` python manage.py runserver 127.0.0.1:8000 ```
启动完成后，打开浏览器输入地址http://127.0.0.1:8000/admin，用刚才创建的超级管理员账号登录，按照以下步骤完成业务配置：
添加档案分类
- 登录后台后，找到档案管理模块下的「档案分类」，点击右上角「增加」按钮
- 填写分类名称（如：疫情调档、疫苗冷链档案、从业人员健康档案、公共卫生监测档案），填写排序数字，点击「保存」
- 重复操作完成所有需要的分类添加即可
配置用户权限
- 找到「用户」模块，点击「增加」创建新用户
- 填写用户名密码，在「角色分组」栏勾选对应角色，比如给档案管理员勾选「档案管理员」分组
- 点击保存完成用户创建，权限自动生效
档案归档实操
- 打开浏览器访问前台地址
http://127.0.0.1:8000，用档案管理员账号登录 - 点击页面顶部「上传档案」按钮，选择对应档案分类，填写档案编号、档案名称、生成日期、涉密等级
- 点击「选择文件」上传档案原文，支持PDF、Word、Excel、JPG等所有常见格式，点击「保存」即完成归档
- 需要查询档案时，可通过分类筛选、关键词搜索定位档案，支持直接在线预览或下载原文
常见问题排查
- 提示「python不是内部或外部命令」：安装Python时未勾选添加环境变量，卸载后重新安装，必须勾选「Add Python to PATH」即可解决。
- 启动提示端口被占用：修改启动命令的端口，改为8001即可，命令为：
python manage.py runserver 127.0.0.1:8001 - 中文文件名乱码：项目路径包含中文，将项目整个移动到纯英文路径后重新启动即可。
- 数据库初始化报错：检查Python版本，本指南适配Python 3.8-3.10，过高或过低版本都会报错，更换为3.9即可解决。
完成以上所有操作后，系统即可正常投入使用，如需部署到单位内网供多人访问，只需将项目部署到单位内部服务器，修改配置文件中的ALLOW_ACCESS_IPS为服务器内网IP，即可让所有内网成员访问，所有档案数据都存储在单位本地，符合疾控数据安全保密要求。
相关文章
