wikiboss/nahaichuan
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

feat(journalism): 录入8篇深度架构与技术洞察长文，全面升级文章资讯列表与详情页为现代中式浅色专业风并联动首页精选板块

浏览代码
这个提交包含在：
wikiboss
2026-10-09 09:26:32 +08:00
父节点 12793dabd6
当前提交 619bf30315
共有 21 个文件被更改，包括 2627 次插入 和 267 次删除
下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

419
tests/build_journalism_seed.py 普通文件
查看文件

@@ -0,0 +1,419 @@
# -*- coding: utf-8 -*-
"""
生成 8 篇企业级深度技术洞察与公司规范文章种子，并同步至远程数据库
"""
import os
import time
import paramiko
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
SEEDS_DIR = os.path.join(BASE_DIR, 'database', 'seeds')
os.makedirs(SEEDS_DIR, exist_ok=True)
SQL_FILE = os.path.join(SEEDS_DIR, 'journalism_articles.sql')
# 8 篇深度技术与公司规范长文定义
articles = [
{
'id': 201,
'official_category_id': 8, # 行业与技术洞察
'image': '/assets/addons/official/images/articles/article_microservice.svg',
'title': '高并发商城中台架构设计：从单体拆分到微服务与分布式事务实践',
'subheading': '系统解构纳海川在复杂业务中台与高并发秒杀场景下的微服务架构演进，详解分布式锁、RocketMQ可靠消息一致性及多租户分库分表工程实践。',
'source': '纳海川技术委员会',
'source_url': '',
'click': 860,
'weigh': 2008,
'createtime': int(time.time()) - 86400 * 6,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">在传统单体架构向分布式架构演进的过程中，企业往往面临高并发流量冲击、数据库连接耗尽、分布式事务难以保证强一致性等多重工程瓶颈。贵阳纳海川科技有限公司技术中台团队在经历多次千万级日交易压测与真实落地后，总结出一套兼具高吞吐量与金融级数据严谨性的商城中台架构设计方案。</p>
<h3>一、业务架构与核心拓扑设计</h3>
<p>纳海川高并发商城中台整体遵循领域驱动设计（DDD）理念，自上而下解耦为接入网关层、聚合编排层、领域服务层与基础设施层：</p>
<ul>
<li><strong>API 统一接入网关：</strong>基于 Spring Cloud Gateway 与 OpenResty 双层集群，实现动态路径路由、基于令牌桶算法的分布式限流、白名单防爬虫与 JWT 零信任验签。</li>
<li><strong>领域中台服务：</strong>拆分为用户会员、商品类目、营销定价、交易订单、履约库存五大独立自治微服务，服务间基于 gRPC 与 mTLS 协议进行低延迟内网调用。</li>
<li><strong>持久化与缓存层：</strong>采用 MySQL 主从复制读写分离，底层接入 Apache ShardingSphere 进行多租户逻辑与物理分库分表；高速缓存采用 Redis 哨兵集群支持分布式热点数据加速。</li>
</ul>
<h3>二、高并发库存防超卖与分布式锁工程</h3>
<p>库存扣减是高并发电商的核心考验。直接依靠数据库行级锁 <code>SELECT ... FOR UPDATE</code> 会在瞬时秒杀场景下引发大量事务阻塞与死锁。纳海川团队采用“三级扣减防御”策略：</p>
<div class="nhc-code-box">
<pre><code>-- Lua 原子库存扣减脚本（保障 Redis 校验与扣减原子性，杜绝并发竞争超卖）
local stock_key = KEYS[1]
local buy_num = tonumber(ARGV[1])
local current_stock = tonumber(redis.call('get', stock_key) or "0")
if current_stock >= buy_num then
redis.call('decrby', stock_key, buy_num)
return 1
else
return 0
end</code></pre>
</div>
<p>通过 Redis 预扣减过滤 99% 的无效流量后，再由 RocketMQ 顺序消息队列异步驱动数据库最终落库，即使遭遇瞬时峰值，底层数据库连接池负载仍平稳运行在 45% 以内。</p>
<h3>三、分布式事务一致性（Seata AT 与消息补偿双保障）</h3>
<p>对于跨越“订单创建”与“积分扣减”等强关联操作，纳海川团队结合 Seata AT 模式的两阶段提交与 RocketMQ 事务半消息机制：</p>
<ul>
<li>首选事务消息投递模式：保证本地业务入库与消息投递的原子性，消费端实现基于全局唯一业务流水号的严格幂等重试。</li>
<li>离线双向自动对账：每日凌晨执行全链路跨库流水对账作业，如存在偶发网络抖动遗留单据，自动触发补偿工单与风控告警。</li>
</ul>
<div class="nhc-callout">
<strong>架构实测指标：</strong>经过标准压测平台模拟 10,000 并发线程压测，核心结算链路单节点 TPS 突破 8,500+，全链路平均接口耗时控制在 35ms 以内，测试期间实现零脏写与零超卖。
</div>
</div>'''
},
{
'id': 202,
'official_category_id': 8, # 行业与技术洞察
'image': '/assets/addons/official/images/articles/article_ai_agent.svg',
'title': '企业私域 AI 智能体落地指南：基于 RAG 的本地化知识库与安全隔离工程',
'subheading': '围绕政企内网物理隔离与核心数据安全底线，阐述纳海川私域智能体开发范式：大模型本地量化部署、向量多路召回与知识溯源防幻觉机制。',
'source': '纳海川技术委员会',
'source_url': '',
'click': 742,
'weigh': 2007,
'createtime': int(time.time()) - 86400 * 5,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">随着通用大语言模型的普及，企业对智能化应用的需求迅速从公网玩具型问答转向深水区的“私域专业业务助理”。然而，公共大模型存在数据外泄风险、无法掌握企业私有文档知识、回答容易产生事实幻觉等致命缺陷。贵阳纳海川科技基于多年政企软件工程经验，给出了内网私有化 RAG 智能体的标准工程解法。</p>
<h3>一、内网物理隔离与算力基础设施</h3>
<p>对于涉及企业商业机密、财务账表与技术图纸的敏感场景，纳海川坚持“零公网外联、纯内网私有算力服务器部署”原则：</p>
<ul>
<li>硬件选型：针对中小企业与政企内网机房，采用本地 GPU 算力集群（单卡或双卡 RTX/A系列专业卡），支持主流开源大模型 4-bit / 8-bit AWQ 量化平稳运行。</li>
<li>网络边界受控：整套系统打包为私有化容器镜像包，在企业纯局域网环境一键离线部署，从物理上杜绝数据传输至第三方公有云服务器的可能性。</li>
</ul>
<h3>二、多路召回与跨编码重排序（Rerank）架构</h3>
<p>单一向量检索无法精准处理专业术语、料号与精确数字查询。纳海川构建了“密集向量 + 稀疏关键词”混合多路检索管道：</p>
<div class="nhc-flow-box">
<p><strong>数据输入</strong> → PDF/Word 智能结构化分块（保留表格与层级上下文） → <strong>Milvus 密集向量嵌入</strong> + <strong>Elasticsearch BM25 稀疏全文检索</strong> → <strong>Cross-Encoder 重排序模型（Top-5 精选）</strong> → 注入 Prompt 约束提示词 → <strong>生成严谨回答</strong></p>
</div>
<h3>三、防止事实幻觉与章节双向锚定</h3>
<p>企业级应用最核心的标准是真实可信。纳海川智能体在系统底层植入强约束机制：</p>
<ul>
<li><strong>强制原文档溯源出处：</strong>智能体在给出每条推论时，均自动标注文档来源名称、页码、段落原文，支持用户一键悬停查阅高亮原文对照。</li>
<li><strong>置信度阈值拦截：</strong>若检索召回文本的综合语义相似度低于 0.72，系统直接输出“根据现有知识库未检索到明确规定，建议咨询人工专家”，坚决杜绝模型胡编乱造。</li>
</ul>
<div class="nhc-callout">
<strong>工程实测成果：</strong>在某大型企业 120,000+ 条规章规程与技术问答知识库实战中，首字吐出延迟缩短至 650ms，问答专业采纳准确率提升至 95.8%，大幅缩减内部合规与技术初审的人工耗时。
</div>
</div>'''
},
{
'id': 203,
'official_category_id': 8, # 行业与技术洞察
'image': '/assets/addons/official/images/articles/article_erp_bom.svg',
'title': '全链路进销存系统的业财一体化构建：多级动态 BOM 与高可靠盘点设计',
'subheading': '深入剖析复杂制造业与流通业进销存核心痛点，详解多层级装配 BOM 动态递归分解、批次批号生命周期追踪及不停产动态盘点算法。',
'source': '纳海川技术委员会',
'source_url': '',
'click': 690,
'weigh': 2006,
'createtime': int(time.time()) - 86400 * 4,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">对于实体制造、组装加工与大型商贸企业而言，进销存软件的核心价值远不仅是简单的记账录单，而在于“物料流”与“资金流”的精准穿透和无缝勾稽。纳海川进销存研发团队针对 35,000+ SKU 复杂度的大型客户场景，设计了多层动态 BOM 递归解算与不停产动态盘点引擎。</p>
<h3>一、多层级装配 BOM 动态递归分解</h3>
<p>在装备制造与深加工行业，一个成品通常由数十种半成品和上百种原料装配而成。传统的静态物料清单无法应对工序损耗浮动与临时替代料问题：</p>
<ul>
<li><strong>动态 BOM 树状递归模型：</strong>系统基于闭包表（Closure Table）与动态树遍历算法，支持无限级物料嵌套定义与动态工时分摊核算。</li>
<li><strong>齐套率实时推演：</strong>生产开工前自动执行 MRP 物料需求推演，秒级给出当前库存满足度报告与精准缺料预警清单，避免盲目排产停工待料。</li>
</ul>
<h3>二、不停产动态盘点与增量流水对冲</h3>
<p>传统进销存必须“停产封库”才能进行盘点，给企业带来高昂停工损失。纳海川系统引入“快照时点 + 增量事务对冲”盘点算法：</p>
<div class="nhc-code-box">
<pre><code>-- 动态盘点逻辑公式
实际账面基准 = 盘点锁定时刻系统快照库存
盘点期间变化量 = 盘点开始至提交时刻已发生的 (入库审核量 - 出库审核量)
最终盘盈盘亏 = 现场实盘录入数量 - (实际账面基准 + 盘点期间变化量)</code></pre>
</div>
<p>该机制使得仓库管理人员可以在白天正常出入库流转的同时，使用移动手持 PDA 完成货架扫描盘点，系统自动完成差异校正，平稳消解并发冲突。</p>
<h3>三、三单智能自动匹配与业财穿透</h3>
<p>为彻底打破业务部门与财务部门之间的信息孤岛，系统实现了采购订单、送货验收单、进项增值税发票的“三单智能核对”。任何价格溢出或数量偏差均被系统自动拦截，从源头杜绝财务坏账与重付款风险。</p>
<div class="nhc-callout">
<strong>业务应用成效：</strong>客户落地后，综合库存周转天数降低 35%，呆滞料库存压降 50% 以上，财务月度结账对账耗时由原先的 3 天压缩至 2 小时自动化完成。
</div>
</div>'''
},
{
'id': 204,
'official_category_id': 8, # 行业与技术洞察
'image': '/assets/addons/official/images/articles/article_cross_app.svg',
'title': '跨端移动开发工程化实践：Flutter 与 Uni-app 在复杂物联网生态下的性能调优',
'subheading': '对比分析主流跨端方案在工业手持机与消费级终端上的表现，分享蓝牙 BLE 外设低延迟通信、后台保活与 60fps 丝滑渲染调优经验。',
'source': '纳海川移动研发组',
'source_url': '',
'click': 615,
'weigh': 2005,
'createtime': int(time.time()) - 86400 * 3,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">在当今移动互联网与产业物联网融合的背景下，移动端软件开发已经不再是简单的展示页面拼装，而是涉及与热敏打印机、扫码手持机、电子秤等各类蓝牙硬件高频通讯的复杂工程系统。纳海川移动团队针对 Flutter 与 Uni-app 双技术栈在生产环境下的工程优化实践进行了全方位复盘。</p>
<h3>一、技术选型决策矩阵：Flutter vs Uni-app</h3>
<p>没有放之四海而皆准的技术栈，纳海川团队根据业务形态制定清晰的分级准则：</p>
<ul>
<li><strong>选择 Flutter 场景：</strong>对图形渲染要求极高、存在深度自定义 Canvas 拓扑图、需要常驻后台心跳保活、主打 Android/iOS 独立安装包的工业级 APP。利用其 Skia/Impeller 自绘底层，达成全机型 60fps 丝滑表现。</li>
<li><strong>选择 Uni-app 场景：</strong>强依赖微信生态裂变、公众号打通、多端小程序（微信/支付宝/抖音）统一编译发布的商业零售与政务办事系统，极大降低双端维护成本。</li>
</ul>
<h3>二、低功耗蓝牙（BLE）通讯丢包与状态机治理</h3>
<p>现场作业中，外设蓝牙信号干扰、突发断开是导致移动端 APP 闪退或打印漏单的元凶。纳海川构建了一套工业级 BLE 连接状态机：</p>
<div class="nhc-flow-box">
<p><strong>设备扫描发现</strong> → <strong>MTU 动态协商扩展（247字节）</strong> → <strong>GATT 服务配对与特征订阅</strong> → <strong>环形分包发送队列（防硬件缓冲区溢出）</strong> → <strong>心跳探活与断线指数退避重连</strong></p>
</div>
<p>通过精细化的分包发送控制（每包 20ms 间隔发送），彻底杜绝了廉价热敏打印机因接收过载而乱码打印的行业痼疾。</p>
<h3>三、移动端内存泄漏精细治理</h3>
<p>针对手持仓储扫码枪频繁长达 8 小时连续作业的工况，团队实施了严格的内存画像监控：大图自动下采样缩放加载、列表视图深度重用复用机制、离开页面时彻底注销 EventBus 与硬件广播监听，使 APP 内存占用始终平稳在 80MB 以内，无内存泄露风险。</p>
<div class="nhc-callout">
<strong>性能量化对比：</strong>实施全链路工程优化后，移动端冷启动时间压缩至 680ms，复杂万行长列表滑动掉帧率低于 0.2%，蓝牙打印指令平均响应延迟达到 150ms 级别。
</div>
</div>'''
},
{
'id': 205,
'official_category_id': 8, # 行业与技术洞察
'image': '/assets/addons/official/images/articles/article_pos_offline.svg',
'title': '新零售商业收银系统的容灾演进：弱网与断网离线记账机制解析',
'subheading': '门店网络突发中断如何确保持续结账不漏单？详解纳海川智慧收银基于本地轻量存储、离线加密挂单与网络恢复幂等状态机回传工程设计。',
'source': '纳海川技术委员会',
'source_url': '',
'click': 580,
'weigh': 2004,
'createtime': int(time.time()) - 86400 * 2,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">在餐饮、超市与零售实体门店的日常运营中，宽带光纤被挖断、商场 Wi-Fi 突发拥堵等网络不可用故障时有发生。如果收银系统完全依赖云端接口，断网即意味着停业，将带来灾难性的客户流失与客诉纠纷。纳海川商业收银系统从设计之初便将“离线容灾”列为第一优先级工程目标。</p>
<h3>一、收银端轻量本地安全沙箱</h3>
<p>为了脱离云端依然能独立运转，纳海川收银前台内置了基于本地 SQLite 的全加密存储沙箱：</p>
<ul>
<li><strong>核心基础数据预加载：</strong>商品价目表、会员离线档案、促销阶梯算法在开店时从云端全量同步并本地常驻，断网期间仍可完成扫码选品、会员积分计算与整单折扣。</li>
<li><strong>离线交易单据加密持久化：</strong>断网状态下的挂账、现金收银、储值卡消费自动生成本地防伪数字凭证，使用 AES-256 加密持久化存储在本地安全存储区。</li>
</ul>
<h3>二、网络恢复后的幂等回传状态机</h3>
<p>当网络信号恢复时，如何保障数百笔离线订单正确回传、既不丢失又不重复记账？纳海川设计了双重防御机制：</p>
<div class="nhc-code-box">
<pre><code>-- 订单唯一幂等约束
CREATE TABLE `fa_pos_orders` (
`id` bigint(20) NOT NULL AUTO_INCREMENT,
`device_sn` varchar(64) NOT NULL COMMENT '收银机终端唯一硬件码',
`client_order_sn` varchar(64) NOT NULL COMMENT '终端本地雪花ID流水号',
`sync_status` tinyint(1) NOT NULL DEFAULT '0' COMMENT '0-未同步 1-已同步 2-对账异常',
PRIMARY KEY (`id`),
UNIQUE KEY `uniq_device_order` (`device_sn`, `client_order_sn`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;</code></pre>
</div>
<p>服务端通过终端硬件码加本地流水号的复合唯一索引杜绝重复入库；即使网络抖动触发多次重试，业务端仍能自动保持幂等。</p>
<h3>三、后厨与外设局域网双向容灾通信</h3>
<p>除了收银台本身，前台点餐到后厨打印的链路同样具备局域网自组网容灾能力：即便外网中断，基于局域网广播协议与双网口热敏打印机的底层直连机制仍可秒级完成菜品分单打印，避免漏做漏上。</p>
<div class="nhc-callout">
<strong>实战运行指标：</strong>经受全国 300+ 实体商业门店连续 720 天生产环境严苛考验，在多次突发断网演练中实现 100% 离线结账无阻断，网络恢复后离线丢单率为 0%。
</div>
</div>'''
},
{
'id': 206,
'official_category_id': 7, # 公司新闻与工程规范
'image': '/assets/addons/official/images/articles/article_tdd_standards.svg',
'title': '贵阳纳海川科技全线推行 TDD 测试驱动开发与白盒源码交付标准',
'subheading': '秉持务实工匠精神，纳海川正式发布全新项目交付规范：坚持测试先行、接口自动化测试覆盖率大于 85%，白盒交付完整工程源码与数据库字典。',
'source': '贵阳纳海川科技有限公司',
'source_url': '',
'click': 920,
'weigh': 2003,
'createtime': int(time.time()) - 86400 * 2,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">软件定制开发行业长期存在“交付即失联”、“代码套壳加密”、“二次开发举步维艰”等行业痼疾。为彻底消除客户对定制软件资产安全与后续维护的顾虑，贵阳纳海川科技有限公司技术管理委员会正式宣布：在所有企业定制与中台开发项目中全面实施 TDD 测试驱动开发与 100% 白盒源码移交标准。</p>
<h3>一、坚持 TDD 测试驱动开发原则</h3>
<p>纳海川团队坚信，高可靠的软件质量不是后期“测出来”的，而是前期“设计并规范出来”的：</p>
<ul>
<li><strong>测试断言先行（Red）：</strong>在编写任何业务代码前，必须先依据客户业务需求蓝图编写自动化测试用例，明确边界条件、并发约束与预期结果。</li>
<li><strong>精炼代码实现（Green）：</strong>编写最简洁、最少量代码使自动化测试用例全量通过，杜绝不必要的过度设计与冗余代码。</li>
<li><strong>持续架构重构（Refactor）：</strong>在全部测试绿灯通过的保护下，进行代码优化、圈复杂度审计与依赖精简，确保系统结构清晰易读。</li>
<li><strong>覆盖率红线：</strong>项目最终交付时，核心业务接口与复杂算法的自动化单元测试覆盖率必须稳定在 85% 以上。</li>
</ul>
<h3>二、100% 白盒交付资产清单</h3>
<p>纳海川承诺在终验阶段向客户完整移交全套技术资产，绝不留后门，绝不进行混淆加密绑定：</p>
<div class="nhc-table-wrap">
<table class="nhc-tech-table">
<thead>
<tr>
<th>资产大类</th>
<th>具体交付清单</th>
<th>技术标准与格式</th>
</tr>
</thead>
<tbody>
<tr>
<td>工程源代码</td>
<td>完整前后端 Git 仓库代码、完整 Commit 提交历史记录、构建编译脚本</td>
<td>标准 Git 代码仓，无混淆加密</td>
</tr>
<tr>
<td>数据库全资产</td>
<td>生产初始化 SQL 脚本、测试用例种子数据、完整数据字典（含索引字段说明）</td>
<td>MySQL 5.7+ / 8.0 DDL 标准</td>
</tr>
<tr>
<td>架构设计蓝图</td>
<td>系统物理部署拓扑图、业务用例流程图、模块 E-R 关系图、Swagger 接口文档</td>
<td>高清矢量图与 Markdown 结构化文档</td>
</tr>
<tr>
<td>部署运维手册</td>
<td>Docker Compose 容器化部署脚本、环境变量对照表、数据备份与灾备恢复方案</td>
<td>开箱即用脚本与详细运维排障指引</td>
</tr>
</tbody>
</table>
</div>
<h3>三、品质承诺与首年 365 天维保</h3>
<p>纳海川为所有由我方自主定制开发的软件系统提供首年 365 天免费质保服务，建立 15 分钟技术响应与 7x24 紧急事故应急响应通道，用扎实的工程契约为企业数字化转型保驾护航。</p>
</div>'''
},
{
'id': 207,
'official_category_id': 7, # 公司新闻与工程规范
'image': '/assets/addons/official/images/articles/article_security_whitepaper.svg',
'title': '纳海川技术委员会发布《企业级微服务安全审计与合规防护白皮书》',
'subheading': '落实网络安全等级保护与数据安全法要求，纳海川总结数十套政企高可靠系统实操经验，为中小企业数字化转型提供系统级安全防护指引。',
'source': '纳海川技术委员会',
'source_url': '',
'click': 840,
'weigh': 2002,
'createtime': int(time.time()) - 86400 * 1,
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">随着《中华人民共和国数据安全法》与《个人信息保护法》的全面施行，软件系统的数据合规与安全防御已成为关乎企业生存发展的生命线。贵阳纳海川科技有限公司技术委员会依据国家信息系统安全等级保护（等保三级）标准，结合大量政企系统交付经验，正式对外发布《企业级微服务安全审计与合规防护白皮书》。</p>
<h3>一、微服务网关层零信任防御模型</h3>
<p>打破“内网即安全”的传统侥幸心理，纳海川推行全面的零信任网络架构：</p>
<ul>
<li><strong>双向 mTLS 证书鉴权：</strong>微服务集群之间所有 RPC 和 HTTP 通讯均强制启用双方证书加密与身份鉴权，杜绝内网伪造调用与窃听嗅探。</li>
<li><strong>动态令牌生命周期：</strong>引入双 Token 机制（短期 AccessToken 与安全隔离的 RefreshToken），配合黑名单即时注销，防范权限越权与会话劫持。</li>
<li><strong>请求防重放与加签验签：</strong>核心支付与资产敏感接口强制执行 Timestamp + Nonce + HMAC-SHA256 签名校验，重放攻击窗口严格限制在 60 秒内。</li>
</ul>
<h3>二、企业敏感数据分级加密与存储脱敏</h3>
<p>针对客户隐私信息与财务账目，系统实施多层次的国密加密与数据脱敏：</p>
<div class="nhc-code-box">
<pre><code>-- 敏感字段透明加解密架构
-- 手机号、身份证号、银行卡号在落盘时采用国密 SM4/AES-GCM 算法加密存储
-- 应用层根据操作员权限角色动态执行脱敏展示（例如：139****6826）
-- 密钥由安全隔离的外部环境变量注入，代码仓库零明文硬编码</code></pre>
</div>
<h3>三、不可篡改全链路审计日志</h3>
<p>白皮书明确规定，所有涉及数据修改、用户授权与资金变动的操作必须生成全局 TraceID 贯穿的安全审计日志，记录请求 IP、操作人、修改前后对比快照，并定期流转归档至独立日志服务器，确保全流程可追溯、防篡改。</p>
<div class="nhc-callout">
<strong>合规价值：</strong>该白皮书不仅已内嵌于纳海川所有自研产品与定制项目的代码基线中，更作为开放指引为广大实体客户提供安全加固参考，赋能客户轻松满足安全合规审查。
</div>
</div>'''
},
{
'id': 208,
'official_category_id': 7, # 公司新闻与工程规范
'image': '/assets/addons/official/images/articles/article_southwest_digital.svg',
'title': '立足西南数谷：纳海川助力数十家实体企业完成业务数字化中台转型',
'subheading': '扎根贵阳、辐射全国。纳海川研发团队通过深度驻场调研与敏捷迭代，以高性价比与严格质量把控，为多领域实体制造与商贸客户构筑稳固数字底座。',
'source': '贵阳纳海川科技有限公司',
'source_url': '',
'click': 995,
'weigh': 2001,
'createtime': int(time.time()),
'content': '''<div class="nhc-article-body">
<p class="nhc-lead-paragraph">贵州作为全国首个国家级大数据综合试验区，数字经济与实体经济的深度融合正加速推进。贵阳纳海川科技有限公司自创立以来，扎根贵阳、依托数谷技术红利，持续深耕智能制造、智慧商贸、连锁新零售等实体行业，通过自主研发的技术中台助力数十家企事业单位构建核心数字资产。</p>
<h3>一、坚持贵阳本土驻场服务技术优势</h3>
<p>与纯线上沟通的远程团队相比，纳海川技术团队始终坚持“深扎现场、面对面务实沟通”：</p>
<ul>
<li><strong>资深架构师面对面调研：</strong>深入客户生产车间、配送仓库、线下门店一线，梳理真实的业务操作卡点与单据流转阻滞。</li>
<li><strong>拒绝二次转包：</strong>自有高水平核心研发团队独立交付，杜绝外包转包造成的需求失真与沟通壁垒。</li>
<li><strong>极速服务时效保障：</strong>贵阳及西南周边地区提供 15 分钟技术初审响应，紧急技术故障 2 小时内安排工程师到达现场解决。</li>
</ul>
<h3>二、标杆实体客户转型实效</h3>
<p>纳海川量身定制的数字化技术中台为实体企业带来了切实可量化的经营提效：</p>
<ul>
<li>某大型酒类连锁企业：通过收银系统与微商城多商户体系重构，打通线上线下 300+ 门店会员资产，年交易承载量突破千万级。</li>
<li>某精密制造装备企业：通过上线纳海川全链路进销存与动态 BOM 调度系统，原材料库存呆滞率降低 55%，生产交付准时率大幅提升。</li>
<li>某垂直政企知识服务中心：通过落地纯内网物理隔离的 AI 智能体应用，实现数万条法律规章秒级结构化问答，初审人力负担直降 80%。</li>
</ul>
<h3>三、恪守工匠初心，陪伴企业长期成长</h3>
<p>未来，纳海川将继续秉持严谨求实、精益求精的软件工程精神，持续探索 AI 智能体、云原生微服务与物联网前沿技术的融合应用，为实体经济的高质量转型注入源源不断的数字活力。</p>
</div>'''
}
]
# 1. 构造 SQL 文件内容
sql_statements = []
sql_statements.append("-- 纳海川官方网站 深度技术文章与公司规范种子数据")
sql_statements.append("-- 生成时间: " + time.strftime('%Y-%m-%d %H:%M:%S'))
sql_statements.append("SET NAMES utf8mb4;\n")
for art in articles:
# 转义单引号
c_title = art['title'].replace("'", "\\'")
c_sub = art['subheading'].replace("'", "\\'")
c_src = art['source'].replace("'", "\\'")
c_src_url = art['source_url'].replace("'", "\\'")
c_content = art['content'].replace("'", "\\'")
sql = f"""REPLACE INTO `fa_official_list_journalism`
(`id`, `official_category_id`, `image`, `title`, `subheading`, `source`, `source_url`, `click`, `content`, `language`, `weigh`, `createtime`, `updatetime`, `deletetime`)
VALUES
({art['id']}, {art['official_category_id']}, '{art['image']}', '{c_title}', '{c_sub}', '{c_src}', '{c_src_url}', {art['click']}, '{c_content}', 2, {art['weigh']}, {art['createtime']}, {art['createtime']}, NULL);"""
sql_statements.append(sql)
full_sql = "\n\n".join(sql_statements)
with open(SQL_FILE, 'w', encoding='utf-8') as f:
f.write(full_sql)
print(f"Generated SQL seed at: {SQL_FILE}")
# 2. 通过 SSH 同步到远程服务器 MySQL 数据库
print("Connecting to remote MySQL on 118.184.172.94...")
ssh = paramiko.SSHClient()
ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
try:
ssh.connect('118.184.172.94', port=22, username='root', password='Bjsslxz1', timeout=10)
print("SSH connected. Uploading seed SQL file...")
sftp = ssh.open_sftp()
remote_sql_path = "/tmp/journalism_articles.sql"
sftp.put(SQL_FILE, remote_sql_path)
sftp.close()
print("Executing MySQL import on remote server...")
stdin, stdout, stderr = ssh.exec_command(f"mysql -uhaichuandata -p'7iNWJSDmGFzNJneN' --default-character-set=utf8mb4 haichuandata < {remote_sql_path}")
err = stderr.read().decode('utf-8')
if err and "Warning" not in err:
print(f"MySQL Import Warning/Error: {err}")
else:
print("Remote MySQL import succeeded!")
# 验证导入结果
stdin, stdout, stderr = ssh.exec_command("mysql -uhaichuandata -p'7iNWJSDmGFzNJneN' haichuandata -e 'SELECT id, official_category_id, title, weigh FROM fa_official_list_journalism WHERE id >= 201;'")
check_res = stdout.read().decode('utf-8')
print("Remote records verification:\n" + check_res)
except Exception as e:
print(f"Remote sync failed: {e}")
finally:
ssh.close()

318
tests/generate_article_covers.py 普通文件
查看文件

@@ -0,0 +1,318 @@
# -*- coding: utf-8 -*-
"""
生成文章资讯专属现代中式浅色专业风矢量封面图 (SVG)
尺寸 600x380，浅色专业背景、科技蓝与中国印章点缀、窗棂细线、无 emoji
"""
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
TARGET_DIR = os.path.join(BASE_DIR, 'public', 'assets', 'addons', 'official', 'images', 'articles')
os.makedirs(TARGET_DIR, exist_ok=True)
# 模板定义
def create_article_svg(title_cn, subtitle_en, tag_text, badge_label, content_elements):
return f'''<svg width="600" height="380" viewBox="0 0 600 380" fill="none" xmlns="http://www.w3.org/2000/svg">
<defs>
<linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
<stop offset="0%" stop-color="#FFFFFF"/>
<stop offset="100%" stop-color="#F8FAFC"/>
</linearGradient>
<linearGradient id="primaryGrad" x1="0%" y1="0%" x2="100%" y2="0%">
<stop offset="0%" stop-color="#2563EB"/>
<stop offset="100%" stop-color="#3B82F6"/>
</linearGradient>
<pattern id="latticeGrid" width="24" height="24" patternUnits="userSpaceOnUse">
<path d="M 24 0 L 0 0 0 24" fill="none" stroke="#E2E8F0" stroke-width="0.75" stroke-dasharray="2,2"/>
</pattern>
</defs>
<!-- 背景卡片与淡雅窗棂网格 -->
<rect width="600" height="380" rx="8" fill="url(#bgGrad)"/>
<rect width="600" height="380" rx="8" fill="url(#latticeGrid)" opacity="0.6"/>
<rect x="1" y="1" width="598" height="378" rx="7" fill="none" stroke="#E2E8F0" stroke-width="1.5"/>
<!-- 顶部控制台标题栏 -->
<rect x="20" y="20" width="560" height="36" rx="4" fill="#FFFFFF" stroke="#E2E8F0"/>
<circle cx="36" cy="38" r="4.5" fill="#EF4444"/>
<circle cx="50" cy="38" r="4.5" fill="#F59E0B"/>
<circle cx="64" cy="38" r="4.5" fill="#10B981"/>
<text x="84" y="42" fill="#334155" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="600">{subtitle_en}</text>
<!-- 中式印章 -->
<rect x="495" y="26" width="72" height="22" rx="2" fill="#FEF2F2" stroke="#EF4444" stroke-width="1"/>
<text x="502" y="42" fill="#DC2626" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11" font-weight="700">{badge_label}</text>
<!-- 核心图解视窗区域 -->
{content_elements}
<!-- 底部文章标签条 -->
<rect x="20" y="324" width="560" height="36" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
<rect x="32" y="332" width="76" height="20" rx="2" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="40" y="346" fill="#1D4ED8" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="11" font-weight="600">{tag_text}</text>
<text x="120" y="347" fill="#64748B" font-family="'Noto Serif SC', 'SimSun', serif" font-size="12">{title_cn}</text>
<text x="480" y="346" fill="#2563EB" font-family="'Inter', sans-serif" font-size="11" font-weight="600">NAHAICHUAN TECH</text>
</svg>'''
articles = [
{
'file': 'article_microservice.svg',
'title': '高并发商城微服务中台分布式事务与分库分表实践',
'sub': 'Engineering Insight · High-Concurrency Mall Architecture',
'tag': '技术洞察',
'badge': '高可用中台',
'content': '''
<rect x="30" y="75" width="250" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="250" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">分布式核心拓扑 (Distributed Mesh)</text>
<rect x="44" y="120" width="222" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">API 网关 · 限流熔断与路由分发</text>
<rect x="44" y="166" width="222" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="188" fill="#334155" font-family="'Inter', sans-serif" font-size="11">交易订单集群 · RocketMQ 事务消息</text>
<rect x="44" y="212" width="222" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="234" fill="#334155" font-family="'Inter', sans-serif" font-size="11">库存防超卖 · Redis RedLock + Lua 脚本</text>
<rect x="44" y="258" width="222" height="32" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="278" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">压测吞吐量: 8,500+ TPS · 延迟 &lt; 35ms</text>
<rect x="300" y="75" width="270" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="300" y="75" width="270" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="314" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">数据一致性与多租户分片</text>
<path d="M 320 135 L 550 135 M 320 180 L 550 180 M 320 225 L 550 225" stroke="#F1F5F9" stroke-width="1"/>
<text x="320" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">分库分表策略 (Sharding-Sphere)</text>
<text x="320" y="150" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">按商户ID哈希分区 + 订单月份归档</text>
<text x="320" y="195" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">分布式事务协调 (Seata AT 模式)</text>
<text x="320" y="220" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">两阶段提交 · 自动全局锁回滚机制</text>
<rect x="320" y="248" width="230" height="42" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="330" y="274" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">严谨设计：双向对账机制与死信队列自动报警</text>
'''
},
{
'file': 'article_ai_agent.svg',
'title': '企业私域AI智能体落地：RAG本地知识库与安全隔离工程',
'sub': 'AI Engineering · Private RAG & Knowledge Governance',
'tag': '技术洞察',
'badge': '私域智能体',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">RAG 双路检索与溯源流水线</text>
<rect x="44" y="120" width="232" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">密集向量检索 (Milvus) + BM25 稀疏全文</text>
<rect x="44" y="166" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="188" fill="#334155" font-family="'Inter', sans-serif" font-size="11">跨编码器 Rerank 重排序引擎 (Top-5)</text>
<rect x="44" y="212" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="234" fill="#334155" font-family="'Inter', sans-serif" font-size="11">原文章节双向锚定 (章节溯源防幻觉)</text>
<rect x="44" y="258" width="232" height="32" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="278" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">检索命中准确率: 95.8% · 响应 &lt; 1.2s</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">纯内网物理隔离安全沙箱</text>
<rect x="324" y="120" width="232" height="48" rx="4" fill="#FEF2F2" stroke="#FECACA"/>
<text x="334" y="142" fill="#991B1B" font-family="'Inter', sans-serif" font-size="11" font-weight="600">物理隔离隔离域 · 零外网数据外泄</text>
<text x="334" y="158" fill="#B91C1C" font-family="'Inter', sans-serif" font-size="10">私有算力服务器量化部署 · 内网专网运行</text>
<rect x="324" y="178" width="232" height="42" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="196" fill="#334155" font-family="'Inter', sans-serif" font-size="11" font-weight="600">企业角色级敏感数据脱敏 (RBAC)</text>
<text x="334" y="210" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">动态字段脱敏 · 问答审计日志永久加密归档</text>
<rect x="324" y="230" width="232" height="60" rx="4" fill="#F1F5F9" stroke="#E2E8F0"/>
<text x="334" y="254" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">工程交付：提供完整微调脚本、</text>
<text x="334" y="272" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">向量分块策略与内网环境 Docker 镜像包</text>
'''
},
{
'file': 'article_erp_bom.svg',
'title': '全链路进销存系统的业财一体化构建与动态BOM算法',
'sub': 'Enterprise Systems · Multi-Level BOM & Financial Cohesion',
'tag': '技术洞察',
'badge': '进销存架构',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">多级动态 BOM 树状递归模型</text>
<rect x="44" y="120" width="232" height="34" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="141" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">成品装配节点 · 动态工时与损耗率核算</text>
<rect x="44" y="162" width="232" height="34" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="183" fill="#334155" font-family="'Inter', sans-serif" font-size="11">半成品自递归拆解 · 齐套率缺料实时预警</text>
<rect x="44" y="204" width="232" height="34" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="225" fill="#334155" font-family="'Inter', sans-serif" font-size="11">原料批次批号绑定 · 一物一码全流程溯源</text>
<rect x="44" y="246" width="232" height="44" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="265" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">35,000+ SKU 大数据量下</text>
<text x="54" y="280" fill="#065F46" font-family="'Inter', sans-serif" font-size="10">生产需求计算 (MRP) 耗时稳定在 1.8 秒内</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">业务与财务闭环核算引擎</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">三单智能自动匹配 (Three-Way Match)</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">采购订单 = 验收送货单 = 进项发票</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">不停产动态快照盘点 (Dynamic Stocktake)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">基于快照时点 + 增量出入库流水对冲</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">消除信息孤岛：财务科目凭证自动生成，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">应收应付账期与信用额度实时联锁控制</text>
'''
},
{
'file': 'article_cross_app.svg',
'title': '跨端移动开发工程化实践：Flutter与Uni-app选型与调优',
'sub': 'Mobile & IoT · Cross-Platform Rendering & Bluetooth BLE',
'tag': '技术洞察',
'badge': '跨端开发',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">架构选型决策矩阵</text>
<rect x="44" y="120" width="232" height="50" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11" font-weight="600">Flutter 自绘引擎 (iOS / Android)</text>
<text x="54" y="158" fill="#2563EB" font-family="'Inter', sans-serif" font-size="10">Skia/Impeller 底层渲染 · 稳定 60fps 高帧率</text>
<rect x="44" y="178" width="232" height="50" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="200" fill="#334155" font-family="'Inter', sans-serif" font-size="11" font-weight="600">Uni-app 全生态 (微信 / 支付宝 / 抖音)</text>
<text x="54" y="216" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">轻量跨小程序运行环境 · 微信生态无缝裂变</text>
<rect x="44" y="236" width="232" height="54" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="258" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">首屏启动性能冷启动优化</text>
<text x="54" y="274" fill="#065F46" font-family="'Inter', sans-serif" font-size="10">分包预加载 + 异步骨架屏，启动压缩至 680ms</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">低功耗蓝牙 (BLE) 工业外设直连</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">状态机自动重连与心跳保活机制</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">扫描 -> GATT握手 -> 特征订阅 -> 丢包重传</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">原生平台通道双向通信 (MethodChannel)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">热敏打印机 / 工业手持扫码枪指令秒级解析</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">内存优化实录：大图纹理缓存精细回收，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">连续操作 8 小时无卡顿与 OOM 闪退</text>
'''
},
{
'file': 'article_pos_offline.svg',
'title': '新零售商业收银系统容灾：弱网断网离线记账机制解析',
'sub': 'POS Reliability · Offline Transactions & Queue Recovery',
'tag': '技术洞察',
'badge': '收银容灾',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">门店离线记账沙箱架构</text>
<rect x="44" y="120" width="232" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">本地 SQLite 离线存储 · 全加密暂存凭单</text>
<rect x="44" y="166" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="188" fill="#334155" font-family="'Inter', sans-serif" font-size="11">后厨 ESC/POS 打印机双网口局域网直连</text>
<rect x="44" y="212" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="234" fill="#334155" font-family="'Inter', sans-serif" font-size="11">断网期间保障点单、出票、挂账平稳运行</text>
<rect x="44" y="258" width="232" height="32" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="278" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">离线丢单率: 0% · 扫码付响应 &lt; 0.3s</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">网络恢复幂等自动同步状态机</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">幂等性与重试控制 (Idempotency Engine)</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">全局雪花ID防重校验 · 事务幂等入库</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">增量冲突消解策略 (Conflict Resolution)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">版本号时钟排序 · 差异对账自动生成补差单</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">经受 300+ 实体门店连续 720 天生产考验，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">高可靠断网防御与零财务差错保障</text>
'''
},
{
'file': 'article_tdd_standards.svg',
'title': '贵阳纳海川科技全线推行TDD测试驱动与白盒源码交付标准',
'sub': 'Quality Assurance · Test-Driven Development & White-Box Delivery',
'tag': '公司动态',
'badge': '交付规范',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">TDD 测试驱动开发研发循环</text>
<rect x="44" y="120" width="232" height="36" rx="4" fill="#FEF2F2" stroke="#FECACA"/>
<text x="54" y="142" fill="#991B1B" font-family="'Inter', sans-serif" font-size="11">1. 编写自动化业务测试断言 (红灯阶段)</text>
<rect x="44" y="166" width="232" height="36" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="188" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">2. 最简化高质量代码实现 (绿灯通过)</text>
<rect x="44" y="212" width="232" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="234" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">3. 架构重构与静态审计 (保持绿灯)</text>
<rect x="44" y="258" width="232" height="32" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="278" fill="#334155" font-family="'Inter', sans-serif" font-size="11">核心接口单元测试覆盖率 &gt; 85%</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">100% 白盒交付资产清单</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">工程可控资产 (Engineering Assets)</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">完整无加密 Git 源码仓库与提交历史</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">设计与架构文档 (Documentation)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">数据库字典字典 + 拓扑蓝图 + 运维部署手册</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">坚决杜绝外包套壳模板代码，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">确保企业客户对数字资产拥有完整掌控权</text>
'''
},
{
'file': 'article_security_whitepaper.svg',
'title': '纳海川发布《企业级微服务安全审计与合规防护白皮书》',
'sub': 'Security Whitepaper · Microservice Defense & Cryptography',
'tag': '公司动态',
'badge': '安全合规',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">微服务零信任纵深防御模型</text>
<rect x="44" y="120" width="232" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">mTLS 双向证书通信 · 服务间调用零信任</text>
<rect x="44" y="166" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="188" fill="#334155" font-family="'Inter', sans-serif" font-size="11">国密 SM4 敏感信息加密存储与脱敏传输</text>
<rect x="44" y="212" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="234" fill="#334155" font-family="'Inter', sans-serif" font-size="11">SQL 预编译防注入 + XSS 白名单严格转义</text>
<rect x="44" y="258" width="232" height="32" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="278" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">国家信息系统安全等级保护三级对照设计</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">全链路审计闭环与合规追溯</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">全链路跟踪 (Distributed TraceID)</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">网关到存储统一链路标识，毫秒级定位异常</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">不可篡改审计日志 (Tamper-Proof Audit)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">管理端关键动作数字签名存证归档</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">白皮书全面总结政企系统交付经验，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">赋能实体企业低成本达成数据安全法规合规</text>
'''
},
{
'file': 'article_southwest_digital.svg',
'title': '立足西南数谷：纳海川助力数十家实体企业数字化转型纪实',
'sub': 'Regional Practice · Southwest Digital Middle Platform Realization',
'tag': '公司动态',
'badge': '本地服务',
'content': '''
<rect x="30" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="30" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="44" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">贵阳本土驻场服务技术优势</text>
<rect x="44" y="120" width="232" height="36" rx="4" fill="#EFF6FF" stroke="#BFDBFE"/>
<text x="54" y="142" fill="#1E40AF" font-family="'Inter', sans-serif" font-size="11">自有本地研发团队 · 资深架构师面对面沟通</text>
<rect x="44" y="166" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="188" fill="#334155" font-family="'Inter', sans-serif" font-size="11">深入车间、门店与仓库现场梳理真实业务逻辑</text>
<rect x="44" y="212" width="232" height="36" rx="4" fill="#F8FAFC" stroke="#CBD5E1"/>
<text x="54" y="234" fill="#334155" font-family="'Inter', sans-serif" font-size="11">拒绝二次转包 · 杜绝异地沟通信息失真</text>
<rect x="44" y="258" width="232" height="32" rx="4" fill="#ECFDF5" stroke="#A7F3D0"/>
<text x="54" y="278" fill="#065F46" font-family="'Inter', sans-serif" font-size="11">响应时效: &lt;15分钟响应 · 紧急现场2小时内到达</text>
<rect x="310" y="75" width="260" height="230" rx="6" fill="#FFFFFF" stroke="#E2E8F0"/>
<rect x="310" y="75" width="260" height="32" rx="6 6 0 0" fill="#F8FAFC"/>
<text x="324" y="96" fill="#0F172A" font-family="'Inter', 'Noto Sans SC', sans-serif" font-size="12" font-weight="700">实体企业转型标杆收益矩阵</text>
<text x="324" y="125" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">生产周转效率 (Operational Velocity)</text>
<text x="324" y="148" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">库存物料占用压降 35% · 交付周期缩短 40%</text>
<text x="324" y="185" fill="#64748B" font-family="'Inter', sans-serif" font-size="10">售后与维保承诺 (Warranty & SLA)</text>
<text x="324" y="208" fill="#0F172A" font-family="'Inter', sans-serif" font-size="12" font-weight="600">首年 365 天免费运维 · 终身技术架构咨询支持</text>
<rect x="324" y="235" width="232" height="55" rx="4" fill="#F8FAFC" stroke="#E2E8F0"/>
<text x="334" y="258" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">立足贵阳数谷优势，以严谨技术工匠精神，</text>
<text x="334" y="275" fill="#475569" font-family="'Noto Serif SC', 'SimSun', serif" font-size="11">为实体产业注入扎实稳固的数字化新动能</text>
'''
}
]
for a in articles:
svg_code = create_article_svg(a['title'], a['sub'], a['tag'], a['badge'], a['content'])
file_path = os.path.join(TARGET_DIR, a['file'])
with open(file_path, 'w', encoding='utf-8') as f:
f.write(svg_code)
print(f"Generated: {a['file']}")
print("All 8 article covers successfully generated!")

13
tests/run_tests.py
查看文件

@@ -261,6 +261,15 @@ def test_homepage_button_links_suite():
res.assert_true(test_result.wasSuccessful(), f"首页所有按钮点击与跳转断言全部通过 (共 {test_result.testsRun} 项)")
return res.summary()
def test_journalism_and_articles_suite():
res = TestResult("新闻资讯与文章深度专项测试 (JournalismAndArticles)")
from tests.test_journalism_and_articles import TestJournalismAndArticles
suite = unittest.TestLoader().loadTestsFromTestCase(TestJournalismAndArticles)
runner = unittest.TextTestRunner(verbosity=0)
test_result = runner.run(suite)
res.assert_true(test_result.wasSuccessful(), f"新闻资讯与文章深度断言全部通过 (共 {test_result.testsRun} 项)")
return res.summary()
def main():
import unittest
results = [
@@ -274,10 +283,12 @@ def main():
test_client_rigor_suite(),
test_ad_law_compliance_suite(),
test_natural_copywriting_suite(),
test_homepage_button_links_suite()
test_homepage_button_links_suite(),
test_journalism_and_articles_suite()
]
sys.exit(0 if all(results) else 1)
if __name__ == '__main__':
main()

102
tests/test_journalism_and_articles.py 普通文件
查看文件

@@ -0,0 +1,102 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
新闻资讯与技术文章改版及丰富度测试 (TDD 模式)
验证文章独立页、移动端模板、首页联动、数据库种子文件及去AI味道规范
"""
import os
import re
import unittest
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
class TestJournalismAndArticles(unittest.TestCase):
def setUp(self):
self.pc_list_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_journalism', 'list.html')
self.pc_details_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_journalism', 'details.html')
self.mobile_list_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_journalism', 'list_e.html')
self.mobile_details_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_journalism', 'details_e.html')
self.home_index_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_home', 'index.html')
self.footer_path = os.path.join(BASE_DIR, 'addons', 'official', 'view', 'web', 'official_common', 'pc', 'footer.html')
self.css_path = os.path.join(BASE_DIR, 'public', 'assets', 'addons', 'official', 'css', 'modern_nhc.css')
self.seed_sql_path = os.path.join(BASE_DIR, 'database', 'seeds', 'journalism_articles.sql')
def test_pc_list_template_spec(self):
"""验证 PC 端文章资讯列表页规范"""
self.assertTrue(os.path.exists(self.pc_list_path), "PC 文章列表模板 list.html 必须存在")
content = open(self.pc_list_path, 'r', encoding='utf-8').read()
self.assertIn("纳海川", content, "必须包含品牌名称【纳海川】")
self.assertIsNone(re.search(r'纳川(?!海)', content), "严禁将品牌错误简写为【纳川】")
self.assertFalse(re.search(r'[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF\u2600-\u26FF\u2700-\u27BF]', content), "严禁包含任何 emoji")
self.assertIn("nhc-article-hero", content, "必须包含现代中式 Hero Banner 容器类")
self.assertIn("nhc-article-card", content, "必须包含现代中式文章卡片样式类")
self.assertIn("render", content, "必须包含分页渲染组件")
def test_pc_details_template_spec(self):
"""验证 PC 端文章资讯详情页规范"""
self.assertTrue(os.path.exists(self.pc_details_path), "PC 文章详情模板 details.html 必须存在")
content = open(self.pc_details_path, 'r', encoding='utf-8').read()
self.assertIn("纳海川", content, "必须包含品牌名称【纳海川】")
self.assertIsNone(re.search(r'纳川(?!海)', content), "严禁将品牌错误简写为【纳川】")
self.assertFalse(re.search(r'[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF\u2600-\u26FF\u2700-\u27BF]', content), "严禁包含任何 emoji")
self.assertIn("nhc-article-body", content, "必须包含规范的文章正文排版容器")
self.assertIn("nhc-breadcrumb", content, "必须包含严谨的面包屑导航")
self.assertIn("info_previous_next_wrap", content, "必须包含上一篇/下一篇自然导流结构")
def test_mobile_templates_spec_and_bugfix(self):
"""验证移动端模板规范并彻底修复循环变量与遗留链接 Bug"""
self.assertTrue(os.path.exists(self.mobile_list_path), "移动端列表模板 list_e.html 必须存在")
self.assertTrue(os.path.exists(self.mobile_details_path), "移动端详情模板 details_e.html 必须存在")
list_content = open(self.mobile_list_path, 'r', encoding='utf-8').read()
details_content = open(self.mobile_details_path, 'r', encoding='utf-8').read()
# 修复历史遗留 bug：循环中错误使用 $item['id'] 替换为正确的遍历项变量
self.assertNotIn("official_video/list", details_content, "详情页严禁遗留旧 official_video/list 错误路径")
self.assertFalse(re.search(r'[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF\u2600-\u26FF\u2700-\u27BF]', list_content), "移动端列表严禁 emoji")
self.assertFalse(re.search(r'[\U0001F600-\U0001F64F\U0001F300-\U0001F5FF\u2600-\u26FF\u2700-\u27BF]', details_content), "移动端详情严禁 emoji")
def test_css_design_tokens_for_articles(self):
"""验证 CSS 中已包含文章与资讯专属样式定义"""
css = open(self.css_path, 'r', encoding='utf-8').read()
self.assertIn(".nhc-article-card", css, "CSS 必须定义 .nhc-article-card 样式")
self.assertIn(".nhc-article-body", css, "CSS 必须定义 .nhc-article-body 样式")
def test_seed_sql_rich_articles(self):
"""验证数据库种子包含不少于 8 篇扎实深度专业文章"""
self.assertTrue(os.path.exists(self.seed_sql_path), "数据库种子文件 journalism_articles.sql 必须存在")
sql = open(self.seed_sql_path, 'r', encoding='utf-8').read()
# 验证至少 8 篇优质文章插入
insert_count = (sql.count("INSERT INTO `fa_official_list_journalism`") +
sql.count("INSERT INTO fa_official_list_journalism") +
sql.count("REPLACE INTO `fa_official_list_journalism`") +
sql.count("REPLACE INTO fa_official_list_journalism"))
self.assertGreaterEqual(insert_count, 8, "必须有至少 8 篇高质量文章 SQL 写入语句")
# 验证核心业务主题覆盖
self.assertIn("微服务", sql, "必须覆盖微服务架构深度文章")
self.assertIn("智能体", sql, "必须覆盖 AI 智能体/大模型与知识库落地文章")
self.assertIn("进销存", sql, "必须覆盖全链路进销存与业财一体化文章")
self.assertIn("收银", sql, "必须覆盖智慧收银容灾与离线记账机制文章")
self.assertIn("测试驱动开发", sql, "必须覆盖 TDD 测试驱动开发规范文章")
# 严禁假大空与 AI 味营销词汇
for bad_word in ["赋能千行百业", "颠覆式创新", "颠覆传统", "未来已来", "数字化新纪元"]:
self.assertNotIn(bad_word, sql, f"文章种子严禁包含 AI 味空话：{bad_word}")
def test_home_and_footer_linkage(self):
"""验证首页与页脚自然联动技术洞察板块"""
home = open(self.home_index_path, 'r', encoding='utf-8').read()
footer = open(self.footer_path, 'r', encoding='utf-8').read()
# 首页必须包含技术洞察/动态资讯展示区块
has_news_section = "nhc-insights-section" in home or "技术洞察" in home or "研发动态" in home
self.assertTrue(has_news_section, "首页必须包含技术洞察与研发动态板块")
# 页脚必须有技术资讯入口
has_insights_link = "official_journalism" in footer or "技术洞察" in footer or "新闻资讯" in footer
self.assertTrue(has_insights_link, "页脚必须包含技术洞察/新闻资讯链接")
if __name__ == '__main__':
unittest.main()