frostbyte_neo/xlgo-core
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
9 Commits 1 Branch 8 Tags
75756dd5fbf3984eca49852ee7fca0aead2d64d2
Commit Graph

9 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
杭州明婳科技 75756dd5fb release: v1.1.1 补丁发布 
- ServerConfig.Host 绑定地址字段
- 面向用户文案统一中文
- 修正 README 过时/错误描述（含会致启动失败的配置示例）+ 重写首段介绍

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
v1.1.1 		2026-06-23 23:19:26 +08:00
杭州明婳科技 8421e06fa8 docs: README 修正过时描述 + 重写首段介绍 
修正 v1.1.0 后的过时/错误描述：
- 删除目录结构里已移除的 wire/ 段
- 快速开始配置示例：jwt.secret 补足 32 字节(否则被 Validate 拦截)，
  expire 由 86400(秒,int) 改 "24h"(time.Duration)，补 refresh_expire/issuer/algorithm
- server 段补 host/timeout/response_mode 字段
- v1.0.2 更新日志标注 WithWire 已于 v1.1.0 移除
- 目录结构补 v1.1.0 新文件：metrics/timeout/metrics route/validate/mode
- 框架特性段重写为三组(架构可注入/生产就绪/基础功能)，补全 v1.1.0 能力
- 响应格式段补 Mode 开关(ModeBusiness/ModeREST)与 Custom API

重写首段介绍(原描述过于普通化、无辨识度)：
- 加 tagline 点明核心差异：组件全部 Manager 化，简单调用与注入实例兼得
- 新增"为什么是 xlgo"段：对比一般 Gin 脚手架的包级单例痛点 + 对照代码
- 5 条差异化卖点(可注入/生产就绪内置/零 Fatal/默认轻量/可插拔方言)
- 30 秒上手极简可跑示例

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 23:13:11 +08:00
杭州明婳科技 18e4f7e891 fix: ServerConfig 加 Host 字段 + 面向用户文案统一中文 
- ServerConfig 新增 Host 字段：空=监听所有接口(兼容)，设值=绑定指定地址
  (127.0.0.1 仅本机 / 内网IP 绑定指定网卡)，避免生产暴露 0.0.0.0
- app.go 启动地址改 host:port，日志区分"所有接口"/指定地址
- 面向用户/调用的文案统一中文：
  - middleware/recover.go: "Panic recovered"→"panic 已恢复"，"Panic: %v"→"服务器内部错误: %v"
  - middleware/logger.go: 5 处日志消息改中文
  - middleware/metrics.go: 3 个 Prometheus Help 改中文
  - app.go/database/manager.go/logger.go: 英文 error 改中文
- 保留英文：JSON 协议字段名、Prometheus metric Name、MySQL 错误串匹配、技术专有名词
- CLI 模板与 example 配置加 host 注释

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-23 23:12:40 +08:00
杭州明婳科技 0c9f256dfc feat(v1.1.0): HA & Manager 化 
对应体检报告 #10-#24，一次性完成 v1.1.0 全部 13 项：

- #10 storage/cache/redis/jwt/logger 五组件 Manager 化（XxxManager + DefaultXxx + SetDefaultXxxManager，包级 facade 保留兼容）
- #11 删除 wire 包 + 清理 StartServerWithPort/GracefulShutdown 双轨
- #12 Lifecycle Hooks（OnInit/OnStart/OnReady/OnStop）
- #13 Server 参数配置化（timeout/TLS/unix_socket/response_mode）
- #14 JWTConfig.Expire 改 time.Duration + 删 AppConfig.TokenExpire
- #15 response Mode 开关（ModeBusiness/ModeREST）
- #16 Config.Validate 启动期校验
- #17 livez/readyz 探针路由
- #18 Prometheus metrics 中间件 + /metrics
- #19 请求级 Timeout 中间件
- #21 主库探活 + replica 健康剔除
- #22 App.Go + in-flight goroutine 管理
- #24 RequestID 默认装入 + #23 核对

Breaking：删 wire、删 TokenExpire、JWTConfig.Expire 类型变更、删双轨函数。
详见 CHANGELOG 升级说明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
v1.1.0 		2026-06-23 10:41:05 +08:00
杭州明婳科技 cd3d629282 release: v1.0.4 DX & Docs release 
v1.0.4 定位为 DX & Docs release，开发体验与文档改进，无破坏性 API 变更。
对应体检报告 #25/#27/#28/#29/#30（代码改动已在 deb3cc7 提交）。

