academico-sis / academico

Lavarel-based school management platform for small and medium institutions

About this project

Academico is an open-source, Lavarel-based school management platform. Its main features include course management, enrolments management, resources scheduling, reports and stats. It is primarily targeted at small and medium-sized institutions who need a simple and affordable solution to manage their school and courses.

Documentation

• Technical documentation (EN), including installation instructions -> https://github.com/laxsmi/academico/wiki

Maintainers wanted!

This project does not get as much of my attention as it deserves. The "pro" version is used by several institutions but the "oss" version (that does not require a paid Backpack for Laravel licence) does not receive many updates anymore. I would be happy to put a link here to an active fork of this project, if you want to take over the free/oss version. Please open an issue if you're interested to discuss it!

Contributors welcome! ✨

This project was initially developed to address the needs of one specific school, however, the project is now published as open-source with the hope that others might use it. Developing and maintaining a new application takes a lot of time and effort, and everyone wins by using and improving already existing software instead of starting from scratch every time.

There are many areas of this project that would greatly benefit from new contributions. It is also a great way to train your developer skills. Some issues are available to beginners. Please see this page on the wiki for details.

Thanks goes to these wonderful people (emoji key):

Thomas Debay 💻 📖 🤔 🚧 ⚠️	Marc Marina Miravitlles 💻	Damien Baudet 🚧 💻	Mubarak M Aminu 💻	Ibrahim Abdullahi Aliyu 💻	AleksandarMitevski ⚠️ 💻	Tano Rojas ⚠️ 💻
Nikola Cirkovic 🐛 🚧	quieneslatern 🌍	Vitor Micillo 🚧	Tatiana Goloviznina 💻	Rm Yakovenko 💻	Sam 💻 📖	Wynton Franklin 💻
Collins Kiplangat Rono 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

License

This software is based on Laravel and Backpack for Laravel. The OSS branch (default) is free for everyone to use, with limited features. The "pro" branch requires a Backpack license and adds features such as filters, exports, more advanced CRUD forms, etc.

academico's Issues

Enrollment process

• add new saldos status
• review status changes workflow
• renvoyer schéma

translate Vue components

Améliorer l'ergonomie de la fonction "cours non assignés"

vérifier compte sur page d'accueil. Ne pas compter les cours passés.

Sélection de cycle par défaut depuis l'écran d'accueil

Improve leads management

• add loading indicator on lead status update
• Make LeadStatus model translatable
• Auto-disable students who didn't come back for current period

Use config instead of env() helper

Ajouter un indicateur de statut de la connexion avec le serveur comptable

Reports improvements

• Optimize report methods (number of queries)

• Bug when saving head_count in a course (see model events)

• Write tests

Compte des commentaires non correct sur la page d'accueil

Merge changes in "master" branch to afcuenca and keep only one branch

Permettre d’activer/désactiver les modules selon les besoins du centre

Avoid page reloads

Throughout the application, Vue components are making AJAX requests to create, edit or delete entries. However, full reactivity is not yet achieved since a full page reload is performed after making the AJAX call.

Search for location.reload to find related methods.

The goal is to avoid page reloads altogether, and to use the response contents to pull in fresh data instead. It's also possible to use GET routes to retrieve fresh data and populate the vue components.

Check attendance from student's details

It should not be possible to drag events to "unassigned" in calendar.overview

Skills module improvements

• compute a percentage according to the skills evaluation for each student

• Custom skills ordering

• Keyboard navigation

• import export skillsets from file = this allows to have skills for any custom course we may need, but keeping preset files ready for our recursive courses.

Improve the Attendance features

• Improve the pending attendance display (teacher dashboard)

• Avertissement visuel en cas de dépassement des 3 absences (pour l'étudiant, le prof et l'administration)

• Une fiche de présence avec le détail des séances sera disponible pour le cycle en cours ainsi que pour les cycles précédents

• permettre de télécharger cette fiche en PDF

• Amélioration des notifications par mail : envoyer un feedback à l'étudiant à chaque fois avec prof et administration en copie

Add teacher bug

Make LeadStatus model translatable

Split setup() method (Backpack)

Edit or add phone numbers for students and additional contacts

Leaves management

• allow to create a leave per period (from ... to ...)
• review how hours are counted in HR dashboard

Fix JS assets

• load <script src="/js/app.js"></script> GLOBALLY.
  Be aware of possible conflicts with other libraries or scripts on specific pages...

• Remove fullcalendar from public (clean webpack.mix.js)

