feat: 迁移前端

Author: longsizhuo

.github/workflows/content-check.yml

@@ -7,24 +7,14 @@ permissions:
 on:
   pull_request:
     paths:
-      - "**/*.md"
-      - "**/*.mdx"
-      - "source.config.ts"
-      - "app/docs/**"
-      - "data/**"
-      - "tests/**"
-      - "lib/source.ts"
-      - "mdx-components.tsx"
-      - "package.json"
-      - "pnpm-lock.yaml"
-      - "next.config.mjs"
-      - "postcss.config.mjs"
-      - "tailwind.config.ts"
-      - "tsconfig.json"
+      - "frontend/**"
 
 jobs:
   check-content:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
     env:
       NEXT_TELEMETRY_DISABLED: "1"
       CI: "true"
@@ -41,6 +31,7 @@ jobs:
         with:
           node-version: 20
           cache: "pnpm"
+          cache-dependency-path: frontend/pnpm-lock.yaml
 
       # Verify pnpm version matches package.json packageManager field
       - name: Check pnpm version
@@ -56,10 +47,7 @@ jobs:
             echo "This indicates a pnpm version mismatch or corrupted lockfile"
             echo ""
             echo "Expected pnpm version from package.json:"
-            # Use multiple fallback methods to extract version
-            grep '"packageManager"' package.json | grep -o 'pnpm@[^"]*' || \
-              node -e "try { console.log(require('./package.json').packageManager || 'not specified') } catch(e) { console.log('Could not read') }" || \
-              echo "Could not extract version"
+            grep '"packageManager"' package.json | grep -o 'pnpm@[^"]*' || echo "not specified"
             echo ""
             echo "Actual pnpm version:"
             pnpm --version || echo "pnpm not found"

.github/workflows/deploy.yml

@@ -7,12 +7,19 @@ permissions:
 on:
   push:
     branches: [main]
+    paths:
+      - "frontend/**"
   pull_request:
+    paths:
+      - "frontend/**"
   workflow_dispatch:
 
 jobs:
   build:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
     env:
       NEXT_TELEMETRY_DISABLED: "1"
       CI: "true"
@@ -30,6 +37,7 @@ jobs:
         with:
           node-version: 20
           cache: pnpm
+          cache-dependency-path: frontend/pnpm-lock.yaml
 
       # Verify pnpm version matches package.json packageManager field
       - name: Check pnpm version
@@ -45,10 +53,7 @@ jobs:
             echo "This indicates a pnpm version mismatch or corrupted lockfile"
             echo ""
             echo "Expected pnpm version from package.json:"
-            # Use multiple fallback methods to extract version
-            grep '"packageManager"' package.json | grep -o 'pnpm@[^"]*' || \
-              node -e "try { console.log(require('./package.json').packageManager || 'not specified') } catch(e) { console.log('Could not read') }" || \
-              echo "Could not extract version"
+            grep '"packageManager"' package.json | grep -o 'pnpm@[^"]*' || echo "not specified"
             echo ""
             echo "Actual pnpm version:"
             pnpm --version || echo "pnpm not found"
@@ -73,23 +78,28 @@ jobs:
         run: |
           set -euo pipefail
 
+          # Note: we need to run git commands from the root but parse paths correctly
+          cd ..
           git fetch --depth=2 origin ${{ github.ref }} || true
           CHANGED="$(git diff --name-only HEAD~1 HEAD || true)"
-          CHANGED_DOCS="$(echo "$CHANGED" | grep -E '^(app/docs/|content/docs/).*\.(mdx?|tsx?)$' || true)"
+          # Updated regex to include frontend/ prefix
+          CHANGED_DOCS="$(echo "$CHANGED" | grep -E '^frontend/(app/docs/|content/docs/).*\.(mdx?|tsx?)$' || true)"
 
           URLS=()
 
           while IFS= read -r f; do
             [ -z "$f" ] && continue
-            if [[ "$f" =~ ^app/docs/(.*)/page\.(mdx|md|tsx|ts|jsx|js)$ ]]; then
+            # Match frontend/app/docs/path/page.tsx -> /docs/path
+            if [[ "$f" =~ ^frontend/app/docs/(.*)/page\.(mdx|md|tsx|ts|jsx|js)$ ]]; then
               slug="${BASH_REMATCH[1]}"
               URLS+=("$SITE_ORIGIN/docs/$slug")
             fi
           done <<< "$CHANGED_DOCS"
 
           while IFS= read -r f; do
             [ -z "$f" ] && continue
