docs: 整理文档目录结构 — 清理过时文档、归集功能子目录、统一命名规范

清理:
- 删除 34 份过时文档(gap reports/QA临时报告/验收报告/阶段性文档)
- 删除 docs/.hermes/skills 第三方 skills 副本(16 文件)
- 删除 skills-lock.json

目录归集:
- 根目录仅保留 README.md 索引
- product/ — 产品与架构设计(PRD + ARCHITECTURE + P2设计文档 + AI/企业路线图)
- tracking/ — Chatwoot parity 开发跟踪
- requirements/ — M01-M12 模块需求
- plans/ — 历史实现计划
- parity/ — 路由 parity 与前端契约
- qa/ — QA 报告与测试计划
- ops/ — 运维部署

命名规范:
- 全小写 kebab-case,禁止全大写文件名
- product/tracking/ops 用 NN- 序号前缀
- requirements 用 MNN- 两位零填充模块号
- plans/qa 用 YYYY-MM-DD- 日期前缀
- requirements M1-M9 零填充为 M01-M09(修复字典序)

同步更新:
- backend/cmd/route_parity/main.go 路径默认值
- backend/scripts/parity_frontend_smoke.sh 报告路径
- 所有 docs 内部交叉引用
- .gitignore 排除编译产物 (backend/gochat, backend/route_parity)
- 新增迁移 000052/000053
- 前端 WS 相关修改
This commit is contained in:
2026-07-09 14:53:27 +08:00
parent 805402f938
commit 0dabb8cfa5
136 changed files with 1240 additions and 14484 deletions
+25 -23
View File
@@ -11,6 +11,8 @@ import (
"github.com/ThreeDotsLabs/watermill/message"
"github.com/redis/go-redis/v9"
wspkg "github.com/gochat/gochat/internal/ws"
"github.com/gochat/gochat/pkg/logger"
)
@@ -214,24 +216,26 @@ func (s *Subscriber) forwardToAccountAndConversation(eventType string) func(msg
return nil
}
// Build the event frame
frame := EventFrame{
Type: ServerEvent,
Event: eventType,
Payload: payload.Data,
// Build the WSMessage — the frontend's onReceived handler expects
// { event: "...", data: {...} } which matches WSMessage serialization.
// Hub.SendToAccount wraps this in ActionCable format:
// { identifier: "...", message: { event: "...", data: {...} } }
wsMsg := wspkg.WSMessage{
Event: eventType,
Data: payload.Data,
}
frameData, err := json.Marshal(frame)
msgData, err := json.Marshal(wsMsg)
if err != nil {
logger.L().Errorf("ws: failed to marshal event frame for %s: %v", eventType, err)
logger.L().Errorf("ws: failed to marshal event for %s: %v", eventType, err)
return nil
}
// Push to account room
s.hub.SendToAccount(accountID, frameData)
s.hub.SendToAccount(accountID, msgData)
// Also push to conversation room if conversation_id is present
if payload.ConversationID > 0 {
s.hub.SendToAccountConversation(accountID, payload.ConversationID, frameData)
s.hub.SendToAccountConversation(accountID, payload.ConversationID, msgData)
}
return nil
@@ -254,18 +258,17 @@ func (s *Subscriber) forwardToAccount(eventType string) func(msg *message.Messag
return nil
}
frame := EventFrame{
Type: ServerEvent,
Event: eventType,
Payload: payload.Data,
wsMsg := wspkg.WSMessage{
Event: eventType,
Data: payload.Data,
}
frameData, err := json.Marshal(frame)
msgData, err := json.Marshal(wsMsg)
if err != nil {
logger.L().Errorf("ws: failed to marshal event frame for %s: %v", eventType, err)
logger.L().Errorf("ws: failed to marshal event for %s: %v", eventType, err)
return nil
}
s.hub.SendToAccount(accountID, frameData)
s.hub.SendToAccount(accountID, msgData)
return nil
}
}
@@ -287,18 +290,17 @@ func (s *Subscriber) forwardToConversation(eventType string) func(msg *message.M
return nil
}
frame := EventFrame{
Type: ServerEvent,
Event: eventType,
Payload: payload.Data,
wsMsg := wspkg.WSMessage{
Event: eventType,
Data: payload.Data,
}
frameData, err := json.Marshal(frame)
msgData, err := json.Marshal(wsMsg)
if err != nil {
logger.L().Errorf("ws: failed to marshal event frame for %s: %v", eventType, err)
logger.L().Errorf("ws: failed to marshal event for %s: %v", eventType, err)
return nil
}
s.hub.SendToAccountConversation(accountID, conversationID, frameData)
s.hub.SendToAccountConversation(accountID, conversationID, msgData)
return nil
}
}