Skip to content
NutsNews chestnut logoNutsNews Wiki

Technical guide · Overview

Page status: HistoricalHistory group: Classified notes

NutsNews iOS — Story Notes Stable Key Patch

This patch fixes story notes so a note is attached to the same article no matter where the article is opened from.

Visual overview

Primary diagram

System map

This patch fixes story notes so a note is attached to the same article no matter where the article is opened from.

Render the repository-owned system map when you need it.

Diagram is not rendered yet.

View as text
NutsNews iOS — Story Notes Stable Key Patch

This patch fixes story notes so a note is attached to the same article no matter where the article is opened from.

flowchart TB
  accTitle: NutsNews iOS — Story Notes Stable Key Patch
  accDescr {
    This patch fixes story notes so a note is attached to the same article no matter where the article is opened from.
  }
  A["NutsNews iOS — Story Notes Stable Key Patch"] --> B["ios/NUTSNEWS_IOS_STORY_NOTES_STABLE_KEY_PATCH_README.md"]
  B --> C["Auto-generated placeholder diagram"]

NutsNews iOS — Story Notes Stable Key Patch

Fullscreen diagram view.

NutsNews iOS — Story Notes Stable Key Patch

Section titled “NutsNews iOS — Story Notes Stable Key Patch”

This patch fixes story notes so a note is attached to the same article no matter where the article is opened from.

Problem fixed

Section titled “Problem fixed”

Before this patch, notes were keyed by article.id. Different screens can build the same article with different IDs:

  • Home feed may use the database row ID.
  • Saved Stories uses the original URL as the stable saved ID.
  • Search and native recommendation screens may have their own article object.

That means a note saved from one entry point could disappear when opening the same story from Search, Saved Stories, Good Mood, or Today’s Picks.

Fix

Section titled “Fix”

StoryNoteStore now uses LikedStoryStore.stableID(for:), which prefers the original story URL, then falls back to the row ID, then the title.

The patch also keeps backward compatibility by reading old notes saved under article.id and migrating them to the stable key the next time the note is saved.

Files changed

Section titled “Files changed”
NutsNews/NutsNews/Models/StoryNoteStore.swift

Test checklist

Section titled “Test checklist”
  1. Open a story from Home and save a note.
  2. Open the same story from Saved Stories and confirm the note appears.
  3. Edit the note from Saved Stories and save.
  4. Reopen the story from Home and confirm the edit appears.
  5. Open a story from Search and save a note.
  6. Save that story.
  7. Open it from Saved Stories and confirm the note appears.
  8. Open a story from Today’s Picks / Good Mood and save a note.
  9. Reopen from another screen and confirm the note appears.
  10. Clear a note from any screen and confirm it is cleared everywhere.