Skip to content

JW-Albert/ems.fcuems.tw

BranchesTags

Repository files navigation

緊急事件通報系統 / Emergency Management System

本專案是為了逢甲大學衛保救護隊設計的緊急事件通報系統，旨在快速傳遞事件資訊，提升應急處理效率。

This project is an emergency management system designed for the Feng Chia University Health and Safety Rescue Team, aimed at rapidly disseminating incident information and improving emergency response efficiency.

協作指南 / Collaboration Guidelines

請參閱 協作指南，了解提交流程與規範。

Please refer to Collaboration Guidelines for submission processes and standards.

📚 文檔導航 / Documentation Navigation

  • 📖 安裝指南 - 完整的安裝和部署指南 / Complete installation and deployment guide
  • 🔧 API文檔 - 詳細的API技術文檔 / Detailed API technical documentation
  • 🌐 公開API文檔 - 外部系統整合API文檔 / External system integration API documentation
  • 🤝 協作指南 - 專案協作規範 / Project collaboration guidelines

功能簡介 / Features

  1. 案件類別與分類選擇 / Case Category and Classification Selection - 使用者可選擇事件的緊急程度與分類，例如內科、外科、OHCA 等。Users can select the urgency level and classification of incidents, such as internal medicine, surgery, OHCA, etc.

  2. 地點與詳細資訊填寫 / Location and Detailed Information Entry - 系統支援輸入事件地點、樓層及補充資訊。The system supports input of incident location, floor, and additional information.

  3. 即時確認與通知 / Real-time Confirmation and Notification - 系統提供案件確認頁面，並即時廣播訊息給相關人員。The system provides case confirmation pages and broadcasts messages to relevant personnel in real-time.

  4. 多平台訊息廣播 / Multi-platform Message Broadcasting - 支援 LINE Bot 和 Discord Webhook 進行訊息廣播。Supports LINE Bot and Discord Webhook for message broadcasting.

  5. 系統測試功能 / System Testing Function - 提供 LINE Bot 和 Discord Webhook 的快速測試功能，確保通訊正常運作。Provides quick testing functionality for LINE Bot and Discord Webhook to ensure proper communication.

  6. 詳細日誌記錄 / Detailed Logging System - 完整記錄使用者動作、請求回應、地理位置資訊，支援 Cloudflare Tunnel。Comprehensive logging of user actions, request responses, and geographic information with Cloudflare Tunnel support.

  7. 案件紀錄管理 / Case Record Management - 每個案件自動儲存為獨立檔案，包含完整案件資訊和通報者資料。Each case is automatically saved as an individual file with complete case information and reporter data.

  8. 伺服器錯誤與頁面未建置提醒 / Server Error and Page Not Found Handling - 提供自訂的 404 和 500 錯誤頁面，提升使用體驗。Provides custom 404 and 500 error pages to improve user experience.

  9. 隱私與版權聲明 / Privacy and Copyright Statements - 系統包含隱私權保護政策與版權宣告，確保資料使用合規。The system includes privacy protection policies and copyright statements to ensure compliant data usage.

  10. 公告發布功能 / Announcement Publishing Feature - 管理員可通過網頁界面發布系統公告到LINE群組和Discord頻道，支援選擇性發布和即時狀態反饋。Administrators can publish system announcements to LINE groups and Discord channels through a web interface, with selective publishing support and real-time status feedback.

使用技術 / Technologies Used

  • 後端框架 / Backend Framework: Flask
  • 前端技術 / Frontend Technologies: HTML、CSS
  • 配置管理 / Configuration Management: .env 檔案 / .env files
  • 伺服器環境 / Server Environment: Debian 13
  • 其他 / Others: LINE Bot API 用於訊息廣播功能 / LINE Bot API for message broadcasting functionality

系統架構 / System Architecture

本系統採用雙網站架構，將主要功能和管理功能分離，提高安全性：

This system adopts a dual-website architecture, separating main functionality from administrative functions for enhanced security:

