ulthon/ulthon_admin
1
0
Fork 0
mirror of https://gitee.com/ulthon/ulthon_admin.git synced 2026-08-30 12:45:32 +08:00
Code Issues Packages Projects Releases Wiki Activity
1,099 Commits 5 Branches 139 Tags
a7a80417ef257a6c4a12c6755e894b7c1ab1ddd1
Commit Graph

1099 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
augushong
a7a80417ef docs(skill): 新增纯拉取模式工作流与更新策略规则机制 2026-08-08 19:09:26 +08:00
augushong
0e1df3852d feat(update): 新增 admin:update --fetch-only 纯拉取模式 2026-08-08 19:09:21 +08:00
augushong
ad96755ff5 docs(permission): 统一校准权限节点措辞，消除更新节点误解 
admin:permission:nodes 是查看型命令（实时扫描注解、不写库、改注解即生效），但文档/注释多处用一键更新/自动更新/生成等动作词描述，导致开发者系统性误以为它是更新权限节点命令。本次校准 8 个文件 10 处误导措辞，并在命令输出末尾追加机制提示。@NodeAnotation 拼写保持不变（框架故意少一个 t）。
 2026-08-08 18:21:25 +08:00
augushong
7341268ceb fix(docker): run.sh 加 umask 000 + 预创建 runtime 子目录 
bind mount 模式下 Dockerfile 的权限处理被宿主目录覆盖，
PHP 新建的子目录（runtime/cache/da/ 等）默认 755 导致 www-data 无法写入。
- 开头加 umask 000 让子进程创建的文件/目录全局可写
- mkdir 预创建 cache/log/temp/session/nginx 子目录
- docker-dev 和 docker-dev-sync 同步修复
 2026-08-08 10:33:44 +08:00
augushong
8faa52ce90 feat(nginx-log): 多节点适配（node_id 全链路 + 全局/按节点聚合 + 节点筛选 + v2.4.0 升级脚本） 
- 6 张表加 node_id 字段 + position/stat 改复合唯一键（migration）
- 6 个 Scheme 同步 node_id 注解 + 唯一键
- Reader 带 node_id 参数 + 懒加载接管（getLastPosition 回退查 node_id=''）
- Aggregator 全局行（node_id=''）+ 按节点循环 insertAggregatesForScope
- Stat 所有查询方法加 where node_id 条件
- Dashboard 控制器/视图加节点筛选下拉框 + AJAX 带 node_id
- AccessLog 列表加节点列 + 采集进度卡片显示节点信息
- import 定时任务 run_type 改 all（每节点采集自己的日志）
- v2.4.0 升级脚本追加 ALTER TABLE（幂等 check-then-alter）
- 菜单调整：去掉 Nginx 顶级菜单 + 读取位置管理，改为系统管理下挂两个子菜单
- ulthon-timer 文档补充 run_type=all 多节点部署注意事项
 2026-08-08 10:33:20 +08:00
augushong
f1a2e8fd5d fix(nginx-log): service 文件加 Service 后缀（命名规范合规） 
F2 Code quality review 发现：3 个新增 service 未遵守
.agents/rules/ulthon-naming-convention.md 第 19 行规定
（service 模块文件名需带 Service 后缀）。

变更：
- 重命名 6 个文件（3 Base + 3 App）：
  NginxLogParser(Base)→NginxLogParserService(Base)
  NginxLogReader(Base)→NginxLogReaderService(Base)
  NginxLogAggregator(Base)→NginxLogAggregatorService(Base)
- 同步类名、use、类型 hint、new 引用
- NginxLogReaderServiceBase 异常消息前缀同步加 Service
- controller Base 引用更新（NginxLogImportBase / NginxLogStatAggregateBase）

验证：
- php -l 全部 8 个文件语法通过
- grep 残留旧名 = 0 结果（24 处引用全部带 Service 后缀）
 2026-07-28 06:57:13 +08:00
augushong
0f9f12174c test(nginx-log): 权限节点扫描 + 端到端 QA 验证 + curd 路径修复 
- 跑 admin:permission:nodes 扫描 138 个权限节点（17 个 nginx 相关节点）

- 17 个 nginx 节点 assign 给 role-id=1（写入 ul_system_auth_node 满足 plan 验收）