-            if [[ "$f" =~ ^content/docs/(.*)\.(md|mdx)$ ]]; then
+            # Match frontend/content/docs/path.md -> /docs/path
+            if [[ "$f" =~ ^frontend/content/docs/(.*)\.(md|mdx)$ ]]; then
               slug="${BASH_REMATCH[1]}"
               slug="${slug%/index}"
               URLS+=("$SITE_ORIGIN/docs/$slug")

.github/workflows/sync-uuid.yml

@@ -6,13 +6,13 @@ on:
       - main
       - feat/contributor
     paths:
-      - "app/docs/**"
-      - "scripts/uuid.mjs"
-      - "scripts/backfill-contributors.mjs"
-      - "package.json"
-      - "pnpm-lock.yaml"
+      - "frontend/app/docs/**"
+      - "frontend/scripts/uuid.mjs"
+      - "frontend/scripts/backfill-contributors.mjs"
+      - "frontend/package.json"
+      - "frontend/pnpm-lock.yaml"
       - ".github/workflows/sync-uuid.yml"
-      - "generated/doc-contributors.json"
+      - "frontend/generated/doc-contributors.json"
   workflow_dispatch: {}
 
 concurrency:
@@ -28,10 +28,13 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+    defaults:
+      run:
+        working-directory: frontend
     env:
       DATABASE_URL: ${{ secrets.DATABASE_URL }}
       GITHUB_TOKEN: ${{ secrets.GH_PAT }} # 供脚本调用 GitHub API 提升速率
-      DOCS_DIR: app/docs
+      DOCS_DIR: app/docs # 在 working-directory 为 frontend 时，这是相对路径
 
     steps:
       - uses: actions/checkout@v4
@@ -46,6 +49,7 @@ jobs:
         with:
           node-version: 20
           cache: "pnpm" # 顺便启用 pnpm 缓存，加速
+          cache-dependency-path: frontend/pnpm-lock.yaml
 
       # Verify pnpm version matches package.json packageManager field
       - name: Check pnpm version
@@ -67,11 +71,12 @@ jobs:
         uses: stefanzweifel/git-auto-commit-action@v5
         with:
           commit_message: "chore(docs): sync doc metadata [skip ci]" # ← 防循环
-          file_pattern: "app/docs/**/*.md app/docs/**/*.mdx generated/doc-contributors.json"
+          file_pattern: "frontend/app/docs/**/*.md frontend/app/docs/**/*.mdx frontend/generated/doc-contributors.json"
+          working_directory: . # git-auto-commit-action 建议在根目录运行以处理全局路径
 
       - name: Upload snapshot JSON
         uses: actions/upload-artifact@v4
         with:
           name: doc-contributors-snapshot
-          path: generated/doc-contributors.json
+          path: frontend/generated/doc-contributors.json
           if-no-files-found: ignore

.gitignore

@@ -1,61 +1,24 @@
-# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
-
-# dependencies
-/node_modules
-/.pnp
-.pnp.js
-.yarn/install-state.gz
-
-# testing
-/coverage
-
-# next.js
-/.next/
-/out/
-
-# production
-/build
-
-# misc
+# IDE & System
 .DS_Store
+.vscode/
+.idea/
+.cursor/
 *.pem
 
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# local env files
+# Environment (Source of Truth)
+.env
+.env.local
 .env*.local
 
-# vercel
-.vercel
-
-# typescript
-*.tsbuildinfo
-next-env.d.ts
+# Dependencies (Root level if any)
+node_modules/
+package-lock.json
+pnpm-lock.yaml
 
-# cursor
-.cursor
+# Testing
+coverage/
 
-# contentlayer
-.contentlayer
-
-# source
-.source
-
-# package管理
-.package-lock.json
-
-# Agents.md
-AGENTS.md
-
-# Environment variables
-.env
-
-# VS code
-.vscode
-/generated/prisma
-
-.idea
-.claude
+# Misc
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

public/git_assets/GIT_GUIDE.md backend/.gitkeeppublic/git_assets/GIT_GUIDE.md renamed to backend/.gitkeep

@@ -0,0 +1,22 @@
+# Next.js Build
+/.next/
+/out/
+/build/
+
+# Dependencies
+node_modules/
+
+# Local env files (These are symlinks, but we should still ignore them)
+.env*.local
+.env
+
+# TypeScript
+*.tsbuildinfo
+next-env.d.ts
+
+# Contentlayer & Source
+.contentlayer/
+.source/
+
+# Generated
+/generated/