first commit

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.
+[聯絡資訊]