idurar / idurar-erp-crm

Open Source Headless ERP CRM E-Commerce Accounting Software | Node Js React
https://cloud.idurarapp.com/
Other
5.92k stars 1.74k forks source link

Implement Swagger for API Documentation and Testing #736

Open vincedotcode opened 8 months ago

vincedotcode commented 8 months ago

Feature Request

Is your feature request related to a problem? Please describe. A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

Describe the solution you'd like I would like to propose the addition of Swagger to the project to enable better API documentation and testing. Swagger, also known as OpenAPI, provides a set of tools for designing, building, and documenting RESTful APIs. Implementing Swagger can help both new and existing contributors to understand and test the API endpoints more efficiently.

Describe alternatives you've considered Any alternative solutions or features you've considered.

Additional context Add any other context or screenshots about the feature request here. If the project has many endpoints, a Swagger implementation would make it significantly easier to manage the API documentation and ensure it stays up-to-date as the project evolves.

Implementing Swagger could bring the following benefits:

I believe adding Swagger will be a great value-add to the project and can make the development process more efficient.

Thank you for considering this enhancement.

BalesabuGodugu commented 8 months ago

@vincedotcode could you please assign to me this feature, I would like to implement it

BalesabuGodugu commented 8 months ago

team i am working on this issue. please assign on my name

vincedotcode commented 8 months ago

@salahlalami Would you be able to assign this feature to me and @BalesabuGodugu as well

We'll plan this as a user story and break it down into multiple tasks accordingly

239yash commented 8 months ago

@vincedotcode @salahlalami I also want to contribute to this feat, Let me know, If I can work on this

239yash commented 8 months ago

@vincedotcode I have added a base setup for swagger. We need to add documentation for request, response type and other details.