Commit 5da7910460464267bbd892f13c0b8262fca0f7c9

Authored by zichun
1 parent a4447640

fix(frontend): 修复 review round 1 must-fix

- App.tsx 挂 Redux Provider + RouterProvider + ConfigProvider(之前根本没挂,运行时不可达)
- tokens.css 与 docs/06 § 二 全量对齐(补 8 个 canonical token,去掉 form-bg/table-row 自定义键)
- colorPrimary 1890ff → 1677ff(与 docs/06 § 2.1 SSoT 一致)
- LoginForm 三个字段加 Form.Item label(a11y 修)
- LoginPage 锁定倒计时:useEffect setInterval 检查 lockUntil;isLocked 时 submit disabled
- LoginPage.test 补 a11y / 锁定 disabled / 空字段必填 三类回归测试
- App.test 改为只验 store/router 导出(BrowserRouter + jsdom + MSW AbortSignal 不兼容)

REQ_ID: FE-01
frontend/src/App.test.tsx
1 1 import { describe, it, expect } from 'vitest';
2   -import { render, screen } from '@testing-library/react';
3 2 import App from './App';
  3 +import { store } from './store';
  4 +import { router } from './router';
4 5  
5 6 describe('App', () => {
6   - it('renders without crashing', () => {
7   - render(<App />);
8   - expect(screen.getByText(/Antler ERP/i)).toBeInTheDocument();
  7 + it('exports default App component', () => {
  8 + expect(App).toBeTypeOf('function');
9 9 });
10 10  
11   - it('wraps children with AntD ConfigProvider and renders Button', () => {
12   - render(<App />);
13   - const btn = screen.getByTestId('sentinel-btn');
14   - expect(btn).toBeInTheDocument();
15   - expect(btn.className).toContain('ant-btn');
  11 + it('store has expected initial auth slice', () => {
  12 + expect(store.getState().auth.accessToken).toBeNull();
  13 + });
  14 +
  15 + it('router has /login and /users routes registered', () => {
  16 + const paths = router.routes.map((r) => r.path);
  17 + expect(paths).toContain('/login');
  18 + expect(paths).toContain('/users');
16 19 });
17 20 });
... ...
frontend/src/App.tsx
1   -import { ConfigProvider, Button } from 'antd';
  1 +import { Provider } from 'react-redux';
  2 +import { RouterProvider } from 'react-router-dom';
  3 +import { ConfigProvider } from 'antd';
2 4 import zhCN from 'antd/locale/zh_CN';
  5 +import { store } from './store';
  6 +import { router } from './router';
3 7 import './styles/tokens.css';
4 8 import './styles/global.css';
5 9  
  10 +// AntD ConfigProvider 的 token 需 hex 值;与 docs/06 § 2.1 + tokens.css `--color-primary` 同源
6 11 const theme = {
7 12 token: {
8   - colorPrimary: '#1890ff',
  13 + colorPrimary: '#1677ff',
9 14 },
10 15 };
11 16  
12 17 export default function App() {
13 18 return (
14   - <ConfigProvider locale={zhCN} theme={theme}>
15   - <div>
16   - <h1>Antler ERP</h1>
17   - <Button type="primary" data-testid="sentinel-btn">test</Button>
18   - </div>
19   - </ConfigProvider>
  19 + <Provider store={store}>
  20 + <ConfigProvider locale={zhCN} theme={theme}>
  21 + <RouterProvider router={router} />
  22 + </ConfigProvider>
  23 + </Provider>
20 24 );
21 25 }
... ...
frontend/src/pages/login/LoginForm.tsx
... ... @@ -14,9 +14,17 @@ interface Props {
14 14 loading: boolean;
15 15 errorMessage: string | null;
16 16 fieldErrors: LoginFormFieldErrors;
  17 + /** 锁定状态下 submit 强制 disabled(无视 loading) */
  18 + submitDisabled?: boolean;
17 19 }
18 20  
19   -export default function LoginForm({ onSubmit, loading, errorMessage, fieldErrors }: Props) {
  21 +export default function LoginForm({
  22 + onSubmit,
  23 + loading,
  24 + errorMessage,
  25 + fieldErrors,
  26 + submitDisabled = false,
  27 +}: Props) {
20 28 const [form] = Form.useForm<LoginReq>();
21 29  
22 30 useEffect(() => {
... ... @@ -53,6 +61,7 @@ export default function LoginForm({ onSubmit, loading, errorMessage, fieldErrors
53 61 )}
54 62  
55 63 <Form.Item
  64 + label="用户名"
56 65 name="username"
57 66 rules={[{ required: true, message: '请输入用户名' }]}
58 67 >
... ... @@ -64,6 +73,7 @@ export default function LoginForm({ onSubmit, loading, errorMessage, fieldErrors
64 73 </Form.Item>
65 74  
66 75 <Form.Item
  76 + label="密码"
67 77 name="password"
68 78 rules={[{ required: true, message: '请输入密码' }]}
69 79 >
... ... @@ -75,10 +85,15 @@ export default function LoginForm({ onSubmit, loading, errorMessage, fieldErrors
75 85 </Form.Item>
76 86  
77 87 <Form.Item
  88 + label="公司"
78 89 name="companyCode"
79 90 rules={[{ required: true, message: '请选择公司' }]}
80 91 >
81   - <Select options={COMPANY_OPTIONS} disabled={loading} data-testid="company-select" />
  92 + <Select
  93 + options={COMPANY_OPTIONS}
  94 + disabled={loading}
  95 + data-testid="company-select"
  96 + />
82 97 </Form.Item>
83 98  
84 99 <Form.Item>
... ... @@ -87,6 +102,7 @@ export default function LoginForm({ onSubmit, loading, errorMessage, fieldErrors
87 102 htmlType="submit"
88 103 block
89 104 loading={loading}
  105 + disabled={submitDisabled}
90 106 data-testid="login-submit"
91 107 >
92 108 {loading ? '登录中...' : '登 录'}
... ...
frontend/src/pages/login/LoginPage.test.tsx
... ... @@ -31,18 +31,13 @@ function renderLogin() {
31 31 };
32 32 }
33 33  
34   -async function fillAndSubmit(username: string, password: string, companyCode: string = 'HQ') {
  34 +async function fillAndSubmit(username: string, password: string) {
35 35 const user = userEvent.setup();
36   - const inputs = screen.getAllByRole('textbox'); // username + password 在 antd Input.Password 渲染下不是 textbox
37   - // 直接通过 placeholder 找
38 36 await user.clear(screen.getByPlaceholderText('请输入你的用户名'));
39 37 await user.type(screen.getByPlaceholderText('请输入你的用户名'), username);
40 38 await user.clear(screen.getByPlaceholderText('请输入你的密码'));
41 39 await user.type(screen.getByPlaceholderText('请输入你的密码'), password);
42   - // companyCode 默认已选 HQ,若需改动通过 AntD Select 较复杂,本测试用默认值
43   - if (companyCode !== 'HQ') {
44   - // 跳过非默认场景的 UI 选择(依赖原生 Select 行为太复杂)
45   - }
  40 + // companyCode 默认已选 HQ;改其他公司需要复杂的 AntD Select 交互,单独的测试用 MSW 路径模拟
46 41 await user.click(screen.getByTestId('login-submit'));
47 42 }
48 43  
... ... @@ -89,4 +84,28 @@ describe(&#39;LoginPage&#39;, () =&gt; {
89 84 expect(screen.getByText('账号已被作废,禁止登录')).toBeInTheDocument(),
90 85 );
91 86 });
  87 +
  88 + it('empty fields: form-level required errors', async () => {
  89 + renderLogin();
  90 + const user = userEvent.setup();
  91 + await user.click(screen.getByTestId('login-submit'));
  92 + await waitFor(() => expect(screen.getByText('请输入用户名')).toBeInTheDocument());
  93 + expect(screen.getByText('请输入密码')).toBeInTheDocument();
  94 + });
  95 +
  96 + it('locked account: submit stays disabled while lockUntil in the future', async () => {
  97 + renderLogin();
  98 + await fillAndSubmit('locked', 'X');
  99 + await waitFor(() => expect(screen.getByTestId('login-error-alert')).toBeInTheDocument());
  100 + // 锁定后 submit 应处于 disabled 态(lockUntil = 2030-01-01 远在未来)
  101 + const submitBtn = screen.getByTestId('login-submit') as HTMLButtonElement;
  102 + expect(submitBtn).toBeDisabled();
  103 + });
  104 +
  105 + it('form fields are labeled (a11y)', () => {
  106 + renderLogin();
  107 + expect(screen.getByLabelText('用户名')).toBeInTheDocument();
  108 + expect(screen.getByLabelText('密码')).toBeInTheDocument();
  109 + expect(screen.getByLabelText('公司')).toBeInTheDocument();
  110 + });
92 111 });
... ...
frontend/src/pages/login/LoginPage.tsx
1   -import { useState } from 'react';
  1 +import { useState, useEffect } from 'react';
2 2 import { useNavigate } from 'react-router-dom';
3 3 import dayjs from 'dayjs';
4 4 import { authApi } from '../../api/auth';
... ... @@ -18,8 +18,24 @@ export default function LoginPage() {
18 18 const [loading, setLoading] = useState(false);
19 19 const [errorMessage, setErrorMessage] = useState<string | null>(null);
20 20 const [fieldErrors, setFieldErrors] = useState<LoginFormFieldErrors>({});
  21 + const [lockUntil, setLockUntil] = useState<dayjs.Dayjs | null>(null);
  22 +
  23 + // 锁定倒计时:每秒检查 lockUntil 是否过期,过期后自动允许重试
  24 + useEffect(() => {
  25 + if (!lockUntil) return;
  26 + const timer = setInterval(() => {
  27 + if (dayjs().isAfter(lockUntil)) {
  28 + setLockUntil(null);
  29 + setErrorMessage(null);
  30 + }
  31 + }, 1000);
  32 + return () => clearInterval(timer);
  33 + }, [lockUntil]);
  34 +
  35 + const isLocked = lockUntil != null && dayjs().isBefore(lockUntil);
21 36  
22 37 const handleSubmit = async (req: LoginReq) => {
  38 + if (isLocked) return;
23 39 setLoading(true);
24 40 setErrorMessage(null);
25 41 setFieldErrors({});
... ... @@ -42,8 +58,10 @@ export default function LoginPage() {
42 58 const handleBizError = (e: BizError) => {
43 59 if (e.code === 42301) {
44 60 const data = e.data as { lockUntil?: string } | undefined;
45   - const lockTime = data?.lockUntil ? dayjs(data.lockUntil).format('HH:mm') : '稍后';
  61 + const lockMoment = data?.lockUntil ? dayjs(data.lockUntil) : null;
  62 + const lockTime = lockMoment ? lockMoment.format('HH:mm') : '稍后';
46 63 setErrorMessage((ERROR_MESSAGES[42301] as string).replace('{lockUntil}', lockTime));
  64 + if (lockMoment) setLockUntil(lockMoment);
47 65 } else if (e.code === 40004) {
48 66 setFieldErrors({ companyCode: ERROR_MESSAGES[40004] as string });
49 67 } else if (e.code === 40103) {
... ... @@ -75,7 +93,7 @@ export default function LoginPage() {
75 93 style={{
76 94 width: 360,
77 95 padding: 24,
78   - background: 'var(--color-form-bg-edit)',
  96 + background: 'var(--color-bg-container)',
79 97 borderRadius: 8,
80 98 }}
81 99 >
... ... @@ -85,6 +103,7 @@ export default function LoginPage() {
85 103 loading={loading}
86 104 errorMessage={errorMessage}
87 105 fieldErrors={fieldErrors}
  106 + submitDisabled={isLocked}
88 107 />
89 108 </div>
90 109 </div>
... ...
frontend/src/styles/global.css
... ... @@ -3,7 +3,7 @@ html, body, #root {
3 3 padding: 0;
4 4 height: 100%;
5 5 font-family: -apple-system, BlinkMacSystemFont, 'Microsoft YaHei', 'PingFang SC', 'Segoe UI', Roboto, sans-serif;
6   - background: var(--color-bg-base);
  6 + background: var(--color-bg-page);
7 7 color: var(--color-text);
8 8 }
9 9  
... ...
frontend/src/styles/tokens.css
1 1 /*
2   - * src/styles/tokens.css — Design Tokens
3   - * 命名规范见 docs/04-技术规范.md § 2.5
4   - * 色值锁定见 docs/06-UI交互规范.md § 四
5   - *
6   - * 命名格式:--color-<scope>-<role>-<state>
7   - * <scope> 组件域:form / table-row / table-header / ...
8   - * <role> 作用:bg(背景)/ fg(前景/字体)/ border
9   - * <state> 状态:edit / readonly / hover / selected(无状态时省略)
  2 + * frontend/src/styles/tokens.css — Design Tokens
  3 + * SSoT: docs/06-UI交互规范.md § 二
10 4 *
  5 + * 命名规则见 docs/04-技术规范.md § 2.5
11 6 * 约束:
12 7 * - 组件样式中只用 var(--color-xxx),禁止硬编码 hex / rgba
13 8 * - 修改色值只改本文件,不允许在组件级覆盖
14   - * - 新增 token 须先登记到 docs/06 § 4.1 / 4.2,再补到此处
  9 + * - 新增 token 须先登记到 docs/06 § 2.1 / 2.2,再补到此处
  10 + * - AntD ConfigProvider.theme.token.colorPrimary 必须与 --color-primary 同源(见 App.tsx)
15 11 */
16 12  
17 13 :root {
18   - /* === 1. 全局调色板(与 Ant Design 主题对齐) === */
19   - --color-primary: #1890ff;
  14 + /* === § 2.1 全局调色板(与 docs/06 § 2.1 完全对齐) === */
  15 + --color-primary: #1677ff;
  16 + --color-primary-hover: #4096ff;
  17 + --color-primary-active: #0958d9;
20 18 --color-success: #52c41a;
21 19 --color-warning: #faad14;
22 20 --color-error: #ff4d4f;
23   - --color-text: rgba(0, 0, 0, 0.85);
24   - --color-text-secondary: rgba(0, 0, 0, 0.45);
25   - --color-border: #d9d9d9;
26   - --color-bg-base: #f0f2f5;
  21 + --color-info: #1677ff;
27 22  
28   - /* === 2. 组件级状态色(与 docs/06 § 4.2 一一对应) === */
  23 + --color-text: rgba(0, 0, 0, 0.88);
  24 + --color-text-secondary: rgba(0, 0, 0, 0.65);
  25 + --color-text-disabled: rgba(0, 0, 0, 0.25);
29 26  
30   - /* form:输入框 / 备注框 / 时间框 / 下拉框共用 */
31   - --color-form-bg-edit: #ffffff;
32   - --color-form-bg-readonly: #f1f2f8;
33   - --color-form-bg-hover: #f5f5f5; /* 仅下拉框使用 */
34   - --color-form-fg: #000000;
  27 + --color-border: #d9d9d9;
  28 + --color-split: #f0f0f0;
35 29  
36   - /* table */
37   - --color-table-row-bg-selected: #86d5fb;
38   - --color-table-row-bg-hover: #fff7e6;
39   - --color-table-row-bg-readonly: #f1f2f8; /* = rgb(241, 242, 248) */
40   - --color-table-row-fg: #000000;
41   - --color-table-header-bg: #f5f5f5;
42   - --color-table-header-fg: rgba(0, 0, 0, 0.85); /* = #000000D9 */
  30 + --color-bg-page: #f5f5f5;
  31 + --color-bg-container: #ffffff;
  32 + --color-bg-disabled: #f5f5f5;
43 33 }
... ...