Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Swaggerの導入 #9

Closed
3 tasks done
yuminn-k opened this issue Feb 11, 2024 · 0 comments
Closed
3 tasks done

Swaggerの導入 #9

yuminn-k opened this issue Feb 11, 2024 · 0 comments
Assignees
Labels
⏰ P3 추가적인 의견 제시나 소소한 개선사항 ⚙ Setting 개발 환경 세팅

Comments

@yuminn-k
Copy link
Member

yuminn-k commented Feb 11, 2024

📝 Issueの概要

このIssueの目的は、GinバックエンドフレームワークにSwaggerを導入し、APIドキュメンテーションの自動生成とエンドポイントのテストを容易にすることです。目標は、Swaggerを利用して、開発者がAPIをより効率的に理解し、利用できるようにすることです。

📚 背景情報

現在、我々のプロジェクトではAPIのドキュメントが手動で更新されており、しばしば最新の状態になっていません。Swaggerを導入することで、APIの変更がリアルタイムでドキュメントに反映され、エンドポイントのテストが容易になります。これにより、開発プロセスの効率化を図ります。

📋 具体的な作業内容

  1. Ginフレームワークの現行バージョンを確認し、Swaggerとの互換性を評価する。
  2. 必要なSwagger関連のライブラリとツールを導入する。
  3. 現存するAPIエンドポイントに対してSwaggerアノテーションを追加し、ドキュメントを生成する。

📎 関連するIssueやドキュメント

なし

🖼️ 参考スクリーンショットや図

Swaggerの導入例や、期待されるドキュメントのスクリーンショットをこちらに添付します。

🔄 Issueの進行状況

  • GinSwaggerの互換性評価
  • Swagger関連ライブラリの導入
  • Swaggerアノテーションの追加とドキュメント生成
@yuminn-k yuminn-k added ⚙ Setting 개발 환경 세팅 ⏰ P3 추가적인 의견 제시나 소소한 개선사항 labels Feb 11, 2024
@yuminn-k yuminn-k self-assigned this Feb 11, 2024
@yuminn-k yuminn-k moved this to In progress in ミノリ Feb 11, 2024
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue Feb 13, 2024
- Change the module name in go.mod from 'minori' to 'github.com/YJU-OKURA/project_minori-gin-deployment-repo'.
- This update resolves the issue where Swagger documentation was not accessible due to a module path mismatch.
- Ensure consistent and correct import paths across the project.

Related issue: YJU-OKURA#9
@github-project-automation github-project-automation bot moved this from In progress to Done in ミノリ Feb 13, 2024
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue Feb 24, 2024
- Added 'title' and 'version' fields to Swagger JSON and YAML documentation.
- Ensured compliance with Swagger documentation standards.
- Enhanced clarity and completeness of API documentation.

Related issue: YJU-OKURA#9
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue Feb 26, 2024
Updated Swagger documentation to include new routes and models for group board management in the API. This includes the addition of group board create, update, delete, and list endpoints with detailed descriptions and necessary parameters.

Related issue:
* YJU-OKURA#42
* YJU-OKURA#9
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue Mar 7, 2024
- Adjusted Swagger tags in 'docs.go' for improved categorization and clarity.
- This includes changes in tag naming from lowercase to capitalized versions for consistency.

Related issue: YJU-OKURA#9
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue Apr 5, 2024
Class tagged documents in Swagger Docs were not coming out correctly, so we're updating and committing a new one.

Related issue: YJU-OKURA#9
yuminn-k added a commit to yuminn-k/project_minori-gin-deployment-repo that referenced this issue May 18, 2024
Modified summary, parameter descriptions, and names in Swagger to align with conventions.

Related issue: YJU-OKURA#9
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
⏰ P3 추가적인 의견 제시나 소소한 개선사항 ⚙ Setting 개발 환경 세팅
Projects
Status: Done
Development

No branches or pull requests

1 participant