档案软件双软认证代码与文档实操指南

一、源代码提取与格式整理实操

双软认证中的软件著作权认定（软著）是基础，核心难点在于源代码的提取与格式化。对于档案软件而言，代码量大且模块多，必须按照官方要求的前30页+后30页规则进行精准提取。

1. 代码提取范围选择

不要直接打包整个项目。档案软件的核心在于文件流转、权限控制和存储引擎。请优先提取以下核心模块的代码：

• 核心业务层：档案归档、借阅审批、鉴证流程的Service层代码。
• 数据访问层：涉及元数据管理、全文检索的DAO或Repository层代码。
• 工具类：文件格式转换（如OFD转PDF）、电子签章的工具类。

2. 自动化提取脚本（Python）

手动复制粘贴容易错乱，推荐使用以下Python脚本自动提取并合并代码文件。该脚本会自动去除空行，确保代码紧凑且符合页数要求。

```python import os def combine_code_files(source_dir, output_file, max_lines=1500): """ 将指定目录下的代码文件合并为一个文件 """ allowed_ext = ['.java', '.js', '.py', '.go', '.cs'] with open(output_file, 'w', encoding='utf-8') as outfile: line_count = 0 for root, dirs, files in os.walk(source_dir): for file in files: if any(file.endswith(ext) for ext in allowed_ext): file_path = os.path.join(root, file) try: with open(file_path, 'r', encoding='utf-8') as infile: for line in infile: stripped_line = line.strip() 跳过空行和纯注释行（可根据需要调整） if stripped_line and not stripped_line.startswith("//") and not stripped_line.startswith(""): outfile.write(line + "\n") line_count += 1 if line_count >= max_lines: print(f"已达到最大行数 {max_lines}，停止提取。") return except Exception as e: print(f"无法读取文件 {file_path}: {e}") print(f"代码提取完成，共 {line_count} 行，已保存至 {output_file}") 使用示例：将当前目录下的代码提取到 output.txt combine_code_files('./src', 'source_code.txt') ```

操作步骤：

1. 将上述脚本保存为 extract_code.py。
2. 放在你的档案项目根目录下。
3. 运行命令 python extract_code.py。
4. 打开生成的 source_code.txt，检查头部和尾部是否逻辑完整。

3. 排版格式要求

将提取的文本复制到Word或WPS中，必须严格遵守以下格式，否则会被补正：

• 字体：必须使用宋体，字号小四号。
• 行距：固定值 18磅（或者1.5倍行距，视具体代理要求，通常18磅最稳妥）。
• 页边距：上下左右均为 2.54厘米。
• 页码：必须设置页码，通常在页脚居中。

二、用户操作手册撰写技术细节

用户手册（说明书）是审查人员判断软件功能的直接依据。对于档案软件，手册必须图文并茂，且功能点要与代码逻辑对应。

1. 手册目录结构规范

不要随意编写目录，必须包含以下标准章节，确保覆盖档案业务全流程：

• 第1章 引言：软件编写目的、背景、定义（如：电子档案、元数据）。
• 第2章 软件概述：软件功能列表（必须列出：采集、管理、存储、利用、鉴定、统计）。
• 第3章 运行环境：硬件配置（服务器CPU、内存）、操作系统（CentOS 7.9/Windows Server）、数据库（MySQL 8.0/Oracle）。
• 第4章 安装与初始化：部署截图、数据库初始化脚本执行截图。
• 第5章 功能操作说明：这是核心，需要分模块详细截图。
• 第6章 常见问题处理：如上传失败、索引未建立的解决方案。

2. 核心功能截图要求

在“第5章”中，必须针对档案软件的特有功能进行实操截图。每张截图必须包含软件名称、版本号、操作界面。

• 档案采集界面：截图需展示“上传”按钮、文件格式选择（支持OFD/PDF）、元数据录入框。
• 分类管理界面：截图需展示文书档案的全宗号、年度、保管期限树状结构。
• 全文检索界面：截图需展示检索框输入“合同”后，检索结果的高亮显示。
• 电子签章界面：如果有，必须展示盖章后的锁定状态和验证信息。

注意：截图中的软件名称必须与申请表中填写的全称完全一致，版本号格式统一为 V1.0 或 V2.0。

三、软件产品测试报告准备

“双软”认证的第二步是软件产品测试。这需要由具有CNAS/CMA资质的第三方检测机构（如中国软件评测中心）出具。你需要准备好测试环境。

1. 测试环境搭建标准

在提交测试申请前，请确保你的测试环境符合以下标准，并准备好远程连接方式：

• 服务器环境：建议使用干净的 CentOS 7.6 或 Windows Server 2016，不要安装与软件无关的其他服务。
• 数据库环境：推荐使用 MySQL 5.7 或 PostgreSQL 12，确保字符集为 utf8mb4，防止档案生僻字乱码。
• 中间件：Tomcat 9.0 或 Nginx 1.18，确保日志路径清晰可查。

2. 功能测试用例准备

虽然测试机构有自己的用例，但你提供的演示账号必须能跑通以下核心流程：

• 用户权限测试：准备管理员、普通用户、审计员三个账号，分别登录，验证权限隔离。
• 档案生命周期测试：
  1. 登录 -> 录入档案（上传文件） -> 提交归档。
  2. 管理员审核 -> 通过归档 -> 生成档号。
  3. 普通用户申请借阅 -> 管理员审批 -> 下载/浏览。
  4. 管理员进行鉴定（划控/销毁）。

四、在线申报系统实操

完成代码和文档准备后，最后一步是在官方平台进行申报。目前主要访问 中国版权保护中心 (CPCC) 进行软著申报，以及各地方软件行业协会进行产品测试申报。

1. 软著申报填写规范

访问 https://www.ccopyright.com.cn/，注册账号后进入“软件著作权登记”系统。

• 软件全称：必须以“软件”、“系统”或“平台”结尾，例如 “智慧档案馆管理系统V1.0”。
• 简称：可以填写，如“智慧档案系统”。
• 版本号：必须是 V1.0 以上，不要写 Beta 或 Alpha。
• 开发完成日期：填写代码提交Git仓库的日期，需早于申请日期。
• 首次发表日期：如果未公开发布，通常与开发完成日期一致；如果已发布，需提供首次发表证明（如官网截图）。

2. 上传材料注意事项

在系统中上传材料时，注意以下技术限制：

• 源代码文档：只能上传 PDF 或 DOCX 格式。PDF必须是可以复制的文本，不能是扫描图片。
• 说明书：同样上传 PDF/DOCX，大小通常限制在 10MB 以内。如果手册过大，请压缩非核心截图的分辨率。
• 申请表：在线填写完成后，系统会生成 PDF 版申请表，必须打印、盖章（公章）、扫描后再回传上传。盖章必须清晰，不得遮挡文字。

3. 代码查重避坑指南

现在的审查系统有查重机制。如果代码重复率过高，会被驳回。在提交前，请务必：

• 修改包名/命名空间：将 com.company.archive 修改为具有独特性的名称。
• 重写通用工具类：不要直接照搬 GitHub 上开源的 DateUtils 或 StringUtils，修改其中的变量名和逻辑顺序。
• 注释个性化：在代码头部添加公司版权声明和业务逻辑描述，增加原创权重。

通过以上步骤，严格按照规范整理代码、撰写手册并配置测试环境，即可在零经验的情况下完成档案软件的双软认证技术准备工作。整个过程的核心在于细节的标准化和流程的严谨性。