主網站 (Main Website) - 端口 8000

  • 網域 / Domain: www.fcuems.tw
  • 用途 / Purpose: 緊急事件通報的主要介面 / Main interface for emergency incident reporting
  • 檔案 / File: app.py
  • 功能 / Features: 案件填報、LINE Bot 回調處理、公開API / Case reporting, LINE Bot callback handling, public APIs

管理網站 (Admin Website) - 端口 5000

  • 網域 / Domain: admin.fcuems.tw
  • 用途 / Purpose: 系統管理介面 / System administration interface
  • 檔案 / File: admin_app.py
  • 功能 / Features: 公告發布、日誌管理、案件紀錄管理、系統測試 / Announcement publishing, log management, case records management, system testing
  • 訪問限制 / Access Restriction: 通過 Cloudflare Zero Trust 保護 / Protected by Cloudflare Zero Trust
  • 認證方式 / Authentication: 逢甲大學 O365 帳號登入 / FCU O365 Account Login

Cloudflare Tunnel 服務 / Cloudflare Tunnel Service

  • 服務提供者 / Service Provider: Cloudflare Tunnel (cloudflared)
  • 功能 / Features:
    • 安全的內網穿透 / Secure internal network tunneling
    • SSL/TLS 加密連線 / SSL/TLS encrypted connections
    • DDoS 防護 / DDoS protection
    • 全球 CDN 加速 / Global CDN acceleration
    • Zero Trust 身份認證 / Zero Trust identity authentication
  • 配置 / Configuration: 自動管理 SSL 憑證和路由 / Automatic SSL certificate and routing management

Zero Trust 身份認證 / Zero Trust Authentication

  • 認證提供者 / Identity Provider: Microsoft Azure AD (逢甲大學 O365)
  • 認證網域 / Authentication Domain: o365.fcu.edu.tw
  • 適用範圍 / Scope: 僅限管理網站 (admin.fcuems.tw)
  • 認證流程 / Authentication Flow:
    1. 使用者訪問管理網站 / User accesses admin website
    2. 自動重導向至 Cloudflare Zero Trust 登入頁面 / Automatic redirect to Cloudflare Zero Trust login page
    3. 選擇「逢甲大學 O365」登入選項 / Select "FCU O365" login option
    4. 使用 o365.fcu.edu.tw 帳號密碼登入 / Login with o365.fcu.edu.tw account credentials
    5. 成功認證後重導向回管理網站 / Redirect back to admin website after successful authentication
  • 安全特性 / Security Features:
    • 多因素認證支援 / Multi-factor authentication support
    • 單點登入 (SSO) / Single Sign-On (SSO)
    • 會話管理 / Session management
    • 存取日誌記錄 / Access logging

系統結構 / System Structure

app.py                     - 主程式檔案 / Main application file (端口 8000)
admin_app.py               - 管理網站檔案 / Admin website file (端口 5000)
config.py                  - 配置管理模組 / Configuration management module
logger.py                  - 日誌管理模組 / Logging management module
case_manager.py            - 案件管理模組 / Case management module
message_broadcaster.py     - 訊息廣播模組 / Message broadcasting module
api_routes.py             - API路由模組 / API routes module
data/
    ├── .env              - 環境變數配置檔案 / Environment variables configuration file
templates/
    ├── Inform/            - 填報相關的頁面模板 / Incident reporting page templates
    │   ├── 02_event.html  - 案件分類選擇 / Case classification selection
    │   ├── 03_location.html - 地點輸入 / Location input
    │   ├── 05_room.html   - 教室或位置輸入 / Room or position input
    │   ├── 06_content.html - 補充資訊輸入 / Additional information input
    │   ├── 07_check.html  - 案件確認頁面 / Case confirmation page
    │   ├── 08_sending.html - 廣播傳送頁面 / Broadcasting transmission page
    │   └── 10_sended.html - 廣播完成頁面 / Broadcasting completion page
    ├── Information/       - 其他資訊頁面模板 / Other information page templates
    │   ├── 404.html       - 404 頁面未建置 / 404 page not found
    │   ├── 500.html       - 500 伺服器錯誤 / 500 server error
    │   ├── README.html    - 網站資訊頁 / Website information page
    │   ├── 著作權宣告.html - 版權宣告 / Copyright statement
    │   └── 隱私權保護政策.html - 隱私權政策 / Privacy policy
    ├── admin/             - 管理網站頁面模板 / Admin website page templates
    │   ├── home.html     - 管理首頁 / Admin homepage
    │   └── announcement.html - 公告發布頁面 / Announcement publishing page
    └── system/            - 系統管理頁面模板 / System management page templates
        ├── test.html     - 系統測試頁面 / System test page
        ├── logs.html     - 日誌管理頁面 / Log management page
        └── records.html  - 案件紀錄管理頁面 / Case records management page
