node.js&expressHW_肖裕杰_笃实44_2023011346

.github/pull_request_template.md

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

.github/workflows/README.md

@@ -0,0 +1,14 @@
+# Github 和 Docker Hub 相关网页设置
+
+### 前端(Github Pages)
+
+在你复刻的仓库中，进入设置标签页（https://github.com/[username]/web-workshop/settings），点击左边栏的 Pages，在 Build and deployment 下方的 Source，选择 Github Actions。意思是通过自定义的 action 来部署静态 Github Pages（与之相对的是根据仓库中的 markdown 文件自动部署）
+
+### 后端(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/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,74 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: frontend
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+defaults:
+  run:
+    working-directory: frontend
+
+jobs:
+  build:
+    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: ./frontend/yarn.lock
+
+      - name: Install dependencies
+        run: |
+          yarn install --frozen-lockfile
+
+      - name: Check grammar
+        run: |
+          yarn typecheck
+          yarn lint
+
+      - name: Build
+        run: |
+          yarn build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: "./frontend/build"
+
+  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@v4

.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

README.md

@@ -131,3 +131,43 @@ git clone <先前复制的仓库URI>
    ```bash
    git push --all
    ```
+
+### 作业提交
+每一讲的作业提交采用如下流程：
+- 本地修改对应分支
+- 提交修改到对应分支
+- 向本仓库对应分支提交PR
+- 关联PR到对应Issue
+- 查看作业批改结果
+##### 本地修改对应分支
+fork本仓库所有分支后，根据[Issue](https://github.com/eesast/web-workshop/issues)对应讲作业要求，在本地切换到对应分支进行修改
+```
+git checkout "01-HTML&CSS"
+```
+##### 提交修改到对应分支
+完成修改后，将改动提交到本地并推送到云端 Fork 仓库
+```
+git push origin "01-HTML&CSS"
+```
+##### 向本仓库对应分支提交PR
+打开在 GitHub 上 Fork 的仓库页面后，切换到刚刚推送的 对应分支（如 lesson1）
+
+点击 "Compare & pull request" 按钮，并在 PR 创建页面填写相关信息
+##### 关联PR到对应Issue
+在PR模板填写界面，需手动关联PR到对应Issue
+
+你可以在PR正文中手动关联对应Issue，方法是添加#ISSUE-NUMBER到正文后。例如，需要链接的Issue对应的id是4，则添加一行#4
+
+你也可以在PR编辑界面点击右上方的'Reference'，选择需要链接的PR，最终效果与上述方法相同
+<img width="837" height="369" alt="image" src="https://github.com/user-attachments/assets/1b7ac4eb-ae95-426e-b17c-cc0f1ce1e66d" />
+
+[示例PR](https://github.com/eesast/web-workshop/pull/12)
+
+关联完成后，提交PR，则作业提交完毕
+##### 查看作业批改结果
+作业由讲师批改后，对应 PR 会被打上标签：
+- accepted ✅：作业通过，PR 会被关闭。
+- require revision 🔄：需要修改，PR 保持 open 状态。
+
+
+若需修改，按 PR 下方的评论提示进行更改，然后重复 步骤 2 → 步骤 3 提交更新。

backend/Dockerfile

@@ -0,0 +1,30 @@
+# Builder stage
+FROM node:20 AS builder
+WORKDIR /home/node/app
+
+# Install Dependencies
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile --no-cache
+
+# Copy source code
+COPY . .
+
+# Build
+RUN yarn build
+
+
+# Runner stage
+FROM node:20-alpine AS runner
+WORKDIR /home/node/app
+ENV NODE_ENV=production
+
+# Install Production Dependencies
+COPY package.json yarn.lock ./
+RUN yarn install --frozen-lockfile --no-cache --production
+
+# Copy build files
+COPY --from=builder /home/node/app/build ./build
+
+# Expose port and run
+EXPOSE 8888
+CMD yarn serve