- curd 路径修复：菜单 href 由 system.nginx_access_log/index 改为 nginx.access_log/index（匹配 curd 生成的实际 URL，方案 B）

  - SystemMenu.php / v2.4.0.php / DB ul_system_menu 三处同步（含 id=303 log_position）

  - dashboard id=301 system.nginx_log_stat/index 保持不变（控制器确实在 system 模块）

- 端到端 QA 全通过：100 行日志 → import 74 行（静态过滤）→ aggregate stat_hour=1/url=6 → dashboard 数据完整

- 修复 T10 遗留 bug：cleanStatTables 用 Unix 时间戳当阈值，与 stat_date YYYYMMDD 不匹配导致误删

  - threshold 从 strtotime('today')-days*86400 改为 (int) date('Ymd', strtotime('today')-days*86400)

  - 验证：366 天前 stat 数据被删，今天 stat 数据保留

- 权限隔离：超管可访问，未登录被拦（code=40101 请先登录后台）

- Evidence: .omo/evidence/task-16-nginx-log-analytics-e2e/（15 个文件）
 2026-07-28 06:47:24 +08:00
augushong
8a5a0d9877 feat(nginx-log): NginxLogStat dashboard 视图与 JS（echarts 趋势图） 2026-07-28 06:34:30 +08:00
augushong
3e983d8b8f feat(nginx-log): adminUpdateCodeData v2.4.0 存量升级代码（sysconfig + 菜单幂等补齐) 2026-07-28 06:28:17 +08:00
augushong
d5329cdd45 feat(nginx-log): curd 生成 raw/position 后台并改只读 
- NginxAccessLog + NginxLogPosition Scheme 加 #[Component] 注解
- Scheme Table name 补 ul_ 前缀（curd 严格校验要求）
- curd 生成 nginx 模块完整后台（controller/model/view/js）
- Base/App 双层只读控制器（参照 TimerLogBase 范式）
  - AccessLogBase: add/edit/delete/modify 全部 error
  - LogPositionBase: 同上
- 视图改造：
  - access_log 裁剪到 8 列核心字段（time_local/method/uri/status/remote_addr/request_time/body_bytes_sent/http_user_agent）
  - status/request_time 自定义 badge 渲染
  - toolbar 清空 + operat 仅保留详情（B 类只读页面）
  - log_position 全字段 + 只读化
- HTTP 验证：index 200 OK + add/edit/delete/modify 全部返回错误
 2026-07-28 06:21:13 +08:00
augushong
7987001cd2 feat(nginx-log): NginxLogStat dashboard 控制器（Base/App 双层，日/周/月/年聚合） 
- extend/base/admin/controller/system/NginxLogStatBase.php：完整逻辑
  - @ControllerAnnotation(title=Nginx访问统计) + @NodeAnotation(title=访问统计)
  - index() 页面/接口同体：isAjax() 返回 JSON，否则 fetch()
  - period 解析：day(24h)/week(7d)/month(30d)/year(12m)/custom，invalid 自动 fallback day
  - custom start>end 自动 swap
  - 整体指标：SUM stat_hour，avg_request_time 按 PV 加权平均
  - 趋势：day 按 stat_hour 聚合补 0-23；week/month/custom 按 stat_date 补日期序列；year 按 (stat_date DIV 100) 聚合补 1-12 月
  - Top N：sysconfig('nginx_log','topn_default',10)，topN=0 不截断
  - 跨周期 UV 标注：uv_is_estimate = period !== 'day'
  - 空表/空范围不崩（返回 0/[]）
- app/admin/controller/system/NginxLogStat.php：App 入口，仅 extends Base

性能：stat_hour 10 万行 + period=year 服务端 < 700ms（< 2s 要求）
依赖：T1 stat 模型、T9 Aggregate；blocks：T13 视图
 2026-07-28 06:17:22 +08:00
