Attendance App

An Interactive Presentation

Welcome to the Attendance App

This section introduces the Attendance App, its core purpose, and what it offers. It's designed to give you a quick understanding of how this web-based tool streamlines attendance management for educators and administrators, making daily tasks more efficient and reporting simpler.

Purpose

Streamline student attendance management for teachers and administrators.

Target Audience

End-users (teachers, administrators) and developers.

Getting Started

Access via web browser, secure login and sign-up process.

User Interface

Intuitive two-panel layout with sidebar navigation, header actions, and helpful modals/toasts.

Key Features

Authentication, dashboards, grade hub, attendance taking, notifications, reporting, admin controls, responsive design.

Teacher's Playbook: Core Functionality

This section guides teachers through the daily use of the Attendance App. It covers essential tasks from setting up their classes to recording attendance and generating reports. Understanding these workflows will enable efficient and accurate management of student records.

Typical Teacher Workflow

Select School Year
Access Grade Hub
Manage Students/Sections/Subjects
Take Attendance (Daily/Subject)
View Summary & Export Reports
Attendance Summary Dashboard

Provides an overview of attendance data. You can filter by grade, section, year, and month to see total counts and percentages for Present, Absent, and Late. A student breakdown is also available.

Grade Level Hub: Management

Your control center for each class, with three tabs:

  • Students: Add students manually or import via CSV.
  • Sections: Create and manage class sections.
  • Subjects: Define subjects for per-subject attendance.
Taking Attendance (Daily & Per Subject)

Record student presence (P), absence (A), or lateness (L). Choose between "Entire Day" or "Per Subject" mode. Remember to save your attendance after marking.

Notifications & Alerts

Receive automatic alerts for students reaching 20 (info) and 40 (critical) absences. Click the bell icon to view and clear notifications.

Exporting DepEd SF2 Reports

Generate official DepEd SF2 reports to Excel. Fill in school details, select grade, section, and month, then export. Note: Only daily attendance is included in SF2 exports.

Admin's Command Center

This section outlines the powerful administrative capabilities within the Attendance App. Admins primarily manage teacher accounts and their data access, ensuring smooth operation across the institution. These features are designed for oversight and data management at a higher level.

Teacher Management

View and select registered teachers to manage their assignments and data.

Assigning Grades

Assign specific grade levels to teachers, granting them access to manage data for those grades.

Copying Teacher Data

Duplicate all data (students, attendance, etc.) from one teacher to another for a specific school year. Use with caution as it overwrites existing data.

Deleting Teacher Data

Permanently remove a teacher and all their associated data across all school years. This action is irreversible.

Behind the Scenes: Technical Architecture

This section provides a deeper look into how the Attendance App is built. It details the frontend and backend technologies, the database structure, and the external libraries that power the application. This overview is particularly useful for developers or those interested in the system's underlying architecture.

Technology Stack Overview

The application is built using a modern web stack, primarily leveraging Google's Firebase for backend services and standard web technologies for the frontend.

Firestore Database Structure

Explore the hierarchical structure of the Firestore NoSQL database, showing how collections and documents are organized.

  • assignments
    • {schoolYear}
      • {teacherId}
  • artifacts
    • {appId}
      • {users}
        • {userId}
          • schoolYears
            • {schoolYear}
              • grades
                • {gradeId}
                  • students/{studentId}
                  • sections/{sectionId}
                  • subjects/{subjectId}
                  • attendance/{recordId}
          • notifications
            • {notificationId}
  • users
    • {userId}

Help & Support

This section provides quick solutions to common issues, highlights important security considerations, and directs you to where you can find further assistance. It's your go-to resource for maintaining smooth operation and addressing any questions you may have.

Troubleshooting Common Issues
  • "Error initializing application": Check network, Firebase config.
  • Authentication Errors: Verify email/password, ensure account exists.
  • "No grades assigned": Admin needs to assign grades.
  • "No students/sections/subjects yet": Add data via Grade Level Hub.
  • "Failed to save attendance": Check network, console for errors.
  • SF2 Export issues: Ensure daily records exist for period, all fields filled.
  • Modals/Toasts not appearing: Refresh page, check console for JS errors.
Security Considerations
  • Firebase Security Rules: Crucial for data access control.
  • Authentication: Standard security for user management.
  • Data Validation: Client-side validation, server-side recommended.
  • Admin Access: `ADMIN_EMAIL` for simple admin ID; consider Firebase Custom Claims for robust production.
Support

For any issues, questions, or feature requests, please contact the application administrator or development team.