// Package report 生成每步六字段报告(Markdown + JSON),落盘到 test/reports/。 package report import ( "encoding/json" "fmt" "os" "path/filepath" "strings" "time" "bj_power_test/internal/assert" "bj_power_test/internal/env" ) // Report 一次运行的全部证据。 type Report struct { RunBatch string `json:"runBatch"` Scenario string `json:"scenario"` StartedAt string `json:"startedAt"` FinishedAt string `json:"finishedAt"` Probes []env.ProbeResult `json:"probes"` LoginErrors []string `json:"loginErrors"` DBErrors []string `json:"dbErrors"` Results []assert.Result `json:"results"` Summary Summary `json:"summary"` } // Summary 汇总。 type Summary struct { Total int `json:"total"` Pass int `json:"pass"` Fail int `json:"fail"` Block int `json:"block"` PassRate string `json:"passRate"` } func New(batch, scenario string) *Report { return &Report{RunBatch: batch, Scenario: scenario, StartedAt: time.Now().Format("2006-01-02 15:04:05")} } // Finish 计算汇总。 func (r *Report) Finish() { r.FinishedAt = time.Now().Format("2006-01-02 15:04:05") s := Summary{Total: len(r.Results)} for _, x := range r.Results { switch x.Status { case "通过": s.Pass++ case "阻断": s.Block++ default: s.Fail++ } } if s.Total > 0 { s.PassRate = fmt.Sprintf("%.1f%%", float64(s.Pass)*100/float64(s.Total)) } else { s.PassRate = "0.0%" } r.Summary = s } // Markdown 渲染人类可读报告。 func (r *Report) Markdown() string { var b strings.Builder b.WriteString("# 自动化流水测试报告\n\n") fmt.Fprintf(&b, "- 运行批次:**%s**\n- 场景:%s\n- 开始:%s\n- 结束:%s\n", r.RunBatch, r.Scenario, r.StartedAt, r.FinishedAt) fmt.Fprintf(&b, "- 汇总:共 %d 项,通过 %d / 失败 %d / 阻断 %d,通过率 %s\n\n", r.Summary.Total, r.Summary.Pass, r.Summary.Fail, r.Summary.Block, r.Summary.PassRate) b.WriteString("## 一、服务探活\n\n| 服务 | 地址 | 结果 | 说明 |\n| --- | --- | --- | --- |\n") for _, p := range r.Probes { ok := "不可达" if p.OK { ok = "在监听" } fmt.Fprintf(&b, "| %s | %s | %s | %s |\n", p.Name, p.URL, ok, p.Detail) } if len(r.LoginErrors) > 0 { b.WriteString("\n**登录失败项:**\n") for _, e := range r.LoginErrors { fmt.Fprintf(&b, "- %s\n", e) } } if len(r.DBErrors) > 0 { b.WriteString("\n**数据库建连失败项:**\n") for _, e := range r.DBErrors { fmt.Fprintf(&b, "- %s\n", e) } } b.WriteString("\n## 二、逐步结果(步骤ID / 案例行号 / 期望 / 实际 / 结论 / 失败原因)\n\n") b.WriteString("| 步骤ID | 案例.md 行号 | 层级 | 期望 | 实际 | 结论 | 失败原因 |\n") b.WriteString("| --- | --- | --- | --- | --- | --- | --- |\n") for _, x := range r.Results { fmt.Fprintf(&b, "| %s | %s | %s | %s | %s | %s | %s |\n", esc(x.StepID), esc(x.CaseLine), esc(string(x.Layer)), esc(x.Expect), esc(x.Actual), x.Status, esc(x.FailReason)) } b.WriteString("\n> 测试数据全部保留在库里,不删除;批次前缀用于隔离唯一键。\n") return b.String() } func esc(s string) string { s = strings.ReplaceAll(s, "|", "\\|") s = strings.ReplaceAll(s, "\n", " ") if len(s) > 300 { s = s[:300] + "…" } return s } // Write 落盘 Markdown + JSON,返回两个路径。 func (r *Report) Write(dir string) (string, string, error) { if err := os.MkdirAll(dir, 0o755); err != nil { return "", "", err } base := filepath.Join(dir, r.RunBatch+"-"+strings.ReplaceAll(r.Scenario, " ", "")) mdPath := base + ".md" jsonPath := base + ".json" if err := os.WriteFile(mdPath, []byte(r.Markdown()), 0o644); err != nil { return "", "", err } data, err := json.MarshalIndent(r, "", " ") if err != nil { return mdPath, "", err } if err := os.WriteFile(jsonPath, data, 0o644); err != nil { return mdPath, "", err } return mdPath, jsonPath, nil }