augushong
2b677c6f89 feat(nginx-log): NginxLogStatAggregate 定时任务 + timer config 注册 2026-07-28 06:02:07 +08:00
augushong
8eaa672ed6 feat(nginx-log): NginxLogClean 定时任务 + timer config 注册（完成 3 个 nginx 任务） 2026-07-28 06:00:15 +08:00
augushong
13b1313e92 feat(nginx-log): NginxLogImport 定时任务 + timer config 注册（Base/App 双层） 2026-07-28 05:48:46 +08:00
augushong
ceb73c750a feat(nginx-log): NginxLogAggregator 聚合 service（Base/App 双层，delete-then-insert 幂等） 2026-07-28 00:52:51 +08:00
augushong
9fe55f81bf feat(nginx-log): NginxLogReader 增量读取 service（Base/App 双层，含轮转检测） 2026-07-28 00:39:11 +08:00
augushong
7d707c2150 feat(nginx-log): NginxLogParser 解析器 service（Base/App 双层） 2026-07-28 00:38:25 +08:00
augushong
c4b72913df feat(nginx-log): .example.env 增加 [NGINX_LOG] 配置节（默认关闭） 2026-07-28 00:24:39 +08:00
augushong
ce191adfd8 feat(nginx-log): 4 个 stack 模板增加 log_format 与 access_log 配置（Docker 开箱即用） 2026-07-28 00:24:26 +08:00
augushong
3405f8de60 feat(nginx-log): adminInitData 增加 nginx_log 默认配置（保留策略/topN/静态排除） 2026-07-28 00:18:56 +08:00
augushong
0d19881a22 feat(nginx-log): 新增 6 张表 phinx migration + Scheme + model 2026-07-28 00:03:49 +08:00
augushong
f48e0947cb docs(timer): 技能文档补充 Docker 模式自动启动说明 
新增 Docker 部署章节：server 模式自动启动 timer（nohup + --local --quiet），多节点天然隔离（runtime/node_id.lock 独立）。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-26 09:53:45 +08:00
augushong
97eb8ca99a fix(timer): timer_log 列表页补全刷新按钮与事件监听方法修正 
toolbar 从 [] 改为 ['refresh']（B 类只读页面保留刷新），ua.table.on 修正为 layui.table.on。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-26 09:53:27 +08:00
augushong
739b536f8d fix(host): Host 控制器禁用手动增删改与按钮配置修正 
HostBase 补 add/edit/delete/modify 禁用方法（节点自动注册，不支持手动操作）。_common.js 的 addUrl/editUrl/deleteUrl/exportUrl/modifyUrl 改空字符串。index.js 补 toolbar: ['refresh']（C 类页面，去掉默认的 add/delete/export）。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 22:40:05 +08:00
augushong
908f84ee9f refactor(timer): TimerLog 控制器迁移到 Base 层 + toolbar 与事件监听修正 
控制器逻辑移入 extend/base/admin/controller/system/TimerLogBase.php，app 层改为空壳继承。index.js 补 toolbar:[] + defaultToolbar:['filter']（B 类只读页面），修正 ua.table.on → layui.table.on。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 22:39:53 +08:00
augushong
009647f96f refactor(timer): TimerConfig 控制器与视图迁移到 Base 层 
控制器逻辑移入 extend/base/admin/controller/system/TimerConfigBase.php，app 层改为空壳继承。9 个视图文件迁移到 extend/base/admin/view/system/timer_config/。index.js 补 toolbar: ['refresh', 'export'] 声明（C 类页面，去掉默认的 add/delete）。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 22:39:20 +08:00
augushong
1d704fc32c fix(migration): 新增增量 migration 补齐 timer_config 与 system_host 缺失字段 
建表 migration（SystemTimerConfig/SystemHost）建表时未含动态管控新增字段（trigger_node_id/last_trigger_time/concurrency/is_master），全新安装走 migrate:run 会缺字段。新增 ALTER migration 增量补齐，保证全新安装表结构完整。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 22:22:47 +08:00
augushong
1b0be9a29b docs(timer): 定时器动态管控技能文档补充四章节 
新增并发数动态调整、手动触发定向、多节点协调、clamp 有效域钳制四章节，含 12 个示例对照与 4 个坑位说明。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:58:48 +08:00
augushong
12fe271ce0 feat(timer): 编辑页并发数配置表单 
edit 表单放行 concurrency 字段，空值=继承代码默认写 NULL，正整数=覆盖。前端联动提示语义。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:58:20 +08:00
augushong
41a0f99735 feat(timer): 列表页节点视角下拉与归属可视化 
新增节点视角下拉（全局/指定节点），calcOwnership 计算任务归属，触发操作联动节点选择器定向 trigger_node_id，并发列双通道显示（默认/覆盖值）。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:58:07 +08:00
augushong
f13384403a feat(timer): 后台触发/编辑/节点列表控制器改造 
trigger 定向 trigger_node_id 必填穿透 status；edit/modify 改 concurrency 后 Cache::inc 递增脏标记触发立即 reload（D18）；hostList 返回在线节点；normalizeConcurrency 归一化入库值。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:57:56 +08:00
augushong
3db3f7de78 feat(timer): syncConfig concurrency 不变量与控制器 cap 防御 
TimerServiceBase syncConfig 不覆盖 DB concurrency（NULL=继承代码默认）。TimerControllerBase cap 改 >= 语义，放行 concurrency_id < cap 的 0-indexed 分片。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:57:39 +08:00
augushong
f478ae0e4e feat(timer): runLoop 热加载并发实例与运行时配置参数 
TimerBase 实现 shouldExecuteTask 手动触发原子消费、reloadRequestList 合并式扩缩容、runLoop 脏标记检测+定时兜底+有效域钳制+drain 优雅缩容+checkTriggerTtl 超时复位。config/timer.php 新增 trigger_ttl/force_reload_interval/drain_max_lifetime 三参数。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:57:25 +08:00
augushong
236a343fa9 feat(timer): 新增并发数/触发节点/触发时间三字段及幂等分发 
Scheme 定义 concurrency(nullable)/trigger_node_id/last_trigger_time 三字段，Model 声明属性，v2.3.0 分发代码幂等 ALTER 保证升级自动同步。

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
 2026-07-25 21:57:14 +08:00
