购物网站 Windows 本地运行说明

一、使用方式

1. 解压本压缩包。
2. 进入 shopping_app 目录。
3. 第一次使用时，双击 setup_once.bat。
4. 等待依赖安装完成。
5. 之后每次启动网站，双击 start_site.bat。
6. 浏览器打开：

   http://127.0.0.1:5000

二、文件说明

setup_once.bat
用于第一次配置本地运行环境，包括创建 Python 虚拟环境、安装依赖、修复本地配置。

start_site.bat
用于启动网站。当前版本会同时尝试启动 SSH 数据库隧道，并运行 Flask 网站。

configure_local.py
用于自动修正 Windows 本地配置，例如 Firebase 密钥路径、数据库连接地址等。

run_windows.py
Windows 本地运行入口，使用 waitress 启动 Flask，并提供 /uploads/ 静态上传资源访问。

requirements-windows.txt
Windows 本地运行需要安装的 Python 依赖。

.env.runtime
网站运行配置文件，包括数据库连接、Firebase 路径等。该文件可能包含敏感信息，请勿公开。

firebase-service-account.json
Firebase 服务账号密钥文件，属于敏感文件，请勿公开。

templates
网站页面模板。

uploads
商品图片、头像、店铺图片、站点图标等上传资源。

三、运行前要求

1. Windows 电脑需要安装 Python 3.10 或以上版本。
2. 需要安装 Microsoft ODBC Driver 18 for SQL Server。
3. 如果继续连接服务器数据库，需要能够 SSH 登录服务器。
4. 如果使用本地数据库，需要先在本地 SQL Server 中恢复数据库，并修改 .env.runtime。

四、启动顺序

第一次使用：

双击 setup_once.bat

以后启动：

双击 start_site.bat

如果弹出 SSH 窗口，请保持该窗口不要关闭。

五、访问地址

http://127.0.0.1:5000

六、常见问题

1. 提示 Python was not found

说明当前电脑没有安装 Python，或者 Python 没有加入 PATH。
安装 Python 3.10 或以上版本后重新运行 setup_once.bat。

2. 提示 No module named flask

说明依赖没有安装成功。
重新双击 setup_once.bat。

3. 提示找不到 firebase-service-account.json

确认 firebase-service-account.json 是否在 shopping_app 目录下。
然后重新运行 setup_once.bat。

4. 提示 ODBC Driver 18 for SQL Server 找不到

说明当前电脑没有安装 Microsoft ODBC Driver 18 for SQL Server。
安装后重新启动网站。

5. 页面能打开，但数据库相关页面报错

检查数据库隧道是否打开，或者检查 .env.runtime 中的数据库配置是否正确。

七、安全提醒

本项目包含 .env.runtime 和 firebase-service-account.json。
这两个文件可能包含数据库密码、Firebase 密钥等敏感信息。
不要把完整压缩包公开上传到 GitHub、QQ群、网盘公开链接或其他公共平台。