server/
    ├── boot.sh           - 主網站啟動腳本 / Main website startup script
    ├── setup.sh          - 統一安裝腳本 / Unified installation script
    ├── setup_all.sh      - 完整安裝腳本 / Complete installation script
    ├── admin_setup.sh    - 管理網站安裝腳本 / Admin website installation script (備用)
    ├── ems-flask.service - 主網站 systemd 服務檔案 / Main website systemd service file
    └── ems-admin.service - 管理網站 systemd 服務檔案 / Admin website systemd service file
logs/                     - 日誌檔案目錄 / Log files directory
record/                   - 案件紀錄檔案目錄 / Case record files directory
requirements.txt          - Python 套件依賴 / Python package dependencies

安裝與執行 / Installation and Execution

快速安裝 / Quick Installation

推薦方式：使用統一安裝腳本 / Recommended: Use Unified Installation Script

# 1. 將應用程式檔案複製到目標目錄 / Copy application files to target directory
sudo cp -r . /var/www/ems/web/

# 2. 執行統一安裝腳本 / Run unified installation script
sudo ./server/setup_all.sh

統一安裝腳本會自動完成以下工作 / The unified installation script will automatically complete the following tasks:

  1. ✅ 建立必要的目錄結構 / Create necessary directory structure
  2. ✅ 安裝系統依賴套件 (Python 3, pip, venv, dev tools) / Install system dependencies
  3. ✅ 建立Python虛擬環境 / Create Python virtual environment
  4. ✅ 安裝Python依賴套件 / Install Python dependencies
  5. ✅ 建立logs、record、data目錄 / Create logs, record, data directories
  6. ✅ 設定正確的目錄權限 / Set correct directory permissions
  7. ✅ 安裝systemd服務 / Install systemd services
  8. ✅ 啟動服務 / Start services

手動安裝 / Manual Installation

前置需求 / Prerequisites

  1. 安裝 Python 3.8 或更新版本 / Install Python 3.8 or newer
  2. 安裝相關套件，請執行以下指令 / Install required packages with the following commands: 
    pip install -r requirements.txt
  3. 配置環境變數 / Configure environment variables:
    • 複製 data/.env.example 到 data/.env / Copy data/.env.example to data/.env
    • 填入您的 LINE Bot API 金鑰、Discord Webhook URL 等 / Fill in your LINE Bot API keys, Discord Webhook URL, etc.

執行方式 / Execution Methods

開發環境執行 / Development Environment Execution:

  1. 主網站 / Main Website:

    python app.py

    訪問 http://127.0.0.1:8000 / Visit http://127.0.0.1:8000

  2. 管理網站 / Admin Website:

    python admin_app.py

    訪問 http://127.0.0.1:5000 / Visit http://127.0.0.1:5000

生產環境部署 / Production Environment Deployment:

統一安裝腳本 / Unified Installation Script:

# 安裝全部服務 / Install all services (default)
./server/setup_all.sh

# 只安裝主網站 / Install main website only
./server/setup.sh main

# 只安裝管理網站 / Install admin website only
./server/setup.sh admin

# 安裝全部服務 / Install all services (explicit)
./server/setup.sh all

Cloudflare Tunnel 設定 / Cloudflare Tunnel Configuration:

系統使用 Cloudflare Tunnel (cloudflared) 提供安全的網際網路存取：