augushong
8dce4ab48a docs(deploy): 补充多环境 .env 管理约定 
各环境配置文件（.env.test/.env.prod/.env.demo）放在仓库根目录，
部署时流水线将目标文件覆盖为 .env，代码完全一样只有 .env 不同
 2026-07-23 22:22:52 +08:00
augushong
4ebcea0669 chore(stack): 删除 docker-dev/docker-dev-sync 残留的 .docker-dev.env 
B-route 下 .env 只在仓库根，bind mount 容器直接读根目录 .env，
模式目录不再需要独立的 env 文件
 2026-07-23 22:17:18 +08:00
augushong
3de1b3c058 docs(deploy): 记录义务补充非默认端口要求 
开发者修改了框架模板默认端口（HTTP 8000/MySQL 13306/Redis 16379 等）
时必须记录，否则智能体调试（如 tools:http:call）会用默认端口连接失败
 2026-07-23 22:07:57 +08:00
augushong
1620af9ff2 refactor(stack): 删除 stack.json，README 改为模板使用指南 
- 删除 source/stack/stack.json（与 README 模式表重复，无实际用途）
- README 新增使用方式说明：可直接用，推荐复制后自定义
  （admin:update 只更新原始模板，不覆盖开发者副本）
- 同步清理 ulthon-deploy-environment.md 和
  ulthon-update-workflow SKILL.md 中对 stack.json 的引用
- ulthon-deploy-environment.md 补充记录义务规则：
  智能体应确认 project-dev-runtime-deploy.md 是否已记录运行方式，
  必须包含命令执行方式（容器内 vs 宿主机）
 2026-07-23 22:01:38 +08:00
augushong
544604ebff fix(stack): 其余4个模式同步 bind mount 兼容修复 
与 docker-dev（commit 5797885）保持一致的修复方案：
- run.sh 改为 SCRIPT_DIR 自动检测脚本所在目录
- Dockerfile ENTRYPOINT/chmod 改为完整路径
  /var/www/html/source/stack/<mode>/source/docker/run.sh
- 基础配置（nginx.conf/zz-phprun.ini/zz-phpfpm.conf）复制到各模式目录
- ln -s 改为 ln -sf（防止容器重启时 File exists）

docker-dev-sync 额外保留 sync.sh 调用逻辑（init + watch），
仅路径改为 \/sync.sh
 2026-07-22 23:40:33 +08:00
augushong
5797885f3d fix(stack): 修复 bind mount 遮蔽 build 期 symlink 导致容器启动失败 
B-route 下 build context=仓库根 + bind mount /var/www/html 有两个问题：

