datt30 / python_angular_fullstack_poc

A good proof of concept focused on a conventional scenario in which data interacts with frontend and backend through APIS, the complet stack of the POC are below in description.

Poc Fullstack Web Project

A good proof of concept focused on a conventional scenario in which data interacts with frontend and backend through APIS, the complet stack of the POC are below in description.

Fron-end Layer

For create the front-end I used angular 8 and for UI component infrastructure Material Desing.

Back-end and Service Layer

• Framework for APIS with flask
• Tests with unittest for python
• ORM with SQLAlchemy

Data Layer

During this proof of concept I used a local server and SQL Server Express distribution, but also you can use the distribution of SQL Server you prefer, just change the configuration present in api_poc_project/app/config.py

• SERVER = 'localhost\SQLEXPRESS'
• DATABASE = 'POC'
• DRIVER = 'SQL+Server'
• SQLALCHEMY_DATABASE_URI = f'mssql+pyodbc://{SERVER}/{DATABASE}?driver={DRIVER}'
• SQLALCHEMY_TRACK_MODIFICATIONS = False

Also the scripts to create the tables and stored procedures are in the ScriptsDB folder.

Documentation

• You can see the entire documentation in swagger here: https://app.swaggerhub.com/apis-docs/datt30/POC/1.0.0
• Also you can find a postman collection and YAML in DocumentationForAPI folder

How to run the entire app?

• 1. Create local DB with name "POC" in any distribution of SQL Server and run the scripts presents in ScriptsDB folder.
• 2. Execute run.py present in api_poc_project
• 3. Use any browser to access http://127.0.0.1:5000/

Future improvements

• Add central log register for tracking the errors and make troubleshooting application problems easily solved.
• Add tokens to the API and management components.
• Change default port, because port 5000 its not recomended for production.
• Verify CORS politics in clients calls to the API.
• Python script to automatically run ng build command to generate single page integrated with flask in a blueprint. (DevOps improvement)

Missing features

• Call DB stored procedures from backend
• Components in Angular for Bill and ExternalProvider
• API's control to foreign keys in DB

Notes:

• All that you need from python libraries and packages it's present in requeriments.txt
• Feel in complete confidence to contribute to this project :)