Skip to content

Concepts docs: Presence, heartbeat & connection liveness #447

Closed
Closed
Concepts docs: Presence, heartbeat & connection liveness#447
Assignees
Dannyorji
Labels
Stellar WaveIssues in the Stellar wave programbackenddocumentationImprovements or additions to documentation

Description

@codebestia
codebestia
opened on Jul 29, 2026

Write apps/backend/docs/concepts-presence-heartbeat.md explaining services/presence.ts and services/heartbeat.ts — the Redis-backed per-device/per-user presence model, TTL-based liveness, the 30s/90s heartbeat timing, and how multi-device aggregation works.

Acceptance criteria:

  • Explains the Redis key structure used for presence tracking (which keys exist, what each holds, TTLs)
  • Explains the heartbeat timing contract with the actual current interval/timeout values
  • Explains multi-device aggregation and the transition-broadcast behavior

Activity

  1. codebestia
    added
    documentationImprovements or additions to documentation
    backend
    on Jul 29, 2026
  2. drips-wave
    added
    Stellar WaveIssues in the Stellar wave program
    on Jul 29, 2026

  3. Samuel-21-eng commented on Jul 29, 2026

    @Samuel-21-eng
    Samuel-21-eng
    on Jul 29, 2026 – with Drips Wave

    @Samuel-21-eng has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

    Can I work on this issue

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Samuel-21-eng to this issue.

  4. codebestia
    assigned
    Samuel-21-eng
    on Jul 29, 2026

  5. drips-wave commented on Jul 29, 2026

    @drips-wave
    drips-waveBot
    on Jul 29, 2026 – with Drips Wave

    Congratulations, @Samuel-21-eng! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

    🧑‍💻 @Samuel-21-eng: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

    Warning

    When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

    🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

    🌊 Happy Wave 🌊

  6. codebestia
    unassigned
    Samuel-21-eng
    on Aug 27, 2026

  7. Confidence001Jewel-cmd commented on Aug 27, 2026

    @Confidence001Jewel-cmd
    Confidence001Jewel-cmd
    on Aug 27, 2026 – with Drips Wave

    @Confidence001Jewel-cmd has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    Dear Maintainer,
    Please assign this issue to me, I will love to work on it.

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Confidence001Jewel-cmd to this issue.

  8. KHALLEY commented on Aug 27, 2026

    @KHALLEY
    KHALLEY
    on Aug 27, 2026 – with Drips Wave

    @KHALLEY has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    Hi Maintainer, please assign this issue to me. Thank you

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @KHALLEY to this issue.

  9. VictorEzenma commented on Aug 30, 2026

    @VictorEzenma
    VictorEzenma
    on Aug 30, 2026 – with Drips Wave

    @VictorEzenma has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    Hi maintainer, I would like to work on this

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @VictorEzenma to this issue.

  10. DrSa7ag3 commented on Aug 31, 2026

    @DrSa7ag3
    DrSa7ag3
    on Aug 31, 2026 – with Drips Wave

    @DrSa7ag3 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

    Hello, I’ve read through the issue description and understand the expected outcome. I’d be glad to work on it in the next few hours.

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @DrSa7ag3 to this issue.

  11. ChukwuemekaP1 commented on Sep 24, 2026

    @ChukwuemekaP1
    ChukwuemekaP1
    on Sep 24, 2026 – with Drips Wave

    @ChukwuemekaP1 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    Good day, my name is Chukwuemeka and I'd love to work on this issue.

    I have experience with backend development, Redis-backed systems, and technical documentation, so I can approach this from both the implementation and documentation sides. The important part of this issue is documenting the actual liveness model rather than describing a generic presence system.

    I'll trace "services/presence.ts" and "services/heartbeat.ts" to document the Redis key structure, stored values, TTL behavior, and the current 30s heartbeat/90s timeout contract. I'll also explain how presence is aggregated across multiple devices and when transition broadcasts are triggered, keeping the documentation aligned with the current implementation.

    ETA: 24 hours from assignment. Looking forward to your reply!

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @ChukwuemekaP1 to this issue.

  12. flare-999 commented on Sep 28, 2026

    @flare-999
    flare-999
    on Sep 28, 2026 – with Drips Wave

    @flare-999 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    I'm interested on working on this
    could you assign this issue to me

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @flare-999 to this issue.

  13. Dannyorji commented on Sep 28, 2026

    @Dannyorji
    Dannyorji
    on Sep 28, 2026 – with Drips Wave
    Contributor

    @Dannyorji has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

    I will like to work on this

    ℹ️ Repo Maintainers: To accept this application, review their application or assign @Dannyorji to this issue.

  14. codebestia
    assigned
    Dannyorji
    on Sep 28, 2026

  15. drips-wave commented on Sep 28, 2026

    @drips-wave
    drips-waveBot
    on Sep 28, 2026 – with Drips Wave

    Congratulations, @Dannyorji! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on September 30, 2026.

    🧑‍💻 @Dannyorji: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

    Warning

    When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

    🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

    🌊 Happy Wave 🌊

  16. github-actions commented on Oct 2, 2026

    @github-actions
    github-actionsBot
    on Oct 2, 2026 – with GitHub Actions

    Closed by #615, merged into dev.

  17. github-actions
    closed this as completedon Oct 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave programbackenddocumentationImprovements or additions to documentation

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions