03 database

.github/pull_request_template.md

@@ -0,0 +1,9 @@
+### 2025暑培-网站作业提交
+#### 基本信息
+- **姓名**:
+- **班级**:
+- **学号**:
+
+#### 提交说明
+
+- [ ] 已阅读并理解本次作业要求  

.github/workflows/README.md

@@ -0,0 +1,16 @@
+# Github 和 Docker Hub 相关网页设置
+
+### 前端(Github Pages)
+
+在你复刻的仓库中，进入设置标签页（https://github.com/[username]/web-workshop/settings），点击左边栏的 Pages，在 Build and deployment 下方的 Source，选择 Github Actions。意思是通过自定义的 action 来部署静态 Github Pages（与之相对的是根据仓库中的 markdown 文件自动部署）
+
+本仓库最终版本的 Github Pages 根路径用于展示教学文档，`frontend.yml` 会先构建文档站，再把前端构建产物复制到 `demo/` 子路径。因此官方演示页面位于 [https://eesast.github.io/web-workshop/demo/](https://eesast.github.io/web-workshop/demo/)。如果你在自己的复刻仓库中沿用当前 workflow，前端页面对应地址通常是 `https://[username].github.io/web-workshop/demo/`。
+
+### 后端(Docker)
+
+1. 注册 Dockers Hub 账号（[Signup | Docker](https://app.docker.com/signup)），建议使用 Github 注册。如果使用其他方式注册，请将用户名与 Github 保持一致（大小写不敏感）
+2. 在 Docker Hub 设置界面的 Personal access tokens（个人访问 Token）（[Personal access tokens | Docker](https://app.docker.com/settings/personal-access-tokens)），新增一个 token（至少要有写权限）并复制下来
+3. 在 Github 上复刻仓库的设置页，点击左边栏的 Secrets and variables -> Actions，添加一个 Secret（即密钥，加密防护）和两个 Variables（即变量，明文显示）如下：
+   - [Secret] `DOCKERHUB_TOKEN`，值为之前复制的个人访问 Token
+   - [Variable] `DOCKERHUB_USERNAME`，值为你的 Docker Hub 账号名
+   - [Variable] `DOCKER_TAG`，值为你的 Docker 容器标识名，形如`<repo-name>:latest`，其中`repo-name`任意，不需要与仓库同名

.github/workflows/backend.yml

@@ -0,0 +1,72 @@
+name: backend
+
+on:
+  push:
+    branches: [ main ]
+
+permissions:
+  packages: write
+  contents: read
+  id-token: write
+
+defaults:
+  run:
+    working-directory: backend
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+          cache-dependency-path: ./backend/yarn.lock
+
+      - name: Install dependencies
+        run: |
+          yarn install --frozen-lockfile
+
+      - name: Check grammar
+        run: |
+          yarn typecheck
+
+  build:
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Downcase GitHub username
+        run: echo "USERNAME_LC=${USERNAME@L}" >> $GITHUB_ENV
+        env:
+          USERNAME: ${{ github.repository_owner }}
+
+      - name: Build and push docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: ./backend
+          push: true
+          tags: |
+            ghcr.io/${{ env.USERNAME_LC }}/${{ vars.DOCKER_TAG }}
+            ${{ vars.DOCKERHUB_USERNAME }}/${{ vars.DOCKER_TAG }}

.github/workflows/build-gh-pages.yml

@@ -0,0 +1,55 @@
+name: build-gh-pages
+
+on:
+  pull_request:
+    branches: ["main"]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+          cache-dependency-path: ./frontend/yarn.lock
+
+      - name: Convert TOC syntax
+        run: node assets/js/convert-toc.js
+
+      - name: Build documentation with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./
+          destination: ./_site
+
+      - name: Fix documentation site permissions
+        run: sudo chown -R "$(id -u):$(id -g)" ./_site
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: yarn install --frozen-lockfile
+
+      - name: Check grammar
+        working-directory: frontend
+        run: |
+          yarn typecheck
+          yarn lint
+
+      - name: Build
+        working-directory: frontend
+        run: yarn build
+
+      - name: Copy frontend demo into documentation site
+        working-directory: frontend
+        run: |
+          mkdir -p ../_site/demo
+          cp -R build/. ../_site/demo/

.github/workflows/electron.yml

@@ -0,0 +1,83 @@
+name: electron
+
+on:
+  push:
+    tags:
+      - v*
+
+permissions:
+  contents: write
+
+defaults:
+  run:
+    working-directory: frontend
+
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            output-file: |
+              ./frontend/electron/*.AppImage
+              ./frontend/electron/*.deb
+              ./frontend/electron/*.rpm
+              ./frontend/electron/*.tar.gz
+          - os: windows-latest
+            output-file: |
+              ./frontend/electron/*.exe
+          - os: macos-latest
+            output-file: |
+              ./frontend/electron/*.dmg
+              ./frontend/electron/*.zip
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+          cache-dependency-path: ./frontend/yarn.lock
+
+      - name: Install dependencies
+        run: |
+          yarn install --frozen-lockfile
+          yarn add electron electron-builder --dev
+
+      - name: Build
+        run: |
+          yarn build
+          yarn electron:build
+
+      - name: Upload executables for publish
+        uses: actions/upload-artifact@v4
+        with:
+          name: my-artifact-${{ matrix.os }}
+          path: ${{ matrix.output-file }}
+
+  release:
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Download executables
+        uses: actions/download-artifact@v4
+        with:
+          pattern: my-artifact-*
+          merge-multiple: true
+          path: dist
+
+      - name: Deploy to GitHub Releases
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ./dist/*
+          name: Release ${{ github.ref_name }}
+          generate_release_notes: true
+          prerelease: true

.github/workflows/frontend.yml

@@ -0,0 +1,84 @@
+# Build the documentation site and publish the frontend demo below /demo.
+name: frontend
+
+on:
+  push:
+    branches: ["main"]
+
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+          cache-dependency-path: ./frontend/yarn.lock
+
+      - name: Convert TOC syntax
+        run: node assets/js/convert-toc.js
+
+      - name: Build documentation with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: ./
+          destination: ./_site
+
+      - name: Fix documentation site permissions
+        run: sudo chown -R "$(id -u):$(id -g)" ./_site
+
+      - name: Install dependencies
+        working-directory: frontend
+        run: yarn install --frozen-lockfile
+
+      - name: Check grammar
+        working-directory: frontend
+        run: |
+          yarn typecheck
+          yarn lint
+
+      - name: Build
+        working-directory: frontend
+        run: yarn build
+
+      - name: Copy frontend demo into documentation site
+        working-directory: frontend
+        run: |
+          mkdir -p ../_site/demo
+          cp -R build/. ../_site/demo/
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./_site"
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -5,5 +5,8 @@ node_modules
 
 build
 electron
+_site
+.jekyll-cache
+.sass-cache
 
 .local.env

.mergify.yml

@@ -0,0 +1,9 @@
+pull_request_rules:
+  - name: 🏷️ Label homework
+    description: Label a homework with 'homework' label by detecting keyword
+    conditions:
+      - body~=作业提交
+    actions:
+      label:
+        add:
+          - homework

404.md

@@ -0,0 +1,5 @@
+# Unavailable
+
+This resource is unavailable.
+
+## [Back to Home](./)