Geco-SchoolPlan is an open-source scheduling software designed for schools, training organizations, and educational associations.

It allows you to:

• Easily schedule classes, groups, teachers, and rooms
• View timetables in real time with a single click
• Simplify educational organization

• Schools, middle schools, high schools, and training centers
• Educational coordinators looking for a simple and efficient solution
• Developers seeking a modular foundation for a school-oriented application

✅ Clear and intuitive interface
✅ Modular open-source architecture
✅ Easy deployment locally or on a server
✅ Full control over your data
✅ Real-time visible modifications
✅ Caching system for students not connected to the app
✅ Drag-and-drop course rescheduling

It consists of:

• 🛠️ a web frontend for schedule management (modification, assignment, visualization),
• 📱 a mobile application for teachers and students, in read-only mode:
  👉 Geco-SchoolPlan-App

You can try Geco-SchoolPlan online at the following address:

👉 http://212.132.114.62:3000

Test Credentials:

• ✉️ Email: test@test.com
• 🔒 Password: 123456

The Android application for Teacher and Student:
Releases

✅ Bug fixing
✅ Installation
✅ VPS Server with Software (Ionos)

• 🔐 User authentication (teachers and students)

• 📆 Course and timetable management

• 🧍‍♂️ Supervision scheduling

• 📲 Secure mobile API

• 🔒 JWT-based authentication

• 🛡️ Login attempt limitation

• 🧩 Role-based access control

• 🔐 Encrypted QR codes for secure mobile authentication

• 🌐 Multilingual support:

  System interface languages: French, English, Spanish and German

  Teacher & Student app languages: French, English, Spanish, German, Arabic, and Russian

• Node.js
• MongoDB
• npm or yarn

1. Clone the repository:

   git clone https://github.com/Michaux-Technology/Geco-SchoolPlan.git cd Geco-SchoolPlan

2. Install backend dependencies:

   cd backend npm install

3. Install frontend dependencies:

   cd ../frontend npm install

4. Create a .env file inside backend with the following variables:

   MONGODB_URI=mongodb://localhost:27017/Geco-SchoolPlan JWT_SECRET=your_jwt_secret PORT=5000 ENCRYPTION_KEY=geco-school-plan-2024-secure-key

5. Create a .env file inside frontend with the following variables:

   VITE_SCHOOL_NAME=My School VITE_API_URL=http://xxx.xxx.xxx.xxx:5000 VITE_SCHOOL_NAME=Geco School VITE_ELEVE_USERNAME=eleve VITE_ELEVE_PASSWORD=1234 VITE_ENSEIGNANT_USERNAME=enseignant VITE_ENSEIGNANT_PASSWORD=1234 VITE_ENCRYPTION_KEY=votre_cle_secrete_unique_32_caracteres

xxx.xxx.xxx.xxx is your Server Backend IP

VITE_ELEVE and VITE_ENSEIGNANT are used for QR Code

🔐 QR Code Encryption (Optional but Recommended):

• VITE_ENCRYPTION_KEY: Secret key for encrypting QR code data (32 characters)
• Add ENCRYPTION_KEY=votre_cle_secrete_unique_32_caracteres to backend .env
• See QR_CODE_ENCRYPTION.md for detailed configuration

cd backend npm start

cd frontend npm run dev

• 🔐 JWT-based authentication
• 🛡️ Brute-force login protection
• 🔒 Role-based access control
• ⚖️ GDPR compliant

Contributions are welcome!
Feel free to open an issue or submit a pull request to suggest improvements or report bugs.

This project is distributed under the Business Source License 1.1, which means:

• ✅ Free for development, testing, research, and personal use
• ❌ Not allowed in production environments without a commercial license

To use Geco-SchoolPlan in a production environment (schools, companies, public servers, etc.), you must obtain a commercial license.

📩 License contact:
michaux@free.fr
michaux@magenda.de

Starting July 4, 2030, this project will automatically be relicensed under GPL v3 (fully open source).