719876d039
build / build (push) Successful in 3m5s
根因:SendDue 同时要求“已到配置时段”与“该周已结束(下周一00:00)”。周日23点的时段
只在周内存在,当周周报永远不满足“已结束”,于是 11/08 23:00 只报 nothing_confirmed、
11/09 00:00 又已成 not_due —— 邮件从未尝试发送,与 SMTP 凭据/网络无关。
改法(最小、不碰历史发布模块):
1. 由发送窗口反推要发的周:周日窗口发当天结束的那一周,其它工作日仍发上一完整周
(周一09:00 语义不变)。自动发送只处理这一周,不再按“所有已结束的周”回填。
2. 认领改为只重认 failed(或首次)记录:sent 幂等返回真实 message_id;sending 视为
结果未知,拒绝盲重发并提示核对邮箱。自动与手工共用同一条渲染/认领/投递路径,
并发或重复点击只投递一次;失败如实写 failed,不假写 sent。
3. 新增管理员正式补发(页面按钮 + GET 预览 + POST /weekly-mail/send/{week}):精确指定
周、已确认版本与正文 hash,必须同源操作意图;未来周拒绝,当前周须到设定时点,
已结束周可显式补发。正文/看板图片/主送/抄送与自动发送一致,结果写入正式发送记录。
这不是“发送测试邮件”(只发 review 地址、不登记)。
验证:真实隔离 PostgreSQL(kg-pgtest-writeset 上的独立一次性库)先 RED(旧实现真实
复现 nothing_confirmed)后 GREEN;覆盖到点前/未来周/未确认/正文变化、周一语义保持、
手工补发一次并读回 message_id、并发只投递一次、结果未知不重发、失败可重试一次。
HTTP 与前端解析用例通过;make verify 17 项全绿。
306 lines
11 KiB
Go
306 lines
11 KiB
Go
package httpapi
|
|
|
|
import (
|
|
"context"
|
|
"encoding/base64"
|
|
"errors"
|
|
"knowledge-governance/internal/dobotaiops"
|
|
"knowledge-governance/internal/qawemail"
|
|
"net/http"
|
|
"strconv"
|
|
"time"
|
|
)
|
|
|
|
type weeklyMailStore interface {
|
|
ReadSettings(context.Context) (qawemail.Settings, error)
|
|
SaveSettings(context.Context, string, qawemail.SettingsInput) (qawemail.Settings, error)
|
|
Confirm(context.Context, string, string) (qawemail.Confirmation, error)
|
|
Unconfirm(context.Context, string) error
|
|
ReadConfirmation(context.Context, string) (*qawemail.Confirmation, error)
|
|
Sends(context.Context, string) ([]qawemail.Send, error)
|
|
TestSend(context.Context, string) (string, error)
|
|
SaveDashboardImage(context.Context, string, []byte) error
|
|
SendDue(context.Context, time.Time) (qawemail.DueResult, error)
|
|
PreviewSend(context.Context, string, int64, string, time.Time) (qawemail.SendPreview, error)
|
|
SendManual(context.Context, string, int64, string, string, time.Time) (qawemail.ManualResult, error)
|
|
}
|
|
|
|
// weeklyMailSendError names the rule that refused a manual resend. Anything SMTP-related is
|
|
// reported by the handler itself, so an unmet precondition never looks like a mail failure.
|
|
func weeklyMailSendError(w http.ResponseWriter, err error) {
|
|
switch {
|
|
case errors.Is(err, qawemail.ErrNotCurrent):
|
|
writeJSON(w, http.StatusConflict, map[string]string{"error": "该周周报未确认,或确认后正文/版本已变化;请先确认当前版本再补发"})
|
|
case errors.Is(err, qawemail.ErrFutureWeek):
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "不能补发未来周"})
|
|
case errors.Is(err, qawemail.ErrSlotPending):
|
|
writeJSON(w, http.StatusConflict, map[string]string{"error": "本周尚未到达设定的发送时点,暂不能补发"})
|
|
case errors.Is(err, qawemail.ErrNotConfigured):
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "未配置邮件服务器、发件人或收件人,无法补发"})
|
|
case errors.Is(err, qawemail.ErrSendInFlight):
|
|
writeJSON(w, http.StatusConflict, map[string]string{"error": "该周该版本有一次发送结果未知(记录停在发送中),为避免重复投递未重发;请先核对已发出的邮件"})
|
|
case errors.Is(err, qawemail.ErrNoPassword):
|
|
writeJSON(w, http.StatusConflict, map[string]string{"error": "SMTP 授权码缺失或无法解密,无法补发"})
|
|
case errors.Is(err, qawemail.ErrInvalid):
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "补发参数无效:需要精确的周、已确认版本与正文 hash"})
|
|
default:
|
|
weeklyMailError(w, err)
|
|
}
|
|
}
|
|
|
|
// qaWeeklyMailSendPreview lets the confirmation dialog show the exact week, revision and
|
|
// distribution this send would use — the same settings the send path reads.
|
|
func qaWeeklyMailSendPreview(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) {
|
|
return
|
|
}
|
|
store, ok := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !ok {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
query := r.URL.Query()
|
|
revision, err := strconv.ParseInt(query.Get("revision"), 10, 64)
|
|
if err != nil {
|
|
weeklyMailSendError(w, qawemail.ErrInvalid)
|
|
return
|
|
}
|
|
preview, err := store.PreviewSend(r.Context(), r.PathValue("week"), revision, query.Get("body_sha256"), time.Now())
|
|
if err != nil {
|
|
weeklyMailSendError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": preview})
|
|
}
|
|
|
|
// qaWeeklyMailSend is the formal resend: admin only, bound to the live confirmation, and the same
|
|
// render/claim path as the automatic slot. It is not a test send and never targets the review box.
|
|
func qaWeeklyMailSend(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) || !authorizeQAIntent(w, r, "qa-weekly-mail") {
|
|
return
|
|
}
|
|
identity, ok := sessionFrom(r.Context())
|
|
if !ok || identity.Role != "admin" {
|
|
writeJSON(w, http.StatusForbidden, map[string]string{"error": "仅管理员可正式补发周报"})
|
|
return
|
|
}
|
|
store, found := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !found {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
var request struct {
|
|
Revision int64 `json:"revision"`
|
|
BodySHA256 string `json:"body_sha256"`
|
|
}
|
|
if decodeQualityJSON(w, r, &request) != nil {
|
|
weeklyMailError(w, qawemail.ErrInvalid)
|
|
return
|
|
}
|
|
result, err := store.SendManual(r.Context(), r.PathValue("week"), request.Revision, request.BodySHA256, identity.Username, time.Now())
|
|
if err != nil {
|
|
weeklyMailSendError(w, err)
|
|
return
|
|
}
|
|
if result.Status == "failed" {
|
|
reason := result.Reason
|
|
if len(reason) > 300 {
|
|
reason = reason[:300]
|
|
}
|
|
writeJSON(w, http.StatusBadGateway, map[string]string{"error": "正式补发未送达:" + reason})
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": result})
|
|
}
|
|
|
|
func weeklyMailError(w http.ResponseWriter, err error) {
|
|
switch {
|
|
case errors.Is(err, qawemail.ErrConflict):
|
|
writeJSON(w, http.StatusConflict, map[string]string{"error": "发送设置已被其他人修改,请重新读取后再保存"})
|
|
case errors.Is(err, qawemail.ErrInvalid):
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "发送设置无效:请检查服务器、发件地址、收件人与时间"})
|
|
case errors.Is(err, qawemail.ErrUnavailable):
|
|
writeJSON(w, http.StatusServiceUnavailable, map[string]string{"error": "周报邮件暂不可用,请稍后重试;未标记为已发送"})
|
|
default:
|
|
qaOpsError(w, dobotaiops.ErrUnavailable)
|
|
}
|
|
}
|
|
|
|
func qaWeeklyMailSettings(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) {
|
|
return
|
|
}
|
|
store, ok := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !ok {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
settings, err := store.ReadSettings(r.Context())
|
|
if err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": settings})
|
|
case http.MethodPost:
|
|
if !authorizeQAIntent(w, r, "qa-weekly-mail") {
|
|
return
|
|
}
|
|
if identity, ok := sessionFrom(r.Context()); !ok || identity.Role != "admin" {
|
|
writeJSON(w, http.StatusForbidden, map[string]string{"error": "仅管理员可修改邮件发送设置"})
|
|
return
|
|
}
|
|
var input qawemail.SettingsInput
|
|
if decodeQualityJSON(w, r, &input) != nil {
|
|
weeklyMailError(w, qawemail.ErrInvalid)
|
|
return
|
|
}
|
|
identity, _ := sessionFrom(r.Context())
|
|
actor := identity.Username
|
|
settings, err := store.SaveSettings(r.Context(), actor, input)
|
|
if err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": settings})
|
|
default:
|
|
w.Header().Set("Allow", "GET, POST")
|
|
writeJSON(w, http.StatusMethodNotAllowed, map[string]string{"error": "不支持的方法"})
|
|
}
|
|
}
|
|
|
|
func qaWeeklyMailConfirm(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) {
|
|
return
|
|
}
|
|
if r.Method != http.MethodGet && !authorizeQAIntent(w, r, "qa-weekly-mail") {
|
|
return
|
|
}
|
|
store, ok := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !ok {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
week := r.PathValue("week")
|
|
switch r.Method {
|
|
case http.MethodGet:
|
|
confirmation, err := store.ReadConfirmation(r.Context(), week)
|
|
if err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"confirmation": confirmation}})
|
|
case http.MethodPost:
|
|
identity, _ := sessionFrom(r.Context())
|
|
actor := identity.Username
|
|
confirmation, err := store.Confirm(r.Context(), week, actor)
|
|
if err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"confirmation": confirmation}})
|
|
case http.MethodDelete:
|
|
if err := store.Unconfirm(r.Context(), week); err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"confirmation": nil}})
|
|
default:
|
|
w.Header().Set("Allow", "GET, POST, DELETE")
|
|
writeJSON(w, http.StatusMethodNotAllowed, map[string]string{"error": "不支持的方法"})
|
|
}
|
|
}
|
|
|
|
func qaWeeklyMailSends(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) {
|
|
return
|
|
}
|
|
store, ok := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !ok {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
sends, err := store.Sends(r.Context(), r.URL.Query().Get("week"))
|
|
if err != nil {
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"sends": sends}})
|
|
}
|
|
|
|
func qaWeeklyMailTest(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) || !authorizeQAIntent(w, r, "qa-weekly-mail") {
|
|
return
|
|
}
|
|
identity, ok := sessionFrom(r.Context())
|
|
if !ok || identity.Role != "admin" {
|
|
writeJSON(w, http.StatusForbidden, map[string]string{"error": "仅管理员可发送测试邮件"})
|
|
return
|
|
}
|
|
store, found := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !found {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
var request struct {
|
|
Week string `json:"week"`
|
|
}
|
|
if decodeQualityJSON(w, r, &request) != nil {
|
|
weeklyMailError(w, qawemail.ErrInvalid)
|
|
return
|
|
}
|
|
messageID, err := store.TestSend(r.Context(), request.Week)
|
|
if err != nil {
|
|
if errors.Is(err, qawemail.ErrInvalid) {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "请先保存该周周报正文,并确认已配置服务器、发件人、收件人与授权码"})
|
|
return
|
|
}
|
|
reason := err.Error()
|
|
if len(reason) > 300 {
|
|
reason = reason[:300]
|
|
}
|
|
writeJSON(w, http.StatusBadGateway, map[string]string{"error": "测试发送失败:" + reason})
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"sent": true, "week": request.Week, "message_id": messageID}})
|
|
}
|
|
|
|
func qaWeeklyMailImage(w http.ResponseWriter, r *http.Request, c Config) {
|
|
if !authorizeQAOps(w, r) || !authorizeQAIntent(w, r, "qa-weekly-mail") {
|
|
return
|
|
}
|
|
identity, ok := sessionFrom(r.Context())
|
|
if !ok || identity.Role != "admin" {
|
|
writeJSON(w, http.StatusForbidden, map[string]string{"error": "仅管理员可上传周报附图"})
|
|
return
|
|
}
|
|
store, found := c.QAWeeklyMail.(weeklyMailStore)
|
|
if !found {
|
|
weeklyMailError(w, qawemail.ErrUnavailable)
|
|
return
|
|
}
|
|
var request struct {
|
|
PNGBase64 string `json:"png_base64"`
|
|
}
|
|
// The chart is megabytes of base64, far above the tiny quality-edit limit.
|
|
if decodeGovernanceJSON(w, r, &request, 12<<20) != nil {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "看板图片数据无效或过大(上限 8MB)"})
|
|
return
|
|
}
|
|
png, err := base64.StdEncoding.DecodeString(request.PNGBase64)
|
|
if err != nil || len(png) < 8 || len(png) > 8<<20 {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "图片无效或超过 8MB"})
|
|
return
|
|
}
|
|
if err := store.SaveDashboardImage(r.Context(), r.PathValue("week"), png); err != nil {
|
|
if errors.Is(err, qawemail.ErrInvalid) {
|
|
writeJSON(w, http.StatusBadRequest, map[string]string{"error": "请先确认本周周报,再附上统计看板图片"})
|
|
return
|
|
}
|
|
weeklyMailError(w, err)
|
|
return
|
|
}
|
|
writeJSON(w, http.StatusOK, map[string]any{"data": map[string]any{"saved": true, "bytes": len(png)}})
|
|
}
|