eSchool - Microservice and Containers based open source School Administration Software

Linux Build Status for 'main' branch

Image	Status	Image	Status
Enrolling.API		ESchool.GraphQL
CertificateProcessing.API		Frontend.Blazor
WebStatus		CodeQL
ExamManagement.API		LibraryManagement.API
ResultProcessing.API

System requirements

Recommended Hardware requirements for Windows

• Windows 10 Pro, Education or Enterprise
• 64-bit Processor with Second Level Address Translation (SLAT)
• CPU support for VM Monitor Mode Extension (VT-c on Intel CPU's)
• Virtualization must enabled in BIOS. Typically, virtualization is enabled by default
  • This is different from having Hyper-V enabled

Software requirements for Windows

• Docker Community Edition (aka. Docker for Windows) - Requires Windows 10 Pro 64 bits and Hyper-V enabled
• Latest .NET 5.0 SDK from: https://www.microsoft.com/net/download
• (Optional) Visual Studio 2019
• (Optional) Visual Studio Code

NOTE: If you can install Docker Desktop for Windows following the instruction in https://docs.docker.com/docker-for-windows/install/, then you are good to go.

How to Run

After installing Docker in your machine, just run

$ docker-compose up

in terminal from project's root folder. The first run can take 30 mins to 1 hour depending on your internet speed, as it will download required docker images from the docker hub. After everything starts up, you can access the Enrolling.API swagger UI by visiting http://localhost:5102/swagger/

How to Run on Visual studio

• Open eSchool project on Visual studio then right click on docker-compose project.
• From the menu select Set as Startup Project.
• Now, run the project by clicking docker-compose from the main status menu bar.

Note: You have to run Docker desktop before running eSchool project on visual studio

Service URLs

• eSchool Frontend (Blazor) - http://localhost:5200/
• eSchool Gateway (GraphQL) - http://localhost:5101/graphql/
• WebStatus - http://localhost:5107/
• Enrolling.API (REST - Swagger) - http://localhost:5102/swagger/
• Enrolling.API (GraphQL - Banana Cake Pop) - http://localhost:5102/graphql/
• Distributed Tracing (Jaeger) - http://localhost:16686
• Logging (Seq) - http://localhost:5140/

Tech & Tools

• .NET Core
• Docker
• Orchestrators: Kubernetes
• Visual Studio
• SQL Server
• Azure DevOps
• RabbitMQ
• API Gateway
• GraphQL
• Blazor

Contributing

Everyone is welcome to contribute, whether it's in the form of code, documentation, bug reports, feature requests, or anything else. See the Contributing guide for more details.

Sending feedback and pull requests

As mentioned, we'd appreciate your feedback, improvements and ideas. You can create new issues at the issues section, do pull requests and/or send emails to [email protected]

Thanks to all the people and bot (😉) who have contributed

License

Code licensed under the MIT License.