It is a small web app, provides schools and students help with the enrollment process.

This project is work in progress.

Run make init to start the application locally (requires Docker Compose).

It starts NGINX, PHP-FPM, PostgreSQL, and other Docker containers, builds assets (ReactJS), runs DB migrations (PostgreSQL), NGINX starts to listen to connections on http://localhost:8080
The app is written with Symfony PHP framework for the back end and ReactJS on the front end.

I use GitHub Actions, on each Push into the repo it:

• Starts a set of docker containers
• Validate composer files (PHP code dependencies)
• Validate code style for PHP
• Runs migrations to set up a database
• Runs acceptance tests (I use Selenium WebDriver and Codeception PHP Testing framework)

Run make tests-init (once) and then you can run make tests-a to start acceptance tests in dev.
Here is a YouTube video to see what's going on inside the browser while running the acceptance tests (selenium container provides this feature, with noVNC you can see in your browser how the browser in your tests would look like.

App functionality so far (youtube video)

You have 3 main sections - each is available only for specific roles. You may travel to different sections from the main page.

You can create all 3 users in development by running command make users

School

You can create registration request as a School on page
http://localhost:8080/school/register

Or log in as existed user for School - with email and password: http://localhost:8080/school/login

school@example.com
school

Student

You can register as a Student on page
http://localhost:8080/student/register

Or log in as existed user for School - with email and password: http://localhost:8080/student/login

student@example.com
student

Admin

You can sign in as Admin user here
http://localhost:8080/admin/login

Email: admin@example.com
Pass: admin

Then you'll see all schools applications and you can confirm their registrations
http://localhost:8080/admin/school

After every confirmation an email is sent to the school email address with an invitation link to set up their password and activate an account.
Invitation link gets expired in 5 days.

During the development

Run make watch to start yarn watch. That way you may instantly (-ish) see the result when you change js, scss, etc. files.

What's left to do before release

Student

1. Create applications by students 1. Autocomplete, search for school 1. Autocomplete, search for course 1. Autocomplete, search for intake 1. Next step to fill out the form 1. Passport number, passport expiry, full name, preferred name, date of birth 1. See applications and statuses as student - reviewed, accepted, offer granted

1. See offer as student - download as pdf?
2. Save drafts, show last step on page reload application_draft student_id created_at data on application create - delete all drafts by userId

School

1. See applications as school - list

1. Accept application as school
2. Send offer to student as school
3. See stats on dashboard as school - how many applications by month, by course

Back

1. Add emails

1. Add logs
2. Add GA 1. Add HTTPS 1. Add fake data - generate schools, courses, intakes, students, applications 1. Add fake data prod clean and run
3. Remove all forms, use serialization

Known issues

1. After login need to update app state on front, to get current logged in user email.