tezigudo / hackathon-2023-hackaty

hackathon-2023-hackaty

KU Hackathon 2023

รายละเอียดโครงการ : https://docs.google.com/document/d/1bn_71K9RF_K8MaBbZNgUAtS7PgFJkon91lOat7AtFxw/edit

SOS-Alert @Hackathy : “ ให้เราเป็นความปลอดภัยของนิสิต มก ”

• นิสิตไม่รู้ต้องแจ้งเหตุด่วนเหตุร้ายที่ไหน
• นิสิตไม่ได้รับแจ้งเตือนเหตุฉุกเฉิน
• นิสิตไม่รู้จะร้องเรียนปัญหากับใคร

Members

• Wanatprun Kradee
• Supawee Borvornsaktavorn
• Thanadol Udomsirinanchai
• Preawpan Thamapipol
• Setthanan Thongpanchang

SOS-Alert

SOS Alert ให้บริการ 3 ฟีเจอร์ เพื่อตอบโจทย์ปัญหาของนิสิต

1. SOS Call(ซอส-คอล)

"ไม่รู้เบอร์ติดต่อฉุกเฉินพี่ยาม พอเกิดเหตุขึ้นจริงก็ทำอะไรไม่ถูก" ไม่ต้องกังวลอีกต่อไป เรารวบรวมเบอร์ติดต่อฉุกเฉินไว้ให้คุณใน SOS Call (ซอส-คอล) แล้วหากไม่รู้จะติดต่อใคร สามารถกดปุ่มสีแดงเพื่อติดต่อหน่วยรักษาความปลอดภัย ม.เกษตรเพื่อประสานงานต่อได้!

2. SOS Alert Notification

“ แย่แล้ว นั่นมันควันอะไรกัน นี่มันเกิดอะไรขึ้นกันเนี่ย ” เคยไหมเวลาเกิดเหตุฉุกเฉินแต่เราก็ไม่เคยรู้เลยว่ามันเกิดอะไรขึ้น ปัญหานี้จะหมดไฟเพียงแค่มีฟีเจอร์ SOS Alert Notification ฟีเจอร์ที่จะคอยแจ้งเตือนเหตุฉุกเฉินบนแอพ Nisit KU และยังสามารถรู้ระยะห่างของตัวนิสิตและจุดเกิดเหตุ

3. SOS Alert Map

“ ไฟตรงคณะเราดับ อยากแก้ไขจัง ต้องร้องเรียนที่ใครเนี่ย” ฟีเจอร์ SOS Alert Map ที่จะสามารถร้องเรียนปัญหาที่พบเจอในมหาวิทยาลัยได้ แล้วปัญหานั้นจะขึ้นใน Map เพื่อให้เรารู้ตำแหน่ง รายละเอียด รูปภาพ และยังสามารถเห็นด้วยกับคำร้องของเพื่อนที่แจ้งปัญหานั้นไปแล้วด้วยได้

Design

• Figma File(View)
• Figma Prototype(Nisit)
• Figma Prototype(Admin)

Backend

Install and run

How to Install

make sure that you have python in your computer

first, clone this repository by type this command in your terminal at your choosen path

git clone https://github.com/hackathon-ku/hackathon-2023-hackaty.git Hackaty

go to project directory

cd Hackaty
cd Backend

you have to create file name .env to configuration

.env file template looks like sample.env you can modify value and copy it into .env

you may use this to be a MONGO_URL

mongodb://root:1234@localhost:27018/mongo-hackaty?authSource=admin

run and initialize mongo(db)

docker compose up -d

install requirements

pip install -r requirements.txt

How to run

activate the virtual environment by typing this

in mac/linux

>> source env/bin/activate

Windows

>> env\Scripts\activate

now to run server by type this

uvicorn main:app --reload

Frontend

Technologies Used

• React.js
• Vite
• TypeScript
• Google Maps API

Installation and Setup

Clone the Repository

git clone https://github.com/hackathon-ku/hackathon-2023-hackaty.git
cd hackathon-2023-hackaty

Install Dependencies

Using npm:

npm install or yarn install

Configure Google Maps API

To use the Google Maps API, you will need to obtain an API key. Once you have it, create a .env file in the root of the project and add your API key as REACT_APP_GOOGLE_MAPS_API_KEY=your_api_key_here After starting the project, open http://localhost:5173 in your browser to use the application.

Contributing

Contributions to the SOS Alert project are highly appreciated. If you're interested in helping out:

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Contact

For any questions, suggestions, or issues, please contact us at [[email protected]]. You can also raise an issue in the GitHub repository.

Acknowledgements

Thanks to all contributors and maintainers. Special thanks to Nisit KU for the collaboration and support. Note: Ensure all placeholders (like your API key, email address, etc.) are replaced with actual, relevant information for your project.