https://github.com/silveirinhajuan/cursinho
This is a project aimed at assisting a face-to-face course of a charitable nature. This will be a platform to host in-depth recorded lessons and exercises.
https://github.com/silveirinhajuan/cursinho
charitable charitable-organisations flet python streamlit
Last synced: 7 months ago
JSON representation
This is a project aimed at assisting a face-to-face course of a charitable nature. This will be a platform to host in-depth recorded lessons and exercises.
- Host: GitHub
- URL: https://github.com/silveirinhajuan/cursinho
- Owner: silveirinhajuan
- Created: 2024-11-28T23:12:46.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-12-12T12:40:44.000Z (10 months ago)
- Last Synced: 2025-02-06T04:41:23.628Z (9 months ago)
- Topics: charitable, charitable-organisations, flet, python, streamlit
- Language: Python
- Homepage:
- Size: 92.5 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 📘 Cursinho
**Cursinho** is a digital platform designed to support and optimize the activities of a **charitable preparatory course in Caucaia, Ceará, Brazil**. Our goal is to create accessible and intuitive tools to strengthen free education, offering better resource management and support for students and teachers.
---
## 🎯 Objective
To create a digital environment that facilitates:
- **Student tracking**: Attendance records, grades, and progress monitoring.
- **Class management**: Scheduling, content organization, and activities.
- **Efficient communication**: Connecting students and teachers in an integrated space.
With this, we aim to **maximize the social impact of the preparatory course**, helping more students achieve their academic goals.
---
## 🛠️ Technologies
The project uses the following technologies:
- **[Python](https://www.python.org/)**: The main language for business logic and backend.
- **[Streamlit](https://streamlit.io/)** A framework for building modern, cross-platform interfaces.
---
## 🚀 Features
### 🎓 For Students
- Access to class schedules.
- View materials shared by teachers.
- Track performance in simulations and activities.
### 🧑🏫 For Teachers
- Manage classes and content.
- Record attendance and grades.
- Communicate directly with students.
### 🏫 For Administrators
- Detailed reports on overall performance.
- Organize class schedules and teacher assignments.
- Control access and user permissions.
---
## 📂 Project Structure
```
cursinho/
│
├── app/ # Main application files
│ ├── views/ # Interfaces built with Flet
│ ├── models/ # Data structures and business logic
│ └── controllers/ # Functions connecting logic and UI
│
├── static/ # Static resources (images, CSS)
├── tests/ # Unit tests
└── README.md # Project documentation
```
---
## 🌟 How to Use
1. Clone the repository:
```bash
git clone https://github.com/your-username/cursinho.git
cd cursinho
```
2. Install the dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python main.py
```
4. Access via the browser (or Flet environment, if configured).
---
## 🤝 Contributing
Feel free to contribute to the project! To contribute:
1. Fork this repository.
2. Create a branch for your feature (`git checkout -b my-feature`).
3. Commit your changes (`git commit -m 'Added a new feature'`).
4. Push to the branch (`git push origin my-feature`).
5. Open a **Pull Request**.
---
## 🧑💻 Author
Developed with 💙 by **Juan Guerra**.
To learn more about me or get in touch, visit my [GitHub](https://github.com/your-username) or [LinkedIn](https://linkedin.com/in/silveirinhajuan).
---
## 📜 License
This project is licensed under the **MIT License** – see the [LICENSE](./LICENSE) file for details.