- 2.1 通过安装包直接运行
- 2.2 Azure 部署地址
- 2.3 克隆项目并安装依赖
- 2.4 数据库配置
- 2.5 配置启动应用
- 2.6 运行客户端项目
- 2.7 用户认证与权限管理
- 2.8 前端组件开发
- 操作系统: Windows 10 或更高版本，或支持 .NET 的其他操作系统（如 Linux 或 macOS）。
- 开发工具:
- IDE
- Visual Studio 下载地址：https://visualstudio.microsoft.com/
- Rider 下载地址：Rider: The Cross-Platform .NET IDE from JetBrains
- .NET Core SDK 8.0 或更高版本(https://dotnet.microsoft.com/download)
- SQLite: 本地数据库，用于数据存储。
- IDE
- 浏览器: 支持现代浏览器，如 Chrome、Edge 或 Firefox，确保能够正确调试 WebAssembly 应用。
本项目已上传至Github开源
项目仓库: https://github.com/RealTrueReality/TrueRealityPizza
项目包含以下子项目，每个项目有不同的职责：
-
TrueRealityPizza（服务端项目，基于 Blazor Server）：
- 职责:
- 服务端逻辑处理: 负责核心的业务逻辑，包括与数据库交互、API 的创建、以及身份认证的处理。
- Razor Components 支持: 提供 Razor 组件，这些组件主要用于页面的服务端渲染。Blazor Server 允许在服务端执行逻辑并实时更新客户端界面，保证用户体验的一致性和实时性。
- 身份认证与授权: 通过 ASP.NET Identity 实现用户注册、登录及权限管理，确保不同用户（如管理员、普通用户）拥有正确的权限。
- 职责:
-
TrueRealityPizza.Client（前端项目，基于 Blazor WebAssembly）：
- 职责:
- 用户界面展示: 通过 Blazor WebAssembly 构建的前端应用，在客户端执行。Blazor WebAssembly 的特点是将 C# 代码编译为 WebAssembly 在浏览器中运行，提供高度响应式的前端体验。
- 与服务端 API 的交互: 通过
HttpClient与服务端（TrueRealityPizza Blazor Server）进行交互，客户端可以请求 API 获取订单信息、用户信息等数据，并在界面中展示。 - 页面展示与交互: 包括订单管理、用户操作等，所有的界面逻辑都在浏览器端执行，大大减轻了服务器压力。
- 职责:
-
TrueRealityPizza.ComponentsLibrary（组件库）：
- 职责:
- Blazor 组件复用: 该项目提供可复用的 Blazor 组件，封装了前端页面中的常用交互逻辑，例如对话框、表单和数据列表等。
- 跨项目使用: 这些组件不仅用于 Blazor WebAssembly 前端（TrueRealityPizza.Client），也可以在 Blazor Server 项目中使用（TrueRealityPizza），保证组件逻辑的复用和一致性。
- 职责:
-
TrueRealityPizza.Shared（共享模型和接口）：
- 职责:
- 模型与接口共享: 该项目包含了项目中的实体模型（如 Pizza、订单等）和相关的接口定义。此部分用于在 TrueRealityPizza 和 TrueRealityPizza.Client 两个项目之间共享数据模型，确保前后端使用相同的业务逻辑和数据结构。
- 数据一致性与复用性: 由于前端和后端都使用相同的模型，这确保了前后端数据结构的一致性，避免了不必要的数据转换和重复定义。
- 职责:
TrueRealityPizza/
├── TrueRealityPizza/ # 服务端项目
├── TrueRealityPizza.Client/ # 客户端 WebAssembly 项目
├── TrueRealityPizza.ComponentsLibrary/ # 组件库
├── TrueRealityPizza.Shared/ # 共享库
为了方便用户快速运行项目，已经将程序及其运行时环境打包在 TrueRealityPizzaInstaller.exe 文件中。可以直接通过该安装包进行项目安装并运行：
-
下载并运行安装包： 双击 TrueRealityPizzaInstaller.exe 文件并双击运行。
-
安装过程： 按照安装向导的提示，选择安装路径并进行安装。
-
启动应用： 安装完成后，安装程序会自动启动 TrueRealityPizza 应用，你可以通过桌面快捷方式或者程序目录中的可执行文件启动应用。
安装完成后，应用将自动运行并打开浏览器指向 https://localhost:5001。你可以立即开始使用项目。
项目已经部署在 Azure 云平台上，可以直接访问以下地址使用 TrueRealityPizza：
网址: https://truerealitypizza.azurewebsites.net/
无需在本地运行项目，只需通过浏览器访问上述网址或双击TrueRealityPizzaWeb，即可体验 TrueRealityPizza 应用的完整功能。
如果你希望手动搭建开发环境，可以按照以下步骤操作：
克隆项目仓库:
git clone https://github.com/RealTrueReality/TrueRealityPizza
cd TrueRealityPizza 克隆完仓库后，使用 dotnet restore 命令安装所有依赖包：
dotnet restore项目使用 SQLite 数据库。要初始化数据库并应用迁移，请运行以下命令：
dotnet ef database update这将会创建数据库架构并插入初始数据（如用户角色、Pizza 数据等）。
要启动服务器项目，运行以下命令：
dotnet run --project TrueRealityPizza项目启动后，默认会使用 https://localhost:5001 作为服务器端地址，并自动在浏览器中打开该地址。
客户端项目使用 Blazor WebAssembly 构建，运行命令如下：
dotnet run --project TrueRealityPizza.Client客户端应用将自动连接到服务端，并通过 API 获取数据。
项目通过 ASP.NET Identity 进行用户身份验证和权限管理。在 Program.cs 文件中定义了身份验证和角色管理的详细配置，包括密码要求和账户确认等。常见的身份验证规则包括：
- 密码至少 6 个字符，要求包含数字和小写字母。
- 用户注册后，必须通过电子邮件确认账户。
项目还支持角色管理，例如用户可以被分配为管理员或普通用户，来访问不同的功能模块。
TrueRealityPizza.ComponentsLibrary 中包含可复用的 Blazor 组件，开发者可以通过修改这些组件，定制应用的前端功能。例如，TemplatedDialog.razor 和 TemplatedList.razor 组件提供了通用的对话框和列表展示功能。
项目启动后，前端和后端将分别通过 Blazor WebAssembly 和 ASP.NET Core 进行交互。服务端负责处理 API 请求、数据存储和身份认证，而客户端通过 HttpClient 与服务端 API 进行通信。
数据库操作通过 Entity Framework Core 进行管理，并将所有数据存储在 SQLite 数据库中。所有的数据交互都将在后端进行，而前端提供动态的用户界面。
- 开发模式调试: 在开发模式下，项目启用了 WebAssembly Debugging，允许在浏览器中调试 Blazor 组件和后端 API 请求。
- 生产环境安全性: 在生产模式下，应用将启用 HSTS（HTTP 严格传输安全）以及全局异常处理程序，确保应用在恶意攻击和异常情况中的安全性。
- 浏览器兼容性: 建议使用最新版本的 Chrome、Edge 或 Firefox 浏览器，确保最佳的兼容性和性能。
如果在项目启动时数据库没有成功创建，请检查以下几点：
- 确保已经运行
dotnet ef database update命令来创建和更新数据库。 - 检查项目中的
PizzaStoreContext类，确保连接字符串正确配置为Data Source=pizza.db。
- 检查本地是否正确运行了
dotnet run命令，确保服务器正常启动。 - 如果遇到 HTTPS 错误，请确保你已经为本地开发环境配置了 SSL 证书，或将启动命令中的 URL 修改为
http://localhost:5000。