feat: add windows desktop app with local databases

Author: liqi3333

.github/workflows/build-windows.yml

@@ -0,0 +1,41 @@
+name: Build Windows EXE
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main ]
+  pull_request:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  build-windows:
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build portable EXE
+        run: npm run build:win
+
+      - name: Build standalone HTML package
+        run: npm run build:html
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: Breast-Followup-System-win-x64
+          path: |
+            dist/*.exe
+            dist-html/*.html

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Release Breast Followup HTML
+name: Release Windows EXE
 
 on:
   push:
@@ -14,7 +14,7 @@ permissions:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
+    runs-on: windows-latest
 
     steps:
       - name: Checkout
@@ -24,13 +24,22 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build portable EXE
+        run: npm run build:win
 
       - name: Build standalone HTML package
         run: npm run build:html
 
       - name: Publish GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          files: dist-html/*.html
+          files: |
+            dist/*.exe
+            dist-html/*.html
           body_path: docs/RELEASE_TEMPLATE.md
           generate_release_notes: true

.gitignore

@@ -1,4 +1,6 @@
 dist-html/
+dist/
+node_modules/
 .DS_Store
 *.log
 *.tmp

README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>Breast Follow-up System</h1>
-  <p><strong>Standalone breast cancer follow-up record system + staging helper, with separate PC and mobile web versions.</strong></p>
+  <p><strong>Web + Windows desktop breast cancer follow-up system with local databases, staging helper, and separate PC/mobile web versions.</strong></p>
   <p><a href="README.zh-CN.md">简体中文</a> | <strong>English</strong></p>
 
   <p>
@@ -22,22 +22,25 @@
 This repository productizes a single-file HTML breast cancer follow-up system into a deliverable GitHub project:
 
 - GitHub Pages online usage
-- Standalone HTML download via Releases
+- Windows EXE and standalone HTML download via Releases
 - Automated build + release workflows
 - Separate PC and mobile entry pages
+- Windows desktop local databases with backup and restore
 
 ## Access
 
 - GitHub repository: <https://github.com/liqi3333/breast-followup>
 - Online PC page: <https://liqi3333.github.io/breast-followup/>
 - Online mobile page: <https://liqi3333.github.io/breast-followup/mobile.html>
+- Windows desktop download: <https://github.com/liqi3333/breast-followup/releases/latest>
 - Latest release: <https://github.com/liqi3333/breast-followup/releases/latest>
 
 ## Login / Data storage
 
-- This is a **local-first** web app. Users and records are stored in the browser via `localStorage`.
-- Built-in admin account in the HTML demo:
-  - `admin / admin123`
+- The online version remains a **local-first** web app. Users and records are stored in the browser via `localStorage`.
+- The Windows desktop build creates two local SQLite databases: one for user accounts and one for follow-up records.
+- The desktop app supports one-click backup and restore of those databases.
+- Default admin account: `admin / admin123`
 
 ## Quick Start
 
@@ -56,23 +59,28 @@ Then open the HTML file directly in a browser.
 ### Build locally
 
 ```bash
+npm install
 npm run build:html
+npm run build:win
 ```
 
 Output:
 
 ```text
-dist-html/Breast-Followup-System-1.0.1.html
-dist-html/Breast-Followup-System-mobile-1.0.1.html
+dist/Breast-Followup-System-1.1.0.exe
+dist-html/Breast-Followup-System-1.1.0.html
+dist-html/Breast-Followup-System-mobile-1.1.0.html
 ```
 
 ## Release automation
 
-- Push to `main`: build PC + mobile HTML and upload workflow artifacts
-- Push tag `v*`: build and publish both standalone HTML assets to GitHub Releases
+- Push to `main`: build Windows EXE + PC/mobile HTML and upload workflow artifacts
+- Push tag `v*`: build and publish the Windows EXE plus standalone HTML assets to GitHub Releases
 
 ## Notes / Disclaimer
 
 - This project is for informational and workflow reference only.
 - Do **not** use it as a substitute for formal clinical decision-making.
 - Do **not** store real sensitive patient data in a browser demo app.
+- The desktop backup action exports `users.db`, `followups.db`, and `manifest.json`.
+- The desktop restore action overwrites the current local desktop data, so back up first.

README.zh-CN.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>Breast Follow-up System</h1>
-  <p><strong>乳腺癌随访系统，支持随访记录管理 + 分期辅助，并提供独立 PC / 手机版网页。</strong></p>
+  <p><strong>乳腺癌随访系统，支持 Web + Windows 桌面版，包含本地数据库、随访记录管理与分期辅助。</strong></p>
   <p><strong>简体中文</strong> | <a href="README.md">English</a></p>
 
   <p>
@@ -22,22 +22,25 @@
 这个仓库把单文件 HTML 的「乳腺癌随访系统」整理成可公开交付的 GitHub 项目：
 
 - GitHub Pages 在线使用
-- Releases 提供独立 HTML 下载
+- Releases 提供 Windows EXE 与独立 HTML 下载
 - 自动构建与自动发布工作流
 - 提供独立 PC 页面和手机版页面
+- Windows 桌面版本地数据库、备份与恢复
 
 ## 入口
 
 - GitHub 仓库：<https://github.com/liqi3333/breast-followup>
 - 在线 PC 页面：<https://liqi3333.github.io/breast-followup/>
 - 在线手机版页面：<https://liqi3333.github.io/breast-followup/mobile.html>
+- Windows 桌面版下载：<https://github.com/liqi3333/breast-followup/releases/latest>
 - 最新 Release：<https://github.com/liqi3333/breast-followup/releases/latest>
 
 ## 登录 / 数据存储说明
 
-- 这是 **本地优先（local-first）** 的网页应用，用户与随访记录保存在浏览器 `localStorage`。
-- HTML 演示内置管理员账号：
-  - `admin / admin123`
+- 在线版仍是 **本地优先（local-first）** 的网页应用，用户与随访记录保存在浏览器 `localStorage`。
+- Windows 桌面版会在本机创建两个 SQLite 数据库：一个存用户账号，一个存随访记录。
+- 桌面版支持一键备份 / 恢复数据库。
+- 默认管理员账号：`admin / admin123`
 
 ## 快速开始
 
@@ -56,22 +59,27 @@
 ### 本地构建
 
 ```bash
+npm install
 npm run build:html
+npm run build:win
 ```
 
 产物：
 
 ```text
-dist-html/Breast-Followup-System-1.0.1.html
-dist-html/Breast-Followup-System-mobile-1.0.1.html
+dist/Breast-Followup-System-1.1.0.exe
+dist-html/Breast-Followup-System-1.1.0.html
+dist-html/Breast-Followup-System-mobile-1.1.0.html
 ```
 
 ## 自动发布流程
 
-- 推送到 `main`：自动构建 PC + 手机版 HTML，并上传 workflow artifact
-- 推送 `v*` 标签：自动生成 PC / 手机版独立 HTML 并发布到 GitHub Releases
+- 推送到 `main`：自动构建 Windows EXE + PC / 手机版 HTML，并上传 workflow artifact
+- 推送 `v*` 标签：自动生成 Windows EXE、PC / 手机版 HTML 并发布到 GitHub Releases
 
 ## 说明 / 免责声明
 
 - 本项目仅供信息参考与流程示例，不替代正式临床决策。
 - 不建议在浏览器 demo 应用中存放真实敏感患者数据。
+- 桌面版“备份数据库”会导出 `users.db`、`followups.db` 和 `manifest.json`。
+- 桌面版“恢复数据库”会覆盖当前本机桌面版数据，请先备份。