feat: integrate swag fmt and improve CI/CD workflows

- Add swag fmt to git pre-commit hook and CI/CD pipeline
- Create comprehensive CONTRIBUTING.md guide with AI section
- Update ADR-0013 with swag fmt documentation
- Fix swagger generation to include all endpoints
- Improve local testing scripts and workflows
- Update Dockerfile for better swagger handling
- Fix CI/CD workflow file references

adr/0013-openapi-swagger-toolchain.md

@@ -334,6 +334,116 @@ go install github.com/swaggo/swag/cmd/swag@latest
 // @host localhost:8080
 // @BasePath /api
 package main
+```
+
+### Swag Formatting Integration
+
+To ensure consistent swagger comment formatting, we've integrated `swag fmt` into our workflow:
+
+#### Git Hooks
+Added to `.git/hooks/pre-commit`:
+```bash
+# Run swag fmt to format swagger comments
+echo "Running swag fmt..."
+if command -v swag >/dev/null 2>&1; then
+    swag fmt
+    if [ $? -ne 0 ]; then
+        echo "ERROR: swag fmt failed"
+        exit 1
+    fi
+else
+    echo "swag not installed, skipping swag fmt"
+fi
+```
+
+#### CI/CD Integration
+Added to `.gitea/workflows/go-ci-cd.yaml` lint-format job:
+```yaml
+- name: Install swag
+  run: go install github.com/swaggo/swag/cmd/swag@latest
+
+- name: Run swag fmt
+  run: swag fmt
+```
+
+#### Benefits
+- **Consistent Formatting**: Automatic formatting of swagger comments
+- **Pre-Commit Validation**: Catches issues before commit
+- **CI/CD Enforcement**: Ensures formatting in all pull requests
+- **Team Consistency**: Everyone follows the same rules
+- **Automatic Fixes**: Issues are fixed automatically
+
+#### Usage
+```bash
+# Format swagger comments manually
+swag fmt
+
+# Format is automatically run in:
+# - pre-commit hook
+# - CI/CD lint-format job
+```
+=======
+### Final Implementation
+
+```bash
+# 1. Install swaggo
+go install github.com/swaggo/swag/cmd/swag@latest
+
+# 2. Add swagger metadata to main.go
+// @title DanceLessonsCoach API
+// @version 1.0
+// @description API for DanceLessonsCoach service
+// @host localhost:8080
+// @BasePath /api
+package main
+```
+
+### Swag Formatting Integration
+
+To ensure consistent swagger comment formatting, we've integrated `swag fmt` into our workflow:
+
+#### Git Hooks
+Added to `.git/hooks/pre-commit`:
+```bash
+# Run swag fmt to format swagger comments
+echo "Running swag fmt..."
+if command -v swag >/dev/null 2>&1; then
+    swag fmt
+    if [ $? -ne 0 ]; then
+        echo "ERROR: swag fmt failed"
+        exit 1
+    fi
+else
+    echo "swag not installed, skipping swag fmt"
+fi
+```
+
+#### CI/CD Integration
+Added to `.gitea/workflows/go-ci-cd.yaml` lint-format job:
+```yaml
+- name: Install swag
+  run: go install github.com/swaggo/swag/cmd/swag@latest
+
+- name: Run swag fmt
+  run: swag fmt
+```
+
+#### Benefits
+- **Consistent Formatting**: Automatic formatting of swagger comments
+- **Pre-Commit Validation**: Catches issues before commit
+- **CI/CD Enforcement**: Ensures formatting in all pull requests
+- **Team Consistency**: Everyone follows the same rules
+- **Automatic Fixes**: Issues are fixed automatically
+
+#### Usage
+```bash
+# Format swagger comments manually
+swag fmt
+
+# Format is automatically run in:
+# - pre-commit hook
+# - CI/CD lint-format job
+```
 
 ### Annotation Placement Considerations