From 616f9bd8c6b9dd8d2013c1d78ff0ee6aa6cb5da5 Mon Sep 17 00:00:00 2001
From: cryptocommuniums-afk <cryptocommuniums@gmail.com>
Date: Mon, 2 Feb 2026 10:12:26 +0800
Subject: [PATCH] refactor: move project under backend

---
 .gitignore                                           |  5 ++---
 backend/.gitignore                                   |  3 +++
 README.md => backend/README.md                       |  2 ++
 {app => backend/app}/.env                            |  2 +-
 {app => backend/app}/package-lock.json               |  0
 {app => backend/app}/package.json                    |  0
 {app => backend/app}/src/public/app.js               | 11 +++++++++--
 {app => backend/app}/src/public/docs/index.html      |  6 +++---
 {app => backend/app}/src/public/index.html           |  6 +++---
 {app => backend/app}/src/public/openapi.json         |  2 +-
 {app => backend/app}/src/public/styles.css           |  0
 {app => backend/app}/src/server.js                   |  0
 {app => backend/app}/src/storage.js                  |  0
 {app => backend/app}/src/utils/rpc.js                |  0
 {app => backend/app}/src/watchers/btcWatcher.js      |  0
 {app => backend/app}/src/watchers/evmWatcher.js      |  0
 {infra => backend/infra}/docker/btcpay-src           |  0
 {infra => backend/infra}/docker/btcpay/.env.example  |  0
 .../infra}/docker/btcpay/docker-compose.yml          |  0
 {infra => backend/infra}/docker/keagate-src          |  0
 {infra => backend/infra}/docker/keagate/local.json   |  2 +-
 {infra => backend/infra}/docker/x402-rs              |  0
 .../infra}/nginx/sites-enabled/capay.conf            | 12 ++++++++++--
 {x402 => backend/x402}/facilitator/.env              |  0
 {x402 => backend/x402}/facilitator/config.json       |  0
 {x402 => backend/x402}/facilitator/networks.json     |  0
 {x402 => backend/x402}/facilitator/tokens.json       |  0
 27 files changed, 35 insertions(+), 16 deletions(-)
 create mode 100644 backend/.gitignore
 rename README.md => backend/README.md (94%)
 rename {app => backend/app}/.env (96%)
 rename {app => backend/app}/package-lock.json (100%)
 rename {app => backend/app}/package.json (100%)
 rename {app => backend/app}/src/public/app.js (95%)
 rename {app => backend/app}/src/public/docs/index.html (91%)
 rename {app => backend/app}/src/public/index.html (97%)
 rename {app => backend/app}/src/public/openapi.json (99%)
 rename {app => backend/app}/src/public/styles.css (100%)
 rename {app => backend/app}/src/server.js (100%)
 rename {app => backend/app}/src/storage.js (100%)
 rename {app => backend/app}/src/utils/rpc.js (100%)
 rename {app => backend/app}/src/watchers/btcWatcher.js (100%)
 rename {app => backend/app}/src/watchers/evmWatcher.js (100%)
 rename {infra => backend/infra}/docker/btcpay-src (100%)
 rename {infra => backend/infra}/docker/btcpay/.env.example (100%)
 rename {infra => backend/infra}/docker/btcpay/docker-compose.yml (100%)
 rename {infra => backend/infra}/docker/keagate-src (100%)
 rename {infra => backend/infra}/docker/keagate/local.json (91%)
 rename {infra => backend/infra}/docker/x402-rs (100%)
 rename {infra => backend/infra}/nginx/sites-enabled/capay.conf (91%)
 rename {x402 => backend/x402}/facilitator/.env (100%)
 rename {x402 => backend/x402}/facilitator/config.json (100%)
 rename {x402 => backend/x402}/facilitator/networks.json (100%)
 rename {x402 => backend/x402}/facilitator/tokens.json (100%)

diff --git a/.gitignore b/.gitignore
index d0fa236..9fda91c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,2 @@
-app/node_modules/
-app/data/
-*.log
+# Local artifacts created before moving into backend/
+app/
diff --git a/backend/.gitignore b/backend/.gitignore
new file mode 100644
index 0000000..d0fa236
--- /dev/null
+++ b/backend/.gitignore
@@ -0,0 +1,3 @@
+app/node_modules/
+app/data/
+*.log
diff --git a/README.md b/backend/README.md
similarity index 94%
rename from README.md
rename to backend/README.md
index 912da86..2e421b2 100644
--- a/README.md
+++ b/backend/README.md
@@ -24,6 +24,7 @@ npm run dev
 ```
 
 服务默认监听 `:3001`（可在 `app/.env` 修改）。
+通过域名访问时统一前缀为：`https://capay.hao.work/backend`。
 
 ### 免费套餐低频监控
 在 `app/.env` 中已设置：
@@ -35,6 +36,7 @@ npm run dev
 支持多个 Alchemy 免费 key：使用 `ALCHEMY_API_KEYS=key1,key2`，系统会按轮询周期进行轮转调用，降低单 key 的频率。
 
 ## API 说明（简化版）