本 release commit：
- app.go const Version bump 1.0.3 → 1.0.4
- CHANGELOG 新增 [1.0.4] 章节（Added/Changed + 升级说明）
- CHANGELOG 底部链接补 [1.0.4]，修正 [1.0.2] 指向（无 v1.0.2 tag，改 compare 链接）
- README 更新日志补 v1.0.4 (2026-06-22) 摘要

v1.0.4 内容：
- #28 CLI 多模板（minimal/api/fullstack）
- #29 examples/ 目录（minimal + full 可运行示例）
- #25 模块路径文档改进（保留 -core，明确 module path vs package name）
- #27 Without* Option 定位文档化
- #30 文档结构（规划文档归档 docs/plans/）

build/vet/test 全绿，xlgo version → v1.0.4。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
v1.0.4 		2026-06-22 23:28:46 +08:00
杭州明婳科技 deb3cc71bf feat(v1.0.4): DX & Docs 改进 
按报告 v1.0.4 路线图完成 5 项开发体验与文档改进：

#25 模块路径文档改进：
- 保留 -core 后缀（xlgo 是多产品系列：xlgo-core/xlgo-orm/xlgo-ai）
- README 快速开始补完整 import 示例 + 新增「模块路径与包名」小节
- CLAUDE.md Import Path Note 措辞明确化

#27 Without* Option 定位文档化：
- 调研确认 Without* 有真实用例（测试覆盖 + NewFullStack 后排除单项）
- 不删不标 Deprecated，在 app.go 注释 + README 说明其定位

#28 CLI 多模板：
- xlgo new --template minimal/api/fullstack
- minimal 轻量HTTP无依赖，api 标准业务分层（默认），fullstack 全组件
- 三模板实测生成正确

#29 examples/ 目录：
- examples/minimal（50行可跑，无外部依赖）
- examples/full（mysql+redis+jwt+user CRUD）
- examples/README.md

#30 文档结构：
- Version_*.md + report.md 移到 docs/plans/（v2.0-review.md）
- 新增 docs/README.md 索引
- CHANGELOG/GUIDE 留根目录（按惯例）
- .gitignore 整理

build/vet/test + examples 编译全绿。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 23:21:59 +08:00
杭州明婳科技 dcfd24b624 release: v1.0.3 bug fix release 
v1.0.3 定位为 bug fix release，收口 v1.0.2 引入的破坏性清理并修复
4 个轻量 bug + 依赖复查 + 版本号治理 + 文档对齐。同时包含此前未提交
的 v1.0.2 全部工作。

v1.0.3 变更：

Fixed:
- generateJTI 忽略 rand.Read 错误（jwt）— 改为 (string, error) 并传播
- QueryBuilder.Page Count 受残留 Limit 截断（repository）— countDB 加 Limit(-1).Offset(-1)
- OSS/本地存储文件名冲突（storage）— 新增 uniqueFilename 加 8 字节随机后缀
- 数据库重试策略对不可恢复错误无效（database）— 新增 isTransientDBError

Dependencies:
- go mod tidy 补全 postgres 方言传递依赖；安全补丁升级
  x/crypto v0.49→v0.53、golang-jwt/jwt/v5 v5.2.1→v5.3.1、gorilla/websocket v1.5.1→v1.5.3

Removed:
- Breaking: 清理 v1.0.2 兼容别名（InitMySQL* / driverName）
- 死代码 database.DBResolver
- 代码中 292 行"评分/理由"自夸注释（#26，23 个文件）

Changed:
- Breaking: 错误码体系重构 CodeSuccess 1→0、CodeFail 0→1，删除 CodeInvalidParams，加编译期防撞码
- database/mysql.go → manager.go；Logger 拆分三独立 core 修复 Tee 重复写入
- 版本号常量化：app.go 新增 const Version 作为唯一来源，CLI/脚手架模板引用之，不再散落字面量

Security:
- CORS 中间件按 W3C 规范修复 Allow-Credentials / Vary: Origin / 非白名单不回显

Added:
- console 包显式 level 控制（SetLevel/WithLevel/LevelSilent，atomic.Int32 并发安全）
- 新增测试 jwt/repository/storage/database/router/middleware/app
- 文档：新增 CHANGELOG.md、Version_v1.0.2_report.md；更新 README/GUIDE 顶部更新日志
- 文档对齐：删除对不存在的 config.DefaultManager() getter 的描述（保持 API 与文档一致）

详见 CHANGELOG.md 与 README.md 更新日志。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
v1.0.3 		2026-06-22 21:40:10 +08:00
Ethan xlp 2cc8c70960 chore: change license to MIT 2026-04-30 23:40:59 +08:00
杭州明婳科技 2dfcbbbb22 init v1.0.1 2026-04-30 23:26:14 +08:00