refactor: ♻️ migrate project structure to monorepo with turborepo- Move Next.js app to apps/DocFlow- Setup workspace root with pnpm-workspace.yaml- Configure turborepo for build orchestration- Update paths and environment variables (#287)

Author: xun082

.github/ISSUE_TEMPLATE/TASK.md

@@ -1,9 +1,9 @@
 ---
 name: 📋 需求任务
 about: 用于发布新的开发需求任务
-title: '[需求] 需求标题'
-labels: '待认领'
-assignees: ''
+title: "[需求] 需求标题"
+labels: "待认领"
+assignees: ""
 ---
 
 ## 需求描述

.github/workflows/build.yml

@@ -0,0 +1,56 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.2.0
+
+      - name: Extract version
+        id: version
+        run: |
+          VERSION="$(echo ${{ github.sha }} | cut -c1-7)"
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "📦 Version: $VERSION"
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_USERNAME }}
+          password: ${{ secrets.DOCKER_PASSWORD }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ secrets.DOCKER_USERNAME }}/docflow:latest
+            ${{ secrets.DOCKER_USERNAME }}/docflow:${{ steps.version.outputs.version }}
+          build-args: |
+            VERSION=${{ steps.version.outputs.version }}
+            GIT_COMMIT=${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64
+
+      - name: Build summary
+        run: |
+          echo "## 🐳 Docker Build Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- 📦 Version: \`${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "- 🐳 Image: [Docker Hub](https://hub.docker.com/r/${{ secrets.DOCKER_USERNAME }}/docflow)" >> $GITHUB_STEP_SUMMARY
+          echo "- 🏷️ Tags: \`latest\`, \`${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "- ⏰ Time: $(date -u '+%Y-%m-%d %H:%M:%S UTC')" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "> 💡 **Tip:** To deploy this version, create a \`release/*\` branch" >> $GITHUB_STEP_SUMMARY

.github/workflows/deploy.yml

@@ -1,59 +1,32 @@
-name: Deploy to Server via Docker Hub
+name: Deploy to Server
 
 on:
   push:
     branches:
-      - main
+      - 'release/**'
 
 jobs:
-  build-and-push:
+  deploy:
     runs-on: ubuntu-latest
-    outputs:
-      version: ${{ steps.version.outputs.version }}
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4.2.0
 
-      - name: Extract version
+      - name: Get latest image version
         id: version
         run: |
-          VERSION="$(echo ${{ github.sha }} | cut -c1-7)"
+          # 获取最新的短 commit SHA
+          VERSION="$(git rev-parse --short=7 HEAD)"
           echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "📦 Version: $VERSION"
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
-
-      - name: Log in to Docker Hub
-        uses: docker/login-action@v3
-        with:
-          username: ${{ secrets.DOCKER_USERNAME }}
-          password: ${{ secrets.DOCKER_PASSWORD }}
-
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
-        with:
-          context: .
-          push: true
-          tags: |
-            ${{ secrets.DOCKER_USERNAME }}/docflow:latest
-            ${{ secrets.DOCKER_USERNAME }}/docflow:${{ steps.version.outputs.version }}
-          cache-from: type=gha
-          cache-to: type=gha,mode=max
-          platforms: linux/amd64
+          echo "📦 Deploying Version: $VERSION"
 
-  deploy:
-    needs: build-and-push
-    runs-on: ubuntu-latest
-
-    steps:
       - name: Deploy to server via SSH
         uses: appleboy/ssh-action@v1.2.1
         env:
           DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
           DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
-          VERSION: ${{ needs.build-and-push.outputs.version }}
+          VERSION: ${{ steps.version.outputs.version }}
         with:
           host: ${{ secrets.SERVER_HOST }}
           username: ${{ secrets.SERVER_USERNAME }}
@@ -181,6 +154,7 @@ jobs:
         run: |
           echo "## 🚀 Deployment Summary" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
-          echo "- 📦 Version: \`${{ needs.build-and-push.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
+          echo "- 📦 Version: \`${{ steps.version.outputs.version }}\`" >> $GITHUB_STEP_SUMMARY
           echo "- 🐳 Image: [Docker Hub](https://hub.docker.com/r/${{ secrets.DOCKER_USERNAME }}/docflow)" >> $GITHUB_STEP_SUMMARY
+          echo "- 🌿 Branch: \`${{ github.ref_name }}\`" >> $GITHUB_STEP_SUMMARY
           echo "- ⏰ Time: $(date -u '+%Y-%m-%d %H:%M:%S UTC')" >> $GITHUB_STEP_SUMMARY

.gitignore

@@ -1,39 +1,46 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
+# Environment variables
 .env
+.env*.local
 
-# dependencies
-/node_modules
-/.pnp
+# Dependencies
+node_modules/
+.pnp
 .pnp.js
 
-# testing
-/coverage
+# Monorepo & Build tools
+.turbo/
+*.tsbuildinfo
 
-# next.js
-/.next/
-/out/
+# Build outputs
+dist/
+build/
+out/
+.next/
 
-# production
-/build
+# Testing
+coverage/
 
-# misc
-.DS_Store
-*.pem
+# Next.js
+next-env.d.ts
+
+# Vercel
+.vercel
 
-# debug
+# Debug logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+pnpm-debug.log*
 
-# local env files
-.env*.local
-
-# vercel
-.vercel
+# OS files
+.DS_Store
+*.pem
 
-# typescript
-*.tsbuildinfo
-next-env.d.ts
+# IDE
+.vscode/settings.json
+.idea/
 
+# Misc
 .hintrc

.husky/pre-commit

@@ -4,7 +4,7 @@
 set -e
 
 echo "🔍 Running lint check..."
-pnpm lint:ci
+pnpm lint
 
 echo "🎨 Running format check..."  
 pnpm format:ci

.npmrc

@@ -1,5 +1,11 @@
-public-hoist-pattern[]=*import-in-the-middle*
-public-hoist-pattern[]=*require-in-the-middle*
+# Monorepo settings
+auto-install-peers=true
+strict-peer-dependencies=false
+shamefully-hoist=false
 
-node-linker=hoisted
-shamefully-hoist=true
+# Performance
+prefer-frozen-lockfile=true
+engine-strict=true
+
+# Resolution
+resolution-mode=highest

.prettierignore

@@ -1,3 +1,6 @@
 dist/
 node_modules/
-pnpm-lock.yaml
+pnpm-lock.yaml
+.next/
+.turbo/
+coverage/

Dockerfile

@@ -9,7 +9,8 @@ RUN npm config set registry https://registry.npmmirror.com && \
 WORKDIR /app
 
 FROM base AS deps
-COPY package.json pnpm-lock.yaml ./
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY apps/DocFlow/package.json ./apps/DocFlow/package.json
 RUN pnpm install --frozen-lockfile --ignore-scripts
 
 FROM base AS builder
@@ -20,18 +21,21 @@ ARG GIT_COMMIT=unknown
 
 WORKDIR /app
 COPY --from=deps /app/node_modules ./node_modules
-COPY . .
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml turbo.json ./
+COPY apps/ ./apps/
+COPY packages/ ./packages/ 2>/dev/null || true
 
 # 构建时环境变量
 ENV NEXT_TELEMETRY_DISABLED=1
 ENV NODE_OPTIONS="--max-old-space-size=4096"
 
 RUN pnpm build && \
-    rm -rf .next/cache
+    rm -rf apps/DocFlow/.next/cache
 
 FROM base AS prod-deps
 WORKDIR /app
-COPY package.json pnpm-lock.yaml ./
+COPY package.json pnpm-lock.yaml pnpm-workspace.yaml ./
+COPY apps/DocFlow/package.json ./apps/DocFlow/package.json
 RUN pnpm install --frozen-lockfile --prod --ignore-scripts && \
     find node_modules -name "*.d.ts" -delete && \
     find node_modules -name "*.map" -delete && \
@@ -69,14 +73,17 @@ RUN apk add --no-cache libc6-compat && \
     adduser --system --uid 1001 nextjs
 
 COPY --from=prod-deps --chown=nextjs:nodejs /app/node_modules ./node_modules
-COPY --from=builder --chown=nextjs:nodejs /app/.next ./.next
-COPY --from=builder --chown=nextjs:nodejs /app/public ./public
+COPY --from=builder --chown=nextjs:nodejs /app/apps/DocFlow/.next ./apps/DocFlow/.next
+COPY --from=builder --chown=nextjs:nodejs /app/apps/DocFlow/public ./apps/DocFlow/public
+COPY --from=builder --chown=nextjs:nodejs /app/apps/DocFlow/package.json ./apps/DocFlow/package.json
 COPY --from=builder --chown=nextjs:nodejs /app/package.json ./package.json
+COPY --from=builder --chown=nextjs:nodejs /app/pnpm-workspace.yaml ./pnpm-workspace.yaml
 
 USER nextjs
 EXPOSE 3000
 
 HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
   CMD node -e "require('http').get('http://localhost:3000/api/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
 
-CMD ["node_modules/.bin/next", "start"]
+WORKDIR /app/apps/DocFlow
+CMD ["../../node_modules/.bin/next", "start"]