mix/selfpost
1
0
Fork 0
Code Issues Pull Requests Actions 8 Packages Projects Releases Wiki Activity

panel-redesign: Help with seventeen topics; every box links to its own

Browse Source 
Follows the design commit before it. Written by Sonnet, reviewed by
Opus.

  - view/help.go, templates/help.html: the mockup's topics, texts, ids
    and menu. The page shows the groups the reader's menu shows:
    Overview and Server for the global role, Outbound and Inbound by
    reach (Inbound only with the feature on), Account for everyone;
    boxes are numbered as shown.
  - Box.Help set on the boxes the mockups mark; the inbound MX box has
    its link again.
  - TestEveryHelpLinkLandsOnATopic also fails on a topic that no page
    links to, unless it is listed as menu-only (account) - and on a
    stale exception.

Known until the change that follows: the dns, dmarc and account topics
describe the three-choice report address, which the code does not have
yet; Account's DMARC box still links to #dns.

Not verified by running: three sentences rest on Postfix behaviour
(delivery is deferred when a required TLS session cannot be made; a
milter with default_action=tempfail answers 4xx; with "any recipient"
an address the upstream refuses comes back as a bounce).

Evidence
  - docs/assets/panel-redesign/evidence/help.png (1440x3600) and
    in-domain.png: headless Edge, real templates served locally with
    their fixtures - NOT from the container.
  - go test -count=1 ./internal/web/... ./cmd/panel: ok (six packages).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
mix
2026-10-10 11:58:36 +03:00
co-authored by Claude Opus 5.5
parent ef19c1448e
commit 4ab63d08ae
19 changed files with 474 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files
internal/web/view/dmarc.go
+4 -3
View File
@@ -108,7 +108,7 @@ func NewDMARCHub(m Meta, in IngestInput) *DMARCHub {
") only; open a report for the parsed XML."),
},
IngestOn: true,
Ingest: Box{No: "01", Title: "Ingest", End: Rich(TagOf(status, label))},
Ingest: Box{No: "01", Title: "Ingest", End: Rich(TagOf(status, label)), Help: topicLink(HelpDMARC, "What the reports are and where they go")},
IngestFacts: []Fact{
last,
{Label: "This week", Value: Plain(FormatCount(int64(in.KeptThisWeek)) + " kept · " + plural(int64(in.ParseFailures), "parse failure", "parse failures"))},
@@ -126,6 +126,7 @@ func NewDMARCHub(m Meta, in IngestInput) *DMARCHub {
func (p *DMARCHub) WithoutIngest() *DMARCHub {
p.IngestOn = false
p.Recent.No = "01"
p.Recent.Help = p.Ingest.Help
return p
}
@@ -226,7 +227,7 @@ func NewDMARCDomain(m Meta, id int64, name string, hub bool, pass, fail, days in
withCode(hint)...),
Actions: []Action{{Label: "Domain page", Icon: "ti-world-upload", Href: DomainHref(id)}},
},
Sources: Box{No: "01", Title: fmt.Sprintf("Sources · %d days", days)},
Sources: Box{No: "01", Title: fmt.Sprintf("Sources · %d days", days), Help: topicLink(HelpDMARC, "How to read pass, fail and sources")},
SourcesEmpty: EmptyState{Icon: "ti-world-upload", Text: Plain("No mail from any source in this window.")},
Reports: Box{No: "02", Title: "Reports"},
ReportsEmpty: EmptyState{Icon: "ti-report-analytics", Text: Plain("No reports for this domain yet.")},
@@ -379,7 +380,7 @@ func NewDMARCReport(m Meta, in ReportInput) *DMARCReport {
Compact: true,
Route: route,
},
Report: Box{No: "01", Title: "Report"},
Report: Box{No: "01", Title: "Report", Help: topicLink(HelpDMARC, "What an aggregate report is")},
ReportFacts: report,
Policy: Box{No: "02", Title: "Published policy"},
PolicyFacts: policy,