Files
novalon-website/docs
zhangxiang 1b5c75ab64 test(qa): 采用 Playwright Test Agents 做作者侧 AI + 补主导航键盘用例
选型:AI 只用在「写/修/探索」,运行期保持零模型、零外部服务。不引入
tester-army/e2e —— 它是第二套 runner,且与本仓最值钱的三块错配(无像素
基线可比、不模拟 touch/color-scheme/reduced-motion、另起 json/junit 产物
口径)。判据、对照表与边界见 docs/testing/agentic-test-authoring.md。

- init-agents 产物:.claude/agents/{planner,generator,healer}.md + .mcp.json
  指向仓内自带的 run-test-mcp-server(不装 @playwright/mcp;Playwright 自身
  不调 LLM,模型由宿主 loop 提供 ⇒ 无新增密钥依赖,也不外发应用内容)
- 故意不入库 init-agents 生成的 seed.spec.ts:空占位会被 test:functional
  的 4 个 project 当空用例收集
- specs/nav-keyboard-navigation.plan.md:7 个场景,3 个延后并写明原因
- e2e/nav-keyboard.spec.ts(tag @a11y,4 例):补「键盘打不开/走不出主导航
  下拉」。hover 路径早有覆盖,jsdom 单测替不了浏览器层的 relatedTarget 与
  真实焦点顺序;契约逐行取自 src/components/layout/mega-dropdown.tsx:35-76
- 实测读数:dev 四 project 10 passed / 6 skipped(EXIT=0);E2E_TARGET=
  production 10 passed / 2 skipped(EXIT=0);--workers=1 --repeat-each=3
  24/24;type-check 与 lint 均 0 error
- 测到并定性两条「非产品缺陷」:① WebKit 本机不响应真实 Tab 键(连续 4 次
  后 activeElement 仍是 BODY,而 .focus() 有效),与 N-27 同源;② dev 目标
  下触发器 DOM 节点在 hydration 后被整体替换(失败样本 click=1 而 aria 恒
  false,通过样本相反 ⇒ 监听绑在已被换掉的旧节点上),生产产物不复现
  ⇒ openWithKeyboard 用 toPass() 重发交互;跳过范围按引擎收窄,没有用守卫
  把红压掉
- 不在本提交:AGENTS.md 已被 .gitignore 排除,其「85 张基线未提交」的日期
  更正只落本地;该假事实的已入库更正记录在 docs/lessons-learned.md:505
2026-10-08 15:56:20 +08:00
..
2026-03-10 12:45:08 +08:00

Novalon Website 文档

欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。

文档导航

📚 架构文档

💻 开发文档

🚀 部署文档

🧪 测试文档

🔌 API文档

📖 使用指南

项目概述

Novalon Website是四川睿新致远科技有限公司的企业官网,采用现代化的技术栈构建。

技术栈

  • 框架: Next.js 16 + React 19
  • 语言: TypeScript
  • 样式: Tailwind CSS
  • 数据库: SQLite + Drizzle ORM
  • 认证: NextAuth.js
  • 测试: Playwright + Jest

核心功能

  • 企业展示和产品服务介绍
  • 成功案例和新闻动态
  • 在线咨询和联系表单
  • CMS内容管理后台
  • 响应式设计和SEO优化

快速链接

贡献指南

文档更新

  1. 确保文档内容准确、清晰
  2. 使用Markdown格式编写
  3. 添加必要的代码示例
  4. 更新相关链接和引用

文档审查

  • 技术准确性
  • 内容完整性
  • 格式规范性
  • 链接有效性

获取帮助

如果在使用过程中遇到问题,可以:

  1. 查看相关文档
  2. 搜索故障排查指南
  3. 联系开发团队

文档版本

  • 版本: 1.0.0
  • 更新日期: 2026-03-24
  • 维护者: 开发团队

© 2026 四川睿新致远科技有限公司