This contains source code for learning platform. Currently, it is in development phase.

Project currently relies on Django and Django Rest Framework with PostgreSQL as database, in the nearest future proper frontend will be implemented, preferrably using Vue.js framework.

This is a monolithic service that exposes both frontend stuff and REST API. Frontend stuff can be found in src/frontend directory. API calls are made under /api/v1/<endpoint>. Currently they are undocumented.

In case of non-trivial logic, i.e. when ready methods delivered by DRF or Django need to be overloaded, custom error handling is implemented. It's goal is to hide low-level details behind a generic Exceptions understood by views. Example errors I want to hide are:

• KeyError
• BotoCoreError
• IntegrityError

Such errors are translated to ProcessingException and this to ProcessingApiException which inherits from APIException.

Example:

models.py:

class BaseLesson(PolymorphicModel):
    # ...
    def complete(self, user: User):
        try:
            CompletedLesson.objects.create(lesson=self, user=user)
        except IntegrityError as e:
            raise ProcessingException(detail="Already marked as complete.") from e

views.py:

class LessonViewSet(ModelViewSet):
    # ...
    @action(
        detail=True,
        methods=["PATCH", "POST"],
        url_path="mark-as-complete",
        url_name="mark_as_complete",
    )
    def mark_as_complete(self, request: Request, pk: int) -> Response:
        lesson = self.get_object()
        try:
            lesson.complete(user=self.request.user)
        except ProcessingException as e:
            raise ProcessingApiException(detail=e.detail) from e
        return Response(status=status.HTTP_204_NO_CONTENT)

You need to know Python or JS and have docker-compose installed.

Documentation can be found under localhost:8000/docs/ endpoint. Requires DEBUG to be set to be to True.

1. Copy .env.example file to .env. It should contain all necessary variables set for local development.
2. Run docker-compose up. By default, it will start Django's development server that you can access on http://localhost:8000/

Run docker-compose run web python manage.py test.

Project is set up to be deployed automatically on AWS architecture after each push to the master branch.

I am not going to pretend this isn't going to be a commercial project. While I'm very much in favor of open source, I'm also going to turn this into a commercial project. I know that some people may dislike this, so I want to make it very clear from the beginning.

Nonetheless, since this is an open source project, you may still submit Pull Requests, and I'll be happy to review them. You might go through the Issues page to search for "Good first issue" if you are looking for something simple. I'm working on it in my spare time, so I may be slow to respond, but I'm happy to share my knowledge and help those, who want to help me. If you want to learn something new - go ahead :-)