docs: add migration documentation, finalization scripts, and update Swagger paths

2026-04-24 00:50:34 +02:00
parent 9f73ed07ba
commit 74df96c298
10 changed files with 1291 additions and 12 deletions
@@ -0,0 +1,80 @@
+
+# Post-Migration Update Checklist
+
+## Files Updated by Script ✓
+- [x] Swagger YAML files (/api/v1 → /api/skydive, etc.)
+- [x] Postman collection and environment files
+- [x] API routes structure (new domains created)
+
+## Manual Verification Required
+
+### 1. Test API Endpoints
+```bash
+npm run local                    # Start the server
+# In another terminal:
+curl http://localhost:3200/api-docs   # Check Swagger UI
+```
+
+### 2. Verify Routes
+- [ ] GET /api/skydive/jumps
+- [ ] GET /api/cms/articles
+- [ ] GET /api/herowars/clans
+- [ ] Other domain-specific endpoints
+
+### 3. Frontend Updates Required (if applicable)
+- [ ] Update Angular environment files (environment.ts, environment.development.ts, etc.)
+- [ ] Replace all API calls from /api/v1, /api/v2, /api/v3 to new domains
+- [ ] Update service layer URLs
+- [ ] Update HTTP interceptors if needed
+
+### 4. Documentation Updates
+- [ ] Update README.md with new API structure
+- [ ] Update API documentation (if any)
+- [ ] Update deployment/infrastructure docs
+- [ ] Update team wiki/documentation
+
+### 5. CI/CD Pipeline (if applicable)
+- [ ] Update build/deployment scripts referencing v1/v2/v3
+- [ ] Update any health checks pointing to old paths
+- [ ] Update monitoring/alerting rules
+
+### 6. Client Applications
+- [ ] Update all client libraries/SDKs
+- [ ] Update mobile app API endpoints
+- [ ] Update third-party integrations
+
+### 7. Database/Caching (if applicable)
+- [ ] Clear any cached references to old endpoints
+- [ ] Update API documentation in databases
+- [ ] Check for hardcoded URLs in configuration
+
+## Git Operations
+```bash
+# View the migration commits
+git log --oneline -5
+
+# If rollback needed:
+git revert <commit-hash>
+
+# Push changes
+git push origin develop
+```
+
+## Optional: Cleanup Old Directories
+```bash
+# After thorough testing, remove old v1/v2/v3 directories:
+rm -rf src/routes/api/v1
+rm -rf src/routes/api/v2
+rm -rf src/routes/api/v3
+git add -A
+git commit -m "chore: remove old v1/v2/v3 route directories"
+```
+
+## Rollback Procedure
+If issues arise, rollback with:
+```bash
+git reset --hard HEAD~2  # Adjust commit count if needed
+```
+
+---
+Document generated: 2026-04-23T22:48:52.497Z