技小云
d78379486c
- website/：VitePress 官网工程（首页/功能/对比/快速开始/部署运维/教程/社区），与文档站同构 - 两种形态由 SITE_BASE 决定：/www/ 子路径（过渡）与 / 根路径（独立域名），内容同源 - deploy/：新增 with-website profile、网关 /www/ 路由、多域名 website vhost 段 - Makefile：新增 website 镜像条目与 make website 目标 - 教程页给出部署/使用两支视频的元数据与录制要求，官网留有教程入口
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
---
|
|
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）是给运维方自用的工具，需要自建应用的凭据才能启动，**不是平台功能**，未配置时不影响平台运行。
|
|
|
|
运营商通道的生产凭据不随仓发布，需自行向运营商申请。
|