• Use code-splitting to reduce size of JS bundle

• clean the dependencies (require modules instead of copying files from node_modules)

Self-maintenance

• scheduled tasks monitoring (last execution date)

• setup assistant. Create periods, users...

• automate users purge (who have never been enrolled)

• hide older reports

• retry failed jobs

• allow to reset client status for all currently enrolled students (move all converted to lead)

Additional features

• last login date -> monitor

• allow parent login ?

• email when a course result is made available

Better testing

• unit tests everywhere
• replace broken feature tests with highest-level browser tests
• test hours count in HR dashboard
• Test reports

Cart improvements

• improve feedback and checks related to the link with Accounting server

This issue is related to #119

Enrollment improvements

• confirm selected course before enrolling (modal)

• allow secretary to change the status on an enrollment

if pending
-> allow to switch course

if paid
-> allow to switch course
-> allow to cancel (refund)

When cancelling an enrolment, actually delete it.

Refactor the student enrollment modal to avoid code repetition

Present in attendance.event and course.show and maybe more

Exempt courses or event from attendance sheet

Sync lists with mailing software

• code to an interface
• schedule executions and monitor them

Improve course creation process

• Autocomplete for name, price, hours fields... according to rythm for instance
• Child course creation should be done at once (checkbox when creating the course)
• Course edition should be flexible: leave the option to rewrite events when changing the teacher or the room. Same thing when updating the course schedule

Historique des actions

par étudiant, par inscription, par cours etc.

Attendance improvements

• gérer les présences lors de l'ajout ou retrait d'un étudiant après le début du cours

Improve Attendance UI

• add number of students with missing attendance in course attendance view (attendance.course)

• add reactivity to edit a student's attendance record directly from attendance.course instead of attendance.event

Improve the Results Monitoring module

• filter by period

Refactor

• Reduce business logic in the controllers => introduce a new layer of abstraction between controllers and models (Service Layer Pattern) to hold all the business logic, grouped by domain. All the business logic would be encapsulated in specific methods and the controller should only check if the right permission is available for the user, call those methods from the service and compact the data for the view. Services can be injected in controllers using Laravel’s automatic injection, which will easily allow you to mock the services for testing purposes.

• PROFILE THE NUMBER OF DB QUERIES for each action. Some methods are particularly slow and inefficient, for instance all methods retrieving or counting events with incomplete attendance. See for instance Teacher@events_with_pending_attendance and similar.

• improve logging

• clean the dependencies (require modules instead of copying files from node_modules)

• clean routes

Invoicing

• re-enable cart
• improved invoicing
• add books to course
• discounts management
• Gestion des boursiers (catégorie spéciale de dispense de facture, rapports)

Faciliter la création de CP manuels

Par exemple via une création de masse de plusieurs événements même en dehors d'un cours

Allow to edit phone numbers from student details

Enrollments improvements

• do not allow enrollments if the course is closed or if there aren't any spots left

Update contact data

• check phone numbers

• force data update

• add new contact, new phone numbers, etc.

Improve the course action toolbox

• Move coursetimes to "edit" screen
• Move evaluation-related buttons to their own screen
• Move children course to somewhere else (dedicated tab in edit screen?)
• Move attendance to its own screen

Courses syllabi

• Objectifs du cours
• contenus (type syllabus)
• Export liste de compétences
• Infos du cours : dates, modalités, etc.

Improve UI of children courses

• improve messages when creating a new child course : make it clear that the edition page that triggers is for the new course

• The same issue is true for enrolments, in CRUD list and also in student history

• Afin d’éviter les fausses manipulations et améliorer la clarté de l’interface, revoir l'ergonomie de la fonction "créer un cours enfant" et améliorer la lisibilité des relations entre cours parents/enfants dans la liste de cours

• Children should always appear under their parent. Improve clarity in this view (if we are to keep this feature at all). Perhaps rename to sub-courses or sub-blocks

Photo roaster

Allow students to take picture with webcam
Allow teachers to export a roaster for their class

Clients management

• Follow re-enrollments from previous cycle + status + comment

• Objectifs de l'étudiant sur sa fiche.

Allow course result edition without grades or skills

list all enrollments with no result on teacher dashboard.

Validate data in update tunnel

The delete button is making too many DB queries in course.index

Certificate generation

Courses, dates, results

Show feedback when adding a comment

There are several improvements to bring to this operation

• Give the input focus automatically

• If the comment is not valid (for instance < 5 characters) a message should be displayed to the user.

• Flash a notification when the comment has been saved.