chore: 初始开源发布

iotlcm-app：小程序端 + 用户端服务。 - app/：uni-app 小程序前端（基于 unibest，MIT） - 微信 AppID → YOUR_WX_APPID，uni-app AppID → __UNI__YOURAPPID - 内网后端地址 → admin.iotlcm.example.com - 应用标题与 unibest 模板 README 重写（保留上游致谢与 MIT 声明） - server/：GoFrame 用户端服务（基于 XiuAdmin，Apache-2.0） - module xiuadmin → git.5iot.com/iotlcm-public/iotlcm-app（360 文件） - 支付回调地址 → app.iotlcm.example.com，商户名与应用名泛化 - 真实手机号 → 合法 11 位编造号（保留号段前 3 位 + 后 4 位） - 依赖号码尾部的断言同步更新 - 补 server/LICENSE（Apache-2.0） - 移除内部资产：CI 触发器 - 补根 README，LF 行尾 + .gitattributes 已知：TestSysDept_RefreshDeptAncestors 在源仓同一提交上同样失败，属既有缺陷。
2026-10-26 14:01:25 +08:00
commit 2ed5dfa6a1
1013 changed files with 138466 additions and 0 deletions
@@ -0,0 +1,137 @@
+package iot_excelize
+
+import (
+	"reflect"
+
+	"github.com/gogf/gf/v2/util/gconv"
+	"github.com/xuri/excelize/v2"
+)
+
+// BuildByStructs creates an Excel workbook from a struct slice without writing
+// it to HTTP response or disk.
+func BuildByStructs(tags []string, list interface{}, sheetName string) (f *excelize.File, err error) {
+	return BuildByStructsWithOption(tags, list, sheetName, nil)
+}
+
+// BuildByStructsWithOption creates an Excel workbook and applies optional
+// styles or advanced customizations.
+func BuildByStructsWithOption(tags []string, list interface{}, sheetName string, option *BuildOption) (f *excelize.File, err error) {
+	if sheetName == "" {
+		sheetName = "Sheet1"
+	}
+
+	f = excelize.NewFile()
+	if err = f.SetSheetName("Sheet1", sheetName); err != nil {
+		_ = f.Close()
+		return nil, err
+	}
+
+	if err = f.SetSheetRow(sheetName, "A1", &tags); err != nil {
+		_ = f.Close()
+		return nil, err
+	}
+
+	length := len(tags)
+	rowNum := 1
+	for _, item := range gconv.Interfaces(list) {
+		row := structValues(item)
+		rowNum++
+		if err = f.SetSheetRow(sheetName, "A"+gconv.String(rowNum), &row); err != nil {
+			_ = f.Close()
+			return nil, err
+		}
+	}
+	if err = applyBuildOption(f, sheetName, length, rowNum, option); err != nil {
+		_ = f.Close()
+		return nil, err
+	}
+	return f, nil
+}
+
+func applyBuildOption(f *excelize.File, sheetName string, colCount int, rowCount int, option *BuildOption) error {
+	if option == nil {
+		return nil
+	}
+	if option.HeaderHeight > 0 {
+		if err := f.SetRowHeight(sheetName, 1, option.HeaderHeight); err != nil {
+			return err
+		}
+	}
+	if colCount > 0 && option.ColWidth > 0 {
+		lastCol := letter(colCount)[colCount-1]
+		if err := f.SetColWidth(sheetName, "A", lastCol, option.ColWidth); err != nil {
+			return err
+		}
+	}
+	if colCount > 0 && option.HeaderStyle != nil {
+		styleID, err := f.NewStyle(option.HeaderStyle)
+		if err != nil {
+			return err
+		}
+		lastCell, err := excelize.CoordinatesToCellName(colCount, 1)
+		if err != nil {
+			return err
+		}
+		if err = f.SetCellStyle(sheetName, "A1", lastCell, styleID); err != nil {
+			return err
+		}
+	}
+	if colCount > 0 && rowCount > 1 && option.RowStyle != nil {
+		styleID, err := f.NewStyle(option.RowStyle)
+		if err != nil {
+			return err
+		}
+		startCell := "A2"
+		endCell, err := excelize.CoordinatesToCellName(colCount, rowCount)
+		if err != nil {
+			return err
+		}
+		if err = f.SetCellStyle(sheetName, startCell, endCell, styleID); err != nil {
+			return err
+		}
+	}
+	if option.AfterBuild != nil {
+		return option.AfterBuild(f, sheetName)
+	}
+	return nil
+}
+
+func structValues(item interface{}) []interface{} {
+	value := reflect.ValueOf(item)
+	if !value.IsValid() {
+		return nil
+	}
+	if value.Kind() == reflect.Ptr {
+		if value.IsNil() {
+			return nil
+		}
+		value = value.Elem()
+	}
+	if value.Kind() != reflect.Struct {
+		return []interface{}{item}
+	}
+	return collectStructValues(value)
+}
+
+func collectStructValues(value reflect.Value) []interface{} {
+	var row []interface{}
+	for i := 0; i < value.NumField(); i++ {
+		fieldValue := value.Field(i)
+		fieldInfo := value.Type().Field(i)
+		if !fieldInfo.IsExported() {
+			continue
+		}
+		if fieldInfo.Anonymous && derefType(fieldInfo.Type).Kind() == reflect.Struct {
+			if fieldValue.Kind() == reflect.Ptr {
+				if fieldValue.IsNil() {
+					continue
+				}
+				fieldValue = fieldValue.Elem()
+			}
+			row = append(row, collectStructValues(fieldValue)...)
+			continue
+		}
+		row = append(row, fieldValue.Interface())
+	}
+	return row
+}