From 97323ce6e3685e0fbf21ba64534e8e444c747e7f Mon Sep 17 00:00:00 2001 From: Juro Hsu Date: Fri, 9 May 2025 10:04:50 +0800 Subject: [PATCH] first commit --- README.md | 100 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 66 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index d4e8ea8..b3a4ce8 100644 --- a/README.md +++ b/README.md @@ -1,59 +1,91 @@ -# CalendarManager +# 會議室行事曆管理系統 -This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 19.0.6. +這是一個基於 Angular 開發的會議室預約和管理系統,提供直觀的行事曆介面來管理會議室預約。 -## Development server +## 功能特點 -To start a local development server, run: +- 📅 多視圖行事曆顯示(月、週、日視圖) +- 🏢 多會議室管理 +- 🔄 重複會議支援 +- 🎨 Outlook 風格的事件顯示 +- 🌏 繁體中文本地化支援 +- 👥 會議詳細資訊查看 +- 🔒 權限控制 +- ⚡ 即時狀態更新 +## 技術需求 + +- Angular 17+ +- Node.js 18+ +- angular-calendar +- date-fns + +## 安裝說明 + +1. 克隆專案: ```bash -ng serve +git clone http://www.origtek.com:2999/juro.hsu/CalendarManager.git ``` -Once the server is running, open your browser and navigate to `http://localhost:4200/`. The application will automatically reload whenever you modify any of the source files. +2. 執行檔案:`00_run_all.bat` -## Code scaffolding +3. 開啟瀏覽器訪問:`http://localhost:4200/calendar/{UserId}` -Angular CLI includes powerful code scaffolding tools. To generate a new component, run: +## API 端點 -```bash -ng generate component component-name -``` +系統使用以下 API 端點: -For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run: +- `GET /api/calendar/getAuth` - 驗證使用者權限 +- `GET /api/calendar/getMeetingRoom` - 獲取所有會議室 +- `GET /api/calendar/getMeetingApply` - 獲取會議申請列表 +- `GET /api/calendar/getMeetingApplyById` - 獲取特定會議詳情 +- `PUT /api/calendar/closeMeeting` - 關閉單一會議 +- `PUT /api/calendar/closeAllRepeatMeeting` - 關閉所有重複會議 -```bash -ng generate --help -``` +## 主要元件 -## Building +### CalendarComponent -To build the project run: +主要的行事曆顯示元件,功能包括: +- 多視圖切換 +- 會議室篩選 +- 事件顯示和管理 +- 日期導航 -```bash -ng build -``` +### DetailComponent -This will compile your project and store the build artifacts in the `dist/` directory. By default, the production build optimizes your application for performance and speed. +會議詳情顯示元件,用於: +- 顯示會議詳細資訊 +- 處理會議狀態更新 -## Running unit tests +### CalendarService -To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command: +提供所有與後端 API 的通訊服務,包括: +- 會議室資料獲取 +- 會議申請管理 +- 權限驗證 -```bash -ng test -``` +## 使用說明 -## Running end-to-end tests +1. 選擇會議室:使用下拉選單選擇特定會議室 +2. 切換視圖:點擊工具列上的按鈕切換月/週/日視圖 +3. 查看會議:點擊行事曆上的事件查看詳情 +4. 關閉會議:具有權限的使用者可以關閉會議 -For end-to-end (e2e) testing, run: +## 注意事項 -```bash -ng e2e -``` +- 所有時間都基於本地時區 +- 會議關閉操作需要適當的權限 +- 重複會議可以選擇關閉單次或全部 + +## 授權 + +[授權說明] + +## 貢獻指南 -Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs. +歡迎提交 Pull Request 或建立 Issue。 -## Additional Resources +## 聯絡方式 -For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page. +[聯絡資訊]