本项目面向港口装卸业务和港口经营企业的费用管理场景，建设目标是形成覆盖集装箱、散杂货等业务类型的装卸板块一体化费收管控平台。港口业务涉及船舶、航次、客户、货类、作业服务、计费标准、合同政策、优惠减免和实际作业量等多类数据，传统依靠人工维护 Excel、线下审批和分散系统处理的方式，容易出现计费规则不统一、合同执行不透明、费用计算效率低、业务追溯困难以及统计分析滞后等问题。
项目以港口收费目录和基础费率为业务基础，将客户合同、服务项目、费目参数、附加系数、堆存天数、减免规则、船舶航次、货物和箱信息等统一纳入系统管理，实现从业务基础资料维护、计费规则配置、合同管理，到费用计算、审核审批、收费检查和统计分析的完整业务闭环。系统同时兼顾集装箱港口和散杂货港口的业务特点，并通过定时任务与主数据同步机制对接船舶、客户及集团基础信息。项目建设能够减少人工核算和重复录入，提高港口费用管理的规范化、透明化和自动化水平，为港口经营决策、客户结算、收入管控及后续业务扩展提供统一的信息化支撑。
项目主要包括商务管理、管理员配置、费用收取管理、流程审批、统计分析、基础数据同步和权限管理等功能模块。商务管理模块用于维护货名、计费货类、客户、收费标准、服务项目、基础费率、政策、合同、合同档案、合同生效、合同到量维护及价格公告等信息，支持按集装箱、货物、服务类型和业务场景进行分类管理。管理员模块用于配置费规参数、费目参数、服务与费目关系、附加系数、堆存天数算法和堆存减免规则，为费用计算提供可配置的业务规则基础。
费用管理模块负责根据合同、费率、业务量、作业类型和优惠政策生成费用结果，并提供费用收取、费用检查、异常处理和结果查询功能。流程与审批模块支持费用业务提交、审核、审批和状态跟踪，形成规范的业务流转机制。统计分析模块提供费用类别、收入情况、优惠减免、逾期情况、预算执行、综合查询及业务明细等统计功能，并支持数据导出。系统还提供集装箱和散杂货基础数据维护、船舶航次信息同步、客户信息同步、集团主数据同步，以及 TCA 数据手工推送、定时推送、推送记录查询和推送配置等外部协同功能。权限模块覆盖用户、角色和权限点管理，保障不同岗位按职责访问系统。
项目采用前后端分离的 Web 架构实现。后端基于 C#、ASP.NET Core 和 .NET 5，主要由门户服务、基础数据 Web API、后台任务服务和单点登录接口等部分组成；前端采用 Vue 2、Vue CLI、Vue Router、Vuex、Axios 和 iView/View Design，按商务、管理员、管理、权限和推送等业务域进行组件化组织。数据访问层使用 NPoco、Yagoo.DbFactory 及项目自有 Entity、Model、DbAccess 等公共组件，并兼容 Oracle 等关系型数据库。系统集成 JWT 身份认证、统一登录、Serilog/NLog 日志、Swagger 接口文档、Quartz 定时任务、Excel 导入导出、文件上传及外部 Web Service 调用等能力。
项目采用分层和模块化设计，将 Controller、业务服务、实体模型、数据访问和公共组件相互分离，既支持基础数据 API，也支持后台管理和定时任务独立运行。主要难点在于港口收费规则复杂，合同、费率、费目、服务、附加系数、堆存天数和优惠减免之间存在多层关联；同时集装箱与散杂货业务口径不同，需要在统一平台中兼容两类计费模型。项目还需要处理历史数据、船舶和客户主数据同步、外部系统推送、审批状态流转以及费用结果可追溯等问题。项目亮点是将港口收费目录、合同政策和计费规则进行参数化配置，减少硬编码；通过业务规则与实际作业数据结合实现自动计费；通过流程审批和费用检查强化收入管控；通过定时任务、TCA 推送和统一身份认证提升系统协同能力，并通过模块化前后端设计增强了系统的可维护性和扩展性。
评论