Initial commit: 浼佷笟寰俊 AI 鏈哄櫒浜哄姪鐞?MVP

Co-authored-by: Cursor <cursoragent@cursor.com>

deploy/docker/admin.Dockerfile

@@ -0,0 +1,52 @@
+# 生产环境 Admin Dockerfile（最小构建）
+# 用途：构建优化的 Next.js 生产镜像
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# 设置 npm 镜像（可选，根据网络情况）
+ARG NPM_REGISTRY=https://registry.npmjs.org
+RUN npm config set registry ${NPM_REGISTRY}
+
+# 复制依赖文件
+COPY admin/package.json admin/package-lock.json* ./
+
+# 安装依赖
+RUN npm ci --legacy-peer-deps --only=production
+
+# 复制源代码
+COPY admin/ .
+
+# 构建 Next.js 应用
+ENV NEXT_TELEMETRY_DISABLED=1
+RUN npm run build
+
+# 生产镜像
+FROM node:20-alpine
+
+WORKDIR /app
+
+# 从 builder 复制构建产物
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+COPY --from=builder /app/public ./public
+
+# 设置环境变量
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV NEXT_TELEMETRY_DISABLED=1
+
+# 创建非 root 用户
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nextjs -u 1001 && \
+    chown -R nextjs:nodejs /app
+
+USER nextjs
+
+EXPOSE 3000
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+    CMD node -e "require('http').get('http://localhost:3000', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})" || exit 1
+
+CMD ["node", "server.js"]

deploy/docker/backend.Dockerfile

@@ -0,0 +1,46 @@
+# 生产环境 Backend Dockerfile
+# 用途：构建优化的生产镜像
+FROM python:3.12-slim AS builder
+
+WORKDIR /app
+
+# 安装构建依赖
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    && rm -rf /var/lib/apt/lists/*
+
+# 复制依赖文件
+COPY backend/requirements.txt .
+
+# 安装 Python 依赖
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+# 生产镜像
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# 从 builder 复制已安装的依赖
+COPY --from=builder /root/.local /root/.local
+
+# 复制应用代码
+COPY backend/ .
+
+# 设置环境变量
+ENV PYTHONPATH=/app
+ENV PATH=/root/.local/bin:$PATH
+
+# 创建非 root 用户（安全最佳实践）
+RUN useradd -m -u 1000 appuser && \
+    chown -R appuser:appuser /app
+
+USER appuser
+
+EXPOSE 8000
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=10s --start-period=40s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/api/health')" || exit 1
+
+# 启动命令：先执行数据库迁移，再启动服务
+CMD ["sh", "-c", "alembic upgrade head && uvicorn app.main:app --host 0.0.0.0 --port 8000 --workers 2"]

deploy/docker/nginx.conf

@@ -0,0 +1,138 @@
+# 生产环境 Nginx 配置
+# 用途：反向代理 + HTTPS 支持
+
+events {
+    worker_connections 1024;
+    use epoll;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    # 日志格式
+    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
+                    '$status $body_bytes_sent "$http_referer" '
+                    '"$http_user_agent" "$http_x_forwarded_for"';
+
+    access_log /var/log/nginx/access.log main;
+    error_log /var/log/nginx/error.log warn;
+
+    # 性能优化
+    sendfile on;
+    tcp_nopush on;
+    tcp_nodelay on;
+    keepalive_timeout 65;
+    types_hash_max_size 2048;
+    client_max_body_size 20M;
+
+    # Gzip 压缩
+    gzip on;
+    gzip_vary on;
+    gzip_proxied any;
+    gzip_comp_level 6;
+    gzip_types text/plain text/css text/xml text/javascript application/json application/javascript application/xml+rss;
+
+    # Upstream 定义
+    upstream backend {
+        server backend:8000;
+        keepalive 32;
+    }
+
+    upstream admin {
+        server admin:3000;
+        keepalive 32;
+    }
+
+    # HTTP → HTTPS 重定向
+    server {
+        listen 80;
+        server_name _;
+
+        # Let's Encrypt 验证路径（用于证书申请和续期）
+        location /.well-known/acme-challenge/ {
+            root /var/www/certbot;
+            try_files $uri =404;
+        }
+
+        # 健康检查（允许 HTTP 访问）
+        location /health {
+            proxy_pass http://backend/api/health;
+            access_log off;
+        }
+
+        # 其他请求重定向到 HTTPS
+        location / {
+            return 301 https://$host$request_uri;
+        }
+    }
+
+    # HTTPS 服务器
+    server {
+        listen 443 ssl http2;
+        server_name _;
+
+        # SSL 证书配置（Let's Encrypt）
+        # 注意：首次部署时，这些路径可能不存在，需要先配置证书
+        # 证书配置步骤见 docs/deploy.md
+        ssl_certificate /etc/letsencrypt/live/_/fullchain.pem;
+        ssl_certificate_key /etc/letsencrypt/live/_/privkey.pem;
+
+        # SSL 安全配置
+        ssl_protocols TLSv1.2 TLSv1.3;
+        ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
+        ssl_prefer_server_ciphers on;
+        ssl_session_cache shared:SSL:10m;
+        ssl_session_timeout 10m;
+
+        # HSTS（可选，生产环境推荐）
+        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
+
+        # /api -> backend
+        location /api/ {
+            proxy_pass http://backend;
+            proxy_http_version 1.1;
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_set_header Connection "";
+            proxy_read_timeout 30s;
+            proxy_connect_timeout 10s;
+            proxy_send_timeout 30s;
+        }
+
+        # 健康检查
+        location /health {
+            proxy_pass http://backend/api/health;
+            access_log off;
+        }
+
+        # 其余 -> admin（如果 admin 未上线，返回静态占位页）
+        location / {
+            # 如果 admin 服务不可用，返回占位页
+            # 可以通过检查 admin 服务状态来决定
+            proxy_pass http://admin;
+            proxy_http_version 1.1;
+            proxy_set_header Upgrade $http_upgrade;
+            proxy_set_header Connection "upgrade";
+            proxy_set_header Host $host;
+            proxy_set_header X-Real-IP $remote_addr;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto $scheme;
+            proxy_read_timeout 30s;
+            proxy_connect_timeout 10s;
+            proxy_send_timeout 30s;
+
+            # 如果 admin 服务不可用，返回 503 或静态占位页
+            # 可以通过 error_page 配置实现
+            error_page 502 503 504 = @admin_fallback;
+        }
+
+        # Admin 服务不可用时的占位页
+        location @admin_fallback {
+            default_type text/html;
+            return 503 '<!DOCTYPE html><html><head><title>Admin 服务维护中</title></head><body><h1>Admin 服务维护中</h1><p>管理后台暂时不可用，请稍后再试。</p></body></html>';
+        }
+    }
+}