The system uses Cloudflare Tunnel (cloudflared) to provide secure internet access:

  1. 安裝 cloudflared:

    # Debian/Ubuntu
wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
dpkg -i cloudflared-linux-amd64.deb

  2. 設定 Tunnel:

    # 登入 Cloudflare
cloudflared tunnel login

# 建立 Tunnel
cloudflared tunnel create ems-tunnel

# 設定路由
cloudflared tunnel route dns ems-tunnel www.fcuems.tw
cloudflared tunnel route dns ems-tunnel admin.fcuems.tw

  3. 設定 config.yml:

    tunnel: ems-tunnel
credentials-file: /root/.cloudflared/ems-tunnel.json

ingress:
  - hostname: www.fcuems.tw
    service: http://localhost:8000
  - hostname: admin.fcuems.tw
    service: http://localhost:5000
    originRequest:
      access:
        required: true
        teamName: "your-team-name"
  - service: http_status:404

  4. 設定 Zero Trust 認證:

    # 在 Cloudflare Dashboard 中設定 Access Policy
# 1. 前往 Zero Trust > Access > Applications
# 2. 新增 Application: admin.fcuems.tw
# 3. 設定 Identity Provider: Microsoft Azure AD
# 4. 設定 Domain: o365.fcu.edu.tw
# 5. 設定 Access Policy 允許逢甲大學使用者存取

  5. 啟動 Tunnel 服務:

    # 安裝為系統服務
cloudflared tunnel --config /path/to/config.yml service install

# 啟動服務
systemctl start cloudflared
systemctl enable cloudflared

個別安裝腳本 / Individual Installation Scripts (備用選項):

# 主網站安裝 / Main website installation
./server/setup.sh main

# 管理網站安裝 / Admin website installation  
./server/setup.sh admin
  1. 服務管理 / Service Management: 
    # 主網站服務 / Main website service
systemctl start ems-main     # 啟動 / Start
systemctl stop ems-main      # 停止 / Stop
systemctl restart ems-main   # 重啟 / Restart

# 管理網站服務 / Admin website service
systemctl start ems-admin    # 啟動 / Start
systemctl stop ems-admin     # 停止 / Stop
systemctl restart ems-admin  # 重啟 / Restart

系統測試 / System Testing

系統提供快速測試功能，確保 LINE Bot 和 Discord Webhook 正常運作：

The system provides quick testing functionality to ensure LINE Bot and Discord Webhook are working properly:

  1. 訪問管理網站 / Access admin website: https://admin.fcuems.tw 或 http://127.0.0.1:5000
    • 注意 / Note: 透過網域訪問需要逢甲大學 O365 帳號認證 / Domain access requires FCU O365 account authentication
    • 本地測試 / Local Testing: 使用 http://127.0.0.1:5000 可跳過認證 / Use http://127.0.0.1:5000 to bypass authentication
  2. 點擊「系統測試」卡片 / Click "System Test" card
  3. 點擊「測試 LINE Bot」按鈕測試 LINE 群組訊息 / Click "Test LINE Bot" button to test LINE group message
  4. 點擊「測試 Discord」按鈕測試 Discord 頻道訊息 / Click "Test Discord" button to test Discord channel message
  5. 查看測試結果和狀態訊息 / Check test results and status messages

公告發布功能 / Announcement Publishing Feature

系統提供完整的公告發布功能，管理員可以通過網頁界面發布系統公告到LINE群組和Discord頻道：

The system provides comprehensive announcement publishing functionality, allowing administrators to publish system announcements to LINE groups and Discord channels through a web interface:

  1. 訪問管理網站 / Access admin website: https://admin.fcuems.tw 或 http://127.0.0.1:5000
    • 認證要求 / Authentication Required: 網域訪問需要逢甲大學 O365 帳號 / Domain access requires FCU O365 account
  2. 點擊「發布公告」卡片 / Click "Announcement Publishing" card
  3. 輸入公告內容 / Enter announcement content
  4. 選擇發布平台 / Select publishing platforms:
    • ✅ LINE 群組 / LINE Group
    • ✅ Discord 頻道 / Discord Channel
    • ✅ 兩個平台都發送 / Send to both platforms
  5. 點擊「發布公告」按鈕 / Click "Publish Announcement" button
  6. 查看發布結果和狀態 / Check publishing results and status

