Krispire AdminandClaude Opus 5.5
d76505772a
Categories move from a hard-coded list to a feedback_categories table (migration 0062), seeded with the four existing keys, labels and descriptions so production feedback is untouched; any other key already in use gets an archived category. Keys are fixed, so renames relabel past feedback. Archive hides a category from the form; only unused categories can be deleted. Submissions are validated against active categories, and feedback responses carry category_label. New: GET /feedback/categories (public); /admin/feedback/categories CRUD + reorder behind the new feedback:categories permission (granted to Admin). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
68 lines
3.1 KiB
Go
68 lines
3.1 KiB
Go
package model
|
|
|
|
import "time"
|
|
|
|
// Feedback is a user-submitted message — bug report, feature request,
|
|
// or general comment — captured by the /feedback page. Surfaced to
|
|
// admins both via the /stats page and via an email fan-out on insert.
|
|
//
|
|
// UserID is a pointer so the model can carry anonymous submissions
|
|
// (logged-out visitors) and orphaned rows (the submitter has since
|
|
// deleted their account — the FK is set null). ContactEmail is the
|
|
// optional reply-to filled in by anonymous submitters.
|
|
//
|
|
// AuthorHandle / AuthorName / AuthorEmail are populated by joins in
|
|
// the repo's lookup helpers (used by the admin email template and the
|
|
// /stats page). They're nil for anonymous rows.
|
|
type Feedback struct {
|
|
ID string `json:"id"`
|
|
UserID *string `json:"user_id,omitempty"`
|
|
Category string `json:"category"`
|
|
// CategoryLabel is the category's current display name (falls back to
|
|
// the key if the category was ever removed).
|
|
CategoryLabel string `json:"category_label"`
|
|
Message string `json:"message"`
|
|
ContactEmail *string `json:"contact_email,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
// AcknowledgedAt is set when an admin presses "Acknowledge" on the
|
|
// /stats page — the team has seen it and (if it needs work) the devs
|
|
// have started. NULL until then. One-way like ResolvedAt.
|
|
AcknowledgedAt *time.Time `json:"acknowledged_at,omitempty"`
|
|
// ResolvedAt is set the moment an admin presses "Mark resolved" on
|
|
// the /stats page. NULL while open. The action is one-way — the
|
|
// repo's MarkResolved guards on `resolved_at IS NULL` so a second
|
|
// resolve is a no-op.
|
|
ResolvedAt *time.Time `json:"resolved_at,omitempty"`
|
|
|
|
// ReplyMessage is the admin's written reply to the submitter, sent
|
|
// (and stored) from the admin panel. NULL until an admin replies.
|
|
// RepliedAt stamps when it was sent. Surfaced to the submitter on the
|
|
// "My feedback" page as the team's response.
|
|
ReplyMessage *string `json:"reply_message,omitempty"`
|
|
RepliedAt *time.Time `json:"replied_at,omitempty"`
|
|
|
|
// HasContactEmail reports *whether* an anonymous submitter left a reply-to
|
|
// address, without carrying the address itself. Populated only by
|
|
// Recent(), whose sole consumer is the PUBLIC /stats page — that page has
|
|
// to distinguish "anonymous, but we can reply" from "anonymous dead end"
|
|
// while never handling the email. Admins see the real address in the
|
|
// admin panel, which is auth-gated.
|
|
HasContactEmail bool `json:"-"`
|
|
|
|
AuthorHandle *string `json:"author_handle,omitempty"`
|
|
AuthorName *string `json:"author_name,omitempty"`
|
|
AuthorEmail *string `json:"-"` // server-side only; never serialised
|
|
}
|
|
|
|
// FeedbackCategory is one option on the /feedback form, managed from the
|
|
// admin panel. Key is what feedback.category stores and never changes.
|
|
type FeedbackCategory struct {
|
|
Key string `json:"key"`
|
|
Label string `json:"label"`
|
|
Description string `json:"description"`
|
|
SortOrder int `json:"sort_order"`
|
|
ArchivedAt *time.Time `json:"archived_at,omitempty"`
|
|
// UsageCount is admin-only: how much feedback is filed under it.
|
|
UsageCount int `json:"usage_count,omitempty"`
|
|
}
|