feat: web app, CI, and GitHub Actions multi-platform release

Made-with: Cursor

Author: Yikuanzz

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - master
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: go mod verify
+        run: go mod verify
+
+      - name: go vet
+        run: go vet ./...
+
+      - name: go test
+        run: go test ./...
+
+      - name: Verify offline static assets
+        run: go run ./scripts/check_offline_urls.go

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    env:
+      VERSION: ${{ github.ref_name }}
+      LDFLAGS: -s -w
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - name: Verify offline static assets
+        run: go run ./scripts/check_offline_urls.go
+
+      - name: Build and archive
+        run: |
+          set -euo pipefail
+          mkdir -p dist build
+          pack_tar() {
+            local goos=$1 goarch=$2
+            local slug="mini-dba-${VERSION}-${goos}-${goarch}"
+            local dir="build/${slug}"
+            rm -rf "${dir}"
+            mkdir -p "${dir}"
+            GOOS="${goos}" GOARCH="${goarch}" CGO_ENABLED=0 \
+              go build -ldflags="${LDFLAGS}" -o "${dir}/mini-dba" .
+            cp LICENSE README.md config.example.yaml "${dir}/"
+            tar -czf "dist/${slug}.tar.gz" -C "${dir}" .
+          }
+          pack_zip() {
+            local goos=$1 goarch=$2
+            local slug="mini-dba-${VERSION}-${goos}-${goarch}"
+            local dir="build/${slug}"
+            rm -rf "${dir}"
+            mkdir -p "${dir}"
+            GOOS="${goos}" GOARCH="${goarch}" CGO_ENABLED=0 \
+              go build -ldflags="${LDFLAGS}" -o "${dir}/mini-dba.exe" .
+            cp LICENSE README.md config.example.yaml "${dir}/"
+            (cd "${dir}" && zip -q -r "../../dist/${slug}.zip" .)
+          }
+          pack_tar linux amd64
+          pack_tar linux arm64
+          pack_zip windows amd64
+          pack_zip windows arm64
+          pack_tar darwin amd64
+          pack_tar darwin arm64
+          ( cd dist && sha256sum *.tar.gz *.zip > "mini-dba_${VERSION}_checksums.txt" )
+
+      - name: Publish GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.ref_name }}
+          files: |
+            dist/*.tar.gz
+            dist/*.zip
+            dist/mini-dba_*_checksums.txt
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

AGENT.md

@@ -4,48 +4,52 @@
 
 ## 产品定位
 
-- **Go 单二进制**，内网轻量 MySQL 运维 Web：**执行 SQL**、表元数据、分页浏览、多连接（DSN）配置。
-- **`config.yaml`**：`secret_key`（网页登录 / 后续 API 放行）、`databases`（DSN）、`readonly` 等。
-- **前端**：MUI 取向的 Material 风，服务端模板 + 随包静态资源（无公网 CDN）；当前 **`web/demo/`** 为定稿用静态 Demo，**`cmd/demo`** 提供登录与静态托管。
+- **Go 单二进制**，内网轻量 MySQL 运维 Web：**执行 SQL**、表列表、表结构、分页浏览、多连接（DSN）与 **`/settings` 保存写回 `config.yaml`**。
+- **`config.yaml`**：`secret_key`（`/login` 与会话 Cookie；亦可 **`X-MiniDBA-Secret`** / **`Authorization: Bearer`**）、`databases`（DSN）、`readonly`、`max_result_rows` 等。
+- **前端**：`html/template` + [`web/static/css/theme.css`](web/static/css/theme.css)；**`go:embed`** 打包 `web/templates` 与 `web/static`。历史目录 **`web/demo/`** 仅作可选参考，正式路由以主程序为准。
 
-## 仓库结构（预期演进）
+## 仓库结构
 
 ```text
-main.go              # 正式入口（当前占位）
-cmd/demo/            # UI 预览：secret_key 登录 + 静态页
-internal/            # 正式开发：handler / service / dao / config（待建）
-web/demo/            # 静态 Demo HTML
-web/static/css/      # theme.css，可迁模板后复用
-docs/DESIGN.md       # 设计规格
-config.example.yaml  # 可提交的示例配置（复制为 config.yaml）
+main.go              # 入口：-config 指定 yaml
+internal/
+  auth/              # HMAC 会话、Header 放行
+  csrf/              # Double-submit Cookie
+  config/            # 加载/校验/原子保存
+  dbmgr/             # 连接池与热重载
+  server/            # 路由与页面
+  sqlrun/            # 只读/黑名单/执行
+web/templates/       # 布局与各页
+web/static/          # 主题 CSS
+docs/DESIGN.md
+config.example.yaml
 ```
 
 ## 本地命令
 
 | 用途 | 命令 |
 |------|------|
-| UI Demo | 根目录：复制 `config.example.yaml` → `config.yaml` 并设 `secret_key`，再 `task demo` 或 `go run ./cmd/demo` |
-| Demo 监听 / 配置 | `MINIDBA_DEMO_ADDR`、`MINIDBA_CONFIG`（默认 `config.yaml`） |
-| 格式化 | `task golangci:fmt` 或 `go fmt ./...` |
-| 主程序占位 | `task run` → `go run main.go` |
+| 运行 | 复制 `config.example.yaml` → `config.yaml`，`task run` 或 `go run . -config config.yaml` |
+| 测试 | `go test ./...` |
+| Linux 构建 | `task build` → `./release/minidba` |
+| 格式化 | `task golangci:fmt` / `go fmt ./...` |
 
-## 配置与密钥
+## 配置说明
 
-- **`config.yaml` 已加入 `.gitignore`，勿提交。** 团队仅用 **`config.example.yaml`** 入库。
-- 含真实 `secret_key`、DSN 密码的文件限制权限，与设计文档 §7 一致。
+- **`config.yaml` 勿提交**（见 `.gitignore`）；团队以 **`config.example.yaml`** 为范本。
+- **`config.Save` 整文件重写后 YAML 注释会丢失**（MVP 已知限制）。
+- 修改 **`secret_key` 仅手改文件并重启进程**，设置页不轮换该字段。
 
 ## 编码约定
 
-- **Go 版本**：见 `go.mod`。
-- **改动范围**：与设计/MVP 相关；避免无关大范围重构。
-- **依赖**：新增依赖保持理由清晰；离线构建与设计 §4 一致。
-- **正式 HTTP**：设计文档 §9（`/login`、`/logout`、`/query`、`/settings` 等）；Demo 路由以 `cmd/demo` 为准直至合并进主程序。
+- 改动与设计/MVP 对齐；避免无关大范围重构。
+- 所有 **POST**（除 `/login`）需 **CSRF**；业务接口需 **`secret_key` 会话或 Header**。
 
 ## 代理工作协议（建议）
 
-1. 接到需求时先核对 **`docs/DESIGN.md`** 对应章节。
+1. 接到需求时先核对 **`docs/DESIGN.md`**。
 2. 改配置模型或安全行为时，同步更新 **设计文档 + `config.example.yaml`**。
-3. UI 变更可先对齐 **`web/demo`** 或 **`web/static/css/theme.css`**，再接入 `html/template`。
+3. 样式以 **`theme.css`** 与现有模板块为准。
 
 ---
 

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MiniDBA contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,24 @@
+# MiniDBA
+
+内网场景下的轻量 MySQL Web 运维小工具（Go，单二进制 + 本地配置）。设计说明见 [docs/DESIGN.md](docs/DESIGN.md)。
+
+## 运行（开发）
+
+```bash
+go run . -config config.yaml
+```
+
+或使用 [Task](https://taskfile.dev/)：
+
+```bash
+task run
+```
+
+从 `config.example.yaml` 复制为 `config.yaml`，设置 `secret_key` 与 `databases`。
+
+## 构建与发版
+
+- 本地 Linux amd64：`task build`
+- 发版流程（GitHub Actions，推送 `v*` tag）：见 [docs/RELEASE.md](docs/RELEASE.md)
+
+预编译包见 **GitHub Releases**。

Taskfile.yaml

@@ -3,42 +3,42 @@
 version: "3"
 
 tasks:
-  demo:
-    desc: "预览 UI 静态 Demo（127.0.0.1:18899，须在仓库根目录）"
-    cmds:
-      - go run ./cmd/demo
-
   run:
-    desc: "启动应用"
+    desc: "启动 MiniDBA（默认读取 ./config.yaml）"
     cmds:
       - task golangci:fmt
-      - go run main.go
-
+      - go run . -config config.yaml
 
   build:
-    desc: "构建 Linux 二进制（从任意平台交叉编译）"
+    desc: "构建 Linux 单二进制（嵌入模板与静态资源）"
     env:
       CGO_ENABLED: "0"
       GOOS: "linux"
       GOARCH: "amd64"
     cmds:
       - task: golangci:fmt
       - go env GOOS GOARCH CGO_ENABLED
-      - go build -ldflags="-s -w" -o ./release ./main.go
-      # - docker build -t backend_admin:latest .
-      # - docker save -o ./docker/registry/images/backend_admin.tar backend_admin:latest
+      - go build -ldflags="-s -w" -o ./release/mini-dba .
+
+  release:verify-offline:
+    desc: "检查 web 模板与静态资源是否引用公网字体 CDN（与 CI 门禁一致）"
+    cmds:
+      - go run ./scripts/check_offline_urls.go
+
+  release:tag:
+    desc: "创建并推送版本 tag（触发 GitHub Release）；用法 task release:tag VERSION=v0.1.0"
+    requires:
+      vars: [VERSION]
+    cmds:
+      - git tag -a {{.VERSION}} -m "Release {{.VERSION}}"
+      - git push origin {{.VERSION}}
 
-  # golangci-lint 检查
   golangci:lint:
     desc: "运行 golangci-lint 检查"
     cmds:
       - golangci-lint run
 
-  # golangci-lint 检查
   golangci:fmt:
     desc: "运行 golangci-lint 格式化"
     cmds:
       - go fmt ./...
-
- 
-