Skip to content

docs: fix remaining callsign references and stale documentation notes#51

Open
w2naf wants to merge 6 commits intodevelopfrom
feature/naf
Open

docs: fix remaining callsign references and stale documentation notes#51
w2naf wants to merge 6 commits intodevelopfrom
feature/naf

Conversation

@w2naf
Copy link
Contributor

@w2naf w2naf commented Mar 7, 2026

Summary

  • Generalize all KD3ALD/FN21ni hardcoded references in user-facing docs to use W3USR (API examples) or YOUR_CALLSIGN (operator guide template)
  • Fix docs/CLAUDE.md references throughout (file was moved to repo root)
  • Correct stale Session 6 note in CLAUDE.md: vendor/GeoJSON files are now git-tracked
  • Fix OPERATOR_GUIDE.md troubleshooting: remove instruction to check internet for GeoJSON (files are bundled)
  • Add WSPRDaemon storedb/ ingestion integration (storedb.py + storedb.sh)
  • Add systemd autostart and gunicorn deployment instructions to README
  • Add MongoDB authentication setup section to README

Test plan

  • Verify grep -r KD3ALD finds no remaining references in README.md, CONTRIBUTING.md, OPERATOR_GUIDE.md
  • Verify all links in CLAUDE.md resolve correctly from repo root
  • Verify storedb/storedb.sh is executable and storedb/storedb.py ingests spots correctly
  • Verify dashboard starts with gunicorn "app:create_app()" and binds to 0.0.0.0:5000

🤖 Generated with Claude Code

w2naf and others added 6 commits March 7, 2026 02:37
Add storedb/storedb.py and storedb/storedb.sh to ingest decoded WSPR
spots into MongoDB via WSPRDaemon's WSPR_LOGGING_CMD hook. Improves on
the previous local-only storedb.py by using .env for credentials,
adding band/mode fields, and using upsert to prevent duplicates.

Update README with MongoDB auth setup, WSPRDaemon integration setup,
and manual test instructions.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove hardcoded W3USR/KD3ALD callsigns and paths throughout README.
Replace with generic placeholders so any amateur station can follow
the installation guide. Fix gunicorn command to use create_app()
factory syntax. Update systemd service template with correct syntax
and Restart=on-failure. Update storedb.sh to use dynamic path
detection via BASH_SOURCE instead of hardcoded paths.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove incorrect instructions to download basemap and Leaflet files
separately. All static data files (GeoJSON boundaries, Natural Earth
basemap, Leaflet 1.9.4) are tracked in the repository and require no
separate download steps.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
README.md:
- Genericize architecture diagram (remove KD3ALD station reference)
- Update JS file line counts (735/223)
- Add storedb.sh to Data Flow description
- Fix Prerequisites (remove stale WSPRDaemon db note)
- Add storedb/ to project structure tree
- Fix vendor/ comment (files are git-tracked, not downloaded separately)
- Fix mongosh command (replace deprecated mongo)
- Remove hardcoded dash.kd3ald.com URL
- Update CLAUDE.md reference to root path

OPERATOR_GUIDE.md:
- Add template customization note at top
- Replace all KD3ALD/FN21ni/dash.kd3ald.com with YOUR_CALLSIGN/YOUR_GRID placeholders

CONTRIBUTING.md:
- Fix git clone URL (hamsci/contesting-dashboard → HamSCI/frc_contesting)
- Fix bug report template URL
- Fix license statement (GPL v3, not TBD)
- Update CLAUDE.md reference to root path

CLAUDE.md:
- Move from docs/CLAUDE.md to repo root

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Replace KD3ALD/FN21ni with W3USR/FN21ej in API response examples
  (README.md /spots, /config, and database schema sections)
- Replace KD3ALD with W3USR in CONTRIBUTING.md code style examples
- Fix CONTRIBUTING.md docs/CLAUDE.md references → CLAUDE.md (file moved to root)
- Fix closing signature: 73 de KD3ALD → 73 de HamSCI
- Fix OPERATOR_GUIDE.md: KD3ALD → YOUR_CALLSIGN in limitations section
- Fix OPERATOR_GUIDE.md troubleshooting: remove stale "internet needed for GeoJSON"
  (GeoJSON files are git-tracked, no download required)
- Fix CLAUDE.md: update Session 6 vendor note to reflect files are now git-tracked
- Fix CLAUDE.md: correct internal self-reference links (docs/CLAUDE.md → CLAUDE.md)
- Fix CLAUDE.md: correct Key Documents relative paths from root location

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@w2naf w2naf requested a review from KD3ALD March 7, 2026 04:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant