Cài đặt dự án ClassroomIO

Cài đặt cục bộ

1. Fork repo, sau đó clone bằng lệnh sau (hãy thay thế URL bằng URL từ repo bạn đã fork):

				
					git clone https://github.com/rotimi-best/classroomio.git
				
			

2. Di chuyển vào thư mục dự án:

				
					cd classroomio
				
			

3. Cài đặt đúng phiên bản Node:

Nếu phiên bản Node của bạn không phù hợp với yêu cầu của dự án, hãy dùng nvm (Node Version Manager) để chuyển sang đúng phiên bản:

				
					nvm use
				
			

Nếu chưa có phiên bản yêu cầu, chạy:

				
					nvm install && nvm use

				
			

3. Cài đặt đúng phiên bản Node:

Nếu phiên bản Node của bạn không phù hợp với yêu cầu của dự án, hãy dùng nvm (Node Version Manager) để chuyển sang đúng phiên bản:

				
					nvm use
				
			

4. Cài đặt pnpm (trình quản lý gói thay thế cho npm)

   Xem hướng dẫn cài đặt tại trang chủ pnpm.

Cấu hình file .env

5. Vào các thư mục sau:

   • apps/classroomio-com

   • apps/dashboard

   • apps/backend

Sao chép file .env.example và đổi tên thành .env

Sau đó điền các biến môi trường cần thiết

Cài đặt dependencies

6. Cài tất cả dependencies bằng lệnh:

				
					pnpm i

				
			

Cài đặt Supabase (cơ sở dữ liệu)

7. Cài và khởi động Docker.

Sau đó, trong thư mục dự án, khởi động Supabase:

				
					pnpm supabase:start

				
			

Bạn sẽ thấy kết quả như:

				
					supabase local development setup is running.
    API URL: http://127.0.0.1:54321
GraphQL URL: http://127.0.0.1:54321/graphql/v1
      DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres
  Studio URL: http://127.0.0.1:54323
Inbucket URL: http://127.0.0.1:54324
  JWT secret: super-secret-jwt-token-with-at-least-32-characters-long
    anon key: <anon key>
service_role key: <service_role key>

				
			

Cấu hình Supabase cho dashboard

8. Trong thư mục apps/dashboard, thêm các biến môi trường sau vào file .env:

				
					PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
PUBLIC_SUPABASE_ANON_KEY=<anon key>
PRIVATE_SUPABASE_SERVICE_ROLE=<service_role key>

				
			

• Các giá trị trên lấy từ kết quả khi chạy pnpm supabase:start

• Mở trình duyệt và truy cập Studio URL để xem giao diện quản lý Supabase: http://127.0.0.1:54323

Chạy toàn bộ dự án ở chế độ phát triển:

				
					pnpm dev

				
			

Tất cả các phần sẽ chạy:

• classroomio-com: http://localhost:5174

• backend: http://localhost:3002

• dashboard: http://localhost:5173

• docs: http://localhost:3000

Running a specific project

• classroomio-com: pnpm dev --filter=classroomio-com
• backend: pnpm dev --filter=backend
• dashboard: pnpm dev --filter=dashboard
• docs: pnpm dev --filter=docs

Login into dashboard

• Visit http://localhost:5174/login
• Enter email: admin@test.com
• Enter password: 123456

To learn more about how to login with a dummy account, go here.