Files

T

rogee 0dabb8cfa5 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 相关修改

2026-07-09 14:53:27 +08:00

3.1 KiB

Raw Blame History

Frontend Smoke Report

Updated: 2026-06-13T12:24:46Z

Status

Enterprise browser smoke passed for reused Chatwoot enterprise route requests and widget boot; enterprise API smoke passed.

Boot Command

scripts/parity_frontend_smoke.sh --boot-only

API Smoke Command

scripts/parity_frontend_smoke.sh --api-smoke

Browser Smoke Command

scripts/parity_frontend_smoke.sh --browser-smoke

Enterprise Smoke Command

scripts/parity_frontend_smoke.sh --enterprise-smoke

Enterprise Browser Smoke Command

scripts/parity_frontend_smoke.sh --enterprise-browser-smoke

Backend

URL: http://127.0.0.1:13000
Command: env GOCHAT_ENV=development GOCHAT_SERVER_HOST=127.0.0.1 GOCHAT_SERVER_PORT=13000 GOCHAT_SERVER_MODE=debug GOCHAT_SEARCH_ENGINE=meilisearch GOCHAT_SEARCH_HOST=http://127.0.0.1:17700 GOCHAT_SEARCH_API_KEY=gochat_dev GOCHAT_CAPTAIN_ENABLED=false go run ./cmd/gochat serve
Search: meilisearch at http://127.0.0.1:17700
Log: /home/rogee/Projects/gochat/.tmp/frontend-smoke-live/gochat.log

Reused Chatwoot Frontend

URL: http://localhost:3036
Source: /home/rogee/Projects/gochat/reference/chatwoot
Command: (cd /home/rogee/Projects/gochat/reference/chatwoot && env CHATWOOT_API_HOST=http://127.0.0.1:13000 pnpm exec vite --host localhost --port 3036)
Log: /home/rogee/Projects/gochat/.tmp/frontend-smoke-live/chatwoot-vite.log

Seed Path

GOCHAT_SEED_ADMIN_EMAIL=admin@gochat.local \
GOCHAT_SEED_ADMIN_PASSWORD=changeme \
GOCHAT_SEED_ACCOUNT_NAME="B12 Smoke Account" \
GOCHAT_SEED_INBOX_NAME="B12 Smoke Website Inbox" \
go run ./cmd/gochat seed

The seed command creates deterministic login/account/inbox/contact/company/conversation data plus CSAT, SLA, CustomRole, AgentCapacity, and Captain fixtures for the smoke paths.

Smoke Matrix

Area	Current result	Owner if failing
Boot GoChat backend	Passed /health during enterprise browser smoke	B12.1
Boot reused Chatwoot Vite frontend	Passed Vite readiness during enterprise browser smoke	B12.1
Auth/profile	Passed browser login plus API smoke	B2/B12.2
Inbox list/settings	Passed API smoke	B5/B12.2
Conversation list/detail/message send	Passed dashboard browser request plus API smoke	B3/B12.2
Contact/company views	Passed contact/company API smoke	B4/B12.2
Search/indexing	Passed search API smoke	B6/B12.2
Widget config/message	Passed API smoke	B12.2
Public CSAT	Passed CSAT API/download and browser route requests	B8/B12.2
Enterprise screens	Passed enterprise browser route requests for SLA, CSAT, automation, macros, audit, custom roles, capacity, Captain, and Copilot	B7-B11/B12.3

Notes

Command run: scripts/parity_frontend_smoke.sh --enterprise-browser-smoke. Browser report: /home/rogee/Projects/gochat/.tmp/frontend-smoke-live/browser-smoke-report.json.

When using the default Meilisearch-first boot command, start Meilisearch separately, for example:

docker run --rm -p 7700:7700 -e MEILI_MASTER_KEY=gochat_dev getmeili/meilisearch:latest

3.1 KiB Raw Blame History