chenxing
29d32eed6e
build / build-push (push) Successful in 58s
- widget_catalog：comp_type=1 内容在 front 工程（库里只登记键）、=2 内容存 content，全表无 url 字段 ⇒ 小组件链路彻底不再有「html 地址」；sch_id 只留字段与 visibleToSchool 过滤钩子（v1 全校一致）
- 新接口（真实路径按 /{platform} 展开为 /api/xxx）：getWidgetData?code=¶ms=（统一取数，未知 code 回空数据+msg 不抛 500）、getWidgetContent?code=（仅 comp_type=2 按需取正文，不塞进 getUserSettings 免每次进桌面下发全部 HTML）、GetWidgetCatalogList、SaveWidgetCatalog（content 走 JSON body）
- 管理端鉴权照抄 AppSettingController.checkAdmin（超管 type==1 或 roleId∈{2,5,7}，判定标准一字未改；该方法是 private 故复制逻辑），拒绝走 BizException(ErrorCode.FORBIDDEN)，按平台信封为 code=3 非 500
- getUserSettings：widgetAppList 改读自建表并增 code/compType、删 url，id/appId 同值以复用既有 widgetAppIds 存取与面板排序链路；saveUserWidget/toggleWidgetShow 未动
- 数据源按拍板走 L2 可溯源 mock（yunhai 9 工程检索课表/听评课零命中），字段逐一等于 design/widget-snapshots-old-bsch 旧接口口径，接入点以 // TODO 接入 oapi: 标注；本期无出站，故未注入 YschOpenCall（零手写签名代码）
- DDL：仓库无 migration 机制（ddl-auto=update），脚本按既有约定落 resources/sql/widget_catalog.sql，dev 自动建表、测试/生产需手工执行（INSERT IGNORE 可重复跑）
UserhomeService
本仓库由 projman 自动创建并注入 CI（
.gitea/workflows/build.yml）与 Dockerfile（docker/Dockerfile）。 推送代码到 main 分支即自动构建镜像并推送到 Nexus，projman 收到通知后建档待部署，由运维在 projman「后端发布」手动点部署。
首次推送本地代码到本仓库
目标：把本地已有代码推上去，同时保留 projman 注入的文件（
build.yml、Dockerfile）。
# 1. 进入本地代码目录
cd /your/local/code/dir
# 2. 初始化 git（目录已有 .git 也安全，git init 幂等无副作用）
git init
git branch -M main
# 3. 先把本地代码提交成一个 commit（关键！不提交直接 merge 会丢失本地代码）
git add -A
git commit -m "init local code"
# 4. 关联远程仓库（幂等：已存在 origin 则改地址，不报错）
git remote add origin http://gitea:3000/userhome/UserhomeService.git 2>/dev/null \
|| git remote set-url origin http://gitea:3000/userhome/UserhomeService.git
# 5. 拉取远程信息（只下载，不合并）
git fetch origin
# 6. 合并远程 main（关键步骤）
# 本地与远程是两条独立历史，需允许合并不相关历史。
# 此步会把 projman 注入的 build.yml 与 Dockerfile 合并进你的本地工作区。
git merge origin/main --allow-unrelated-histories -m "merge projman injected files"
# 7. 查看状态（确认 .gitea/workflows/build.yml、docker/Dockerfile 已在本地）
git status
# 8. 提交并推送
git add -A
git commit -m "sync local code" 2>/dev/null || true
git push origin main
推送后验证
push 触发 CI 构建，前往 Gitea 仓库 → Actions 查看日志；构建成功后镜像推送到 Nexus，projman 建档待部署，在 projman 应用详情「后端发布」手动点部署。
禁止写法（会导致注入文件被删）
git reset origin/main + git add -A 会把远程已注入、但你本地没有的文件（build.yml、Dockerfile）当作"删除"提交并推送，导致这些文件被删、CI 失败。务必用 git merge 而非 git reset，且 merge 前先提交本地代码。
关于 Dockerfile
projman 注入的 Dockerfile 仅在仓库不存在时写入；你自备的 Dockerfile 优先，不会被覆盖。