+域名访问时请在路径前加 `/backend` 前缀（例如：`/backend/payments/orders`）。
 ### 1) 开通商户
 `POST /merchants`
 ```json
diff --git a/app/.env b/backend/app/.env
similarity index 96%
rename from app/.env
rename to backend/app/.env
index 15fdbb3..0d8b275 100644
--- a/app/.env
+++ b/backend/app/.env
@@ -1,5 +1,5 @@
 APP_PORT=3001
-APP_HOST=https://capay.hao.work
+APP_HOST=https://capay.hao.work/backend
 PLAN=free
 ADMIN_API_KEY=whoami139
 
diff --git a/app/package-lock.json b/backend/app/package-lock.json
similarity index 100%
rename from app/package-lock.json
rename to backend/app/package-lock.json
diff --git a/app/package.json b/backend/app/package.json
similarity index 100%
rename from app/package.json
rename to backend/app/package.json
diff --git a/app/src/public/app.js b/backend/app/src/public/app.js
similarity index 95%
rename from app/src/public/app.js
rename to backend/app/src/public/app.js
index 3afcf9d..9e8c7ce 100644
--- a/app/src/public/app.js
+++ b/backend/app/src/public/app.js
@@ -21,7 +21,9 @@ const curlTrackTx = document.getElementById('curl-track-tx');
 const webhookTip = document.getElementById('webhook-tip');
 
 const STORAGE_KEY = 'capay_admin_key';
-const baseUrl = window.location.origin;
+const basePath = window.location.pathname.replace(/\/[^/]*$/, '/').replace(/\/+$/, '');
+const apiBase = basePath || '';
+const baseUrl = `${window.location.origin}${apiBase}`;
 
 function setStatus(text, ok) {
   statusText.textContent = text;
@@ -43,13 +45,18 @@ function setAdminKey(value) {
   localStorage.setItem(STORAGE_KEY, value);
 }
 
+function withBase(path) {
+  if (!apiBase) return path;
+  return `${apiBase}${path}`;
+}
+
 async function request(path, options = {}) {
   const headers = options.headers ? { ...options.headers } : {};
   const adminKey = getAdminKey();
   if (adminKey) {
     headers['x-admin-key'] = adminKey;
   }
-  const res = await fetch(path, { ...options, headers });
+  const res = await fetch(withBase(path), { ...options, headers });
   if (!res.ok) {
     const text = await res.text();
     let message = text;
diff --git a/app/src/public/docs/index.html b/backend/app/src/public/docs/index.html
similarity index 91%
rename from app/src/public/docs/index.html
rename to backend/app/src/public/docs/index.html
index dc41deb..149452d 100644
--- a/app/src/public/docs/index.html
+++ b/backend/app/src/public/docs/index.html
@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Capay API Docs</title>
     <link rel="stylesheet" href="https://unpkg.com/swagger-ui-dist@5/swagger-ui.css" />
-    <link rel="stylesheet" href="/styles.css" />
+    <link rel="stylesheet" href="../styles.css" />
     <style>
       .docs-header {
         max-width: 1180px;
@@ -41,7 +41,7 @@
         <h2>Capay API Docs</h2>
         <p class="muted">Swagger-style documentation with live requests.</p>
       </div>
-      <a class="pill link" href="/">Back to Admin</a>
+      <a class="pill link" href="../">Back to Admin</a>
     </div>
 
     <div id="swagger-ui"></div>
@@ -50,7 +50,7 @@
     <script>
       window.onload = function () {
         window.ui = SwaggerUIBundle({
-          url: "/openapi.json",
+          url: "../openapi.json",
           dom_id: "#swagger-ui",
           deepLinking: true,
           presets: [SwaggerUIBundle.presets.apis],
diff --git a/app/src/public/index.html b/backend/app/src/public/index.html
similarity index 97%
rename from app/src/public/index.html
rename to backend/app/src/public/index.html
index 3a957d5..70c35bc 100644
--- a/app/src/public/index.html
+++ b/backend/app/src/public/index.html
@@ -4,7 +4,7 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width,initial-scale=1" />
     <title>Capay 管理后台</title>
-    <link rel="stylesheet" href="/styles.css" />
+    <link rel="stylesheet" href="styles.css" />
   </head>
   <body>
     <div class="page">
@@ -16,7 +16,7 @@
         <div class="hero-meta">
           <span class="pill">API Admin</span>
           <span class="pill" id="status-pill">未连接</span>
-          <a class="pill link" href="/docs/">API Docs</a>
+          <a class="pill link" href="docs/">API Docs</a>
         </div>
       </header>
 
@@ -131,6 +131,6 @@
       </section>
     </div>
 
-    <script src="/app.js"></script>
+    <script src="app.js"></script>
   </body>
 </html>
diff --git a/app/src/public/openapi.json b/backend/app/src/public/openapi.json
similarity index 99%
rename from app/src/public/openapi.json
rename to backend/app/src/public/openapi.json
index 761e1b8..e7e46ba 100644
--- a/app/src/public/openapi.json
+++ b/backend/app/src/public/openapi.json
@@ -7,7 +7,7 @@
   },
   "servers": [
     {
-      "url": "/"
+      "url": "/backend"
     }
   ],
   "tags": [
diff --git a/app/src/public/styles.css b/backend/app/src/public/styles.css
similarity index 100%
rename from app/src/public/styles.css
rename to backend/app/src/public/styles.css
diff --git a/app/src/server.js b/backend/app/src/server.js
similarity index 100%
rename from app/src/server.js
rename to backend/app/src/server.js
diff --git a/app/src/storage.js b/backend/app/src/storage.js
similarity index 100%
rename from app/src/storage.js
rename to backend/app/src/storage.js
diff --git a/app/src/utils/rpc.js b/backend/app/src/utils/rpc.js
similarity index 100%
rename from app/src/utils/rpc.js
rename to backend/app/src/utils/rpc.js
diff --git a/app/src/watchers/btcWatcher.js b/backend/app/src/watchers/btcWatcher.js
similarity index 100%
rename from app/src/watchers/btcWatcher.js
rename to backend/app/src/watchers/btcWatcher.js
diff --git a/app/src/watchers/evmWatcher.js b/backend/app/src/watchers/evmWatcher.js
similarity index 100%
rename from app/src/watchers/evmWatcher.js
rename to backend/app/src/watchers/evmWatcher.js
diff --git a/infra/docker/btcpay-src b/backend/infra/docker/btcpay-src
similarity index 100%
rename from infra/docker/btcpay-src
rename to backend/infra/docker/btcpay-src
diff --git a/infra/docker/btcpay/.env.example b/backend/infra/docker/btcpay/.env.example
similarity index 100%
rename from infra/docker/btcpay/.env.example
rename to backend/infra/docker/btcpay/.env.example
diff --git a/infra/docker/btcpay/docker-compose.yml b/backend/infra/docker/btcpay/docker-compose.yml
similarity index 100%
rename from infra/docker/btcpay/docker-compose.yml
rename to backend/infra/docker/btcpay/docker-compose.yml
diff --git a/infra/docker/keagate-src b/backend/infra/docker/keagate-src
similarity index 100%
rename from infra/docker/keagate-src
rename to backend/infra/docker/keagate-src
diff --git a/infra/docker/keagate/local.json b/backend/infra/docker/keagate/local.json
similarity index 91%
rename from infra/docker/keagate/local.json
rename to backend/infra/docker/keagate/local.json
index 66b1324..08acbf5 100644
--- a/infra/docker/keagate/local.json
+++ b/backend/infra/docker/keagate/local.json
@@ -1,5 +1,5 @@
 {
-  "HOST": "https://capay.hao.work",
+  "HOST": "https://capay.hao.work/backend",
   "PORT": 8081,
   "MONGO_CONNECTION_STRING": "mongodb://localhost:27017",
   "MONGO_KEAGATE_DB": "keagate",
diff --git a/infra/docker/x402-rs b/backend/infra/docker/x402-rs
similarity index 100%
rename from infra/docker/x402-rs
rename to backend/infra/docker/x402-rs
diff --git a/infra/nginx/sites-enabled/capay.conf b/backend/infra/nginx/sites-enabled/capay.conf
similarity index 91%
rename from infra/nginx/sites-enabled/capay.conf
rename to backend/infra/nginx/sites-enabled/capay.conf
index d40fc3c..c6e57e5 100644
--- a/infra/nginx/sites-enabled/capay.conf
+++ b/backend/infra/nginx/sites-enabled/capay.conf
@@ -13,8 +13,16 @@ server {
   # include /etc/letsencrypt/options-ssl-nginx.conf;
   # ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
 
-  location / {
-    proxy_pass http://127.0.0.1:3001;
+  location = / {
+    return 302 /backend/;
+  }
+
+  location = /backend {
+    return 301 /backend/;
+  }
+
+  location /backend/ {
+    proxy_pass http://127.0.0.1:3001/;
     proxy_set_header Host $host;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
     proxy_set_header X-Forwarded-Proto $scheme;
diff --git a/x402/facilitator/.env b/backend/x402/facilitator/.env
similarity index 100%
rename from x402/facilitator/.env
rename to backend/x402/facilitator/.env
diff --git a/x402/facilitator/config.json b/backend/x402/facilitator/config.json
similarity index 100%
rename from x402/facilitator/config.json
rename to backend/x402/facilitator/config.json
diff --git a/x402/facilitator/networks.json b/backend/x402/facilitator/networks.json
similarity index 100%
rename from x402/facilitator/networks.json
rename to backend/x402/facilitator/networks.json
diff --git a/x402/facilitator/tokens.json b/backend/x402/facilitator/tokens.json
similarity index 100%
rename from x402/facilitator/tokens.json
rename to backend/x402/facilitator/tokens.json