功能特點 / Feature Highlights:

  • 🎯 選擇性發布 / Selective Publishing: 可選擇發布到LINE、Discord或兩個平台 / Can choose to publish to LINE, Discord, or both platforms
  • 📝 豐富內容支援 / Rich Content Support: 支援多行文本、表情符號和格式化內容 / Supports multi-line text, emojis, and formatted content
  • ⚡ 即時狀態反饋 / Real-time Status Feedback: 發布狀態即時顯示，包括成功/失敗詳情 / Real-time publishing status display with success/failure details
  • 🔄 錯誤處理 / Error Handling: 完善的錯誤提示和重試機制 / Comprehensive error prompts and retry mechanisms
  • 📊 日誌記錄 / Logging: 所有發布操作都會記錄到系統日誌 / All publishing operations are logged to system logs
  • 📱 響應式設計 / Responsive Design: 支援桌面和移動設備 / Supports desktop and mobile devices

公告格式 / Announcement Format:

📢 系統公告 / System Announcement

[您的公告內容 / Your announcement content]

發布時間 / Published Time: YYYY-MM-DD HH:MM:SS
發布者 / Publisher: 系統管理員 / System Administrator

使用範例 / Usage Examples:

  • 🔔 系統維護通知 / System maintenance notifications
  • 📋 重要政策更新 / Important policy updates
  • 🚨 緊急事件提醒 / Emergency incident alerts
  • 📢 活動公告 / Event announcements
  • ⚠️ 服務狀態變更 / Service status changes

日誌管理 / Log Management

系統提供完整的日誌管理功能，記錄所有使用者動作和系統事件：

The system provides comprehensive log management functionality, recording all user actions and system events:

  1. 訪問管理網站 / Access admin website: https://admin.fcuems.tw 或 http://127.0.0.1:5000
    • 認證要求 / Authentication Required: 網域訪問需要逢甲大學 O365 帳號 / Domain access requires FCU O365 account
  2. 點擊「日誌管理」卡片 / Click "Log Management" card
  3. 查看即時統計資料 / View real-time statistics
  4. 過濾和搜尋日誌 / Filter and search logs
  5. 匯出日誌檔案 / Export log files
  6. 清除舊日誌 / Clear old logs

記錄內容包括 / Logged content includes:

  • 使用者 IP 地址和地理位置 / User IP address and geographic location
  • 所有頁面訪問和動作 / All page visits and actions
  • 事件通報詳細資訊 / Incident reporting details
  • 系統測試結果 / System test results
  • 錯誤和警告訊息 / Error and warning messages

日誌檔案管理 / Log File Management:

  • 每天自動創建新的日誌檔案 / Automatic daily log file creation
  • 檔案命名格式：flask_app_YYYYMMDD.log / File naming format: flask_app_YYYYMMDD.log
  • 支援多天日誌查詢和匯出 / Support multi-day log query and export
  • 自動日誌輪轉，避免單一檔案過大 / Automatic log rotation to prevent oversized files

案件紀錄管理 / Case Record Management

系統提供完整的案件紀錄管理功能，每個案件都會自動儲存為獨立檔案：

The system provides comprehensive case record management functionality, with each case automatically saved as an individual file:

  1. 訪問管理網站 / Access admin website: https://admin.fcuems.tw 或 http://127.0.0.1:5000
    • 認證要求 / Authentication Required: 網域訪問需要逢甲大學 O365 帳號 / Domain access requires FCU O365 account
  2. 點擊「案件紀錄」卡片 / Click "Case Records" card
  3. 查看案件統計資料 / View case statistics
  4. 按案件類型、日期範圍過濾 / Filter by case type and date range
  5. 查看案件詳情和下載個別檔案 / View case details and download individual files
  6. 匯出和清除案件紀錄 / Export and clear case records

