1

README.md

@@ -0,0 +1,87 @@
+# open-jd-web
+
+京东跟团查询独立静态站点，部署在 `jd.van333.cn` 等专用域名。
+
+不依赖 ruoyi-vue 整站打包，单 HTML + CDN，仅通过 API 连接 Jarvis 后端。
+
+## 功能
+
+- 订单跟团查询页
+- 接口：`GET /jarvis-api/open/jd/queryTkOrder?orderId=xxx&t=xxx`
+- URL 参数 `t`：推广标识（可选，仅保留在链接中）
+
+## 目录
+
+```
+open-jd-web/
+  index.html           # 主页面
+  config.js            # API 前缀配置
+  config.example.js    # 配置示例
+  nginx.conf.example   # Nginx 参考配置
+  README.md
+```
+
+## 本地预览
+
+直接用浏览器打开 `index.html` 无法调接口（跨域）。本地调试可：
+
+```bash
+# Python 简易静态服务
+python -m http.server 8080
+```
+
+同时需要 Nginx 或 dev 代理把 `/jarvis-api` 转到后端。
+
+## 部署到新服务器（jd.van333.cn）
+
+### 1. 上传文件
+
+将整个目录内容上传到服务器，例如：
+
+```
+/www/sites/jd.van333.cn/index/
+  index.html
+  config.js
+```
+
+### 2. Nginx
+
+参考 `nginx.conf.example`：
+
+- 静态文件走本地 `root`
+- `/jarvis-api/open/jd/` 反代到 `https://jarvis.van333.cn`
+
+### 3. 访问地址
+
+```
+https://jd.van333.cn/?t=TBA224A9B6F
+https://jd.van333.cn/open/jd/promoter?t=TBA224A9B6F
+```
+
+## 配置
+
+编辑 `config.js`：
+
+```js
+window.OPEN_JD_CONFIG = {
+  apiBase: '/jarvis-api'   // 同域反代，推荐
+}
+```
+
+## Git 托管
+
+```bash
+cd open-jd-web
+git init
+git add .
+git commit -m "init: 京东跟团查询独立静态站"
+```
+
+## 与 ruoyi-vue 的关系
+
+| 项目 | 用途 |
+|------|------|
+| `open-jd-web` | 专用域名静态部署（本仓库） |
+| `ruoyi-vue` `/open/jd/promoter` | 可选，jarvis 主站内嵌同功能 |
+
+专用域名请优先使用本仓库部署。