OmniShift

Giới thiệu

OmnShift là một nền tảng web quản lý ca làm việc cho nhân viên. Hỗ trợ quản lý các doanh nghiệp có thể quản lý lịch làm việc của nhân viên, giúp nhân viên chọn và cập nhật lịch làm nhanh chóng. Tương lai sẽ còn phát triển hơn, trở thành hệ thống quản lý toàn doanh nghiệp.

Tech Stack

Frontend

• ReactJS: Thư viện JavaScript để xây dựng giao diện người dùng hiện đại, dễ bảo trì.
• Tailwind CSS: Framework CSS utility-first, giúp phát triển UI nhanh chóng và responsive.
• Chart.js: Hiển thị biểu đồ trực quan cho báo cáo, thống kê.
• FullCalendar: Tích hợp lịch sự kiện để quản lý tiến trình ký và lịch hẹn.

Backend

• Node.js: Nền tảng JavaScript runtime.
• Express.js: Framework nhẹ để xây dựng API RESTful.
• Sequelize: ORM cho Node.js, dễ dàng thao tác với cơ sở dữ liệu.
• PostgreSQL (Neon): Hệ quản trị cơ sở dữ liệu quan hệ mạnh mẽ và cloud-native.

Authentication & Storage

• Firebase Auth: Xác thực người dùng bảo mật và dễ tích hợp.
• Firebase Storage: Lưu trữ và quản lý tệp tài liệu điện tử.

Cấu trúc thư mục

omnishift_source/
│
├── client/                # Ứng dụng frontend
│   ├── public/
│   ├── src/
│   │   ├── assets/
│   │   ├── components/
│   │   ├── hooks/
│   │   ├── pages/
│   │   ├── services/
│   │   ├── App.jsx
│   │   ├── main.jsx
│   ├── index.html
│   ├── vite.config.js
│
├── server/                # Ứng dụng backend
│   ├── src/
│   │   ├── configs/
│   │   ├── controllers/
│   │   ├── models/
│   │   ├── repositories/
│   │   ├── routes/
│   │   ├── services/
│   │   ├── app.js
│   │   ├── server.js
│   ├── .env
│
├── package.json
├── README.md
└── ...

Các tính năng chính

• Xác thực người dùng bằng Firebase Auth
• Lưu trữ và chia sẻ tài liệu trên Firebase Storage
• Quản lý lịch ký và nhắc nhở bằng FullCalendar
• Thống kê, báo cáo bằng biểu đồ Chart.js
• Quản lý database quan hệ với Sequelize và PostgreSQL (Neon)

Cách chạy dự án

1. Cài đặt dependencies

# Cài đặt cho frontend
cd client
npm install

# Cài đặt cho backend
cd ../server
npm install

2. Cấu hình biến môi trường

Tạo file .env cho server với các thông tin:

// client/.env

// backend/.env
PORT=8887

3. Chạy dự án

# Chạy frontend
cd client
npm run dev

# Chạy backend
cd ../server
npm run dev

Đóng góp

Chúng tôi chào đón mọi đóng góp! Hãy fork repo, tạo pull request và mở issue để cùng phát triển OmniShift tốt hơn.

Giấy phép

Bản quyền thuộc OmniMer, phát triển bởi đội ngũ phát triển OmniShift.