busya/ss-tools
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

tech_lead / coder 2roles

Browse Source
This commit is contained in:
busya
2025-12-27 08:02:59 +03:00
parent 07914c8728
commit 3d75a21127
17 changed files with 376 additions and 507 deletions
Download Patch File Download Diff File Expand all files Collapse all files

42
specs/007-migration-dashboard-grid/quickstart.md
View File

@@ -1,23 +1,31 @@
# Quickstart: Migration Dashboard Grid
## Overview
The Migration Dashboard Grid allows users to select dashboards for migration using a rich interface with filtering, sorting, and status indicators.
## Prerequisites
- Backend running (`uvicorn backend.src.app:app --reload`)
- Frontend running (`npm run dev`)
- Superset instance accessible and configured in `config.yaml`
## Usage
## Steps to Verify
1. **Navigate to Migration Page**: Go to the Migration section in the app.
2. **Select Source Environment**: Choose the Superset environment you want to migrate from.
3. **View Dashboards**: The grid will automatically load the list of available dashboards.
- **Filter**: Type in the "Search dashboards..." box to filter by name.
- **Sort**: Click on column headers (Name, Last Modified, Status) to sort.
- **Paginate**: Use the "Next" and "Previous" buttons to navigate through pages.
4. **Select Dashboards**:
- Click individual checkboxes to select specific dashboards.
- Click the "Select All" checkbox in the header to select **all** dashboards matching the current filter (even those on other pages).
5. **Proceed**: Once selection is complete, click "Next" to configure mappings.
1. **Navigate to Migration Page**:
- Open browser to `http://localhost:5173/migration`
- Select a Source Environment from the dropdown.
## Troubleshooting
2. **Verify Dashboard Grid**:
- The grid should appear below the environment selectors.
- It should list dashboards with columns: Title, Last Modified, Status.
- Status pills should be green (Published) or gray (Draft).
- **"No dashboards found"**: Ensure the source environment is correctly configured and accessible.
- **Slow loading**: If the environment has thousands of dashboards, the initial load might take a few seconds.
- **Status "Unknown"**: If the API fails to return publication status, it will default to a neutral state.
3. **Test Filtering**:
- Type in the "Search dashboards..." input.
- The list should filter instantly (client-side).
4. **Test Pagination**:
- If >20 dashboards, check pagination controls at the bottom.
- Navigate to next page.
5. **Test Selection**:
- Select a few dashboards.
- Change filter (hide selected).
- Clear filter -> Selection should persist.
- Click "Select All" -> Should select all matching current filter.