关注不迷路，我带大家上高速
第一章 引言
1.1 编写目的
本设计文档旨在规范软件架构与接口设计，作为项目实施的核心依据。通过组件化任务分解实现并行开发与单元测试，最终完成系统联调，并为后续升级维护提供技术基础。
1.2 总体目的
第四代港口在延续传统装卸转运功能基础上，强化了港口间及供应链物流协同能力，致力于构建一体化、无缝衔接的现代物流网络。本项目以信息技术为核心手段，推动物流管理软件与业务操作深度融合，达成以下目标：
- 实现总系统、分系统与接口间的数据无缝对接；
- 保障库区交通管理高效、顺畅、零差错；
- 推进库区公共物业服务信息化；
- 集成闸口设备设施与各子系统联动控制；
- 确保系统操作简便、精准、高效；
- 支持7×24小时不间断稳定运行。
第二章 系统软件结构
2.1 软件系统概述
基于对物流管理目标与业务流程的深入分析，融合先进管理理念与信息技术，构建面向现代物流中心的整体信息化解决方案。
2.2 软件系统架构
系统采用纯B/S三层架构，具备良好的开放性与可扩展性，具体如下图所示：
各层功能说明：
- 表达层：用户界面部分，负责与用户交互并呈现操作视图；
- 业务逻辑层：系统核心，使用C#语言封装业务规则，将用户管理、数据访问、信息处理等功能模块化为核心API，实现高内聚、低耦合；
- 数据访问层：专用于数据库交互，通过中间件完成复杂数据操作，实现与操作系统及DBMS的对接，统一进行信息分类、整理与存储。
分层架构优势：关注点分离、松散耦合、逻辑复用、标准接口定义。
2.3 网络拓扑结构
系统划分为内网与外网两个区域。内网为园区内部局域网，由多个子网组成，不接入公网；同时支持外部终端经授权后通过互联网访问系统。网络拓扑如图所示：
主要特性包括：
- 支持内外网同步访问，采用中心服务器冗余热备与双链路保障系统稳定性；
- 采用二层组网（核心层+接入层），核心层为双环网，链路带宽达千兆级，百兆到桌面；
- 各子网间部署防火墙隔离，中心机房配置双机热备服务器进行数据备份；
- 主干链路采用有线连接（光纤/网线），关键区域设备份链路；
- 选用高性能、高可靠性网络交换设备，确保7×24小时连续运行。
2.4 连接方式
系统提供三种连接模式：
- 外网连接：用户终端通过Internet访问代理服务器，再由代理服务器连接信息系统，支持远程登录，不受地域限制。拓扑图如下：
- 内网连接：园区用户直接接入局域网，在授权后访问系统，响应速度快。拓扑图如下：
- 内网-公网连接：通过终端安全准入系统控制用户权限，依据用户名密码判断是否允许访问外网，实现内外网访问隔离与动态切换。拓扑图如下：
2.5 功能结构
系统按功能划分为查询模块、交通管理模块、公共物业服务模块、网站功能模块和模拟测试模块，整体架构如下图所示：
方案设计兼顾针对性、战略性、创新性与可扩展性，为二期工程预留接口，各模块详细功能见下文描述。
2.6 功能设计方案
2.6.1 查询模块
2.6.1.1 公共查询模块
由公共信息发布、投诉建议、其他链接三部分构成，架构如下：
- 公共信息发布：用户可通过正确IP或URL浏览园区海关政策、物业服务、交通流程等信息；
- 投诉建议：供企业、客户及操作人员提交对服务工作的反馈意见；
- 其他链接：提供与关联站点的跳转入口。
模块用例图如下：
主要功能包括：关键字检索、全部信息浏览、分类浏览、详情阅读、留言提交与管理、链接维护、信息发布与维护（含录入、修改、删除、置顶）以及答复显示等。
相关数据表设计如下：
- 投诉建议信息表：含留言编号、姓名、单位、电话、邮箱、内容、答复、IP地址、时间等字段；
- 公共信息表：含信息编号、标题、内容、类型、子类型、发布日期等字段；
- 链接信息表：含站点编号、名称、链接字符串等字段。
2.6.1.2 凭密码操作模块
涵盖交通管理、公共服务表单操作、视频浏览与权限管理四部分。其中权限管理仅限管理员可见，普通用户仅可操作自身业务范围内的内容。架构图如下：
2.6.1.2.1 交通管理表单操作
包含车辆调度计划申请表、闸口调度计划表（A1/B1/C1/C2闸口）、各类IC卡信息登记表（入出库、行政、长期）、错误车辆确认表、手动放行登记表、故障卡登记表及车辆记录总表等。
2.6.1.2.2 公共物业服务表单操作
分为公共查询与内部管理两部分，内部管理采用网络版，公共查询主要用于物业费用等信息查询。
2.6.1.2.3 视频浏览
基于CCTV流媒体服务器SDK与前端编码器WEB服务，实现对闸口及仓库区域的实时视频与历史录像查询，架构如下：
- 实时视频查询：通过电子地图双击摄像头图标即可查看实时画面；
- 视频录像查询：在“录像查询”页面设定条件搜索，双击结果文件即可回放。
2.6.1.2.4 权限管理
采用基于角色的访问控制（RBAC）模型，实现用户、角色、权限三级管理体系，如图所示：
用户通过所属角色获取相应资源访问权限，系统依据“用户—角色—权限”关系链进行合法性验证。
核心数据库表包括：
- 用户表（User）：用户代码、名称、密码、部门代码；
- 角色表（Role）：角色代码、名称、描述；
- 用户角色关系表（UserRole）：用户代码、角色代码；
- 秘密级别表（Secret）：级别代码、名称；
- 信息资源表（Sourse）：资源代码、父目录代码、秘密级别；
- 权限表（purview）：权限代码、值；
- 角色权限表（ACL）：角色代码、资源代码、权限代码、秘密级别代码。
权限验证机制：通过对用户操作码与权限编码执行“与”运算，判定其是否具备相应访问权限。完整关联模型如下图：
RBAC优势在于降低管理复杂度，通过角色批量分配权限，适应组织频繁变动需求，显著提升权限管理效率。
2.6.2 交通管理模块
综合运用网络通信、信息处理与系统集成技术，结合闸机系统，以B/S模式实现库区交通信息登记与发布，支撑全流程服务与管理。
2.6.2.1 模块业务分类
本模块是系统核心，涉及7类业务与8种出入库方式，且存在交叉关系。
2.6.2.1.1 业务类型描述
共七类：
- 收费车辆：客户提前申报，调度中心审核后发送至保安点；车辆入园后办理IC卡入库，作业完成后由仓库解卡，出闸自动识别放行；
- 免费车辆：如送水车等，流程同收费车辆；
- 行政车辆：原则上禁止入区，特殊情况下经审批可办一次性或永久卡进入，系统留痕；
- 紧急车辆：消防、救护、抢险车辆由保安手动放行；
- 错误进入车辆：如楼层或楼栋误入，需出闸重进，司机证件暂扣，重新办卡后归还；
- IC卡无法放行：通过可视对讲联系调度中心核查，若信息缺失则重新解卡，若卡片故障则手动放行并回收；
- 读卡机故障：启用临时读卡模块或手输信息确认，闸杆常开应急通行。
2.6.2.1.2 出入库方式描述
共八种，涵盖A、B、C各区不同楼层的上下行盘道与指定闸口进出流程，均需依指示行驶并刷卡通行。
2.6.2.2 数据流程图
主要流程如下：
- 临时卡发放流程：
- 长期卡发放流程：
- 入库流程：客户提前申报→调度中心分类→发送至保安点→车辆入园缓冲场→确认车位空闲→发卡引导入库。
- 解卡流程：作业完成后由授权仓库对IC卡执行解卡操作，生成放行指令。
- 出库流程：司机持卡在出闸口刷卡，系统自动识别并收卡放行，同步更新车辆离库状态。
