evento

evento

evento是一款渐进式 Web 应用程序 (PWA)，旨在通过用快速、高效的数字解决方案取代传统的纸笔方法来简化和现代化大学活动的出勤跟踪。

特征

• 渐进式 Web 应用程序 (PWA) ：可安装在任何设备上并可离线访问，提供类似于本机应用程序的无缝用户体验。
• 二维码扫描：快速扫描学生证二维码，即时记录出勤情况。
• 实时数据：即时更新和数据同步，提供准确、最新的考勤记录。
• 用户角色和权限：主管理员、辅助管理员和具有受限功能的官员的不同访问级别，以确保安全和正确的数据管理。
• 通知和警报：与出勤相关的事件和潜在问题的自定义通知。
• 响应式设计：完全响应式设计，确保在任何设备上的可用性，包括台式机、平板电脑和智能手机。

截图

莫诺雷波

安装

要安装和使用evento ，请按照下列步骤操作：

1. 克隆存储库：

   git clone https://github.com/domsdano/events-attendance.git

2. 导航到项目目录：

    cd evento

3. 安装依赖项：

   npm install

4. 运行应用程序：

   npm start

5. 构建用于生产的应用程序：

   npm run build

6. 部署应用程序：按照您的首选方法将构建的应用程序部署到您的 Web 服务器或托管服务。

用法

1. 登录：管理员和官员使用他们的凭据登录。
2. 扫描二维码：使用内置二维码扫描仪扫描学生证以获取出勤信息。
3. 查看考勤记录：访问和管理实时考勤数据。
4. 通知：接收与出勤相关的事件的警报和通知。
5. 用户管理：管理用户并分配适当的角色和权限。

使用的技术

• React ：用于构建用户界面。
• Tailwind CSS ：用于设计应用程序的样式。
• shadcn ：用于可访问的组件。
• Zustand ：用于状态管理。
• React Query ：用于数据获取和缓存。
• Html5Qrcode ：用于二维码扫描。
• React Toastify ：用于通知和警报。
• TypeScript ：为了类型安全和更好的开发人员体验。
• Framer Motion ：用于平滑的动画和过渡。

贡献

欢迎为改进evento做出贡献！如果您有任何想法、建议或错误报告，请提出问题或提交拉取请求。

1. 分叉存储库：

   git fork https://github.com/domsdano/events-attendance.git

2. 创建一个新分支：

   git checkout -b feature/your-feature-name

3. 提交您的更改：

   git commit -m " Add your commit message "

4. 推送到您的分支机构：

   git push origin feature/your-feature-name

5. 打开拉取请求：描述您的更改并提交拉取请求以供审核。