1. ENTRYPOINT 引用 /var/www/html/source/docker/run.sh 在运行期找不到：
   build 期的 symlink 被 bind mount 完全覆盖，容器看到的是宿主机
   仓库根的 source/docker/（只有 nginx.conf/zz-phprun.ini/zz-phpfpm.conf，
   没有 run.sh）

2. 模式目录 source/docker/ 不自包含：
   只有 run.sh/zzz-dev.ini/zzz-xdebug.ini，缺基础配置

修复（docker-dev 模式）：
- run.sh 改为用 SCRIPT_DIR 自动检测脚本所在目录
- Dockerfile ENTRYPOINT/chmod 改为完整路径
  /var/www/html/source/stack/docker-dev/source/docker/run.sh
- 基础配置（nginx.conf/zz-phprun.ini/zz-phpfpm.conf）复制到模式目录
  使其自包含

验证：docker compose build 通过，up 容器稳定运行，
nginx + PHP-FPM 启动成功，ThinkPHP CLI 正常（v8.1.4）
 2026-07-22 23:29:50 +08:00
augushong
6bc661117c fix(stack): 修复 B-route 下所有 Dockerfile COPY 路径与 build context 不匹配 
B-route 把 build context 改为仓库根后，Dockerfile 中的 COPY source/docker/...
和 chmod/ENTRYPOINT 引用 /var/www/html/source/docker/ 全部失效。

根因：
- 仓库根有全局 source/docker/（仅 nginx.conf/zz-phprun.ini/zz-phpfpm.conf 基础配置）
- 模式专属配置（run.sh、zzz-dev.ini、zzz-xdebug.ini 等）在 source/stack/<mode>/source/docker/
- COPY . 把全局 source/docker/ 复制进容器，但缺少模式专属文件
- 旧 COPY source/docker/zzz-dev.ini 在 context=仓库根时找不到文件

修复（所有 5 个模式统一）：
- 每个 Dockerfile 在 COPY . 后加 rm -rf + ln -sf symlink，
  让 /var/www/html/source/docker 指向模式专属配置目录
- COPY ini 文件路径改为完整的 source/stack/<mode>/source/docker/...
- .dockerignore 去掉 source/stack/ 排除（配置文件仅几 KB，
  但 COPY 需要这些文件在 build context 中）
- .dockerignore 加 docker-dev/docker-dev-data 排除（旧数据残留）
 2026-07-22 23:18:16 +08:00
augushong
0adc497818 docs(stack): restore docker-dev-sync as independent mode in docs 2026-07-22 22:47:46 +08:00
augushong
0a04181d12 revert(stack): un-merge docker-dev-sync, restore as independent B-route directory 
docker-dev 清理合并残留：去掉 rsync/mkdir/chmod、删 ulthon_admin_sync 服务、
删 .env(COMPOSE_PROFILES)、删 sync.sh、删 .dockerignore、去 SYNC_INTERVAL。
docker-dev-sync 恢复独立目录并 B-route 化（context: ../../..）。
两个模式各自独立、各自完整。
 2026-07-22 22:42:58 +08:00
augushong
be6fd9491b docs(stack): 新增迁移说明与 CHANGELOG 记录破坏性命令移除 2026-07-22 01:32:48 +08:00
augushong
28576def0a feat(stack): 合并 docker-dev-sync 到 docker-dev 配置，统一 Dockerfile 2026-07-22 01:27:52 +08:00
augushong
bed965a9b1 fix(stack): 修正构建上下文路径层级 ../../.. 并将 base-build 重命名为 author 2026-07-22 01:16:24 +08:00
augushong
62e72af93d feat(stack): B 路线构建上下文与卷配置方案（docker-serve/docker-dev/full） 2026-07-22 01:10:15 +08:00
augushong
560e0f6a5e docs(update-workflow): 以 B 路线检测替代 admin:stack:mode 2026-07-22 01:05:23 +08:00
augushong
bb602dccda chore(stack): 精简 stack.json 为纯元数据（schema v2） 2026-07-22 01:02:57 +08:00
augushong
50305dd29b ci(stack): 为 B 路线重写工作流并同步默认配置 2026-07-22 00:58:17 +08:00