diff --git a/README.md b/README.md index d69c6e3907189c696aada8c86f5496235e02eb94..2a087a8bf347eeaa70b90340c0a7697d8d159e6d 100644 --- a/README.md +++ b/README.md @@ -1,100 +1,65 @@ -

Organization Logo.png

-

TopskyHotelManagementSystem-MAUI

-

- star - fork - - -

-
-

中文文档 | English Document

-
- -# :exclamation: 重要说明: - -**项目基于.NET 8的MAUI进行开发,目前仅考虑安卓端,其他暂不具备测试条件** - -# :pray: 引用的开源项目: - -1. ##### MAUI——.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.[MAUI,MIT开源协议](https://github.com/dotnet/maui) - -1. ##### Plugin.Toolkit.Fonts.MaterialIcons.[Plugin.Toolkit.Fonts.MaterialIcons,未标明开源协议](https://github.com/andyapin/Plugin.Toolkit.Fonts.MaterialIcons) - - -# :exclamation: 本项目说明: - -1、在对本项目进行二次开发时,请遵循 MIT 开源协议。所有引用的其他开源项目均采用其各自的开源协议。使用这些开源项目时,请务必在项目介绍中添加相应的声明,并按照各自的开源协议进行开源等操作。 - -2、有bug欢迎提出issue!或进行评论 - -3、本系统UI框架目前主要基于MAUI原生控件进行创建,后续可能考虑引入第三方控件,在此特别声明! - -# :thought_balloon: 开发目的: - -与酒店管理系统配套开发的手机程序,主要帮助用户查询空房情况以及预约房间、了解酒店最新的新闻公告、对入住体验进行评价等等。 - -# :mag_right: 系统开发环境: - -操作系统:Windows 11(x64) - -开发工具:Microsoft Visual Studio 2022(系统最新版本) - -数据库:SQLite - -开发语言:C#语言、T-SQL语言 - -开发平台:.Net - -开发框架:.Net 8 - -开发技术:.NET 8 MAUI - -# :open_file_folder: 系统结构: - -```tree -EOM.TSHotelManagementSystem.Mobile -├─ .git -├─ .gitignore -├─ EOM.TSHotelManagementSystem.Mobile.sln -├─ LICENSE -├─ README.md -├─ EOM.TSHotelManagementSystem.Mobile.UI -│ ├─ App.xaml -│ ├─ AppShell.xaml -│ ├─ MauiProgram.cs -│ ├─ Views -│ ├─ ViewModels -│ ├─ Service -│ ├─ Helper -│ ├─ Converter -│ ├─ Program.cs -│ ├─ Properties -│ ├─ Resources -├─ README.en.md -``` - -# :books: 系统功能模块汇总: - -| 功能汇总 | | | | | | | -| -------- | ------------ | ------------ | -------- | -------- | ---- | ---- | -| 新闻 | 新闻列表 | 新闻跳转查看 | | | | | -| 入住 | 预约房间 | 消费账单 | 入住评价 | | | | -| 我的 | 个人信息设置 | 系统设置 | 退出登录 | 注销账号 | | | - - -# :family: 项目作者: - -**原创团队:Jackson、Benjamin、Bin、Jonathan** - -**维护团队:易开元(Easy Open Meta)** - -# :computer: 项目运行部署: - -**下载并安装.NET 8及以上SDK版本。** -**下载并安装Microsoft Visual Studio Professional 2022及以上版本,并通过下载Zip包解压,打开.sln后缀格式文件运行。** - - - -[![java-and-net/TopskyHotelManagementSystem-MAUI](https://gitee.com/java-and-net/topsky-hotel-management-system-maui/widgets/widget_card.svg?colors=4183c4,ffffff,ffffff,e3e9ed,666666,9b9b9b)](https://gitee.com/java-and-net/topsky-hotel-management-system-maui) \ No newline at end of file +# EOM.TSHotelManagementSystem.Mobile.UI + +## 重要说明 +本项目是一个基于 MAUI(Multi-platform App UI)开发的酒店管理系统移动应用界面,支持多平台运行(如 Android、iOS、Windows �://...等)。项目主要使用 C# 和 XAML 编写,实现了导航、新闻展示、入住登记等功能。 + +## 引用的开源项目 +暂未提供具体引用的开源项目信息。 + +## 本项目说明 +本项目专注于构建一个酒店管理系统移动应用的用户界面,支持多个平台,并提供可扩展的架构以便后续集成更多业务功能。 + +## 开发目的 +该项目旨在为酒店管理业务提供一个统一的移动端界面,便于用户在不同设备上进行操作,提升酒店管理的效率和用户体验。 + +## 系统开发环境 +- 开发框架:.NET MAUI +- 编程语言:C#、XAML +- 支持平台:Android、iOS、Windows(WinUI)、MacCatalyst、Tizen +- 依赖服务:INavigationService 及其实现 NavigationService + +## 系统结构 +- **App.xaml / AppShell.xaml**:应用程序全局配置和导航壳。 +- **ViewModels**:包含实现 MVVM 模式的视图模型类。 +- **Views**:包含多个视图组件(如主页、新闻页、入住登记页等)。 +- **Services**:导航服务的接口和实现。 +- **Converter**:数据绑定转换器。 +- **Platforms**:平台相关配置和入口类(如 Android 的 MainActivity、iOS 的 AppDelegate �://...)。 +- **Resources**:应用资源(如图标、字体、样式、启动图等)。 + +## 系统功能模块汇总 +- **导航模块**:通过 `INavigationService` 和 `NavigationService` 实现页面导航。 +- **新闻模块**:通过 `NewsViewModel` 和 `NewsView` 实现新闻数据的加载、刷新和分页展示。 +- **入住登记模块**:提供入住登记界面,由 `CheckInView` 实现。 +- **用户个人中心模块**:用户信息展示与管理界面,由 `ProfileView` 实现。 +- **底部导航栏模块**:通过 `BottomNavigationBar` 实现多标签切换功能。 + +## 项目作者 +暂未提供具体项目作者信息。 + +## 项目运行部署 +### 开发环境搭建 +1. 安装 [.NET 6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0) 或更高版本。 +2. 安装 [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) 或支持 .NET MAUI 的 IDE。 +3. 确保已启用目标平台(Android/iOS/Windows)的开发环境。 + +### 构建与运行 +1. 打开项目文件 `EOM.TSHotelManagementSystem.Mobile.UI.csproj` 或 `.sln` 文件。 +2. 选择目标平台(Android/iOS/Windows)。 +3. 点击运行或使用命令行构建: + ```bash + dotnet build + dotnet run --project EOM.TSHotelManagementSystem.Mobile.UI.csproj + ``` + +### 部署 +- **Android**:连接设备或使用模拟器,点击运行按钮或使用命令 `dotnet build -t:Run -f net6.0-android`。 +- **iOS**:使用 Mac 构建环境,通过 Visual Studio for Mac 或 Xcode 部署。 +- **Windows**:选择 WinUI 平台,直接在 Windows 上运行或生成安装包。 + +更多信息请参考项目中的 `launchSettings.json` 和各平台的配置文件(如 `AndroidManifest.xml`, `Info.plist` 等)。 + +## 许可证 +本项目遵循开源许可证,具体请查看根目录下的 `LICENSE` 文件。 \ No newline at end of file