SPARCS Auth Service

A serverless REST API implemented with Clean Architecture and Domain Driven Design

Architecture

This project follows the clean architecture style and structured the codebase accordingly.

Image credit to Thang Chung under MIT terms

Most important rule:

Source code dependencies can only point inward. Nothing in an inner circle can know anything about something in an outer circle. In particular, the name of something declared in an outer circle must not be mentioned by the code in the inner circle. That includes functions and classes. variables, or any other named software entity.

Setup Local

Run:

1. Make sure you have Python 3.8 installed

pip install pipenv==2023.5.19 --user

pipenv install

pipenv shell

Run Local

uvicorn main:app --reload --log-level debug --env-file .env

Deploy to AWS Lambda

Install serverless framework

npm install -g serverless

Install serverless plugins

npm install

Deploy it

serverless deploy --stage 'dev' --aws-profile 'default'

Resources

• https://fastapi.tiangolo.com/
• https://www.serverless.com/framework/docs
• https://react.dev/reference/react
• https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html