鏟子超人 - 災害資訊整合平台

災害發生時，讓需要幫助的人找到資源，讓想幫助的人找到需求

一個專為救災情境設計的資源配對平台，解決災害發生時資訊不流通的問題。

---

📸 專案展示

百字摘要

本系統整合災情通報、需求管理、物資倉儲、捐款金流、避難所資訊，提供使用者即時發布需求與查詢資源；管理者可在後台審查並進行數據分析，後端採交易管理與索引優化確保一致性與效能，並以 NoSQL 做行為分析。

系統截圖

展示影片

YouTube 影片連結、 Google Drive 影片連結

簡報、報告數連結

簡報 PDF 連結、 報告書 PDF 連結

---

🚀 快速開始

環境需求

• Node.js (with npm): v18 或以上
• PostgreSQL: v14 或以上
• MongoDB: v6.0

事前準備

1. Node.js

   請先手動安裝Node.js+npm

2. PostgreSQL

請在你的 PostgreSQL 中建立資料庫，使用 release 的.backup file 還原資料庫。

3. .env

   更名專案根目錄的 .env.example 為 .env，並填入你的資料庫連線資訊 (DB_USER, DB_PASSWORD 等)。

⚡ 一鍵啟動 (Mac/Linux)

1. 自動啟動：專案根目錄已設定 concurrently，可使用 npm 指令同時啟動前後端。

npm install # 首次執行需安裝依賴
npm run install:all # 一鍵安裝所有依賴 (Root, Backend, Frontend)
npm start

若不幸無法自動啟動，你也可以使用我們寫好的腳本，一鍵安裝所有module，並且同時啟動前後端Server！

2. Shell 腳本 (Mac/Linux)：

./start_system.sh

3. 批次檔(Windows)：

./start_system.bat

---

服務入口

前端：http://localhost:5173/ 後端：http://localhost:3000/

---

🛠️ 詳細安裝步驟

如果你想分開啟動或進行開發，請參考以下步驟。

1. 資料庫設定 (Database)

首先確保 PostgreSQL 服務已啟動。

1. 建立資料庫：

   CREATE DATABASE disaster_platform;

2. 匯入資料表結構：

   # 請確保你在專案根目錄
   psql -U postgres -d disaster_platform -f backend/schema.sql

2. 後端設定 (Backend)

1. 進入後端目錄並安裝依賴：

   cd backend
   npm install

2. 設定環境變數： 在 backend 目錄下建立 .env 檔案，內容如下（請依實際情況調整）：

   DB_USER=postgres
   DB_PASSWORD=your_password
   DB_HOST=localhost
   DB_PORT=5432
   DB_NAME=disaster_platform
   PORT=3000

3. 啟動後端伺服器：

   node server.js
   # 或使用 nodemon (開發模式)
   # npm install -g nodemon
   # nodemon server.js

   成功後會顯示：🚀 Full API running at http://localhost:3000

3. 前端設定 (Frontend)

1. 進入前端目錄並安裝依賴：

   cd frontend
   npm install

2. 啟動開發伺服器：

   npm run dev

   成功後會顯示：Local: http://localhost:5173/

---

🛠 技術架構

• Frontend: React 19, TypeScript, Tailwind CSS, Vite
• Backend: Node.js, Express
• Database: PostgreSQL
• API: RESTful API (/api/...)