Allergyap

Allergypa, is Serverless App With Flutter entirely using AWS services and adheres to established best practices.

Folder Structure • Services Used • How To Use • Architecture • Documentation • Related • License

Folder Structure

This project contains source code for a serverless that can be deployed using the serverless framework. It also contains frontend code built using Next.js that can also be easily deployed or run locally. Also added are the architecture diagrams for the project.

• admin - Admin code for the application.
• allergy-architecture - Contains architectural diagram and workflows for the application
• backend-cognito - Contains the backend/serverless portion of the application built using the serverless framework
• backend-java - Contains the backend java

Services Used

The application utilizes the event driven architecure and is built using AWS services powered by the serverless framework. The following are the AWS services explicitly used

• Amazon S3
• Amazon DynamoDB
• AWS Lambda
• Amazon API Gateway
• Amazon Cognito
• AWS CloudFormation
• AWS STS

How To Use

To clone and run this application, you'll need Git and Node.js v16+ (which comes with npm) installed on your computer. Also create an account with AWS, install the AWS CLI in locally, create an IAM user and add this user to AWS CLI as a profile. This profile user should have necessary permissions to deploy the backend section to AWS. Next, add required credentials to the .env file created from the command below. From your command line:

# Clone this repository
$ git clone https://github.com/AndresPalacio/allergypa/tree/master

# Go into the repository
$ cd allergypa

# Copy environment variable

# Deploy backend (run from folder root)
$ npm i serverless -g
$ cd serverless-backend && npm i && serverless deploy


# Run Admin (run from folder root)
$ cd admin && npm i && npm run dev

Architecture

Documentation

You can find an article that explains the project here

License

MIT

---

LinkedIn @jeisson-palacio

Create a test user

In order to test the application, you will need a test-user in your Cognito User Pool. You can create a user by going to the User Pool directly in the AWS Console or you can run the following two CLI commands (which requires AWS credentials with the right permissions):

aws cognito-idp admin-create-user --user-pool-id <your_user_pool_id> --username <your_user_id>

aws cognito-idp admin-set-user-password --user-pool-id <your_user_pool_id> --username <your_user_id> --password <your_password> --permanent

exmaple

aws cognito-idp sign-up --client-id <your_cliend_id> --username correoadmin@gmail.com --password Prueba1234* --user-attributes Name="email",Value="correoadmin@gmail.com" Name="name",Value="Jeisson Palacio" --region us-east-1 --profile default

aws cognito-idp admin-confirm-sign-up --user-pool-id <your_pool_id> --username correoadmin@gmail.com --region us-east-1

• Create a new Cognito user pool:

aws cognito-idp create-user-pool --pool-name {{name}}

• List all user pools:

aws cognito-idp list-user-pools --max-results {{10}}

• Delete a specific user pool:

aws cognito-idp delete-user-pool --user-pool-id {{user_pool_id}}

• Create a user in a specific pool:

aws cognito-idp admin-create-user --username {{username}} --user-pool-id {{user_pool_id}}

• List the users of a specific pool:

aws cognito-idp list-users --user-pool-id {{user_pool_id}}

• Delete a user from a specific pool:

aws cognito-idp admin-delete-user --username {{username}} --user-pool-id {{user_pool_id}}