公開API使用 / Public API Usage

系統提供公開的API接口，供外部系統整合使用：

The system provides public API interfaces for external system integration:

API端點 / API Endpoints:

  • GET /api/stats - 系統統計資料 / System statistics
  • GET /api/cases - 案件列表 / Case list
  • GET /api/cases/{case_id} - 案件詳情 / Case details
  • GET /api/logs - 日誌資料 / Log data

使用範例 / Usage Examples:

# 獲取系統統計
curl "https://www.fcuems.tw/api/stats"

# 獲取最近10個案件
curl "https://www.fcuems.tw/api/cases?limit=10"

# 獲取特定案件詳情
curl "https://www.fcuems.tw/api/cases/case_20250922_001.txt"

# 獲取今日日誌
curl "https://www.fcuems.tw/api/logs?date_from=2025-09-22&date_to=2025-09-22"

# 本地測試 (Local Testing)
curl "http://localhost:8000/api/stats"

詳細文檔 / Detailed Documentation: 請參閱 API_DOCUMENTATION_PUBLIC.md

案件紀錄內容包括 / Case record content includes:

  • 案件基本資訊（類型、地點、位置、補充資訊）/ Basic case information (type, location, position, additional info)
  • 通報者資訊（IP、地理位置、瀏覽器）/ Reporter information (IP, geographic location, browser)
  • 廣播結果（Discord、LINE 發送狀態）/ Broadcast results (Discord, LINE send status)
  • 完整訊息內容和系統資訊 / Complete message content and system information

案件檔案管理 / Case File Management:

  • 檔案命名格式：case_YYYYMMDD_HHMMSS.txt / File naming format: case_YYYYMMDD_HHMMSS.txt
  • 每個案件一個檔案，便於管理和查詢 / One file per case for easy management and query
  • 支援多天案件查詢和匯出 / Support multi-day case query and export
  • 自動儲存到 record/ 資料夾 / Automatically saved to record/ folder

環境變數配置 / Environment Variables Configuration

系統使用 .env 檔案進行配置管理，包含以下變數：

The system uses .env files for configuration management, including the following variables:

# LINE Bot 設定 / LINE Bot Configuration
LINE_BOT_API_TOKEN=your_line_bot_api_token
LINE_WEBHOOK_HANDLER=your_webhook_handler
LINE_GROUP_ID=your_group_id

# Discord Webhook 設定 / Discord Webhook Configuration
DISCORD_WEBHOOK_URL=your_discord_webhook_url

# 資料庫設定 / Database Configuration
DB_HOST=localhost
DB_USER=your_db_user
DB_PASSWORD=your_db_password
DB_NAME=emergency_system

版權與授權 / Copyright and License

  • 版權擁有者 / Copyright Owner: 王建葦
  • 授權對象 / Licensee: 逢甲大學衛保救護隊 / Feng Chia University Health and Safety Rescue Team
  • 版本 / Version: Alpha 2.0.0

聯絡方式 / Contact Information

  • 管理員名稱 / Administrator Name: 王建葦
  • 管理員信箱 / Administrator Email: admin@mail.jw-albert.tw
  • 伺服器資訊 / Server Information: ems.fcuems.tw (Debian 13)
  • 主網站 / Main Website: https://www.fcuems.tw
  • 管理網站 / Admin Website: https://admin.fcuems.tw
  • 網路服務 / Network Service: Cloudflare Tunnel (cloudflared)

隱私權政策與版權 / Privacy Policy and Copyright

本系統遵守相關隱私權保護條款，所有使用者資料將嚴格保密，詳細條款請參閱 隱私權保護政策 與 著作權宣告。

This system complies with relevant privacy protection terms. All user data will be strictly confidential. For detailed terms, please refer to Privacy Policy and Copyright Notice.

About

緊急報警通報台

www.fcuems.tw

Topics

emergency-response emergency-services fcu

Resources

Readme
Activity

Stars

0 stars

Watchers

2 watching

Forks

0 forks
Report repository

Contributors

Languages