RaxySchool

School Absence Analysis System for São Paulo State Public Schools
Explore the documentation »

View Releases · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Features
5. Analysis Examples
6. Roadmap
7. Contributing
8. License
9. Contact
10. Acknowledgments

About The Project

RaxySchool is a comprehensive tool for analyzing student absences in São Paulo's state education network, using data provided by the São Paulo State Department of Education (SED). The system enables school administrators, pedagogical coordinators, and educators to identify absence patterns and make data-driven decisions to improve attendance and academic performance.

Why use RaxySchool?

Detailed Analysis: Visualize absence patterns by period, school, classroom, and region

Automated Notifications: Send automatic messages to parents about student absences

Visual Reports: Intuitive graphs and reports to facilitate decision-making

Risk Identification: Detect students at risk of school dropout

User-Friendly Interface: Modern and easy-to-use graphical interface

(back to top)

Built With

(back to top)

Getting Started

To start using RaxySchool, follow these simple installation steps.

Prerequisites

Before you begin, make sure you have the following requirements:

Python: Version 3.7 or higher

python --version

Google Chrome: Updated browser (for Selenium automation)

SED Access: Valid credentials to access the Department of Education system

Installation

1. Clone the repository

git clone https://github.com/leonifrazao/RaxySchool.git

2. Navigate to the project directory

cd RaxySchool

3. Install the required dependencies

pip install -r requirements.txt

4. Configure your SED access credentials (if necessary)

# Edit the settings in the configuration file

5. Run the application

python RaxySchool.py

(back to top)

Usage

Main Interface

The RaxySchool interface was developed with CustomTkinter to provide a modern and intuitive experience:

System Login: Enter your SED credentials

Period Selection: Choose the school term you want to analyze

Data Visualization: View reports and graphs in real-time

Export: Export reports in PDF or Excel format

Command Examples

# Load data from a specific school
from RaxySchool import DataAnalyzer

analyzer = DataAnalyzer()
analyzer.load_school_data(school_id="123456")

# Generate absence report
report = analyzer.generate_absence_report()
report.export_to_pdf()

For more examples and detailed documentation, see the Wiki

(back to top)

Features

• Automatic Data Collection: Extraction of data directly from SED
• Pattern Analysis: Identification of absence trends
• Parent Notifications: Automated alert system
• Modern Graphical Interface: Developed with CustomTkinter
• Interactive Charts: Dynamic data visualizations
• Report Generation: Export to PDF and Excel
• Period Analysis: Data comparison between quarters/trimesters
• School/Classroom Analysis: Breakdown by school unit

In Development:

• Mobile Version
• WhatsApp API Integration
• Interactive Web Dashboard
• Real-Time Alert System

(back to top)

Analysis Examples

1. Absence Distribution by Period

Temporal analysis that identifies critical periods with high absence rates throughout the school year, enabling preventive actions at strategic moments.

2. Automated Messages

Automatic notification system for guardians about student absences, promoting greater family engagement in school life.

3. Absences by Classroom

Detailed comparison of absences between different grades and school cycles, helping identify classes that need specific interventions.

4. Impact on Academic Performance

Cross-analysis between absence patterns and student academic performance, revealing the correlation between attendance and school achievement.

5. Geographic Analysis

Mapping of absences by region, school, and district, allowing identification of areas that need special attention.

(back to top)

Roadmap

• SED data collection system
• Graphical interface with CustomTkinter
• Basic report generation
• Email notification system
• Implement web dashboard
• WhatsApp Business API integration
• School dropout prediction system using ML
• Mobile application (iOS/Android)
• REST API for integration with other systems
• Automatic backup system
• Multi-language support
• Offline mode for data analysis

See the open issues for a full list of proposed features and known issues.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion to improve the project, please fork the repository and create a pull request. You can also simply open an issue with the "enhancement" tag. Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Top Contributors

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

Leoni Frazão - @leonifrazao

Project Link: https://github.com/leonifrazao/RaxySchool

(back to top)

Acknowledgments

Resources and tools that made this project possible:

• Python Documentation
• Pandas Documentation
• CustomTkinter
• Selenium WebDriver
• Secretaria de Educação do Estado de São Paulo
• Choose an Open Source License
• Img Shields
• GitHub Pages

(back to top)

---

Developed with a focus on education

Helping schools improve student attendance and performance through data

Back to top