Migration Lifecycle Notifications & Performance Metrics when importing from Bitbucket
## Summary
- Customer opened a support ticket to request a feature proposal for the following:
- Enhance the GitLab Import engine to provide automated notifications and detailed performance metrics for repository migrations from Bitbucket to GitLab, improving transparency and enabling better planning for large-scale migrations.
## Problem Statement
Large-scale repository migrations are time-intensive and involve multiple stakeholders. Currently, the lack of granular status updates and post-migration performance data makes it difficult to:
- Plan maintenance windows for large repositories
- Baseline migration performance
- Provide audit-ready metrics to leadership
- Keep stakeholders informed during lengthy migration processes
## Requested Features
### 1. Lifecycle Alerts
- **Automatic notifications** to the migration initiator when a migration:
- Starts
- Completes successfully
- Fails
- **Optional group notifications** to designated stakeholders
- **Real-time status updates** throughout the migration process
### 2. Migration Summary Report
Upon migration completion, provide a comprehensive summary including:
- **Total Duration**: Complete start-to-finish migration time
- **Object Migration Counts**:
- Pull Requests migrated
- Issues migrated
- Commits migrated
- **Success/failure status** for each object type
## Business Value
- **Performance Baselining**: Enable Engineering Systems teams to establish migration performance benchmarks
- **Improved Planning**: help plan a better maintenance window for large repository migrations
- **Audit Compliance**: Provide leadership with audit-ready migration metrics
- **Enhanced Transparency**: Keep all stakeholders informed throughout the migration process
- **Workflow Optimisation**: Support continuous optimisation of DevOps workflows and migration paths
## Additional Context
- There is an open feature proposal that partially overlaps ([#586471](https://gitlab.com/gitlab-org/gitlab/-/work_items/586471)). Opening this new work item as this feature proposal requests for a wider time and status range - notifying the status of the entire migration lifecycle from start to end in real time.
## Acceptance Criteria
- [ ] Migration initiator receives automated start notification
- [ ] Migration initiator receives automated completion/failure notification
- [ ] Optional group notification functionality is available
- [ ] Migration summary report includes total duration
- [ ] Migration summary report includes count of migrated objects (PRs, Issues, Commits)
- [ ] Summary report is generated for both successful and failed migrations
- [ ] Notifications and reports are audit-ready and suitable for leadership reporting
issue