NEC-384: Feedback board: ideas, discussion and class-weighted votes, written from the plugin #351

Merged
nectenda-agent merged 10 commits from worktree-nec-384-feedback-board-ideas-discussion-and-clas into main 2026-11-10 06:38:50 +00:00
Collaborator

Task: NEC-384 — https://projectron.nerchure.com/tasks/406

Adds the feedback board: a new service beside identity at feedback.nectenda.com where signed-in users post ideas, discuss them and vote from the plugin's new Feedback page (More › Feedback, the "Open feedback" command, or an obsidian://nectenda?feedback= link), with a Team section for admins. Identity mints a short-lived board token carrying the voter's plan class, which only admins ever see; deletes are soft, merges undoable, and nothing is sent to the board while Feedback is closed apart from the one updates count on the settings home. Deployment adds the board's image and a second deployer instance on the identity host, installed but not enabled: going live is deploy/SETUP.md E.9. The website /features section and the Grafana dashboard are NEC-386 and NEC-387.

Spec: docs/changes/NEC-384-feedback-board/spec.md

Changelog

New Feedback page in Nectenda settings (More › Feedback, or the "Open feedback" command): suggest ideas, discuss them and vote on what gets built next.

Task: NEC-384 — https://projectron.nerchure.com/tasks/406 Adds the feedback board: a new service beside identity at feedback.nectenda.com where signed-in users post ideas, discuss them and vote from the plugin's new Feedback page (More › Feedback, the "Open feedback" command, or an obsidian://nectenda?feedback=<id> link), with a Team section for admins. Identity mints a short-lived board token carrying the voter's plan class, which only admins ever see; deletes are soft, merges undoable, and nothing is sent to the board while Feedback is closed apart from the one updates count on the settings home. Deployment adds the board's image and a second deployer instance on the identity host, installed but not enabled: going live is deploy/SETUP.md E.9. The website /features section and the Grafana dashboard are NEC-386 and NEC-387. Spec: `docs/changes/NEC-384-feedback-board/spec.md` ## Changelog New Feedback page in Nectenda settings (More › Feedback, or the "Open feedback" command): suggest ideas, discuss them and vote on what gets built next.
Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
The board ranks votes by who is paying, and never asks identity: the
class rides in a token of its own audience, minted beside the identity
token. The class reuses billing's live set, now exported from orders.ts,
so the board and the subscription move cannot disagree about what counts
as paying.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Ideas, comments and class-weighted votes, read by anyone and written
with the board token identity signs. Its own process and SQLite: it
verifies tokens offline and never sees a signing key or an identity
record. Deletes are soft, a merge is undoable, and no response but an
admin's carries a plan class, which privacy.test.ts walks every route
to hold. The rules are BOARD-001..013 in docs/v1/components.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Its own image and container on the identity host, behind
feedback.nectenda.com, with /srv/identity/board as its data so it never
sees the signing keys. The deployer takes --config and a TAG_KEY so a
second service keeps its own pin, history and state; the template unit
is installed but enabled only at go-live (SETUP.md E.9). The nightly
backup stages board.db beside identity.db.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
More > Feedback in Nectenda's settings, and the same page as a dialog
for "Open feedback" and obsidian://nectenda?feedback=<id>, since
Obsidian cannot open a nested settings page from code. Reading works
signed out; voting, posting and commenting offer the existing sign-in.
The board is reached only while the page is open, plus one request a
minute at most for the updates badge. The board token is held in memory
and renewed once on a 401.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
One vault signed in to the identity harness, whose board token the
board harness trusts. It votes, finds a duplicate while typing a title,
posts, has its delete refused by a vote that landed after the page
loaded, comments and unvotes, all through the page's own buttons; then
opens the page from the command and from an obsidian:// link.

Two fixes it brought: the page reads focus from its own document,
since settings are a popout window, and a rebuild that calls display()
again on an open page tears down the previous drawing first.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
The privacy policy now says what the board holds, that posts are public
and unencrypted, and that a vote's plan is used internally only; it no
longer says nothing we hold was written by you. The security model lists
the board under what is not encrypted, and the published README names
feedback.nectenda.com and when the plugin reaches it. Phone behaviour
goes on the manual testing list.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Nothing typed is lost now: idea, comment and team-form edits live in a
draft store in the vault's local storage until the board takes them,
so a refused save, a settings rebuild or a closed dialog keeps them,
and a double press sends once. Reading, opening Feedback and the badge
no longer make a board account, so someone who never takes part leaves
no name and no plan (BOARD-014); the privacy policy and README say what
is sent and what is kept. Chained merges are refused so every undo is
exact. The deployer's second timer is offset and a busy tick still
sends its heartbeat. Smaller fixes: audits keep replaced words, a
self-hosted vault's feedback link opens nothing, bad tokens always get
401, a failed seen no longer hides the Team section, blocked accounts
cannot edit, and set_kv keeps a newline-less .env intact.

Task: NEC-384

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Don't tell a signed-in vault to sign in when identity sent no board token
All checks were successful
Release note / release-note (pull_request) Successful in 18s
CI / build (pull_request) Successful in 6m56s
CI / e2e (pull_request) Successful in 20m42s
CI / promote (pull_request) Has been skipped
Deploy site / deploy (push) Successful in 58s
CI / build (push) Successful in 6m47s
CI / e2e (push) Successful in 22m20s
CI / promote (push) Successful in 42s
8e5d84a9f4
Tried against the live identity service, which predates the board token, a
signed-in vault posting an idea was told "Sign in to Nectenda to do that".
Signing in again cannot fix that, so the message sent the user looking for
the wrong cure. The token source now says whether the vault is signed in,
and the client answers each case with its own message.

Task: NEC-384
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EV8ztZekZ7qdjaVV17RLqb
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Nectenda/nectenda!351
No description provided.