优化前端规范
parent
897ee8de9f
commit
c6117e1c49
169
AGENTS.md
169
AGENTS.md
|
|
@ -1,128 +1,73 @@
|
|||
# NEX Design System — Agent Entry Rules (0.1.6)
|
||||
# NEX Design System — Agent Development Rules (0.1.7)
|
||||
|
||||
本文件是 NEX 的 Agent 入口。先确认 NEX 目录位置,再以本文件所在目录为基准读取 `docs/`、`config/` 和 `templates/`。如果本文件被合并到项目根 `AGENTS.md`,必须将文档路径改为项目中的实际安装路径,不得保留失效的相对路径。
|
||||
NEX 的目标是统一设计规范并约束 Agent 开发行为。NEX 不负责测试体系、测试覆盖率、自动化测试、质量闸门或测试报告。
|
||||
|
||||
> **本仓库的实际安装路径**(NEX 0.1.6 随仓库置于 `nex_design_system/`,以下路径相对项目根):
|
||||
> 规范 `nex_design_system/docs/`、配置模板 `nex_design_system/config/`、模板 `nex_design_system/templates/`。
|
||||
> 本文件即项目根 `AGENTS.md`,因此 §1 已改写为实际路径,不再使用失效的 `docs/…` 相对路径。
|
||||
> **本仓库的实际安装路径**:NEX 0.1.7 随仓库置于 `nex_design_system/`,
|
||||
> 因此下文的 `docs/…` 均相对该目录(如 `nex_design_system/docs/01-design-principles.md`)。
|
||||
> 本文件即项目根 `AGENTS.md`,§1 第 3、4 项指向的项目规则与项目 UI/UX 规范为:
|
||||
> `frontend/src/styles/design-tokens.css`(Token 权威来源)、
|
||||
> `frontend/src/theme/antdTheme.ts`(antd 主题映射)、
|
||||
> `docs/sdd/architecture/standards/nex-conformance-matrix.md`(符合性与例外,按 0.1.6 章节号登记)、
|
||||
> `docs/sdd/architecture/standards/responsive-breakpoint-registry.md`(断点登记)、
|
||||
> `docs/quickstart.md` §6(前端约定)。本项目没有独立的「项目设计规范」文档,以上即权威来源。
|
||||
|
||||
## 1. 开始任务前必须读取
|
||||
## 1. 每个任务的最小读取范围
|
||||
|
||||
1. `nex_design_system/docs/00-governance-and-adaptation.md`
|
||||
2. `nex_design_system/docs/02-design-principles.md`
|
||||
3. `nex_design_system/docs/03-design-tokens.md`
|
||||
4. `nex_design_system/docs/04-layout-system.md`
|
||||
5. `nex_design_system/docs/05-component-system.md`
|
||||
6. `nex_design_system/docs/06-interaction-system.md`
|
||||
7. `nex_design_system/docs/07-page-patterns.md`
|
||||
8. `nex_design_system/docs/08-accessibility-responsive.md`
|
||||
9. `nex_design_system/docs/09-agent-execution-rules.md`
|
||||
10. `nex_design_system/docs/12-responsive-accessibility-quality.md`
|
||||
11. `nex_design_system/docs/14-accessibility-platform-matrix.md`
|
||||
12. 项目根目录 `nex.config.yaml`(如存在)
|
||||
13. 项目级 UI/UX 规范。本项目当前没有独立的「项目设计 specification」文档,
|
||||
实际权威来源为:`frontend/src/styles/design-tokens.css`(Token)、
|
||||
`frontend/src/theme/antdTheme.ts`(antd 主题映射)、
|
||||
`docs/sdd/architecture/standards/nex-conformance-matrix.md`(符合性与例外)、
|
||||
`docs/sdd/architecture/standards/responsive-breakpoint-registry.md`(断点登记)、
|
||||
`docs/quickstart.md` §6(前端约定)。
|
||||
开始任务时读取:
|
||||
1. 本文件;
|
||||
2. 项目根目录 `nex.config.yaml`(如存在);
|
||||
3. 项目根 `AGENTS.md` 中的项目规则;
|
||||
4. 项目已有的 UI/UX 规范(如存在)。
|
||||
|
||||
只在任务涉及 NexDocus 历史实现或明确要求参考时,读取
|
||||
`nex_design_system/docs/01-project-audit.md`。它不是新项目的实施基线。
|
||||
NEX 0.1.6 包内**不含** `config/reference-nexdocus-profile.example.yaml`
|
||||
(`nex_design_system/config/` 下只有 `project-profile.example.yaml`),引用该文件时按缺失处理。
|
||||
然后**按任务读取** NEX 文档,不得默认全量读取:
|
||||
- 视觉风格/页面:`docs/01-design-principles.md`、`docs/08-page-patterns.md`;
|
||||
- 颜色/主题/Token:`docs/02-design-tokens-and-theme.md`;
|
||||
- 页面布局/导航/移动端:`docs/03-layout-and-responsive.md`;
|
||||
- 公共组件:`docs/04-component-system.md`;
|
||||
- 表单/表格/弹层/反馈:`docs/05-interaction-system.md`;
|
||||
- 语义/键盘/辅助技术支持:`docs/06-accessibility-design.md`;
|
||||
- 体验性能/加载呈现:`docs/07-performance-aware-design.md`;
|
||||
- 新项目技术栈:`docs/10-project-stack-defaults.md`;
|
||||
- 首次接入:`docs/11-project-adoption.md`。
|
||||
|
||||
## 2. 规范层级
|
||||
## 2. 新项目与已有项目
|
||||
|
||||
遵循 NEX 三层模型:
|
||||
- 新项目:`nex.config.yaml` 的 `stack` 是明确技术选型。按它初始化,不得自行换栈。
|
||||
- 已有项目:以真实代码、依赖和锁文件为准,保留现有技术栈;不得因为 NEX 默认值不同而迁移。
|
||||
- 项目具体视觉参数、Token 名称、组件 API、布局尺寸和断点以项目级 UI 规范为准。
|
||||
|
||||
- **NEX Core**:跨项目质量与设计治理要求。
|
||||
- **Project Design Specification**:本项目视觉、布局、技术和交互的权威具体规范。
|
||||
- **Project Implementation**:当前主题、Token、组件和页面的真实实现。
|
||||
## 3. 开发时必须遵守
|
||||
|
||||
NexDocus 参数、示例截图和示例组件名不是跨项目默认值。新项目的技术起步默认值以 `nex.config.yaml` 的 `stack` 为准;它只适用于新项目初始化,不是 NEX Core 对所有项目的强制技术栈。已有项目由项目级规范和真实实现决定。NEX Core 的通用 MUST 要求不能因项目偏好而取消,但可以采用不同技术方式满足。
|
||||
1. 先理解现有页面和组件,再改代码;优先复用,不重复造组件。
|
||||
2. 使用项目既有 Token 和主题单一来源,不另建重复变量层。
|
||||
3. 保持同类页面、组件和交互的一致性。
|
||||
4. 不擅自改变业务流程、交互路径、默认值或数据语义。
|
||||
5. 不擅自升级依赖、替换 UI 库、改变语言或重构目录。
|
||||
6. 仅修改完成当前任务所需的范围;不顺手重构无关页面。
|
||||
7. 响应式、无障碍和体验性能按对应设计规范实现;不把这些要求扩展成 NEX 自建测试流程。
|
||||
8. 若项目实现与 NEX 示例不同,先判断是否是合理的项目适配,不强制套用示例尺寸或命名。
|
||||
9. 设计要求有冲突时,以安全/适用规范底线、项目级 UI 规范和用户明确要求为依据;无法确定时只提出一个关键问题。
|
||||
|
||||
## 3. 默认技术栈与自动发现(0.1.6;沿用 0.1.5 默认栈)
|
||||
## 4. 执行方式
|
||||
|
||||
`nex_design_system/config/project-profile.example.yaml` 是带有明确默认技术栈的配置模板。它不是“技术栈自动猜测模板”。
|
||||
默认采用轻量开发:
|
||||
- 对当前需求做必要分析;
|
||||
- 查找相关现有组件、Token、页面模式;
|
||||
- 读取相关 NEX 章节;
|
||||
- 直接实施必要修改;
|
||||
- 在对话中简要汇报文件和行为变化。
|
||||
|
||||
- **新项目**:`project.lifecycle` 为 `new`,或 `auto` 且仓库为空/没有实际应用代码时,必须把 `stack` 中的默认技术栈作为初始化目标。不得忽略这些选型,也不得再次要求用户填写一份技术栈问卷。
|
||||
- **已有项目**:`project.lifecycle` 为 `existing`,或 `auto` 且仓库已有应用代码/锁文件/构建配置时,以实际项目为准;默认技术栈仅供参考,不得据此替换、升级或迁移现有技术。
|
||||
- `project.type` 默认是 `fullstack`。纯前端或纯后端项目只需覆盖该字段。
|
||||
- 用户可以只覆盖 `stack` 中不符合当前项目意图的字段;未覆盖的默认值仍然有效。
|
||||
只有涉及全局 Token、应用 Shell、导航体系、共享组件 API 或大范围视觉统一时,才先提交简短影响说明和实施计划。
|
||||
|
||||
新项目默认栈详见 `nex_design_system/docs/13-project-stack-defaults.md`,包括 React、TypeScript、Vite、Ant Design、Tailwind CSS v4、Python、FastAPI、SQLite/PostgreSQL 等。依赖版本采用创建时兼容的稳定版本,并提交 lockfile。
|
||||
## 5. NEX 的文件和工具边界
|
||||
|
||||
Agent 仍须自动发现已有项目的实际情况,包括:
|
||||
- 项目名称、类型和主要界面语言;
|
||||
- 前后端框架、语言、依赖版本、构建工具和 UI/样式方案;
|
||||
- 项目 UI/UX 规范与设计决策文档;
|
||||
- Token 权威来源、主题链路、共享组件目录和布局模式;
|
||||
- 路由、断点、响应式规则、质量命令、视觉基线和 CI;
|
||||
- 适用的辅助技术验证范围及尚未执行的人工测试。
|
||||
- 普通任务不得创建阶段报告、审计报告、`reports/` 目录或截图证据目录。
|
||||
- 不得为了遵守 NEX 新建 `scripts/ui/`、自定义检查脚本、自动化测试或质量闸门。
|
||||
- 不得自动引入 Playwright、axe、Vitest、Pytest 或其他测试工具;它们由项目自身工程规范决定。
|
||||
- 不得启动 VoiceOver、NVDA、Orca 等屏幕阅读器;NEX 不定义其测试流程。
|
||||
- 不得把 NEX 规范文档复制成项目中的第二套完整 UI 规范。项目只需保留必要的项目专属设计说明。
|
||||
- 只有用户明确要求,或确有长期设计决策需要留档时,才新增/更新文档。
|
||||
|
||||
无法发现的信息应标记 `UNKNOWN` 并说明证据缺口。不得把 `auto` 当成待用户填写的占位符,也不得为了补全配置而向用户发送长问卷。只有在信息无法从仓库确认且会影响产品选择、数据安全或高风险改动时,才提出最少量的具体问题。
|
||||
## 6. 汇报要求
|
||||
|
||||
新项目未覆盖的 `stack` 字段采用默认技术栈。已有项目不采用默认栈迁移,而是优先保留真实、成熟的现有实现;NEX 的通用设计质量要求仍然适用。
|
||||
|
||||
## 4. 开发前审计要求
|
||||
|
||||
修改既有前端前,先检查:
|
||||
|
||||
- 项目技术栈和真实依赖(以锁文件、`package.json`、构建配置为证据)。
|
||||
- 项目级 UI 规范和设计决策记录。
|
||||
- Token 的单一事实来源及其派生链路(CSS、主题库、框架变量等)。
|
||||
- 已有组件、页面模式、主题机制和布局参数。
|
||||
- 现有交互路径、响应式行为、自动化检查与视觉基线。
|
||||
|
||||
将发现映射为 `COMPLIANT`、`ADOPTED`、`ADAPTED`、`DEFERRED` 或 `NOT_APPLICABLE`。优先使用 `nex_design_system/templates/project-conformance-matrix.md`(本项目落地件:`docs/sdd/architecture/standards/nex-conformance-matrix.md`)。如果用户要求只审计,则不得修改业务代码。
|
||||
|
||||
## 5. 强制约束
|
||||
|
||||
1. **先盘点、后复用、再新增。** 先搜索项目现有共享组件和功能等价物。已有组件能满足需求时,不新增重复组件或第二套组件库。
|
||||
2. **项目适配优先。** 不将 NEX 参考项目的技术栈、品牌色、Token 名称、Header/Sider 尺寸、断点、控件高度或页面模式套用到其他项目。
|
||||
3. **不强制 `--nex-*` 命名。** 优先沿用项目现有语义 Token 和权威主题管线。只有项目没有合理命名体系、且批准采用 NEX 前缀时才可新增命名空间。
|
||||
4. **保持 Token 单一事实来源。** 可以由一个源文件/对象/配置单向派生 CSS Variables、组件库主题或框架变量;不得为同一语义值建立彼此独立、人工维护的多份来源。禁止为追求“统一”而破坏已经验证的单向派生链路。
|
||||
5. **保护成熟实现,但不固化缺陷。** 保留已验证的视觉和交互模式。若发现可复现的功能缺陷、安全问题或可访问性缺陷,应说明证据并提出最小修复;不得以“保持现状”为由忽略缺陷。
|
||||
6. **不擅自改变业务交互。** 视觉改造不得改变用户操作路径、数据语义、默认值或业务流程,除非任务明确授权。修复可访问性时应优先保持原操作意图和鼠标行为。
|
||||
7. **不擅自改技术栈。** 不升级框架、替换 UI 库、改变 JS/TS 方案或引入新样式系统,除非用户明确批准。
|
||||
8. **页面模式按需采用。** 只为项目真实存在的页面和工作区选择模式。`NOT_APPLICABLE` 的页面、组件和工作区不应被引入。
|
||||
9. **避免无意义封装。** 不机械包装所有第三方基础组件;只封装重复、高价值、需要统一 API/状态/可访问性行为的模式。
|
||||
10. **交互状态完整。** 适用时覆盖 loading、success、empty、error、disabled、permission-denied 等状态。状态不能只靠颜色表达。
|
||||
11. **可访问性是质量底线。** 自定义交互必须支持键盘、可见焦点和可访问名称;拖拽操作必须提供非拖拽替代路径。
|
||||
12. **滚动和尺寸必须基于实际布局。** 对嵌套 Flex/Grid 工作区检查 `min-width: 0`、`min-height: 0`、滚动容器归属和溢出,不要机械添加固定尺寸或 `overflow: hidden`。
|
||||
13. **不滥用局部覆盖。** 不用大量 `!important`、高优先级选择器或深层第三方 DOM 覆盖来修补应由 Token/主题/共享组件解决的问题;需要时说明范围和原因。
|
||||
14. **响应式断点必须登记。** 新增断点应有语义名称、数值/范围、布局理由、权威来源和边界测试;不得散落增加无法追踪的媒体查询。
|
||||
15. **窄屏数据必须可对账。** 隐藏列、卡片化或折叠详情不得导致重要数据无处可见;必须核验字段、记录数、顺序和动作仍可访问。
|
||||
16. **图标不得污染可访问名称。** 装饰性图标应从辅助技术名称计算中排除;图标与可见文案组合时避免重复朗读;图标本身不能以内部 glyph 名称充当业务文案。
|
||||
17. **真实 AT 验证按风险触发且跨平台选择。** 日常默认 E0–E2;只有复杂自定义控件、拖拽/排序、复合导航、关键数据表格、重要 Live Region 或合同/目标用户要求触发 E3。macOS 使用 VoiceOver,Windows 使用 NVDA(必要时 JAWS/Narrator),Linux 使用 Orca。E3 不适用时记录 `E3_NOT_REQUIRED`;必要但环境不可用时标记 `MANUAL_QA_REQUIRED`。
|
||||
18. **不得擅自启动屏幕阅读器。** 启动、关闭或切换 VoiceOver/NVDA/Orca 等系统 AT 前必须获得用户对本次 E3 的明确授权。记录初始状态,不得关闭用户原本启用的 AT,不得擅改系统级辅助功能设置。日常视觉、浏览器自动化和键盘验收不得启动屏幕阅读器。
|
||||
19. **样式层与性能优化必须有证据。** 不为形式一致进行全量 CSS Layer 迁移;不为消除 Bundle 警告盲目调阈值或分包。先提供级联冲突或实际加载数据,再做最小变更。
|
||||
20. **范围受控。** 不把审计顺手扩展为全项目重构。超出授权范围、影响已有体验或需改变设计决策时,先提交方案并等待批准。
|
||||
|
||||
## 6. 标准工作流
|
||||
|
||||
1. 读取 NEX Core、项目配置和项目级设计规范。
|
||||
2. 检查真实实现并建立符合性/差异映射。
|
||||
3. 明确任务范围、复用组件、可能受影响页面和回归面。
|
||||
4. 对跨组件或跨页面改动先提交实施计划;仅在用户已明确授权的范围内执行。
|
||||
5. 先修正 Token/主题/共享模式,再迁移具体页面;避免一次性机械替换。
|
||||
6. 执行项目实际存在的检查命令;不得虚构 lint、test、视觉测试或脚本结果。
|
||||
7. 验证受影响的主题、视口、键盘路径和交互状态;使用项目现有检查矩阵,不强制所有项目采用同一固定路由数或视口数。
|
||||
8. 汇报改动、规范映射、测试证据、视觉对比、未完成事项和风险。
|
||||
9. 对关键交互区分 E0 源码审阅、E1 自动化、E2 浏览器人工交互和 E3 真实辅助技术验证;E3 按风险触发,不适用时记录 `E3_NOT_REQUIRED`,必要但未执行时标记 `MANUAL_QA_REQUIRED`。
|
||||
|
||||
## 7. 例外记录
|
||||
|
||||
偏离 NEX Core 的 SHOULD 或采用不同项目实现时,记录:规则、状态(通常为 `ADAPTED` / `DEFERRED`)、原因、证据、影响范围、责任人/批准来源和复审条件。不得把单个项目的例外自动推广为全局规范。
|
||||
|
||||
## 8. 完成定义
|
||||
|
||||
只有在以下事项满足后,才能报告任务完成:
|
||||
|
||||
- 项目规范与实现之间没有未说明的重大冲突。
|
||||
- 新增实现优先复用了现有组件、Token 和页面模式。
|
||||
- 没有未经授权改变技术栈、布局基线或业务交互。
|
||||
- 适用的主题、响应式、键盘和状态检查已执行。
|
||||
- 项目真实可用的质量门禁已执行;不可执行项已说明。
|
||||
- 文档、配置和代码行为保持一致。
|
||||
用简洁对话汇报:完成内容、主要文件、关键设计选择、尚未解决的阻塞。除用户明确要求外,不生成长篇报告,不列出与本任务无关的测试证据。
|
||||
|
|
|
|||
|
|
@ -1,6 +1,7 @@
|
|||
import { useState } from 'react'
|
||||
import { useRef, useState } from 'react'
|
||||
import { useNavigate, useSearchParams } from 'react-router-dom'
|
||||
import { Form, Input, Button, Tabs } from 'antd'
|
||||
import type { InputRef } from 'antd'
|
||||
import { UserOutlined, LockOutlined, MailOutlined, ArrowRightOutlined } from '@ant-design/icons'
|
||||
import { login, register, type LoginPayload, type RegisterPayload } from '@/api/auth'
|
||||
import { getUserMenus } from '@/api/menu'
|
||||
|
|
@ -18,6 +19,30 @@ function Login() {
|
|||
const navigate = useNavigate()
|
||||
const [searchParams] = useSearchParams()
|
||||
const { setUser, setToken } = useUserStore()
|
||||
const usernameRef = useRef<InputRef>(null)
|
||||
const passwordRef = useRef<InputRef>(null)
|
||||
|
||||
/**
|
||||
* Chrome 会把保存过的账号密码直接写进 input,但不派发 React 能收到的 change 事件,
|
||||
* 表单值因此还是空的:第一次点「立即登录」被必填校验拦下,看起来像点了没反应,
|
||||
* 再点一次才成功。这里按 DOM 里的真实值补写进表单并直接重新提交。
|
||||
*/
|
||||
const handleLoginValidationFailed = () => {
|
||||
const domValues: Partial<LoginPayload> = {}
|
||||
const domUsername = usernameRef.current?.input?.value ?? ''
|
||||
const domPassword = passwordRef.current?.input?.value ?? ''
|
||||
if (domUsername) {
|
||||
domValues.username = domUsername
|
||||
}
|
||||
if (domPassword) {
|
||||
domValues.password = domPassword
|
||||
}
|
||||
// 只有补齐到「可以提交」才重试,否则会造成校验失败 → 重提交 → 又失败的死循环
|
||||
if (!domValues.username || !domValues.password) return
|
||||
|
||||
loginForm.setFieldsValue(domValues)
|
||||
loginForm.submit()
|
||||
}
|
||||
|
||||
const handleLogin = async (values: LoginPayload) => {
|
||||
setLoading(true)
|
||||
|
|
@ -133,6 +158,7 @@ function Login() {
|
|||
form={loginForm}
|
||||
name="login"
|
||||
onFinish={handleLogin}
|
||||
onFinishFailed={handleLoginValidationFailed}
|
||||
autoComplete="off"
|
||||
layout="vertical"
|
||||
>
|
||||
|
|
@ -142,6 +168,7 @@ function Login() {
|
|||
rules={[{ required: true, message: '请输入用户名' }]}
|
||||
>
|
||||
<Input
|
||||
ref={usernameRef}
|
||||
prefix={<UserOutlined aria-hidden style={{ color: 'var(--border-color-strong)' }} />}
|
||||
placeholder="请输入用户名"
|
||||
size="large"
|
||||
|
|
@ -154,6 +181,7 @@ function Login() {
|
|||
rules={[{ required: true, message: '请输入密码' }]}
|
||||
>
|
||||
<Input.Password
|
||||
ref={passwordRef}
|
||||
iconRender={passwordVisibilityIcon}
|
||||
prefix={<LockOutlined aria-hidden style={{ color: 'var(--border-color-strong)' }} />}
|
||||
placeholder="请输入密码"
|
||||
|
|
|
|||
|
|
@ -22,11 +22,12 @@
|
|||
|
||||
/* ========== 项目卡片(统一骨架 + 固定高度) ========== */
|
||||
.project-card {
|
||||
height: 236px;
|
||||
/* 固定高度保证同排卡片等高;取值 = 标题行 + 两行描述 + 元信息 + 操作栏 + 少量余量 */
|
||||
height: 224px;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
cursor: pointer;
|
||||
transition: all 0.3s;
|
||||
transition: transform var(--transition-fast), box-shadow var(--transition-fast), border-color var(--transition-fast);
|
||||
position: relative;
|
||||
overflow: hidden;
|
||||
background: var(--card-bg);
|
||||
|
|
@ -34,8 +35,16 @@
|
|||
}
|
||||
|
||||
.project-card:hover {
|
||||
transform: translateY(-4px);
|
||||
box-shadow: var(--panel-shadow);
|
||||
transform: translateY(-2px);
|
||||
box-shadow: var(--shadow-3);
|
||||
border-color: var(--border-color-strong);
|
||||
}
|
||||
|
||||
/* 卡片是「打开项目」的操作(role=button),键盘聚焦必须有明确可见焦点 */
|
||||
.project-card:focus-visible {
|
||||
outline: none;
|
||||
border-color: var(--color-primary);
|
||||
box-shadow: var(--focus-ring), var(--shadow-3);
|
||||
}
|
||||
|
||||
.project-card .ant-card-body {
|
||||
|
|
@ -48,30 +57,36 @@
|
|||
|
||||
.project-card .ant-card-actions {
|
||||
flex: none;
|
||||
background: var(--bg-color-secondary);
|
||||
}
|
||||
|
||||
/* antd 自带分隔线颜色不随主题走,这里用项目 Token 覆盖(需要 !important 才稳定压过 antd) */
|
||||
.project-card .ant-card-actions > li:not(:last-child) {
|
||||
border-inline-end-color: rgba(15, 23, 42, 0.18) !important;
|
||||
}
|
||||
|
||||
body.dark .project-card .ant-card-actions > li:not(:last-child) {
|
||||
border-inline-end-color: rgba(255, 255, 255, 0.2) !important;
|
||||
border-inline-end-color: var(--border-color-secondary) !important;
|
||||
}
|
||||
|
||||
.project-card-public-badge {
|
||||
/* 原先是旋转 45° 的斜带,文字会被卡片圆角裁掉;改为右上角小标签。
|
||||
小号文字用语义浅色底 + 语义前景,两种主题下均达 AA(白字压 --color-success 只有 2.3:1) */
|
||||
position: absolute;
|
||||
top: 8px;
|
||||
right: -28px;
|
||||
background: linear-gradient(135deg, var(--color-success) 0%, #389e0d 100%);
|
||||
color: white;
|
||||
padding: 2px 32px;
|
||||
top: var(--space-xs);
|
||||
right: var(--space-xs);
|
||||
padding: 1px var(--space-xxs);
|
||||
border-radius: var(--radius-xs);
|
||||
background: var(--color-success-bg);
|
||||
color: var(--color-success-strong);
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
transform: rotate(45deg);
|
||||
box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
|
||||
line-height: 16px;
|
||||
z-index: 1;
|
||||
}
|
||||
|
||||
/* 右上角徽标会压住标题行末端:给标题留出徽标宽度,长项目名改为提前省略 */
|
||||
.project-card:has(.project-card-public-badge) .project-card-title-row,
|
||||
.project-card:has(.project-card-update-badge) .project-card-title-row {
|
||||
padding-inline-end: 44px;
|
||||
}
|
||||
|
||||
/* 参与项目右上角:未读更新通知数角标 */
|
||||
.project-card-update-badge {
|
||||
position: absolute;
|
||||
|
|
@ -81,14 +96,13 @@ body.dark .project-card .ant-card-actions > li:not(:last-child) {
|
|||
min-width: 20px;
|
||||
height: 20px;
|
||||
padding: 0 6px;
|
||||
border-radius: 999px;
|
||||
background: linear-gradient(135deg, var(--color-danger) 0%, var(--color-danger-strong) 100%);
|
||||
color: #fff;
|
||||
border-radius: var(--radius-pill);
|
||||
background: var(--color-danger-active);
|
||||
color: var(--text-color-inverse);
|
||||
font-size: 11px;
|
||||
font-weight: 600;
|
||||
line-height: 20px;
|
||||
text-align: center;
|
||||
box-shadow: 0 2px 6px rgba(245, 34, 45, 0.45);
|
||||
animation: project-badge-pop 0.25s ease-out;
|
||||
}
|
||||
|
||||
|
|
@ -123,36 +137,34 @@ body.dark .project-card .ant-card-actions > li:not(:last-child) {
|
|||
flex: none;
|
||||
width: 32px;
|
||||
height: 32px;
|
||||
border-radius: 9px;
|
||||
border-radius: var(--radius-md);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
font-size: 17px;
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
/* 图标只承担「我的 / 参与的」的次要区分:用语义浅色底 + 语义前景,
|
||||
不再用渐变和彩色投影(视觉克制),也避免白字压在中低饱和色上不足对比度。 */
|
||||
.project-card-title-icon.is-owner {
|
||||
background: linear-gradient(135deg, var(--color-primary) 0%, #69b1ff 100%);
|
||||
box-shadow: 0 3px 8px rgba(22, 119, 255, 0.25);
|
||||
}
|
||||
|
||||
body.dark .project-card-title-icon.is-owner {
|
||||
background: var(--color-primary-gradient);
|
||||
background: var(--color-primary-bg);
|
||||
color: var(--color-primary);
|
||||
}
|
||||
|
||||
.project-card-title-icon.is-shared {
|
||||
background: linear-gradient(135deg, var(--color-success) 0%, #95de64 100%);
|
||||
box-shadow: 0 3px 8px rgba(82, 196, 26, 0.25);
|
||||
background: var(--color-success-bg);
|
||||
color: var(--color-success-strong);
|
||||
}
|
||||
|
||||
/* 卡片操作栏 Git 仓库图标:未配置 = 灰色分支图标;已配置 = 实心 GitHub 图标(品牌色区分) */
|
||||
.project-card-git-action-icon {
|
||||
color: var(--text-color-secondary);
|
||||
font-size: 16px;
|
||||
transition: color 0.2s;
|
||||
transition: color var(--transition-fast);
|
||||
}
|
||||
|
||||
.project-card-git-action-icon.configured {
|
||||
/* GitHub 品牌标识色:按媒体原始值保留,不随主题语义走 */
|
||||
color: #24292e;
|
||||
font-size: 17px;
|
||||
}
|
||||
|
|
@ -173,13 +185,15 @@ body.dark .project-card-git-action-icon.configured {
|
|||
color: var(--text-color);
|
||||
}
|
||||
|
||||
/* 描述为卡片主要信息,占据剩余空间保证高度一致 */
|
||||
/* 描述固定两行高度:卡片等高由它保证,
|
||||
不能让 flex 把盒子压到不足两行,否则文字会裁在半行上 */
|
||||
.project-description {
|
||||
flex: 1;
|
||||
flex: none;
|
||||
height: calc(1.6em * 2);
|
||||
font-size: 13px;
|
||||
line-height: 1.6;
|
||||
color: var(--text-color-secondary);
|
||||
margin: 0 0 10px;
|
||||
margin: 0;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
display: -webkit-box;
|
||||
|
|
@ -189,11 +203,12 @@ body.dark .project-card-git-action-icon.configured {
|
|||
|
||||
/* 底部元信息区:三项信息三等分网格(三分格,无分隔线) */
|
||||
.project-card-meta {
|
||||
margin-top: auto;
|
||||
display: grid;
|
||||
grid-template-columns: repeat(3, minmax(0, 1fr));
|
||||
align-items: center;
|
||||
column-gap: 6px;
|
||||
padding-top: 10px;
|
||||
padding-top: var(--space-xs);
|
||||
border-top: 1px dashed var(--border-color);
|
||||
color: var(--text-color-secondary);
|
||||
font-size: 12px;
|
||||
|
|
@ -223,106 +238,34 @@ body.dark .project-card-git-action-icon.configured {
|
|||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: 5px;
|
||||
gap: 4px;
|
||||
min-width: 0;
|
||||
max-width: 100%;
|
||||
}
|
||||
|
||||
.project-card-owner-avatar {
|
||||
flex: none;
|
||||
width: 22px;
|
||||
height: 22px;
|
||||
border-radius: 50%;
|
||||
background: linear-gradient(135deg, var(--color-primary) 0%, #69b1ff 100%);
|
||||
color: #fff;
|
||||
font-size: 11px;
|
||||
font-weight: 600;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
user-select: none;
|
||||
}
|
||||
|
||||
.project-card-share .project-card-owner-avatar {
|
||||
background: linear-gradient(135deg, var(--color-success) 0%, #95de64 100%);
|
||||
color: var(--text-color-secondary);
|
||||
}
|
||||
|
||||
.project-card-owner-name {
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
color: var(--text-color);
|
||||
color: inherit;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
max-width: 100%;
|
||||
}
|
||||
|
||||
/* 项目角色徽章(重新设计:药丸式彩色徽章 + 角色图标) */
|
||||
.project-card-role-badge {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
gap: 4px;
|
||||
padding: 2px 9px;
|
||||
border-radius: 999px;
|
||||
font-size: 11px;
|
||||
line-height: 16px;
|
||||
font-weight: 500;
|
||||
white-space: nowrap;
|
||||
max-width: 100%;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
|
||||
/* 所有者 / 管理者:金色徽章 */
|
||||
.project-card-role-badge.role-owner,
|
||||
.project-card-role-badge.role-admin {
|
||||
background: rgba(250, 173, 20, 0.16);
|
||||
color: #d48806;
|
||||
}
|
||||
|
||||
body.dark .project-card-role-badge.role-owner,
|
||||
body.dark .project-card-role-badge.role-admin {
|
||||
background: rgba(250, 173, 20, 0.22);
|
||||
color: #ffc53d;
|
||||
}
|
||||
|
||||
/* 编辑者:蓝色徽章 */
|
||||
.project-card-role-badge.role-editor {
|
||||
background: rgba(22, 119, 255, 0.12);
|
||||
color: var(--link-color);
|
||||
}
|
||||
|
||||
body.dark .project-card-role-badge.role-editor {
|
||||
background: rgba(23, 125, 220, 0.25);
|
||||
color: #4c9be8;
|
||||
}
|
||||
|
||||
/* 查看者:灰色徽章 */
|
||||
.project-card-role-badge.role-viewer {
|
||||
background: var(--item-hover-bg);
|
||||
color: var(--text-color-secondary);
|
||||
}
|
||||
|
||||
/* ========== 我的项目卡片:蓝色管理风(无顶边) ========== */
|
||||
.project-card-my {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.project-card-my .ant-card-actions {
|
||||
background: var(--bg-color-secondary);
|
||||
}
|
||||
|
||||
/* ========== 参与的项目卡片:绿色协作风(无顶边) ========== */
|
||||
.project-card-share {
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.project-card-share .ant-card-actions {
|
||||
background: var(--bg-color-secondary);
|
||||
}
|
||||
|
||||
/* 参与项目底部功能项:与我的项目操作项风格保持一致(普通操作项,无药丸背景) */
|
||||
/* 参与项目底部:以某角色进入项目是该卡片的主操作。
|
||||
文字用正文色保证两种主题的对比度(主色作文字在暗色下仅 3.9:1,不足 AA 的 4.5:1),
|
||||
主色只落在图标上(图形元素 3:1 即可),悬停时才整体转主色。 */
|
||||
.project-card-view-action {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
|
|
@ -331,13 +274,23 @@ body.dark .project-card-role-badge.role-editor {
|
|||
padding: 0 4px;
|
||||
min-width: 32px;
|
||||
font-size: 14px;
|
||||
font-weight: 500;
|
||||
line-height: 22px;
|
||||
color: var(--text-color);
|
||||
cursor: pointer;
|
||||
transition: color 0.2s ease;
|
||||
transition: color var(--transition-fast);
|
||||
}
|
||||
|
||||
.project-card-view-action .anticon {
|
||||
color: var(--color-primary);
|
||||
}
|
||||
|
||||
.project-card-view-action:hover {
|
||||
color: var(--link-color);
|
||||
color: var(--color-primary-active);
|
||||
}
|
||||
|
||||
body.dark .project-card-view-action:hover {
|
||||
color: var(--color-primary-hover);
|
||||
}
|
||||
|
||||
.project-card-member-action {
|
||||
|
|
@ -346,11 +299,15 @@ body.dark .project-card-role-badge.role-editor {
|
|||
justify-content: center;
|
||||
gap: 4px;
|
||||
cursor: pointer;
|
||||
transition: color 0.2s ease;
|
||||
transition: color var(--transition-fast);
|
||||
}
|
||||
|
||||
.project-card-member-action:hover {
|
||||
color: var(--link-color);
|
||||
color: var(--color-primary-active);
|
||||
}
|
||||
|
||||
body.dark .project-card-member-action:hover {
|
||||
color: var(--color-primary-hover);
|
||||
}
|
||||
|
||||
/* ========== 搜索结果卡片(保持旧版居中风格) ========== */
|
||||
|
|
|
|||
|
|
@ -142,25 +142,12 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) {
|
|||
return project.owner_nickname || project.owner_name || '未知'
|
||||
}
|
||||
|
||||
// 卡片归属用户头像首字符
|
||||
const cardOwnerInitial = (project: ProjectListItem) => {
|
||||
const name = cardOwnerName(project)
|
||||
return (name || '?').charAt(0).toUpperCase()
|
||||
}
|
||||
|
||||
// 卡片角色显示名(我的项目 -> 所有者;参与项目 -> 我的角色)
|
||||
const cardRoleLabel = (project: ProjectListItem) => {
|
||||
if (type === 'my') return '所有者'
|
||||
return projectRoleLabel(project.user_role)
|
||||
}
|
||||
|
||||
// 卡片角色徽章样式类
|
||||
const cardRoleClass = (project: ProjectListItem) => {
|
||||
if (type === 'my') return 'role-owner'
|
||||
const roleMap: Record<string, string> = { admin: 'role-admin', editor: 'role-editor', viewer: 'role-viewer' }
|
||||
return roleMap[normalizeRole(project.user_role)] || 'role-viewer'
|
||||
}
|
||||
|
||||
// 卡片角色徽章图标
|
||||
const cardRoleIcon = (project: ProjectListItem) => {
|
||||
const role = normalizeRole(project.user_role)
|
||||
|
|
@ -807,7 +794,11 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) {
|
|||
<Col xs={24} sm={12} md={8} lg={6} key={project.id}>
|
||||
<Card
|
||||
hoverable
|
||||
className={type === 'share' ? 'project-card project-card-share' : 'project-card project-card-my'}
|
||||
className={`project-card ${type === 'share' ? 'project-card-share' : 'project-card-my'}`}
|
||||
// 整张卡片是「打开项目」的操作,键盘必须能完成同一动作
|
||||
aria-label={`打开项目:${project.name}`}
|
||||
// keyboardActivation 同时提供 role/tabIndex/onKeyDown
|
||||
{...keyboardActivation(() => handleOpenProject(project.id))}
|
||||
onClick={() => handleOpenProject(project.id)}
|
||||
actions={type === 'my' ? [
|
||||
<Tooltip key="settings" title="项目设置">
|
||||
|
|
@ -850,7 +841,7 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) {
|
|||
</Tooltip>,
|
||||
] : [
|
||||
<Tooltip key="view" title={`以${cardRoleLabel(project)}身份进入项目`}>
|
||||
<span className={`project-card-view-action ${cardRoleClass(project)}`}>
|
||||
<span className="project-card-view-action">
|
||||
{cardRoleIcon(project)}
|
||||
{cardRoleLabel(project)}
|
||||
</span>
|
||||
|
|
@ -915,7 +906,6 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) {
|
|||
<CalendarOutlined aria-hidden /> {formatRelativeTime(project.last_activity_at) || formatDate(project.created_at) || '—'}
|
||||
</span>
|
||||
<span className="project-card-owner" title={cardOwnerName(project)}>
|
||||
<span className="project-card-owner-avatar">{cardOwnerInitial(project)}</span>
|
||||
<span className="project-card-owner-name">{cardOwnerName(project)}</span>
|
||||
</span>
|
||||
</>
|
||||
|
|
|
|||
|
|
@ -18,6 +18,9 @@
|
|||
|
||||
--color-success: #52c41a;
|
||||
--color-success-bg: #f6ffed;
|
||||
/* 成功语义的「可读前景」:用于压在 --color-success-bg 上的文字/图标,
|
||||
--color-success 本身作前景在白底仅 2.3:1,不能直接承载信息 */
|
||||
--color-success-strong: #23780d;
|
||||
--color-warning: #faad14;
|
||||
--color-warning-bg: #fffbe6;
|
||||
--color-danger: #ff4d4f;
|
||||
|
|
@ -133,6 +136,7 @@ body.dark {
|
|||
|
||||
--color-success: #49aa19;
|
||||
--color-success-bg: rgba(73, 170, 25, 0.16);
|
||||
--color-success-strong: #73d13d;
|
||||
--color-warning: #d89614;
|
||||
--color-warning-bg: rgba(216, 150, 20, 0.16);
|
||||
--color-danger: #dc4446;
|
||||
|
|
|
|||
|
|
@ -19,6 +19,8 @@ interface ApiErrorBody {
|
|||
export interface RequestConfig extends AxiosRequestConfig {
|
||||
/** 业务层自行提示错误时置 true,拦截器不再重复弹 Toast */
|
||||
skipErrorToast?: boolean
|
||||
/** 请求拦截器记录的本次请求所用 token,用于识别「旧会话迟到的 401」 */
|
||||
sentToken?: string | null
|
||||
}
|
||||
|
||||
export interface ApiRequest {
|
||||
|
|
@ -33,7 +35,9 @@ export interface ApiRequest {
|
|||
blob(config: RequestConfig): Promise<AxiosResponse<Blob>>
|
||||
}
|
||||
|
||||
let isHandlingUnauthorized = false
|
||||
// 最近一次处理会话过期的时间:同一批 401 只处理一次;
|
||||
// 用时间窗而不是布尔量,避免标志一旦置位就永不复位、后续过期再也踢不回登录页。
|
||||
let unauthorizedHandledAt = 0
|
||||
|
||||
function redirectToLoginWithReturnTo() {
|
||||
const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`
|
||||
|
|
@ -41,14 +45,25 @@ function redirectToLoginWithReturnTo() {
|
|||
window.location.href = `/login?redirect=${encodedReturnTo}`
|
||||
}
|
||||
|
||||
/** 会话过期:提示一次,清空凭证并跳转登录页(带上返回地址) */
|
||||
function handleUnauthorized(message: string) {
|
||||
if (window.location.pathname.includes('/login') || isHandlingUnauthorized) return
|
||||
isHandlingUnauthorized = true
|
||||
/**
|
||||
* 会话过期:提示一次,清空凭证并跳转登录页(带上返回地址)。
|
||||
*
|
||||
* sentToken 与当前 token 不一致时,说明这是「旧会话迟到的 401」:
|
||||
* 典型场景是重新登录期间,上一个会话遗留的轮询请求才返回。
|
||||
* 此时不能清理/跳转,否则会把刚登录成功的页面又踢回登录页(表现为要点第二次才进得去)。
|
||||
*/
|
||||
function handleUnauthorized(message: string, sentToken?: string | null) {
|
||||
if (window.location.pathname.includes('/login')) return
|
||||
if (sentToken && sentToken !== getAccessToken()) return
|
||||
if (Date.now() - unauthorizedHandledAt < 3000) return
|
||||
unauthorizedHandledAt = Date.now()
|
||||
Toast.muteErrors(2500)
|
||||
Toast.error('认证失败', message, 3, { force: true })
|
||||
clearAuthStorage()
|
||||
setTimeout(() => {
|
||||
window.setTimeout(() => {
|
||||
// 延迟期间用户可能已经完成重新登录(后台标签页还会把这个定时器整体延后触发),
|
||||
// 此时再把页面跳回登录页就会出现「登录成功但进不去,必须再点一次」。
|
||||
if (getAccessToken()) return
|
||||
redirectToLoginWithReturnTo()
|
||||
}, 600) // 延迟一小段时间,让提示先展示
|
||||
}
|
||||
|
|
@ -70,6 +85,7 @@ instance.interceptors.request.use(
|
|||
const token = getAccessToken()
|
||||
if (token) {
|
||||
config.headers.Authorization = `Bearer ${token}`
|
||||
;(config as RequestConfig).sentToken = token
|
||||
}
|
||||
return config
|
||||
},
|
||||
|
|
@ -94,7 +110,7 @@ instance.interceptors.response.use(
|
|||
if (res.code !== 200) {
|
||||
// 401: 未登录或 token 过期
|
||||
if (res.code === 401) {
|
||||
handleUnauthorized(res.message || '未登录或登录已过期')
|
||||
handleUnauthorized(res.message || '未登录或登录已过期', (response.config as RequestConfig).sentToken)
|
||||
return Promise.reject(new Error(res.message || '未登录或登录已过期'))
|
||||
}
|
||||
|
||||
|
|
@ -116,7 +132,7 @@ instance.interceptors.response.use(
|
|||
|
||||
// 401 始终走会话过期处理(清空凭证 + 跳转登录页)
|
||||
if (status === 401) {
|
||||
handleUnauthorized(data?.detail || '未登录或登录已过期')
|
||||
handleUnauthorized(data?.detail || '未登录或登录已过期', (error.config as RequestConfig | undefined)?.sentToken)
|
||||
} else if (!skipErrorToast) {
|
||||
switch (status) {
|
||||
case 403:
|
||||
|
|
|
|||
|
|
@ -1,24 +1,22 @@
|
|||
# NEX 0.1.6 默认项目配置
|
||||
# 新项目采用明确默认技术栈;已有项目自动识别并保留现状。
|
||||
# 通常无需填写。需要更换技术方案时,只修改 stack 中对应字段即可。
|
||||
# NEX 0.1.7 默认项目配置
|
||||
# 新项目使用明确默认栈;已有项目保留真实栈。
|
||||
# 普通使用无需填写整张表,只需覆盖与项目意图不同的字段。
|
||||
|
||||
nex:
|
||||
version: "0.1.6"
|
||||
version: "0.1.7"
|
||||
compliance: required
|
||||
profile_mode: default_stack_with_project_adaptation
|
||||
|
||||
project:
|
||||
name: auto
|
||||
lifecycle: auto # auto | new | existing;空仓库按 new,已有代码按 existing
|
||||
lifecycle: auto # auto | new | existing
|
||||
type: fullstack # fullstack | frontend-only | backend-only
|
||||
language: zh-CN
|
||||
|
||||
# 新项目默认技术栈(明确给定);已有项目不得因默认值不同而迁移。
|
||||
# 仅作为新项目的默认技术方案。已有项目不得据此迁移。
|
||||
stack:
|
||||
preset: nex-standard-fullstack
|
||||
version_policy: latest-stable-compatible
|
||||
lockfile: required
|
||||
|
||||
frontend:
|
||||
framework: React
|
||||
language: TypeScript
|
||||
|
|
@ -29,25 +27,22 @@ stack:
|
|||
state_management: Zustand
|
||||
routing: React Router
|
||||
http_client: Axios
|
||||
|
||||
backend:
|
||||
language: Python
|
||||
framework: FastAPI
|
||||
validation: Pydantic
|
||||
orm: SQLAlchemy
|
||||
migrations: Alembic
|
||||
|
||||
database:
|
||||
development: SQLite
|
||||
production: PostgreSQL
|
||||
|
||||
api:
|
||||
style: REST
|
||||
contract: OpenAPI
|
||||
|
||||
storage:
|
||||
local_assets: ./data
|
||||
|
||||
# NEX 只定义设计和开发行为,不定义测试工具或质量闸门。
|
||||
requirements:
|
||||
use_shared_components: true
|
||||
use_design_tokens: true
|
||||
|
|
@ -55,32 +50,16 @@ requirements:
|
|||
preserve_verified_patterns: true
|
||||
preserve_existing_stack: true
|
||||
avoid_duplicate_design_system_layers: true
|
||||
responsive_design: required
|
||||
accessibility_design: required
|
||||
performance_aware_design: required
|
||||
audit_before_broad_refactor: true
|
||||
require_approval_for_broad_changes: true
|
||||
|
||||
tooling:
|
||||
frontend:
|
||||
lint: ESLint
|
||||
format: Prettier
|
||||
unit_test: Vitest
|
||||
e2e_test: Playwright
|
||||
backend:
|
||||
test: Pytest
|
||||
|
||||
quality:
|
||||
auto_discover_commands: true
|
||||
responsive_review: true
|
||||
keyboard_review: true
|
||||
accessibility_naming_review: true
|
||||
responsive_table_data_reconciliation: true
|
||||
require_non_drag_alternative_when_applicable: true
|
||||
performance_optimization_requires_measurement: true
|
||||
accessibility:
|
||||
engineering_target: WCAG_2_2_AA
|
||||
routine_evidence_levels: [E0, E1, E2]
|
||||
advanced_evidence_level: E3
|
||||
real_screen_reader_testing: risk_based
|
||||
screen_reader_platform_matrix: auto_by_project_support_scope
|
||||
auto_start_screen_reader: false
|
||||
explicit_user_approval_before_start: true
|
||||
unavailable_environment_status: MANUAL_QA_REQUIRED
|
||||
agent:
|
||||
default_execution: lightweight
|
||||
load_documents_by_task: true
|
||||
create_reports_by_default: false
|
||||
create_custom_check_scripts: false
|
||||
add_test_frameworks: false
|
||||
run_full_project_audit_for_routine_tasks: false
|
||||
|
|
|
|||
Loading…
Reference in New Issue