History and saved surveys
You never have to remember to save. Stopping a survey is the save — any walk that recorded a reading or a roam lands in the History tab automatically, newest first, ready to reopen, grade, or export.
What a History row shows
Section titled “What a History row shows”Each row is a summary, read from a lightweight index rather than the full survey document, so the list opens instantly however many surveys you have:
| Element | What it is |
|---|---|
| Thumbnail | A miniature top-down walk map, its dots coloured by signal band. |
| Title | Your custom name if you set one, otherwise the RUCKUS One venue name, otherwise Manual survey. |
| Subtitle | Date and time, point count, roam count, and the transport — always Live, since SSH is the only transport. |
| Grade badge | The letter grade, colour-coded, computed once when the survey was saved. |
Tap a row to open the same Results screen the survey ended on — the full document is decoded in the background, so a very long walk takes a moment. Swipe a row to delete it, which removes the survey document from the device permanently.
Rename a survey
Section titled “Rename a survey”The title is edited on the Results screen, not in the list: open the survey and type over the name in the grade card header. Clearing it back to empty restores the default venue-or-date title.
A report you opened without saving it (see below) has no title field — there is nothing on disk to rename.
Where surveys are stored
Section titled “Where surveys are stored”Saved surveys live inside ARRF’s own container on the iPhone: one JSON document per survey — byte-identical to the JSON export — plus a small index file that backs the list. They are never uploaded anywhere, and deleting the app deletes them.
When a survey can’t be saved
Section titled “When a survey can’t be saved”If writing the survey to storage fails — a full disk is the usual cause — ARRF does not discard the walk. A “Survey not saved” alert appears with the underlying reason and two choices:
- Retry — attempt the write again. The survey is still held in memory, so a retry after freeing space usually succeeds.
- Open anyway — skip saving and open the Results screen regardless, so you can still export the PDF, CSV, or JSON by hand before leaving the screen.
When a saved survey won’t open
Section titled “When a saved survey won’t open”Tapping a row whose file is missing or damaged raises a “Couldn’t open survey” alert rather than doing nothing:
| Message | Meaning |
|---|---|
| ”This survey’s file is missing from storage.” | The index still lists the survey but its document is gone. |
| ”This survey’s file is damaged and can’t be opened.” | The document is present but can’t be decoded. |
The row stays in the list — ARRF never deletes a document it failed to read, so a file recovered from a backup still opens. Swipe to remove the row yourself once you’re satisfied it’s unrecoverable.
Recovered surveys
Section titled “Recovered surveys”If the index file is lost or damaged, ARRF rebuilds it at launch by scanning the survey documents themselves, and re-grades each one it finds. The survey data — readings, roams, floor plan, grade — is fully intact. The one casualty is the RUCKUS One venue name, which lives only in the index: a recovered survey shows as Manual survey until you rename it.