Dai0814
6944652966
mirror-to-gitee / mirror (push) Successful in 3s
原先导航「官方文档」指向 /#docs（首页内的文档区块）， 用户期望点它直接进 http://open.5iot.com:5051/docs/。 改动 - 导航项改为外链 http://open.5iot.com:5051/docs/， 带 target=_blank 与 rel=noopener，新开标签页不打断阅读 - 首页 hero 的「官方文档」按钮同样改为外链直跳 - 文档站地址收敛为单一来源：data/content.ts 导出 DOCS_BASE / DOCS_HOME， 可用环境变量 DOCS_BASE 覆盖；config.mts 与 HomePage.vue 都引用它， 消除原先三处硬编码 - 首页的「官方文档」区块（#docs）保留，仍是各手册入口的聚合卡片 验证 - 导航渲染实测：href=http://open.5iot.com:5051/docs/, target=_blank - 点击实测：新开标签页到目标地址，原页面 URL 不变 - 锚点项高亮不受影响（点「产品功能」仍正常变蓝） - 构建 13 页 262 引用 0 失效
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
---
|
|
title: 关于
|
|
description: 雪羊科技开源项目门户说明
|
|
outline: deep
|
|
---
|
|
|
|
# 关于
|
|
|
|
雪羊科技对外开源的物联网卡与设备管理平台，汇集公司发布的开源项目。当前收录物联网卡管理平台（iotLCM）、DTU 设备管理平台（秀杰 DTU）与中后台开发框架（XiuAdmin）。
|
|
|
|
## 许可证
|
|
|
|
全部项目以 **Apache-2.0** 发布。
|
|
|
|
| 允许 | 需要 |
|
|
| --- | --- |
|
|
| 自由使用、修改、商用、再分发 | 保留版权声明与许可证原文 |
|
|
| 用于闭源商业产品 | 对修改过的文件注明变更 |
|
|
| 专利授权（贡献者授予） | 各项目上游依赖保留其原始许可 |
|
|
|
|
## 各项目仓库
|
|
|
|
| 项目 | 仓库 |
|
|
| --- | --- |
|
|
| iotLCM | <https://git.5iot.com/iotlcm-public/iotlcm> |
|
|
| 秀杰 DTU 管理平台 | <https://gitee.com/snowgoat/xiu-dtu> |
|
|
| XiuAdmin | <https://gitee.com/snowgoat/xiu-admin> |
|
|
| 本门户站 | <https://git.5iot.com/iotlcm-public/website> |
|
|
|
|
## 参与贡献
|
|
|
|
| 步骤 | 做什么 |
|
|
| --- | --- |
|
|
| 1 | 从目标项目的默认分支切出特性分支，命名 `feat/xxx`、`fix/xxx` |
|
|
| 2 | 提交前确保构建与测试通过：Go 服务跑 `go build ./...` 与 `go test ./...`，前端跑 `pnpm build` |
|
|
| 3 | 提交合入请求，说明变更动机与影响范围 |
|
|
|
|
## 提问与反馈
|
|
|
|
| 类型 | 去哪 |
|
|
| --- | --- |
|
|
| 使用问题与缺陷 | 对应仓库开 issue |
|
|
| 功能建议 | issue 里描述清楚场景与期望 |
|
|
| 部署排错 | 先看各项目详情页的常见问题表，再开 issue 并附 `docker compose ps` 与相关日志 |
|
|
|
|
## 边界说明
|
|
|
|
| 项 | 说明 |
|
|
| --- | --- |
|
|
| 飞书通知机器人 | `with-bot` profile 下的运维自用工具，需要自建应用凭据才能启动，**不是平台功能**，未配置不影响运行 |
|
|
| 运营商凭据 | 通道的生产凭据不随仓发布，需自行向运营商申请与配置 |
|
|
| 老平台私有模块 | 开源版发布的是微服务家族，不含历史项目的私有定制部分 |
|
|
|
|
## 门户本身
|
|
|
|
门户是一个独立的 VitePress 工程，与平台代码不在同一个仓库。构建产物是纯静态站点，可用任意静态服务器或容器托管。
|
|
|
|
镜像构建与部署说明见[门户部署](/guide/portal-deploy)。
|