Diễn đàn trao đổi về cây cảnh PLANTGURU

Thông tin nhóm

Thứ tự nhóm	19
Thành viên	MSSV
Đàm Thành Nam	21522354
Đoàn Thanh Tùng	21521646
Lê Khai Trí	21521565
Lê Ngọc Hưng	21520889
Lê Anh Tuấn	21521626

---

Hướng dẫn chạy dự án Next.js

Yêu cầu hệ thống

• Node.js (phiên bản >= 16.x) và npm (đi kèm với Node.js).
• Kiểm tra Node.js: node -v
• Kiểm tra npm: npm -v

Cài đặt Node.js và npm

1. Truy cập Node.js và tải phiên bản LTS (khuyến nghị).
2. Cài đặt Node.js theo hướng dẫn của hệ điều hành (Windows, macOS, Linux).
3. Sau khi cài đặt, kiểm tra lại bằng lệnh:
   • node -v
   • npm -v

Cách chạy dự án

1. Clone dự án Sử dụng git để clone project:

   git clone https://github.com/tungnk123/plant-guru-nextjs
   

2. Cài đặt thư viện

   • Chuyển vào thư mục dự án:

     cd <PROJECT_FOLDER>
     

   • Cài đặt các gói thư viện cần thiết:

     npm install
     

3. Chạy dự án trong môi trường dev

   • Khởi chạy dự án Next.js:

     npm run dev
     

   • Mở trình duyệt và truy cập: http://localhost:3000

4. Build dự án (sản phẩm cuối cùng)

   • Nếu muốn build project cho môi trường sản phẩm:

     npm run build
     

   • Sau khi build thành công, chạy thử ứng dụng:

     npm start
     

---

Cấu trúc dự án

Thư mục/File	Mô tả
/app	Chứa source code của project
/components	Các thành phần giao diện (UI components)
/public	Chứa các file tĩnh như hình ảnh, favicon, file animation lottie
next.config.js	File cấu hình cho Next.js
package.json	File chứa các library bên thứ ba mà project sử dụng

---

Hướng dẫn chạy dự án ASP.NET Web API

Backend chính:

Yêu cầu hệ thống

• .NET SDK (phiên bản >= 6.0)
• Kiểm tra .NET SDK: dotnet --version
• Visual studio (phiên bản 2022)

1. Clone dự án: Sử dụng git để clone project:

   git clone https://github.com/21522354/PlanGuruAPI

2. Mở dự án bằng visual studio:
   • Mở visual studio chọn mở dự án có sẵn và trỏ thư mục đến thư mục dự án
3. Chạy dự án:

   dotnet run

   • Hoặc bấm vào nút run trong giao diện của visual studio

Cấu trúc dự án

Thư mục/tầng	Mô tả
Domain	Chứa các entity model cốt lõi của ứng dụng
Application	Định nghĩa các luồng nghiệp vụ cụ thể (interface) mà ứng dụng cung cấp
Infrastructure	Sử dụng model từ Domain và sử dụng các giao diện được cung cấp từ Application để triển khai hệ thống
Application(Web API)	Chứa các endpoint để người dùng thao tác với hệ thống

---

Quiz Service:

1. Clone dự án: Sử dụng git để clone project:

   git clone https://github.com/TriKhaiLe/QuizService.git

2. Tích hợp Firestore:

   • Truy cập Firebase Console
   • Tạo project mới
   • Trong mục Project settings, tab General, sao chép Project ID
   • Chuyển sang tab Service Account, tạo khóa riêng mới và tải file JSON về
   • Trong Firestore database, tạo một database mới
   • Mở file appsettings.json.example trong project Quiz Service, gắn dữ liệu cho ProjectId đã sao chép, và gắn giá trị cho CredentialsPath là đường dẫn tới file private key JSON đã tải về

3. Lấy Gemini API key:

   • Truy cập AI Studio và lấy API key, gắn vào ApiKey trong appsettings.json.example

4. Đổi tên file:

   • Đổi tên file appsettings.json.example thành appsettings.json

5. Chạy dự án:

   • Chạy lệnh dotnet run từ thư mục chứa file appsettings.json

Sản phẩm từ source code

FrontEnd:

• Link GitHub: https://github.com/tungnk123/plant-guru-nextjs
• Link Deploy: https://plantguru.vercel.app

Backend:

• Link GitHub: https://github.com/21522354/PlanGuruAPI
• Link Deploy: https://un-silent-backend-develop.azurewebsites.net/swagger/index.html

---

Hình ảnh demo của trang web