feat: 新增开源版官网骨架 website/,并接入部署编排与网关路由
- website/:VitePress 官网工程(首页/功能/对比/快速开始/部署运维/教程/社区),与文档站同构 - 两种形态由 SITE_BASE 决定:/www/ 子路径(过渡)与 / 根路径(独立域名),内容同源 - deploy/:新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段 - Makefile:新增 website 镜像条目与 make website 目标 - 教程页给出部署/使用两支视频的元数据与录制要求,官网留有教程入口
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: 社区
|
||||
description: 如何参与 iotLCM 开源版
|
||||
outline: deep
|
||||
---
|
||||
|
||||
# 社区
|
||||
|
||||
## 源码仓库
|
||||
|
||||
```
|
||||
https://git.5iot.com/iotlcm-public/iotlcm
|
||||
```
|
||||
|
||||
单仓多服务:全部后端服务、前端应用、文档站与部署编排都在同一个仓库里。分支与标签规范见仓库内的 `README.md`。
|
||||
|
||||
## 许可
|
||||
|
||||
Apache-2.0。可自由使用、修改、商用与分发;分发时保留版权声明与许可证原文,并对修改部分注明变更。
|
||||
|
||||
各子目录的上游依赖保留其原始许可(前端模板基于 Vben Admin / MIT,用户端基于 unibest / MIT)。
|
||||
|
||||
## 贡献
|
||||
|
||||
1. 从 `main` 切出特性分支,命名 `feat/xxx`、`fix/xxx`
|
||||
2. 改动保持单一职责,提交信息用中文说明「做了什么」与「为什么」
|
||||
3. Go 服务改动补单元测试;前端改动说明验证方式
|
||||
4. 文档改动同步更新 `docs/`(文档站源码)与本官网
|
||||
5. 提交合入请求前自检:能否编译、测试是否通过、部署编排是否需要同步变更
|
||||
|
||||
## 提问与反馈
|
||||
|
||||
- 使用问题与缺陷:仓库 issue
|
||||
- 功能建议:仓库 issue,描述清楚场景与期望
|
||||
- 部署排错:先看[部署与运维](/guide/deploy)的常见问题表,再开 issue 附上 `docker compose ps` 与相关日志
|
||||
|
||||
## 运维自用组件的边界
|
||||
|
||||
飞书通知机器人(`with-bot` profile)是给运维方自用的工具,需要自建应用的凭据才能启动,**不是平台功能**,未配置时不影响平台运行。
|
||||
|
||||
运营商通道的生产凭据不随仓发布,需自行向运营商申请。
|
||||
Reference in New Issue
Block a user