ISSUE: user wants to see change trends and delta

[codecovdesign]

Problem to solve

When analyzing the bundle data, users described desire to see the "delta" and/or "change" of assets over time and between commits/branches.

GH-1413_p4.mp4

GH-1413_p1.mp4

GH-1413_p3.mp4

Solution

At repo level explore showing changes over time, changes from last commit, and/or changes at release level (issue TODO)

Consider longer term implications too as under review in: #1420

view designs + engineering investigation

Tasks

Beta Give feedback

1. BA V2 Discovery and Technical Planning - Change trends and delta #1698
   investigation +1
   

Backend ingestion

Beta Give feedback

1. [Shared] Update SQLite Asset schema to store uuid #1767
   +0
   
2. [Shared] When parsing generate mapping to link previous Asset to current Asset and store uuid #1768
   +0
   
3. [Worker] Add bundle measurements to MeasurementName enum #1765
   +0
   
4. [API] Add bundle measurements to MeasurementName enum #1766
   +0
   
5. [Worker] Create a task to save measurements for BA assets #1769
   +0
   
6. [Worker] Retrieve data from BundleAnalysisReport to be inserted into timeseries #1770
   +0
   
7. [API] Create Dataset object if not present during bundle uploading #1771
   +0
   
8. [Shared] Make migration mechanism after introducing UUID to Asset #1825
   +0
   
9. [ref][Shared/Worker] Refactor ingest to return a bundle_name to know which bundle to save measurements for #1875
   +0
   
10. [ref] Bundle Analysis: Asset association use SQLalchemy ORM to update instead of raw SQL #1846
    +0
    

Backend Retrieval

Beta Give feedback

1. [API] Create API schema to fetch bundle and asset measurements #1772
   +0
   
2. [API] Retrieve bundle trends with filtering on bundle names #1773
   +0
   
3. [API] Retrieve asset trends with filtering on bundle names #1774
   +0
   
4. [ref] Bundle Analysis: Delete asset type measurements that's no longer being associated anymore #1775
   +0
   
5. Bundle Analysis: fill first datapoint from past if it is null in the date range #1976
   +0
   

UI Changes

Beta Give feedback

1. [UI] Create hook to fetch bundle trend data #1800
   1 of 1
   +0
   
2. [UI] Create new chart for bundle trend data #1801
   +0
   
3. [UI] Add in bundle trend chart to bundles tab #1802
   1 of 1
   +0
   
4. [UI] Update table data fetching hook #1803
   1 of 1
   +0
   
5. [UI] Add in size column to show asset percentage #1804
   1 of 1
   +0
   
6. [UI] Add in change over time column w/Sparkline #1805
   1 of 1
   +0
   
7. [UI] Move Trend Dropdown #2047
   +0
   
8. [UI] Reorder Asset Table Columns #2048
   +0
   

[codecovdesign]

some ideation of how this could help:

user wants to see changes over time

• timeline graph: line graph showing the evolution of bundle sizes over the project's history
  • bundle (and/or grouping/filtering aggregate) level (macro overview)
  • individual asset (micro overview), such as sparkline of trend data per full lifespan
• custom time ranges: allow users to select and examine specific time periods

user wants to see how asset changed from last time of change

• delta indicators: show the size difference since the last change (per commit) next to each modified asset
  • link to commits: connect to the corresponding commit for quick access and troubleshooting
  • Vu: more helpful at the PR/commit level / at the repo level would be helpful to see at the (engineer dependent) more interested in macro level
    • scope down to PR comment for up/down?
    • alternative for the individual asset at the repo level: show % of bundle size, who added it, commit history (the delta) more interested in the fuller history of it
• visual cues / filtering: use indicators to highlight increases and decreases in size to help user at a glance + filtering

[nicholas-codecov]

Anything around tracking individual assets going to be extremely difficult to accomplish atm, we need to do some work to figure this out as with each change to an asset, the file name changes so it is hard to track over time.