chore(docs): docs/ 目录全面重新编号 + 重组

**重构前**（旧编号 02-11）： - docs/02-产品需求/ → 00 产品规划/PRD - docs/03-技术架构/ → 01-05 子目录散落 - docs/04-原型设计/ → 01-02 产品设计（HTML 原型） - docs/05-原型设计/ → screens/ - docs/06-测试素材/ → 02-E2E / 03-功能 / 04-版本测试 - docs/07-项目管理/ → 任务说明书/日报/计划 - docs/08-安全审计/ → 审计报告 - docs/09-堡垒运维/ → toolbox / deploy - docs/10-项目管理/ → 任务说明书（重复） - docs/11-历史归档/ → deploy-nas-archived **重构后**（新编号 00-07，语义化）： - docs/00-产品开发流程与文档管理规范.md - docs/00-版本迭代总览.md - docs/01-产品文档/ （PRD/原型/认证/会话/AI 服务/坐席/集成） - docs/02-技术文档/ （技术方案/架构图/重构记录/前端改造/实现配置） - docs/03-测试文档/ （E2E/功能用例/版本报告/缺陷单） - docs/04-运维文档/ （部署运维/运维指南） - docs/05-运营文档/ （品牌推广/用户手册） - docs/06-安全审计/ （审计报告） - docs/07-项目管理/ （任务说明书/日报/计划/看板） **净收益**： - 目录编号与产品文档管理规范对齐（按文档阶段 01-07 编号） - 消除 02-产品需求与 10-项目管理的编号重叠 - 子目录按文档类型分组（如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录） - 把运维/安全/项目管理从 0X 散落改为 04/06/07 合计 494 文件 + 78495 行 / - 14076 行
2026-08-03 18:46:55 +08:00
parent 3a44141eac
commit 44e77dcb0e
494 changed files with 78494 additions and 14075 deletions
@@ -0,0 +1,138 @@
+# =============================================================================
+# 企微IT智能服务台 — Nginx 配置（NAS + Cloudflare Tunnel 版）
+# =============================================================================
+# 与标准 nginx.conf 的区别：
+#   1. 移除 / 根路径反代到 IT 数据查询平台（NAS 上没有此服务）
+#   2. 增加 Cloudflare 真实 IP 还原（CF-Connecting-IP）
+#   3. 增加 HSTS 和安全头（通过 Tunnel 时客户端是 HTTPS）
+#   4. 增加 /api/wecom/callback 路径用于企微消息回调
+# =============================================================================
+
+events {
+    worker_connections 1024;
+}
+
+http {
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    # ------------------------------------------------------------------
+    # 日志格式（增加 CF 真实 IP）
+    # ------------------------------------------------------------------
+    log_format main '$http_x_forwarded_for - $remote_user [$time_local] "$request" '
+                    '$status $body_bytes_sent "$http_referer" '
+                    '"$http_user_agent"';
+
+    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 50m;   # 支持文件上传（企微媒体文件）
+
+    # ------------------------------------------------------------------
+    # Gzip 压缩（前端静态资源）
+    # ------------------------------------------------------------------
+    gzip            on;
+    gzip_vary      on;
+    gzip_min_length 1024;
+    gzip_types      text/plain text/css text/xml text/javascript
+                   application/javascript application/xml+rss
+                   application/json application/ld+json;
+
+    # =================================================================
+    # 上游服务定义（Docker 内部网络）
+    # =================================================================
+    upstream backend_api {
+        server backend:8000;
+    }
+
+    # =================================================================
+    # 主服务：监听 80 端口（Cloudflare Tunnel 终止 SSL，容器内走 HTTP）
+    # =================================================================
+    server {
+        listen 80;
+        server_name itdesk.amanzac.com;
+
+        # ------------------------------------------------------------------
+        # 安全头（通过 Cloudflare Tunnel 时客户端是 HTTPS）
+        # ------------------------------------------------------------------
+        # 告诉浏览器只通过 HTTPS 访问（通过 Cloudflare 的 HSTS 配置更佳）
+        add_header X-Content-Type-Options "nosniff" always;
+        add_header X-Frame-Options "SAMEORIGIN" always;
+        add_header X-XSS-Protection "1; mode=block" always;
+
+        # ------------------------------------------------------------------
+        # 健康检查端点（用于 Docker healthcheck）
+        # ------------------------------------------------------------------
+        location = /itdesk/health {
+            access_log off;
+            return 200 "healthy\n";
+            add_header Content-Type text/plain;
+        }
+
+        # ------------------------------------------------------------------
+        # H5 员工端 — /itdesk/
+        # ------------------------------------------------------------------
+        location /itdesk/ {
+            alias /usr/share/nginx/html/itdesk/;
+            index index.html;
+            try_files $uri /itdesk/index.html;
+        }
+
+        # ------------------------------------------------------------------
+        # 坐席工作台 — /itagent/
+        # ------------------------------------------------------------------
+        location /itagent/ {
+            alias /usr/share/nginx/html/itagent/;
+            index index.html;
+            try_files $uri /itagent/index.html;
+        }
+
+        # ------------------------------------------------------------------
+        # 后端 API — /api/
+        # ------------------------------------------------------------------
+        location /api/ {
+            proxy_pass http://backend_api/;
+            proxy_set_header Host $host;
+            # Cloudflare 真实 IP 还原
+            proxy_set_header X-Real-IP $http_cf_connecting_ip;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            # Cloudflare Tunnel 终止 SSL，告知后端原始协议是 HTTPS
+            proxy_set_header X-Forwarded-Proto https;
+
+            # 超时设置（AI 回复可能较慢）
+            proxy_connect_timeout 60s;
+            proxy_send_timeout    300s;
+            proxy_read_timeout    300s;
+        }
+
+        # ------------------------------------------------------------------
+        # WebSocket — /ws/（坐席端实时通信）
+        # ------------------------------------------------------------------
+        location /ws/ {
+            proxy_pass http://backend_api;
+            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 $http_cf_connecting_ip;
+            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto https;
+            proxy_read_timeout 86400s;  # WebSocket 长连接
+        }
+
+        # ------------------------------------------------------------------
+        # 默认路径 — 重定向到 H5 员工端
+        # ------------------------------------------------------------------
+        location = / {
+            return 302 /itdesk/;
+        }
+    }
+}