@wisdomgarden/mobile-assets 0.0.78 → 0.0.80

package/README.md

@@ -1,34 +1,73 @@
-# Update assets flow
+# mobile-assets
 
-## Update version info
+Static assets hosted for the TronClass mobile apps: app version-update configs
+(`version_update_*.json`, `version_aligner.json`, `toggle.json`), the privacy
+policy / user agreement documents (root + `app-legal/`), the mhesi version files
+and login-proxy pages, plus a few standalone HTML tools.
+
+Everything is published to npm as [@wisdomgarden/mobile-assets](https://www.npmjs.com/package/@wisdomgarden/mobile-assets)
+and served to the apps through two CDNs:
+
+- **jsDelivr** — served straight from the npm package (`cdn.jsdelivr.net/npm/@wisdomgarden/mobile-assets@latest/...`).
+- **qiniu** — files are uploaded to the `lms-mobile` bucket and served from `https://mobile-download.tronclass.com.cn/...`.
+
+So updating an asset is: edit the file → publish a new version → refresh the CDN
+caches. The two common tasks (update version info / update privacy policy) both
+follow that flow; the shared steps are documented first.
+
+## Publish and add tag
 
-### I. Sync version file files
-  - In Project [mobile-assistant](https://gitlab.tronclass.com.cn/lms/mobile-assistant), prepare the preliminary work according to readme.md.
-  - You should clone mobile-assistant into the same directory as the current project.
-  - use `bash ./scripts/sync_version_files.sh` to sync latest file
+1. use `git diff` to check the changed files
+2. commit all files, e.g. `git commit -m "update version file"`
+3. `node scripts/upgrade_version.js` — bumps the project version number and adds a new git tag
+4. `git push && git push --tags` — pushes to GitHub; the GitHub Action then publishes to npm
 
+## Refresh CDN
 
-### II. upgrade package `mobile-assets` version
+Publishing to npm does **not** refresh the CDN caches — you must purge/re-upload
+after the new version is live.
 
-1. ues `git diff` to check the changed files
-2. then commit all files `git commit -m "update version file"`
-3. `node scripts/upgrade_version.js` increase current project version number and add new tag
-4. `git push && git push --tags` push to GitHub, and Github Action publish it to [npm @wisdomgarden/mobile-assets](https://www.npmjs.com/package/@wisdomgarden/mobile-assets)
+1. Wait ~10 minutes, then check [jsDelivr package data](https://data.jsdelivr.com/v1/package/npm/@wisdomgarden/mobile-assets)
+   until the latest tag matches `package.json.version`.
+2. Run the refresh command **for the scope you changed** — each scope only touches
+   its own files / CDNs, so updating the version no longer re-uploads the legal
+   docs and vice versa:
 
-###  III. refresh cdn
+   ```bash
+   bash scripts/refresh_cdn.sh version    # version_update_*.json / version_aligner.json / toggle.json
+   bash scripts/refresh_cdn.sh legal      # privacy-policy / user-agreement / children / summary (root + app-legal/)
+   bash scripts/refresh_cdn.sh mhesi      # mhesi/version/*.json + mhesi/third-party-login-proxy/
+   bash scripts/refresh_cdn.sh identity   # identity-web-login-proxy/ directory
+   bash scripts/refresh_cdn.sh all        # everything (default when no scope given)
+   ```
 
-1. after about 10 minutes, check [jsDeliver package data](https://data.jsdelivr.com/v1/package/npm/@wisdomgarden/mobile-assets) util latest tag is same as package.json.version then `bash scripts/refresh_cdn.sh` refresh json file cdn cache
-2. preview release note. local use live server `./preview-release.html` or [Online from GitHub Pages](https://wisdomgardeninc.github.io/mobile-assets/preview-release.html)
+Notes:
 
-if update other file, edit `refresh_cdn.sh`, then run `bash scripts/refresh_cdn.sh` refresh it.
+- Requires `qshell` configured for the `lms-mobile` bucket (used for the qiniu
+  upload + refresh; jsDelivr only needs `curl`).
+- The file list for each scope is maintained in **one place** inside
+  `scripts/refresh_cdn.sh` — jsDelivr purge, qiniu upload and qiniu refresh are all
+  derived from it. If you add a new file, add it to the matching group array there.
+
+## Update version info
+
+1. Sync version files from [mobile-assistant](https://gitlab.tronclass.com.cn/lms/mobile-assistant):
+   `bash ./scripts/sync_version_files.sh [path-to-mobile-assistant]` (defaults to `../mobile-assistant`).
+2. [Publish and add tag](#publish-and-add-tag).
+3. [Refresh CDN](#refresh-cdn): `bash scripts/refresh_cdn.sh version`.
+4. Preview the release note: local live server `./preview-release.html`, or
+   [online from GitHub Pages](https://wisdomgardeninc.github.io/mobile-assets/preview-release.html).
 
 ## Update privacy policy
 
-Privacy-policy / user-agreement files live in `app-legal/`. Edit them there, then
-publish via [II](#II-upgrade-package-mobile-assets-version). Keep the whole set in
+Privacy-policy / user-agreement files live in `app-legal/`. Keep the whole set in
 that folder — pages load `policy-common.*` / `marked-4.0.1.min.js` and fetch their
 `*-info.json` / `*-<lang>.md` by relative path.
 
+1. Edit the files under `app-legal/`.
+2. [Publish and add tag](#publish-and-add-tag).
+3. [Refresh CDN](#refresh-cdn): `bash scripts/refresh_cdn.sh legal`.
+
 - Root-level copies are legacy duplicates for already-released apps still using the
   root URLs; edit them in sync, and delete once those app versions are retired.
 - China app-market review snapshots: see `app-legal/store-review/`.

package/assets-list.md

@@ -29,6 +29,28 @@ https://mobile-download.tronclass.com.cn/children-privacy-policy-zh-CN.md
 https://mobile-download.tronclass.com.cn/summary-privacy-policy.html
 https://mobile-download.tronclass.com.cn/summary-privacy-policy-zh-CN.md
 
+// app-legal/ — used by new app versions
+https://mobile-download.tronclass.com.cn/app-legal/policy-jump.html
+https://mobile-download.tronclass.com.cn/app-legal/marked-4.0.1.min.js
+https://mobile-download.tronclass.com.cn/app-legal/policy-common.js
+https://mobile-download.tronclass.com.cn/app-legal/policy-common.css
+https://mobile-download.tronclass.com.cn/app-legal/privacy-policy.html
+https://mobile-download.tronclass.com.cn/app-legal/privacy-policy-info.json
+https://mobile-download.tronclass.com.cn/app-legal/privacy-policy-zh-CN.md
+https://mobile-download.tronclass.com.cn/app-legal/privacy-policy-en.md
+https://mobile-download.tronclass.com.cn/app-legal/privacy-policy-zh-TW.md
+https://mobile-download.tronclass.com.cn/app-legal/user-agreement.html
+https://mobile-download.tronclass.com.cn/app-legal/user-agreement-info.json
+https://mobile-download.tronclass.com.cn/app-legal/user-agreement-zh-CN.md
+https://mobile-download.tronclass.com.cn/app-legal/user-agreement-zh-TW.md
+https://mobile-download.tronclass.com.cn/app-legal/user-agreement-en.md
+https://mobile-download.tronclass.com.cn/app-legal/children-privacy-policy.html
+https://mobile-download.tronclass.com.cn/app-legal/children-privacy-policy-info.json
+https://mobile-download.tronclass.com.cn/app-legal/children-privacy-policy-zh-CN.md
+https://mobile-download.tronclass.com.cn/app-legal/summary-privacy-policy.html
+https://mobile-download.tronclass.com.cn/app-legal/summary-privacy-policy-zh-CN.md
+https://mobile-download.tronclass.com.cn/app-legal/privacy_policy_google_play.html
+
 // identity-web-login-proxy
 https://mobile-download.tronclass.com.cn/identity-web-login-proxy/favicon.ico
 https://mobile-download.tronclass.com.cn/identity-web-login-proxy/identity-web-login-proxy-callback.html
@@ -67,6 +89,28 @@ https://wisdomgardeninc.github.io/mobile-assets/children-privacy-policy-zh-CN.md
 https://wisdomgardeninc.github.io/mobile-assets/summary-privacy-policy.html
 https://wisdomgardeninc.github.io/mobile-assets/summary-privacy-policy-zh-CN.md
 
+// app-legal/ — used by new app versions
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/policy-jump.html
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/marked-4.0.1.min.js
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/policy-common.js
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/policy-common.css
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy-policy.html
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy-policy-info.json
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy-policy-zh-CN.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy-policy-en.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy-policy-zh-TW.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/user-agreement.html
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/user-agreement-info.json
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/user-agreement-zh-CN.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/user-agreement-zh-TW.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/user-agreement-en.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/children-privacy-policy.html
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/children-privacy-policy-info.json
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/children-privacy-policy-zh-CN.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/summary-privacy-policy.html
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/summary-privacy-policy-zh-CN.md
+https://wisdomgardeninc.github.io/mobile-assets/app-legal/privacy_policy_google_play.html
+
 // identity-web-login-proxy
 https://wisdomgardeninc.github.io/mobile-assets/identity-web-login-proxy/favicon.ico
 https://wisdomgardeninc.github.io/mobile-assets/identity-web-login-proxy/identity-web-login-proxy-callback.html

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wisdomgarden/mobile-assets",
-  "version": "0.0.78",
+  "version": "0.0.80",
   "description": "host mobile assets",
   "main": "index.js",
   "repository": "git@github.com:WisdomGardenInc/mobile-assets.git",

package/version_aligner.json

@@ -1,4 +1,12 @@
 [
+  {
+    "mobileVersion": "2.16.0",
+    "serverVersion": "1.77"
+  },
+  {
+    "mobileVersion": "2.15.1",
+    "serverVersion": "1.76"
+  },
   {
     "mobileVersion": "2.15.0",
     "serverVersion": "1.76"
@@ -58,45 +66,5 @@
   {
     "mobileVersion": "2.10.0",
     "serverVersion": "1.72"
-  },
-  {
-    "mobileVersion": "2.9.1",
-    "serverVersion": "1.71"
-  },
-  {
-    "mobileVersion": "2.8.1",
-    "serverVersion": "1.70-1.72"
-  },
-  {
-    "mobileVersion": "2.8.0",
-    "serverVersion": "1.70-1.72"
-  },
-  {
-    "mobileVersion": "2.7.0",
-    "serverVersion": "1.69-1.71"
-  },
-  {
-    "mobileVersion": "2.6.2",
-    "serverVersion": "1.68-1.70"
-  },
-  {
-    "mobileVersion": "2.6.1",
-    "serverVersion": "1.68-1.70"
-  },
-  {
-    "mobileVersion": "2.6.0",
-    "serverVersion": "1.68-1.70"
-  },
-  {
-    "mobileVersion": "2.5.2",
-    "serverVersion": "1.67-1.69"
-  },
-  {
-    "mobileVersion": "2.5.1",
-    "serverVersion": "1.67-1.69"
-  },
-  {
-    "mobileVersion": "2.5.0",
-    "serverVersion": "1.67-1.69"
   }
 ]

package/version_update_android.json

@@ -1,9 +1,9 @@
 {
-  "version": "2.15.0",
-  "update_type": 0,
+  "version": "2.16.0",
+  "update_type": 1,
   "allow_lowest_version": "2.14.5",
   "app_store_url": "https://play.google.com/store/apps/details?id=com.wisdomgarden.trpc",
-  "app_store_url_cn": "https://mobile-download.tronclass.com.cn/mobile-2.0/app/android/app-release-2.15.0.apk",
+  "app_store_url_cn": "https://mobile-download.tronclass.com.cn/mobile-2.0/app/android/app-release-2.16.0.apk",
   "release_note_en_us": "- Fix bugs and improve system performance.",
   "release_note_zh_hans": "- 已知问题修复和性能优化",
   "release_note_zh_hant": "- 已知問題修復和性能優化"

package/version_update_ios.json

@@ -1,6 +1,6 @@
 {
-  "version": "2.15.0",
-  "update_type": 0,
+  "version": "2.16.0",
+  "update_type": 1,
   "allow_lowest_version": "2.14.5",
   "app_store_url": "https://apps.apple.com/app/scratch/id973028199",
   "release_note_en_us": "- Fix bugs and improve system performance.",