Compare commits

..
37 Commits
Author SHA1 Message Date
baorong ccaf67076e bump version: 6.0.0 2026-03-14 14:20:35 +08:00
baorong 8f7dd82e40 refactor: umi v4 support 2026-03-13 23:07:16 +08:00
baorong 9989aa4de5 bump version: 5.5.0 2026-02-19 22:06:42 +08:00
baorong f983533d59 chore dep: use puppeteer-core because npm install easy to fail 2026-02-19 22:03:32 +08:00
baorong 2182759d47 chore dep: little mistake 2026-02-19 21:43:23 +08:00
baorong 4d1851ddd2 chore deps: upgrade axios to 1.x 2026-02-19 21:30:25 +08:00
baorong 0d82eca735 chore lint: code sth. 2026-02-19 21:28:07 +08:00
baorong cfb6b271ee chore code: clear some warnings and remove MapChart & AirportCoord 2026-02-19 21:19:40 +08:00
baorong 0b97964457 fix i18n: lingui not work 2026-02-18 19:28:50 +08:00
baorong edfbfcf5db chore(code): adapt code to antd v6 2026-02-18 19:28:00 +08:00
baorong e5172432df chore dep: use highcharts-react-official 2026-02-18 19:04:53 +08:00
baorong 741b04f120 chore deps: upgrade lingui to v5 2026-02-18 15:53:34 +08:00
baorong 83f2cc1344 chore dep: upgrade antd v6 2026-02-13 17:56:40 +08:00
baorong 152556d582 chore dep: upgrade to lingui v4 2026-02-13 17:39:53 +08:00
Baorong Li 67fc31a008 Merge pull request #1165 from baocang/codex/find-and-fix-two-bugs
fix: correct typos in build config and demo
2025-05-29 22:23:18 +08:00
Baocang Nie 23eace8350 fix: correct typos in build config and demo 2025-05-28 11:13:32 +08:00
Baorong 93817e4840 fix: dep mis with pnpm 2024-04-13 12:50:58 +08:00
Baorong bb97d982e4 fix: npm run start not work #1152 2024-04-13 12:49:16 +08:00
Baorong Li 700f58015d Merge pull request #1156 from XyanZhang/master
fix: clicking on the sidebar collapse button results in a blank screen.
2023-06-14 15:17:56 +08:00
XyanZhang 872ce3a825 fix: can't scroll when the media is mobile 2023-06-14 14:47:06 +08:00
XyanZhang 385b31e7bb fix: clicking on the sidebar collapse button results in a blank screen. 2023-06-14 14:16:33 +08:00
Baorong Li 3d66a616ff chore readme: change documentation url 2023-02-21 10:36:16 +08:00
superlbr b7e18a1214 fix locale: change locale filepath due to antd5 #1146 2023-01-22 20:44:28 +08:00
Baorong Li 3b0bae9c70 chore umirc: set antd to false since v5 2022-12-22 10:14:27 +08:00
Baorong Li 8b9343a320 Merge pull request #1142 from vagusX/feat/upgrade-antd-v5
feat: upgrade antd v5
2022-11-27 17:32:40 +08:00
vagusx 8618c75459 feat: replace moment to dayjs 2022-11-27 16:29:42 +08:00
vagusx 711d2077e2 feat: import BackTop from FloatButton 2022-11-27 16:17:07 +08:00
vagusx b25646b033 feat: rename modal open 2022-11-27 15:54:25 +08:00
vagusx 02bf7784b1 feat: upgrade antd v5 2022-11-26 22:15:15 +08:00
Baorong Li c164d60643 Merge pull request #1132 from SuperRay3/master
fix: 修复 antd 组件无法国际化的问题
2022-05-23 15:59:15 +08:00
leijialiang 1bd4cfe73c fix: 修复 antd 组件无法国际化的问题 2022-05-23 14:43:09 +08:00
superlbr f4e1eeb21c fix login: form mis password 2021-12-24 15:19:15 +08:00
superlbr 4b5fe62014 fix i18n: t not work use Trans instead 2021-12-23 20:09:35 +08:00
superlbr 36c2be61ae chore readme: add account/password desc. 2021-11-16 16:08:26 +08:00
superlbr e9206a9448 fix dev: loading chunk mf-dep_async failed 2021-08-03 18:31:03 +08:00
superlbr 0bf28879c4 chore umi: enable mfsu 2021-08-03 17:47:27 +08:00
superlbr 7c936712b9 fix dev: #1108 #1109 2021-07-15 08:15:51 +08:00
166 changed files with 6165 additions and 12186 deletions
-16
View File
@@ -1,16 +0,0 @@
# http://editorconfig.org
root = true
[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true
[*.md]
trim_trailing_whitespace = false
[Makefile]
indent_style = tab
-3
View File
@@ -1,3 +0,0 @@
BROWSER=none
HOST=0.0.0.0
PORT=7000
+10 -1
View File
@@ -1 +1,10 @@
docs/**/*.js
node_modules
dist
.umi
build
public
coverage
*.config.js
# ignore umi generated files under src
src/.umi
-9
View File
@@ -1,9 +0,0 @@
{
"extends": "react-app",
"rules": {
"import/no-anonymous-default-export": 0,
"jsx-a11y/href-no-hash": 0,
"no-console": "warn",
"valid-jsdoc": "warn"
}
}
+61
View File
@@ -0,0 +1,61 @@
module.exports = {
root: true,
parser: '@typescript-eslint/parser',
parserOptions: {
ecmaVersion: 2020,
sourceType: 'module',
ecmaFeatures: { jsx: true },
},
plugins: [
'@typescript-eslint',
'react',
'react-hooks',
'unused-imports',
'prettier',
'import',
'jsx-a11y',
],
extends: [
'eslint:recommended',
'plugin:@typescript-eslint/recommended',
'plugin:react/recommended',
'plugin:react-hooks/recommended',
'plugin:prettier/recommended',
],
settings: {
react: { version: 'detect' },
'import/resolver': {
typescript: {},
},
},
env: {
browser: true,
node: true,
es6: true,
},
rules: {
'prettier/prettier': 'error',
'react/react-in-jsx-scope': 'off',
'@typescript-eslint/no-unused-vars': [
'warn',
{ argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
],
'@typescript-eslint/no-explicit-any': 'off',
'unused-imports/no-unused-imports': 'warn',
'no-console': [
'warn',
{
allow: ['warn', 'error', 'info'],
},
],
'import/order': 'off',
},
overrides: [
{
files: ['*.ts', '*.tsx'],
rules: {
'@typescript-eslint/explicit-module-boundary-types': 'off',
},
},
],
};
-8
View File
@@ -1,8 +0,0 @@
> 请酌情提供细节,并保持issue精简便于查阅
> 1. 功能需求 => 详细说明
> 2. Bug反馈
> 2.1 简单描述下报错
> 2.2 你期望什么结果
> 2.3 如何操作导致的
> 2.4 可提供运行环境信息
> 3. 代码求助 => 可以提,未必及时答复
+76
View File
@@ -0,0 +1,76 @@
++ name: CI
on:
push:
branches: [master]
pull_request:
branches: [master]
jobs:
build:
runs-on: ubuntu-latest
strategy:
matrix:
node-version: [18, 20]
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: ${{ matrix.node-version }}
cache: 'pnpm'
- name: Enable corepack (pnpm)
run: |
corepack enable
corepack prepare pnpm@latest --activate
- name: Cache pnpm store
uses: actions/cache@v4
with:
path: |
~/.pnpm-store
~/.cache/pnpm
key: ${{ runner.os }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}
restore-keys: |
${{ runner.os }}-pnpm-
- name: Install dependencies
run: pnpm install
- name: Test (if present)
run: pnpm test --if-present
- name: Lint
run: pnpm run lint
- name: Build
run: pnpm run build
- name: Upload build (artifact)
if: success()
uses: actions/upload-artifact@v4
with:
name: dist
path: ./dist
publish:
name: Publish to GitHub Pages
runs-on: ubuntu-latest
needs: build
if: github.event_name == 'push' && github.ref == 'refs/heads/master'
steps:
- name: Download artifact
uses: actions/download-artifact@v4
with:
name: dist
- name: Deploy to GitHub Pages
uses: peaceiris/actions-gh-pages@v3
with:
publish_dir: ./dist
publish_branch: gh-pages
github_token: ${{ secrets.GITHUB_TOKEN }}
+13 -25
View File
@@ -1,26 +1,14 @@
coverage
dist
node_modules
npm-debug.log
yarn-error.log
yarn.lock
package-lock.json
/node_modules
/.env.local
/.umirc.local.ts
/config/config.local.ts
/src/.umi
/src/.umi-production
/src/.umi-test
/dist
.swc
.turbopack
pnpm-lock.yaml
# ide
.idea
# Mac General
.DS_Store
.AppleDouble
.LSOverride
# umi
.umi
.umi-production
# jslingui
src/locales/_build
src/locales/**/*.js
.vscode
yarn.lock
npm-lock.json
+2
View File
@@ -0,0 +1,2 @@
registry=https://registry.npmjs.com/
+7 -4
View File
@@ -1,6 +1,9 @@
*.svg
*.ejs
.DS_Store
node_modules
dist
.umi
build
coverage
public
node_modules
.umi
.umi-production
src/locales/**/*.json
+5 -2
View File
@@ -1,5 +1,8 @@
{
"semi": false,
"printWidth": 80,
"singleQuote": true,
"trailingComma": "es5"
"trailingComma": "all",
"proseWrap": "never",
"overrides": [{ "files": ".prettierrc", "options": { "parser": "json" } }],
"plugins": ["prettier-plugin-organize-imports", "prettier-plugin-packagejson"]
}
-9
View File
@@ -1,9 +0,0 @@
{
"extends": ["stylelint-config-standard", "stylelint-config-prettier"],
"rules": {
"declaration-empty-line-before": null,
"no-descending-specificity": null,
"selector-pseudo-class-no-unknown": null,
"selector-pseudo-element-colon-notation": null
}
}
-18
View File
@@ -1,18 +0,0 @@
language: node_js
node_js:
- node
script:
- npm run build
before_install:
- yarn global add now
after_script:
- |
if [[ $TRAVIS_BRANCH == 'master' ]]; then
echo $PROD_SITE_NOW_CONFIG >> dist/vercel.json && echo $PROD_DOC_NOW_CONFIG >> docs/vercel.json;
else
echo $DEV_SITE_NOW_CONFIG >> dist/vercel.json && echo $DEV_DOC_NOW_CONFIG >> docs/vercel.json;
fi
- cd ./dist
- now -A vercel.json -t $NOW_TOKEN --prod -c
- cd ../docs
- now -A vercel.json -t $NOW_TOKEN --prod -c
+15
View File
@@ -0,0 +1,15 @@
import { defineConfig } from 'umi';
export default defineConfig({
plugins: ['@umijs/plugins/dist/antd', '@umijs/plugins/dist/locale'],
esbuildMinifyIIFE: true,
locale: {
antd: true,
default: 'zh-CN',
baseNavigator: true,
useLocalStorage: true,
baseSeparator: '-',
title: true,
},
npmClient: 'pnpm',
});
+74 -52
View File
@@ -1,87 +1,109 @@
<p align="center">
<a href="http://github.com/zuiidea/antd-admin">
<img alt="antd-admin" height="64" src="./docs/_media/logo.svg">
</a>
<a href="http://github.com/zuiidea/antd-admin" target="_blank">
<img alt="antd-admin-logo" height="80" src="./public/logo.svg">
</a>
</p>
<h1 align="center">AntD Admin</h1>
<div align="center">
一套优秀的中后台前端解决方案
[![antd](https://img.shields.io/badge/antd-^3.10.0-blue.svg?style=flat-square)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/umi-^2.2.1-orange.svg?style=flat-square)](https://github.com/umijs/umi)
[![GitHub issues](https://img.shields.io/github/issues/zuiidea/antd-admin.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/issues)
[![MIT](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](http://opensource.org/licenses/MIT)
![Travis (.org)](https://img.shields.io/travis/zuiidea/antd-admin.svg)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
[![Gitter](https://img.shields.io/gitter/room/antd-admin/antd-admin.svg)](https://gitter.im/antd-admin/antd-admin)
基于 Ant Design 6、Umi 4 与 TypeScript 构建的企业级前端解决方案。
</div>
- 在线演示 - [https://antd-admin.zuiidea.com](https://antd-admin.zuiidea.com)
- 使用文档 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/](https://doc.antd-admin.zuiidea.com/#/zh-cn/)
- 常见问题 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/faq](https://doc.antd-admin.zuiidea.com/#/zh-cn/faq)
- 更新日志 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/change-log](https://doc.antd-admin.zuiidea.com/#/zh-cn/change-log)
---
[English](./README.md) | 简体中文
## 📖 项目简介
## 特性
**AntD Admin** 是一个轻量、高性能的管理后台模板,旨在为构建企业级应用提供干净、可扩展的起点。项目使用 **Ant Design 6**、**Umi 4** 与 **TypeScript** 的最新特性,减轻样板代码,提升开发体验。
- 国际化,源码中抽离翻译字段,按需加载语言包
- 动态权限,不同权限对应不同菜单
- 优雅美观,Ant Design 设计体系
- Mock 数据,本地数据调试
无论您要构建仪表盘、管理系统,还是集成 AI 功能的工具,本项目都能提供必要的基础。
## ✨ 主要特性
## 使用
- 🚀 **现代栈**:基于 **Ant Design 6** + **Umi 4** + **TypeScript**。
- 🎨 **清晰架构**:使用 `zustand` 进行轻量状态管理。
- 🛠 **良好的开发体验**:内置本地 mock 服务器(`mock/index.js`),无需后端即可开发前端功能。
- 📦 **丰富示例页面**:包含可直接使用的页面示例:
- 📊 **仪表盘**:数据可视化概览。
- 👥 **用户管理**:CRUD 操作示例。
- 🧩 **菜单管理**:动态路由配置示例。
- 🤖 **AI 聊天示例**:大模型(LLM)接口集成示例。
- ✅ **CI/CD 支持**:预配置的 GitHub Actions 工作流,用于 lint 和构建。
1. 下载项目代码。
## 🚀 快速开始
建议使用 **pnpm** 进行包管理。
```bash
git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
# 1. 克隆仓库
git clone https://github.com/zuiidea/antd-admin.git -b master --depth=1
cd antd-admin
# 2. 安装依赖
pnpm install
# 3. 启动本地开发(含 mock 数据)
npm run dev
# 4. 构建生产包
npm run build
# 5. 代码质量检查
npm run lint
npm run format
```
2. 进入目录安装依赖,国内用户推荐使用 [cnpm](https://cnpmjs.org) 进行加速。
🔌 开发说明
```bash
yarn install
```
#### Mock 服务
或者
项目包含位于 `mock/index.js` 的内置 mock 服务,方便在没有后端的情况下独立开发前端功能。
```bash
npm install
```
如需关闭 mock 或切换到真实 API,请修改项目的代理配置(例如 Umi 项目可能的配置文件 `config/proxy.ts`、`.umirc.ts` 或 `config/config.ts`),以匹配您的实际项目结构。
3. 启动本地服务器。
#### 常用路由
```bash
npm run start
```
| 路由 | 说明 |
| --- | --- |
| `/` 或 `/dashboard` | 主仪表盘 |
| `/users` | 用户列表与管理 |
| `/sys/menu` | 系统菜单配置 |
| `/ai/chat` | AI 聊天示例界面 |
4. 启动完成后打开浏览器访问 [http://localhost:7000](http://localhost:7000),如果需要更改启动端口,可在 `.env` 文件中配置。
#### 定制化
- **API 集成:** 在 `src/services` 中更新 API 接口以对接真实后端。
- **组件扩展:** 在 `src/components` 中复用或扩展现有组件(例如 `DropOption`、`StandardTable`)。
- **主题:** 在主题配置中自定义 Ant Design 变量以匹配品牌视觉。
> 更多信息请参考 [使用文档](https://doc.antd-admin.zuiidea.com/#/zh-cn/)。
#### GitHub Actions(CI)
仓库包含预配置的 GitHub Actions 工作流(见 `.github/workflows/ci.yml`),用于保证代码质量:
## 支持环境
- 使用 `pnpm` 安装依赖。
- 运行 lint 检查。
- 构建生产包。
现代浏览器。
- **工作流位置:** `.github/workflows/ci.yml`
- **提示:** 若要在 CI 中加入自动化测试,请在 `package.json` 中添加测试脚本并更新 workflow YAML。
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera |
| --------- | --------- | --------- | --------- | --------- |
|IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions
## 🤝 贡献
## 参与贡献
欢迎各类贡献:修复 bug、添加新示例页面或组件、完善类型定义与 lint 规则、改进国际化等。
我们非常欢迎你的贡献,你可以通过以下方式和我们一起共建 :smiley:
- 在你的公司或个人项目中使用 AntD Admin。
- 通过 [Issue](http://github.com/zuiidea/antd-admin/issues) 报告 bug 或进行咨询。
- 提交 [Pull Request](http://github.com/zuiidea/antd-admin/pulls) 改进代码。
常见贡献流程:
1. Fork 仓库。
2. 新建分支:`git checkout -b feature/AmazingFeature`。
3. 提交变更:`git commit -m 'Add some AmazingFeature'`。
4. 推送分支:`git push origin feature/AmazingFeature`。
5. 提交 Pull Request。
## 📄 许可证
本项目采用 MIT 许可证。
由 zuiidea 与贡献者共同维护,Made with ❤️。
> 强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393),更好的问题更容易获得帮助。
+81 -53
View File
@@ -1,7 +1,6 @@
<p align="center">
<a href="http://github.com/zuiidea/antd-admin">
<img alt="antd-admin" height="64" src="./docs/_media/logo.svg">
<a href="http://github.com/zuiidea/antd-admin" target="_blank">
<img alt="antd-admin-logo" height="80" src="./public/logo.svg">
</a>
</p>
@@ -9,78 +8,107 @@
<div align="center">
An excellent front-end solution for enterprise applications.
An excellent enterprise-grade front-end solution built with Ant Design 6, Umi 4, and TypeScript.
[![antd](https://img.shields.io/badge/antd-^4.0.0-blue.svg?style=flat-square)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/umi-^2.2.1-orange.svg?style=flat-square)](https://github.com/umijs/umi)
[![GitHub issues](https://img.shields.io/github/issues/zuiidea/antd-admin.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/issues)
[![MIT](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](http://opensource.org/licenses/MIT)
![Travis (.org)](https://img.shields.io/travis/zuiidea/antd-admin.svg)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
[![Gitter](https://img.shields.io/gitter/room/antd-admin/antd-admin.svg)](https://gitter.im/antd-admin/antd-admin)
[![antd](https://img.shields.io/badge/AntD-^6.0.0-1890ff?style=flat-square&logo=ant-design)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/Umi-^4.0.0-ff9900?style=flat-square&logo=umijs)](https://github.com/umijs/umi)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178c6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
[![GitHub issues](https://img.shields.io/github/issues/zuiidea/antd-admin?style=flat-square)](https://github.com/zuiidea/antd-admin/issues)
[![GitHub stars](https://img.shields.io/github/stars/zuiidea/antd-admin?style=flat-square)](https://github.com/zuiidea/antd-admin/stargazers)
[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](http://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
</div>
- Preview - [https://antd-admin.zuiidea.com](https://antd-admin.zuiidea.com)
- Documentation - [https://doc.antd-admin.zuiidea.com](https://doc.antd-admin.zuiidea.com)
- FAQ - [https://doc.antd-admin.zuiidea.com/#/faq](https://doc.antd-admin.zuiidea.com/#/faq)
- ChangeLog - [https://doc.antd-admin.zuiidea.com/#/change-log](https://doc.antd-admin.zuiidea.com/#/change-log)
---
English | [简体中文](./README-zh_CN.md)
## 📖 Introduction
## Features
**AntD Admin** is a lightweight, high-performance admin template designed to provide a clean and extensible starting point for building enterprise applications. It leverages the latest features of **Ant Design 6**, **Umi 4**, and **TypeScript**, offering a modern development experience with minimal boilerplate.
- Internationalization, extracting translation fields from source code, loading language packs on demand
- Dynamic permissions, different permissions for different menus
- Elegant and beautiful, Ant Design system
- Mock data, local data debugging
Whether you are building a dashboard, a management system, or an AI-powered tool, this project provides the essential foundation you need.
## ✨ Key Features
## Usage
- 🚀 **Modern Stack**: Built on **Ant Design 6** + **Umi 4** + **TypeScript**.
- 🎨 **Clean Architecture**: Lightweight state management using `zustand`.
- 🛠 **Dev Experience**: Integrated local mock server (`mock/index.js`) for seamless frontend development without backend dependency.
- 📦 **Rich Examples**: Includes ready-to-use pages:
- 📊 **Dashboard**: Data visualization overview.
- 👥 **User Management**: CRUD operations example.
- 🧩 **Menu Management**: Dynamic routing configuration.
- 🤖 **AI Chat Demo**: Integration example for LLM interfaces.
- ✅ **CI/CD Ready**: Pre-configured GitHub Actions for linting and building.
1. Clone project code.
## 🚀 Quick Start
We recommend using **pnpm** for package management.
```bash
git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
# 1. Clone the repository
git clone https://github.com/zuiidea/antd-admin.git -b master --depth=1
cd antd-admin
# 2. Install dependencies
pnpm install
# 3. Start local development server (with mock data)
npm run dev
# 4. Build for production
npm run build
# 5. Code quality checks
npm run lint
npm run format
```
2. Installation dependence.
🔌 **Development Notes**
```bash
yarn install
```
#### Mock Server
Or
The project includes a built-in mock server defined in `mock/index.js`. This allows you to develop frontend features independently of the backend.
```bash
npm install
```
To disable mocks or switch to a real API, modify the proxy settings in your configuration file (for example, `config/proxy.ts` or `.umirc.ts`).
3. Start local server.
#### Common Routes
```bash
npm run start
```
| Route | Description |
| --- | --- |
| `/` or `/dashboard` | Main Dashboard |
| `/users` | User List & Management |
| `/sys/menu` | System Menu Configuration |
| `/ai/chat` | AI Chat Interface Demo |
4. After the startup is complete, open a browser and visit [http://localhost:7000](http://localhost:7000), If you need to change the startup port, you can configure it in the `.env` file.
#### Customization
- **API Integration:** Update API endpoints in `src/services` to connect to your real backend.
- **Component Extension:** Reuse or extend existing components in `src/components` (for example, `DropOption`, `StandardTable`).
- **Theme:** Customize Ant Design tokens in the theme configuration to match your brand identity.
> More instructions at [documentation](https://doc.antd-admin.zuiidea.com)。
#### GitHub Actions CI
This repository includes a pre-configured GitHub Actions workflow to ensure code quality:
## Browsers support
- Installs dependencies using `pnpm`.
- Runs linting checks.
- Builds the project for production.
Modern browsers.
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera |
| --------- | --------- | --------- | --------- | --------- |
|IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions
## Contributing
We very much welcome your contribution, you can build together with us in the following ways :smiley:
- Use Ant Design Pro in your daily work.
- Submit [GitHub issues](http://github.com/zuiidea/antd-admin/issues)s to report bugs or ask questions.
- Propose [Pull Request](http://github.com/zuiidea/antd-admin/pulls) to improve our code.
- **Workflow location:** `.github/workflows/ci.yml`
- **Tip:** To add automated tests to the CI pipeline, add a test script to `package.json` and update the workflow YAML accordingly.
🤝 Contributing
Contributions are always welcome! Whether it's fixing a bug, adding a new feature, or improving documentation, please feel free to submit an Issue or a Pull Request.
Typical contributions include:
🐛 Bug fixes
🧩 New example pages or components
📝 Type definitions and linting improvements
🌍 Internationalization (i18n) updates
How to contribute:
Fork the repository.
Create your feature branch (git checkout -b feature/AmazingFeature).
Commit your changes (git commit -m 'Add some AmazingFeature').
Push to the branch (git push origin feature/AmazingFeature).
Open a Pull Request.
📄 License
This project is licensed under the MIT License.
Made with ❤️ by zuiidea and contributors.
-35
View File
@@ -1,35 +0,0 @@
### 开发环境
- OS:Windows
- 编辑器:Atom
- cmd:Cmder
### Atom 插件
- [atom-beautify](https://atom.io/packages/atom-beautify)
#### Less
- [x] Beautify On Save
#### Javascript
- [ ] Disable Beautifying Language
#### Markdown
- [x] Beautify On Save
- [x] Default Beautifier:Remark
#### HTML
- [x] Beautify On Save
- [linter](https://atom.io/packages/linter)
- [ ] Lint on Change
- [linter-eslint](https://atom.io/packages/linter-eslint)
- [x] Fix errors on save
### Cmder 主题
- [Panda-Theme-Cmder](https://github.com/HamidFaraji/Panda-Theme-Cmder)
-5
View File
@@ -1,5 +0,0 @@
const config = {
publicPath: 'https://cdn.antd-admin.zuiidea.com/',
}
export default config
-61
View File
@@ -1,61 +0,0 @@
/**
* see more, https://umijs.org/config
*/
import lessToJs from 'less-vars-to-js'
import fs from 'fs'
import routes from './routes'
import path from 'path'
import proxy from './proxy'
const theme = lessToJs(
fs.readFileSync(path.join(__dirname, '../src/themes/default.less'), 'utf8')
)
const config = {
hash: true,
ignoreMomentLocale: true,
targets: { ie: 11 },
theme,
proxy,
routes,
devtool: 'eval',
mock: {
exclude: ['utils/index'],
},
extraBabelPresets: ['@lingui/babel-preset-react'],
extraBabelPlugins: [
'macros',
[
'import',
{
libraryName: 'lodash',
libraryDirectory: '',
camel2DashComponentName: false,
},
'lodash',
],
[
'import',
{
libraryName: 'antd',
libraryDirectory: 'es',
style: 'css',
},
'antd',
],
[
'import',
{
libraryName: '@ant-design',
libraryDirectory: 'icons',
camel2DashComponentName: false,
},
'ant-design-icons',
],
],
chainWebpack: (memo) => {
memo.module.rule('po').test(/\.po$/).use('po').loader('@lingui/loader')
},
}
export default config
-7
View File
@@ -1,7 +0,0 @@
export default {
'/api/v1/weather': {
target: 'https://api.seniverse.com/',
changeOrigin: true,
pathRewrite: { '^/api/v1/weather': '/v3/weather' },
},
}
-13
View File
@@ -1,13 +0,0 @@
const routes = [
{
exact: false,
path: '/',
// component: '@/layouts/index', // comment due to double layout
routes: [
{ exact: true, path: '/login', component: '@/pages/login' },
{ exact: true, path: '/user', component: '@/pages/user' },
],
},
]
export default routes
+27 -77
View File
@@ -1,86 +1,36 @@
# API configuration
## Why
This project uses explicit per-feature service modules (TypeScript) under `src/services/` that call a shared HTTP helper `src/utils/request.ts` (exported as the default `api` function).
In the use of `redux` or `dva` projects, we often write functions like the following `service` layer to make the code structure clearer, but it is easy to see that we will write a lot of similar code in `antd -admin@5.0`, using the more concise configuration method to achieve the same function.
Why this pattern?
- Clear function boundaries per domain (users, admin, menu, dashboard).
- Type-safe signatures in TypeScript for inputs/outputs (`src/types`).
- Centralized request handling (query params, JSON body, auth header, unified response format) in `src/utils/request.ts`.
```javascript
export async function login(data) {
  return request({
    url: '/api/v1/user/login',
    method: 'post',
    data,
  })
Example service (from `src/services/user.ts`):
```ts
import type { PagedResponse, User } from '@/types/user';
import api from '../utils/request';
export async function listUsers(
params?: Record<string, string | number | boolean>,
): Promise<PagedResponse<User>> {
return api<PagedResponse<User>>('/users', { method: 'GET', params });
}
export async function createUser(values: Record<string, unknown>): Promise<User> {
return api('/user', { method: 'POST', body: values });
}
```
## Configuration and use
Usage:
- Import named functions from the service module: `import { listUsers } from '@/services/user'`.
- The helper `api(path, options)` returns the parsed `data` payload from responses that follow the `{ success, message, data }` convention.
In the `src/services/api.js` file, you will see the following configuration object, the object's key is used to call the function name, the object's value is the requested `url`, the default request method is `GET`, The format of the value of the other request mode object is `'method url'`.
Notes about `src/utils/request.ts`:
- Combines `config.apiPrefix` with the provided `path`.
- Supports `params` (query), `body` (JSON or FormData), and sets `Authorization` header from local storage when available.
- Throws errors and shows UI messages for non-success responses.
```javascript
export default {
  ...
  queryUser: '/user/:id',
  queryUserList: '/users',
  updateUser: 'Patch /user/:id',
  createUser: 'POST /user/:id',
  removeUser: 'DELETE /user/:id',
  removeUserList: 'POST /users/delete',
  ...
}
```
Used in other files
```javascript
import { queryUser } from 'api'
// in the general file
...
queryUser(option).then(data => console.log(data))
...
/ / Model file
...
yield call(queryUser, option)
...
```
## Method to realize
Refer to the `src/services/index.js` file to traverse the api configuration. Each property returns the corresponding encapsulated request function.
```javascript
import request from 'utils/request'
import { apiPrefix } from 'utils/config'
import api from './api'
const gen = params => {
  let url = apiPrefix + params
  let method = 'GET'
  const paramsArray = params.split(' ')
  if (paramsArray.length === 2) {
    method = paramsArray[0]
    url = apiPrefix + paramsArray[1]
  }
  return function(data) {
    return request({
      url,
      data,
      method,
    })
  }
}
const APIFunction = {}
for (const key in api) {
  APIFunction[key] = gen(api[key])
}
module.exports = APIFunction
```
If you are migrating older code that used an API mapping, prefer creating small service modules with clear function names and types as shown above.
+31 -57
View File
@@ -8,76 +8,50 @@
<div align="center">
An excellent front-end solution for enterprise applications.
An enterprise-grade front-end starter built with Ant Design 6, Umi 4 and TypeScript.
[![antd](https://img.shields.io/badge/antd-^3.10.0-blue.svg?style=flat-square)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/umi-^2.2.1-orange.svg?style=flat-square)](https://github.com/umijs/umi)
[![GitHub issues](https://img.shields.io/github/issues/zuiidea/antd-admin.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/issues)
[![MIT](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](http://opensource.org/licenses/MIT)
![Travis (.org)](https://img.shields.io/travis/zuiidea/antd-admin.svg)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
[![Gitter](https://img.shields.io/gitter/room/antd-admin/antd-admin.svg)](https://gitter.im/antd-admin/antd-admin)
[![antd](https://img.shields.io/badge/AntD-^6.0.0-1890ff?style=flat-square&logo=ant-design)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/Umi-^4.0.0-ff9900?style=flat-square&logo=umijs)](https://github.com/umijs/umi)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178c6?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
[![License](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](http://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
</div>
- Preview - [https://antd-admin.zuiidea.com](https://antd-admin.zuiidea.com)
- Documentation - [https://doc.antd-admin.zuiidea.com](https://doc.antd-admin.zuiidea.com)
- FAQ - [https://doc.antd-admin.zuiidea.com/#/faq](https://doc.antd-admin.zuiidea.com/#/faq)
- ChangeLog - [https://doc.antd-admin.zuiidea.com/#/change-log](https://doc.antd-admin.zuiidea.com/#/change-log)
- Documentation source for this project is under `docs/`.
## Features
## Quick start
- Internationalization, extracting translation fields from source code, loading language packs on demand
- Dynamic permissions, different permissions for different menus
- Elegant and beautiful, Ant Design system
- Mock data, local data debugging
## Usage
1. Clone project code.
This repository uses `pnpm` in examples and CI; `npm` or `yarn` also work but `pnpm` is recommended.
```bash
git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
# clone
git clone https://github.com/zuiidea/antd-admin.git
cd antd-admin
# install
pnpm install
# start dev server (includes local mock server)
npm run dev
# build
npm run build
# lint & format
npm run lint
npm run format
```
2. Installation dependence.
Notes:
```bash
yarn install
```
- Mock data live in `mock/index.js` and the project can run without a backend during development.
- CI workflow is available at `.github/workflows/ci.yml` (uses pnpm, lint, build).
- Update API endpoints under `src/services` to integrate a real backend.
Or
```bash
npm install
```
3. Start local server.
```bash
npm run start
```
4. After the startup is complete, open a browser and visit [http://localhost:7000](http://localhost:7000), If you need to change the startup port, you can configure it in the `.env` file.
> More instructions at [documentation](https://doc.antd-admin.zuiidea.com)。
## Browsers support
Modern browsers.
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera |
| --------- | --------- | --------- | --------- | --------- |
|IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions
For detailed documentation see the other pages in this `docs/` folder.
## Contributing
We very much welcome your contribution, you can build together with us in the following ways :smiley:
Contributions welcome — file issues or open a PR as usual on GitHub.
- Use Ant Design Pro in your daily work.
- Submit [GitHub issues](http://github.com/zuiidea/antd-admin/issues)s to report bugs or ask questions.
- Propose [Pull Request](http://github.com/zuiidea/antd-admin/pulls) to improve our code.
+19 -43
View File
@@ -1,50 +1,26 @@
## 5.0.0
## 6.0.0
#### Optimization
This project was modernized and migrated to a modern front-end stack. Key highlights of the current version:
- Try to use decorators to simplify code writing and improve code readability.
### Modern stack
- Upgraded to Ant Design 6, Umi 4 and TypeScript 5.
- React has been updated to the current major line used in the repo (see `package.json`).
- API configurization to simplify the way data is obtained.
### Architecture & DX
- Services are implemented as TypeScript modules under `src/services/` and use a centralized HTTP helper `src/utils/request.ts`.
- Lightweight local state management using `zustand` replacing older `dva` patterns.
- Local mock server using `mock/index.js` with `mockjs` for frontend development without backend dependency.
- The files in `utils` are split and each has its own role.
### Tooling & CI
- Dev workflows use `pnpm` by default; scripts are defined in `package.json` (e.g. `pnpm run dev`, `pnpm run build`).
- Tests use `jest` and related tooling; CI is implemented with GitHub Actions (`.github/workflows/ci.yml`) which installs via `pnpm`, lints and builds the project.
- Simplify the `utils/request` file without special handling.
### Quality and types
- TypeScript types are added/expanded under `src/types/` for safer APIs and components.
- Prettier / ESLint configuration added to enforce code style.
#### Specification
### Other
- Documentation is maintained under `docs/` (this site) and updated to reflect the new stack and commands.
- Removed old custom components that duplicate Ant Design functionality and simplified the codebase accordingly.
- Functions add comments, parameters, return values, etc., ambiguous code adds comments, canonical reference [Google JavaScript Style Guide](https://google.github.io/styleguide/jsguide.html#appendices-jsdoc-tag-reference).
  
- Semantic version number, specification participation [semantic version 2.0.0](https://semver.org/lang/zh-CN/).
- Static code checking, unified code style, will use `prettier`, `stylelint`, `eslint` specification code before code submission.
- Git submits information normalization, [git-commit-emoji-cn](https://github.com/liuchengxu/git-commit-emoji-cn).
- Based on the pre-defined routing of `Umi`, there is no need to write a routing configuration file.
- Use `React 16` new features such as `Fragment`, `Context`, `PureComponent`, etc.
#### Features
- Support internationalization, extract source fields from source code, load language packs on demand, and automatically translate online.
- Support for the introduction `lodash` functions on demand.
  
- Support multiple layouts, which rules can be used according to the rules.
- Support Antd Admin to automatically compile and deploy on Travis.
- Generate a documentation website using `Docsify`.
#### Style
- Added Antd Admin standalone Logo.
- Rewrite the overall layout component, optimize the menu, automatic breadcrumb navigation, menu auto-expansion and other logic.
- The mobile menu is changed to drawer.
#### Other
- Discard components such as `IconFont`, `Search`, `DataTable` because they are well supported and replaceable in `Antd`.
If you want a more detailed, commit-level changelog for each migration step, I can generate one from git history or help draft a migration guide.
+1 -70
View File
@@ -30,73 +30,4 @@ You can do some custom configuration in `/src/utils/config.js`:
- Type: `String`
Under the `Primary` layout, whether the top of the page is fixed when scrolling。
## layouts
- Type: `Array`
Configuration? Which routes use which layout, unspecified route uses the default layout `Public`, the project currently has `Primary` and `Public` layouts,
     The default configuration is as follows:
```javascript
layouts: [
{
name: 'primary',
include: [/.*/],
exclude: [/(\/(en|zh))*\/login/],
},
],
```
The object properties for each layout are as follows:
- `name` - The name of the layout;
- `include` - Specifies a list of routing rules that use this layout, which can be a regular expression or a string;
- `exclude` - Specifies a list of routing rules that do not use this layout, which can be a regular expression or a string.
> Note: `exclude` takes precedence over `include`, and the layout previous it has a higher priority than the behind layout. The development process may need to be combined with the layout in the `src/layouts` directory. For details, see [Using Layout](./layout.md).
## i18n
- Type: `Object`
Configure internationalization, the default configuration is as follows:
```javascript
i18n: {
languages: [
{
key: 'en',
title: 'English',
flag: '/america.svg',
},
{
key: 'zh',
title: '中文',
flag: '/china.svg',
},
],
defaultLanguage: 'en',
}
```
### i18n.languages
- Type: `Array`
Specify which languages the app supports, and the object properties for each language are as follows:
- `key` - The `key` of the language is applied to the page url to distinguish the language, and also corresponds to the language package folder name in the `src/locales` directory;
- `title` - The name of the language, at the bottom of the login page, at the top of the `Primary` layout, the language switch is displayed;
- `flag` - The path of the flag icon of the language, the language switching display at the top of the `Primary` layout.
### i18n.defaultLanguage
- Type: `String`
Configure the default language.
Under the `Primary` layout, whether the top of the page is fixed when scrolling。
+9 -7
View File
@@ -1,6 +1,6 @@
# Quick Start
> Before delving into Ant Design React, a good knowledge base of [React](http://facebook.github.io/react/) 、 [ES2015+](http://es6.ruanyifeng.com/) 、 [Antd Design](https://ant.design/docs/react/introduce-cn) . Learn about [UmiJS](https://umijs.org/) , [Dva](http://github.com/dvajs/dva) . And properly installed and configured [Node.js](https://nodejs.org/) v8 or above, [Git](https://git-scm.com/). It would be helpful if you have pre-existing knowledge on those.
> Before delving into Ant Design React, a good knowledge base of [React](http://facebook.github.io/react/) 、 [ES2015+](http://es6.ruanyifeng.com/) 、 [Antd Design](https://ant.design/docs/react/introduce-cn). Learn about [UmiJS](https://umijs.org/). Ensure you have [Node.js](https://nodejs.org/) (v18+ recommended) and [Git](https://git-scm.com/) installed.
## Installation
@@ -52,22 +52,24 @@ The project layout is as follows:
## Development
1. Install Dependencies.
1. Install dependencies (recommended: `pnpm`).
```bash
yarn install
pnpm install
```
Or
Or with other package managers:
```bash
npm install
# or
yarn install
```
2. Start local server.
2. Start local development server.
```bash
npm run start
npm run dev
```
3. After the startup is complete, open a browser and visit [http://localhost:7000](http://localhost:7000), If you need to change the startup port, you can configure it in the `.env` file.
3. After startup, open the app in a browser (see dev server output for the actual URL/port).
+103 -57
View File
@@ -1,75 +1,121 @@
# globalization
# Internationalization (i18n) Guide
## Add language
This project uses Umi's `plugin-locale` (based on `react-intl`) to manage localization. Translation resources live in `src/locales` (for example `en-US.json`, `zh-CN.json`). Below are instructions for: adding a language, adding a translation entry, switching languages, and disabling i18n. Examples use Japanese `ja-JP`.
Take Japanese as an example.
## 1. Add a new language (persistent)
![i18n](../_media/term_i18n.svg)
1. Create a new translation file under `src/locales/` with the language id as the file name, for example: `src/locales/ja-JP.json`.
1. Add a language pack local file, `ja` is the Japanese language code, and a list of languages ​​that support translation [有道智云](http://ai.youdao.com/docs/doc-trans-api.s#p05), the `src/locales/ja/messages.json` file will be generated after running the following command.
2. The file should contain a JSON object of translation keys and values (nesting allowed):
```bash 
npm run add-locale ja
```
```json
{
"welcome": "ようこそ",
"login": {
"username": "ユーザー名",
"password": "パスワード",
"submit": "ログイン"
}
}
```
2. Extract the fields in the code that need to be translated, ie `<Trans>?message</Trans>`, `` t`message `` in the `message` field, run the following command after `src/locales/ja /messages.json` will appear after the extracted field configuration.
3. If you want Ant Design components to use the same locale (dates, component text), add the AntD locale import and mapping in `src/app.tsx`'s `pick` function, e.g.:
```bash 
npm run extract
```
```ts
import jaJP from 'antd/locale/ja_JP';
// ...
if (l === 'ja-JP') return jaJP;
```
You will see the following information:
4. Add the language to the language selector (for example in `src/components/TopbarControls.tsx`):
```bash
Catalog statistics:
┌─────────────┬─────────────┬─────────┐
│ Language │ Total count │ Missing │
├─────────────┼─────────────┼─────────┤
│ en (source) │ 52 │ - │
│ ja │ 52 │ 52 │
│ zh │ 52 │ 0 │
└─────────────┴─────────────┴─────────┘
```
```ts
{ key: 'ja-JP', label: '日本語' }
```
3. At the same time, we have added the relevant configuration in `src/utils/config.js`.
5. Restart the dev server:
```javascript
{
...
i18n: {
languages: [
...
{
key:'ja',
title: '日本語',
flag: '/japanese.svg',
},
],
},
}
```
```bash
pnpm run dev
```
> Routing related effects, after the configuration `npm run start` takes effect after restart.
Umi collects files in `src/locales` into `localeInfo` at build/dev time so the new language becomes available. If you prefer not to restart, see the runtime registration option below.
4. Use the built-in commands for automatic translation. You will see the translated configuration in `src/locales/ja/messages.json`.
## 2. Add a translation entry
```bash
npm run trans:only
```
1. Add the same key to each language JSON (keep `en-US.json` and `zh-CN.json` up to date alongside the new language):
You will see the following information:
`src/locales/en-US.json`
```bash
start: en -> ja
...
youdao: en -> ja: Unpublished -> 未発表
youdao: en -> ja: Update -> 更新
youdao: en -> ja: Update User -> ユーザーの更新
youdao: en -> ja: Username -> 名
...
All translations have been completed.
```
```json
"my.feature.greeting": "Hello from feature"
```
> `npm run trans` will execute `npm run extract` and `npm run trans:only` in order.
`src/locales/zh-CN.json`
5. Finally, you can adjust the inaccurate fields in `src/locales/ja/messages.json`. Start the development mode `npm run start`, open [http://localhost:7000/ja/login](http://localhost:7000/ja/login) and you will see the Japanese version of the app.
```json
"my.feature.greeting": "来自功能的问候"
```
2. In a component use `useIntl()` and `formatMessage`:
```ts
import { useIntl } from 'umi';
const intl = useIntl();
const text = intl.formatMessage({ id: 'my.feature.greeting', defaultMessage: 'Hello' });
```
Use `useIntl()` (or `injectIntl`) so the component updates automatically when the locale changes.
## 3. Runtime switching and registering
- Switch locale (writes `umi_locale` to localStorage and either reloads or triggers an update):
```ts
import { setLocale } from 'umi';
// switch and reload
setLocale('ja-JP', true);
// switch without reload (emit update event)
setLocale('zh-CN', false);
```
- Register a locale at runtime (no server restart required):
```ts
import { addLocale, setLocale } from 'umi';
import jaMessages from '@/locales/ja-JP.json';
import jaAntd from 'antd/locale/ja_JP';
addLocale('ja-JP', jaMessages, { antd: jaAntd, momentLocale: 'ja' });
setLocale('ja-JP', false);
```
`addLocale` merges messages into the internal `localeInfo`. You can pass extra data (like AntD locale and moment locale) so components using AntD/moment behave correctly.
## 4. Disable i18n (turn off multi-language)
To permanently disable multi-language support:
1. In `src/app.tsx`'s `LocaleWrapper`, return a fixed AntD locale (ignore `localStorage` `umi_locale`):
```ts
const pick = (l: string | null) => {
return zhCN; // force Chinese
};
```
2. Remove or hide the language switcher (for example, remove language menu items in `src/components/TopbarControls.tsx`).
3. Optionally remove other JSON files in `src/locales` except the single target language to reduce build size.
If you only want to temporarily prevent user switching, hide the switcher (step 2) and keep files intact for easy re-enable.
## 5. Debugging & common issues
- New language not appearing: restart dev server or use `addLocale`; ensure AntD locale mapping exists in `app.tsx`.
- Missing translations: check all `src/locales/*.json` contain the key, and the `formatMessage` id is correct.
- Want automated extraction of message ids: this repo does not include extraction scripts; consider integrating `lingui`, `babel-plugin-react-intl`, or other tooling and adding scripts to `package.json`.
If you want, I can:
- create an initial `src/locales/ja-JP.json` and update `TopbarControls`/`app.tsx` mappings; or
- add a small example component that demonstrates runtime registration using `addLocale`. Tell me which one you prefer.
+1 -1
View File
@@ -57,4 +57,4 @@ Take a new layout named `secondary` as an example to make the route starting wit
   }
```
5. Finally, start the development mode `npm run start`, open [http://localhost:7000/secondary/](http://localhost:7000/secondary/) and you will see the page for the `secondary` layout.
5. Finally, start the development mode with `npm run dev`, then open the layout page in your browser (see dev server output for the actual URL), e.g. `/secondary/`.
+27 -16
View File
@@ -1,22 +1,33 @@
# HTTP request
# HTTP requests
this project use axios for http service, file located in src/utils/request.js
This project uses a small fetch-based HTTP helper implemented at `src/utils/request.ts` (export default `api`). The helper centralizes:
## Custom Header
- Prefixing paths with `config.apiPrefix`.
- Handling `params` (query string) and `body` (JSON or FormData).
- Injecting an `Authorization` header from local storage when available.
- Unified response parsing and error handling (expects backend responses in the form `{ success, message, data }`).
As for privilege access or modify cookie, you could add header param by yourself
Key behaviors
```
axios.defaults.headers.common['Authorization'] = 'token'
- `api(path, options)` merges `config.apiPrefix` + `path` to build the URL.
- If `options.params` is provided it's serialized and appended as query string.
- `options.body` handling:
- FormData is sent as-is (do not set Content-Type manually).
- Strings and Blobs are sent directly.
- Plain objects are JSON.stringified and Content-Type defaults to `application/json`.
- If a token exists in local storage (key `app-auth-token`), the helper injects an `Authorization: Bearer <token>` header unless one is already provided.
- Responses are expected to be JSON with `{ success: boolean, message?: string, data: T }`. Non-success responses throw an Error and show a UI message (uses `antd`'s `message`).
Usage (TypeScript-friendly):
```ts
import api from '@/utils/request';
// GET with query params
const page = await api('/users', { method: 'GET', params: { page: 1, pageSize: 10 } });
// POST with JSON body
const created = await api('/user', { method: 'POST', body: { name: 'Alice' } });
```
Or
```
axios.interceptors.request.use(function (config) {
config.headers.token = window.localStorage.getItem('token');
return config;
}, function (error) {
return Promise.reject(error);
});
```
The helper returns the `data` field from successful responses. Check `src/utils/request.ts` for exact typings and behavior.
+26 -77
View File
@@ -1,86 +1,35 @@
# 接口配置
## 为什么
本项目使用基于 TypeScript 的按功能分割服务模块,位于 `src/services/`,所有服务通过共享的 HTTP 封装 `src/utils/request.ts`(默认导出为 `api` 函数)发起请求。
在使用了`redux`或者`dva`项目中,我们经常会写类似下面的`service`层的函数,使代码结构更清晰,但是很容易看出,我们会写很多相似的代码,在`antd-admin@5.0`中,使用了更加简洁的配置方式实现了相同的功能。
为什么采用此模式?
- 每个领域(user/admin/menu/dashboard)有独立函数,职责清晰。
- 使用 TypeScript 提供输入/输出类型定义,便于维护(参见 `src/types`)。
- 请求处理集中化(查询参数、JSON body、鉴权 header、统一响应格式等)在 `src/utils/request.ts`。
```javascript
export async function login(data) {
return request({
url: '/api/v1/user/login',
method: 'post',
data,
})
示例(来自 `src/services/user.ts`):
```ts
import type { PagedResponse, User } from '@/types/user';
import api from '../utils/request';
export async function listUsers(
params?: Record<string, string | number | boolean>,
): Promise<PagedResponse<User>> {
return api<PagedResponse<User>>('/users', { method: 'GET', params });
}
export async function createUser(values: Record<string, unknown>): Promise<User> {
return api('/user', { method: 'POST', body: values });
}
```
## 配置和使用
使用方式:
- 通过 `import { listUsers } from '@/services/user'` 导入命名函数。
- `api(path, options)` 返回后端约定格式 `{ success, message, data }` 中的 `data` 字段。
在`src/services/api.js`文件中,你会看到如下配置对象,对象的键用于调用时的函数名称,对象的值为请求的`url`,默认请求方式为`GET`,如果是其他请求方式对象的值的格式则为`'method url'`。
关于 `src/utils/request.ts`:
- 会将 `config.apiPrefix` 与 `path` 拼接;支持 `params`(查询)、`body`(JSON 或 FormData);若存在本地 token 则自动注入 `Authorization`。
- 对非成功响应会抛出异常并在界面上显示消息(使用 `antd` 的 `message`)。
```javascript
export default {
...
queryUser: '/user/:id',
queryUserList: '/users',
updateUser: 'Patch /user/:id',
createUser: 'POST /user/:id',
removeUser: 'DELETE /user/:id',
removeUserList: 'POST /users/delete',
...
}
```
在其他文件中使用
```javascript
import { queryUser } from 'api'
// 一般文件中
...
queryUser(option).then(data => console.log(data))
...
// model文件中
...
yield call(queryUser, option)
...
```
## 实现方式
参考`src/services/index.js`文件,对api配置进行遍历,每个属性都返回对应的封装后的request函数。
```javascript
import request from 'utils/request'
import { apiPrefix } from 'utils/config'
import api from './api'
const gen = params => {
let url = apiPrefix + params
let method = 'GET'
const paramsArray = params.split(' ')
if (paramsArray.length === 2) {
method = paramsArray[0]
url = apiPrefix + paramsArray[1]
}
return function(data) {
return request({
url,
data,
method,
})
}
}
const APIFunction = {}
for (const key in api) {
APIFunction[key] = gen(api[key])
}
module.exports = APIFunction
```
如果你在迁移旧的 API 映射实现,建议按当前结构将功能拆分为小型服务模块并补充类型定义。
+29 -60
View File
@@ -8,77 +8,46 @@
<div align="center">
一套优秀的中后台前端解决方案
基于 Ant Design 6、Umi 4 与 TypeScript 的企业级前端起手模版。
[![antd](https://img.shields.io/badge/antd-^3.10.0-blue.svg?style=flat-square)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/umi-^2.2.1-orange.svg?style=flat-square)](https://github.com/umijs/umi)
[![GitHub issues](https://img.shields.io/github/issues/zuiidea/antd-admin.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/issues)
[![MIT](https://img.shields.io/dub/l/vibe-d.svg?style=flat-square)](http://opensource.org/licenses/MIT)
![Travis (.org)](https://img.shields.io/travis/zuiidea/antd-admin.svg)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/zuiidea/antd-admin/pulls)
[![Gitter](https://img.shields.io/gitter/room/antd-admin/antd-admin.svg)](https://gitter.im/antd-admin/antd-admin)
[![antd](https://img.shields.io/badge/AntD-^6.0.0-1890ff?style=flat-square&logo=ant-design)](https://github.com/ant-design/ant-design)
[![umi](https://img.shields.io/badge/Umi-^4.0.0-ff9900?style=flat-square&logo=umijs)](https://github.com/umijs/umi)
</div>
- 在线演示 - [https://antd-admin.zuiidea.com](https://antd-admin.zuiidea.com)
- 使用文档 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/](https://doc.antd-admin.zuiidea.com/#/zh-cn/)
- 常见问题 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/faq](https://doc.antd-admin.zuiidea.com/#/zh-cn/faq)
- 更新日志 - [https://doc.antd-admin.zuiidea.com/#/zh-cn/change-log](https://doc.antd-admin.zuiidea.com/#/zh-cn/change-log)
- 文档源文件位于 `docs/` 目录。
## 特性
## 快速开始
- 国际化,源码中抽离翻译字段,按需加载语言包
- 动态权限,不同权限对应不同菜单
- 优雅美观,Ant Design 设计体系
- Mock 数据,本地数据调试
## 使用
1. 下载项目代码。
本仓库示例与 CI 使用 `pnpm`,你也可以使用 `npm` 或 `yarn`,但推荐 `pnpm`。
```bash
git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
# 克隆
git clone https://github.com/zuiidea/antd-admin.git
cd antd-admin
# 安装依赖
pnpm install
# 启动开发(含本地 mock)
npm run dev
# 构建
npm run build
# lint 与格式化
npm run lint
npm run format
```
2. 进入目录安装依赖,国内用户推荐使用 [cnpm](https://cnpmjs.org) 进行加速。
说明:
```bash
yarn install
```
- 本地 mock 实现在 `mock/index.js`,便于在无后端时开发。
- CI 工作流位于 `.github/workflows/ci.yml`(使用 pnpm、lint、build)。
- 若需对接真实后端,请修改 `src/services` 下的 API。
或者
更多详细文档请查看 `docs/` 目录下的其他页面。
```bash
npm install
```
## 参与贡献
3. 启动本地服务器。
```bash
npm run start
```
4. 启动完成后打开浏览器访问 [http://localhost:7000](http://localhost:7000),如果需要更改启动端口,可在 `.env` 文件中配置。
> 更多信息请参考 [使用文档](https://doc.antd-admin.zuiidea.com/#/zh-cn/)。
## 支持环境
现代浏览器。
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera |
| --------- | --------- | --------- | --------- | --------- |
|IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions
## 参与贡献
我们非常欢迎你的贡献,你可以通过以下方式和我们一起共建 :smiley:
- 在你的公司或个人项目中使用 AntD Admin。
- 通过 [Issue](http://github.com/zuiidea/antd-admin/issues) 报告 bug 或进行咨询。
- 提交 [Pull Request](http://github.com/zuiidea/antd-admin/pulls) 改进代码。
> 强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393),更好的问题更容易获得帮助。
欢迎提交 Issue 或 PR 改进项目文档或代码。
+1 -70
View File
@@ -30,73 +30,4 @@
- 类型: `String`
在`Primary`布局下,页面滚动时是否固定顶部。
## layouts
- 类型: `Array`
配置哪些路由使用哪种布局,未指定路由使用默认布局 `Public`,项目中目前有 `Primary` 和 `Public` 两种布局,
默认配置如下:
```javascript
layouts: [
{
name: 'primary',
include: [/.*/],
exclude: [/(\/(en|zh))*\/login/],
},
],
```
每种布局的对象属性如下:
- `name` - 布局的名称;
- `include` - 指定使用该布局的路由规则列表,规则可为正则表达式或者字符串;
- `exclude` - 指定不使用该布局的路由规则列表,规则可为正则表达式或者字符串。
> 注意:`exclude` 优先级高于 `include`,前面的布局优先级高于后面的布局。开发过程中可能需要结合`src/layouts`目录下的布局使用,具体方法可查看 [使用布局](./layout.md)。
## i18n
- 类型: `Object`
配置国际化,默认配置如下:
```javascript
i18n: {
languages: [
{
key: 'en',
title: 'English',
flag: '/america.svg',
},
{
key: 'zh',
title: '中文',
flag: '/china.svg',
},
],
defaultLanguage: 'en',
}
```
### i18n.languages
- 类型: `Array`
指定应用支持哪些语言,每种语言的对象属性如下:
- `key` - 语言的`key`,应用到页面 url 上以区分语言,也对应 `src/locales` 目录下的语言包文件夹名;
- `title` - 语言名称,在登录页底部、`Primay` 布局顶部语言切换显示;
- `flag` - 语言的国旗图标的路径,在 `Primay` 布局顶部语言切换显示。
### i18n.defaultLanguage
- 类型: `String`
配置默认语言。
在`Primary`布局下,页面滚动时是否固定顶部。
+30 -34
View File
@@ -9,32 +9,29 @@ git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
```
## 目录结构
应用的目录结构如下
1. 克隆项目并安装依赖(推荐使用 `pnpm`)。
```bash
├── dist/ # 默认build输出目录
├── mock/ # Mock文件目录
├── public/ # 静态资源文件目录
├── src/ # 源码目录
│ ├── components/ # 组件目录
│ ├── e2e/ # e2e目录
│ ├── layouts/ # 布局目录
│ ├── locales/ # 国际化文件目录
│ ├── models/ # 数据模型目录
│ ├── pages/ # 页面组件目录
│ ├── services/ # 数据接口目录
│ │ ├── api.js # 接口配置
│ │ └── index.js # 接口输出
│ ├── themes/ # 项目样式目录
│ │ ├── default.less # 样式变量
│ │ ├── index.less # 全局样式
│ │ ├── mixin.less # 样式函数
│ │ └── vars.less # 样式变量及函数
│ ├── utils/ # 工具函数目录
│ │ ├── config.js # 项目配置
│ │ ├── constant.js # 静态常量
git clone https://github.com/zuiidea/antd-admin.git my-project
cd my-project
pnpm install
```
或使用其它包管理器:
```bash
npm install
# 或
yarn install
```
2. 启动开发模式:
```bash
npm run dev
```
3. 启动完成后在浏览器打开项目(查看开发服务器输出以获取实际 URL/端口)。
│ │ ├── index.js # 工具函数
│ │ ├── request.js # 异步请求函数(axios)
│ │ └── theme.js # 项目需要在js中使用到样式变量
@@ -52,22 +49,21 @@ cd my-project
## 本地开发
1. 进入目录安装依赖,国内用户推荐使用 [cnpm](https://cnpmjs.org) 进行加速
项目推荐使用 `pnpm` 进行依赖管理:
```bash
yarn install
pnpm install
npm run dev
```
或者
也可以使用 `npm` 或 `yarn`:
```bash
npm install
# 或
yarn install
# 然后使用对应的启动命令,例如 `npm run dev` 或 `yarn dev`(若 package.json 中配置了),
# 本仓库默认开发脚本为 `npm run dev`。
```
2. 启动本地服务器
```bash
npm run start
```
3. 启动完成后打开浏览器访问 [http://localhost:7000](http://localhost:7000),如果需要更改启动端口,可在 `.env` 文件中配置。
启动后在浏览器打开项目(查看开发服务器输出以获取实际 URL/端口)。
+105 -57
View File
@@ -1,75 +1,123 @@
# 国际化
# 国际化(i18n)使用说明
## 新增应用语言
本项目通过 Umi 的 `plugin-locale`(基于 `react-intl`)管理多语言,翻译资源位于 `src/locales`(例如 `en-US.json`、`zh-CN.json`)。下面说明如何:新增语言、增加翻译条目、切换语言与关闭多语言。示例以新增日语 `ja-JP` 为例。
以新增日语为例。
## 1. 新增一种语言(长期支持)
![i18n](../_media/term_i18n.svg)
1. 在 `src/locales/` 下创建新的翻译文件,文件名为语言标识,例如:`src/locales/ja-JP.json`。
1. 添加语言包本地文件,`ja` 为日语的语言代码,支持翻译的语言列表参考 [有道智云](http://ai.youdao.com/docs/doc-trans-api.s#p05),运行下面命令后会生成 `src/locales/ja/messages.json` 文件。
2. 文件内容为 JSON 格式的翻译对象(可嵌套):
```bash
npm run add-locale ja
```
```json
{
"welcome": "ようこそ",
"login": {
"username": "ユーザー名",
"password": "パスワード",
"submit": "ログイン"
}
}
```
2. 提取代码中需要翻译的字段,即 `<Trans>message</Trans>`、`` intl.formatMessage({ id: 'message `` 中 `message` 字段,运行下面命令后 `src/locales/ja/messages.json' }) 将会出现提取后的字段配置。
3. 若希望 Ant Design 组件也使用对应的本地化(日期/组件文案),在 `src/app.tsx` 的 `pick` 函数中添加对应的 AntD locale 引入与映射,例如:
```bash
npm run extract
```
```ts
import jaJP from 'antd/locale/ja_JP';
// ...
if (l === 'ja-JP') return jaJP;
```
你将看到如下信息:
4. 在语言选择列表(例如 `src/components/TopbarControls.tsx` 的 `localeMenuItems`)中加入新语言项:
```bash
Catalog statistics:
┌─────────────┬─────────────┬─────────┐
│ Language │ Total count │ Missing │
├─────────────┼─────────────┼─────────┤
│ en (source) │ 52 │ - │
│ ja │ 52 │ 52 │
│ zh │ 52 │ 0 │
└─────────────┴─────────────┴─────────┘
```
```ts
{ key: 'ja-JP', label: '日本語' }
```
3. 与此同时,我们在 `src/utils/config.js` 新增相关配置。
5. 重启开发服务器:
```javascript
{
...
i18n: {
languages: [
...
{
key:'ja',
title: '日本語',
flag: '/japanese.svg',
},
],
},
}
```
```bash
pnpm run dev
```
>  路由相关效果,配置后 `npm run start` 重启后生效。
Umi 会在构建时将 `src/locales` 下的文件编入 `localeInfo`,页面即可使用新语言。
4. 使用内置的命令进行自动翻译,在 `src/locales/ja/messages.json` 中将会看到翻译后的配置。
提示:如不想重启或想动态注册翻译,可使用运行时 API `addLocale(name, messages, extraLocales)`(见下一节)。
```bash
npm run trans:only
```
## 2. 增加一条多语言文本(翻译条目)
你将看到如下信息:
1. 在所有语言的 JSON 文件中添加相同的 id(推荐同时维护 `en-US.json` 与 `zh-CN.json`,新语言也应添加):
```bash
start: en -> ja
...
youdao: en -> ja: Unpublished -> 未発表
youdao: en -> ja: Update -> 更新
youdao: en -> ja: Update User -> ユーザーの更新
youdao: en -> ja: Username -> 名
...
All translations have been completed.
```
`src/locales/en-US.json`
> `npm run trans` 将会依次执行 `npm run extract` 和 `npm run trans:only`
```json
"my.feature.greeting": "Hello from feature"
```
5. 最后,可以在 `src/locales/ja/messages.json` 中对翻译不准确的的字段进行调整。启动开发模式 `npm run start`,打开 [http://localhost:7000/ja/login](http://localhost:7000/ja/login),你将看到日语版本的应用。
`src/locales/zh-CN.json`
```json
"my.feature.greeting": "来自功能的问候"
```
2. 在组件中使用 `useIntl()` 获取 `intl`,并调用 `formatMessage`:
```ts
import { useIntl } from 'umi';
const intl = useIntl();
const text = intl.formatMessage({ id: 'my.feature.greeting', defaultMessage: 'Hello' });
```
建议使用 `useIntl()`(或 `injectIntl`)以保证语言切换时组件可自动刷新并显示新文本。
## 3. 运行时切换或注册语言
- 切换语言(会写入 `localStorage` 并触发刷新或事件):
```ts
import { setLocale } from 'umi';
// 切换并刷新页面
setLocale('ja-JP', true);
// 切换但不刷新(触发事件更新)
setLocale('zh-CN', false);
```
- 运行时注册(无需重启):
```ts
import { addLocale, setLocale } from 'umi';
import jaMessages from '@/locales/ja-JP.json';
import jaAntd from 'antd/locale/ja_JP';
addLocale('ja-JP', jaMessages, { antd: jaAntd, momentLocale: 'ja' });
setLocale('ja-JP', false);
```
`addLocale` 会把翻译合并到内部 `localeInfo`,并可同时提供 AntD 与(可选的)moment 本地化配置。
## 4. 关闭多语言(禁用 i18n)
若想永久关闭多语言功能:
1. 在 `src/app.tsx` 的 `LocaleWrapper` 中,直接返回固定的 AntD locale(忽略 `localStorage` 中的 `umi_locale`):
```ts
const pick = (l: string | null) => {
return zhCN; // 强制使用中文
};
```
2. 移除或隐藏语言切换控件(例如删除 `src/components/TopbarControls.tsx` 中的语言菜单项或 Dropdown)。
3. 可选:删除 `src/locales` 中其它语言文件,仅保留目标语言文件以减少构建体积。
如果只是临时禁止用户切换,建议仅执行第 2 步(隐藏切换),以便未来快速恢复多语言支持。
## 5. 调试与常见问题
- 新增语言后无显示:确认已重启 dev server(或使用 `addLocale` 动态注册),并在 `app.tsx` 中为该语言提供 AntD locale。
- 翻译未生效或缺失:检查 `src/locales/*.json` 是否包含对应 id,且 `formatMessage` 中的 id 拼写正确。
- 想自动抽取翻译 id:仓库未内置抽取脚本,建议按需集成 `lingui`、`babel-plugin-react-intl` 或其他工具并在 `package.json` 中添加相应脚本。
如果你需要,我可以:
- 为你创建一个 `src/locales/ja-JP.json` 的初始翻译并更新 `TopbarControls` 与 `app.tsx` 映射;或
- 添加一个示例组件,演示如何在运行时通过 `addLocale` 注册新语言。请告诉我你更希望我执行哪项。
+1 -1
View File
@@ -57,4 +57,4 @@
}
```
5. 最后,启动开发模式 `npm run start`,打开 [http://localhost:7000/secondary/](http://localhost:7000/secondary/),你将看到 `secondary` 布局的页面。
5. 最后,使用 `npm run dev` 启动开发模式,然后在浏览器中打开该布局页面(查看开发服务器输出以获取实际 URL),例如 `/secondary/`。
+27 -18
View File
@@ -1,24 +1,33 @@
# HTTP请求
# HTTP 请求
本项目使用了axios提供http请求服务,文件在src/utils/request.js
本项目使用位于 `src/utils/request.ts` 的轻量封装(基于 `fetch`),默认导出为 `api`。该封装负责:
## 自定义Header
- 将 `config.apiPrefix` 与请求 `path` 拼接为最终 URL。
- 处理 `params`(查询字符串)与 `body`(JSON 或 FormData)。
- 在本地有 token 时自动注入 `Authorization` 头(本项目使用 localStorage 键 `app-auth-token`)。
- 统一解析后端返回(后端需遵循 `{ success, message, data }` 约定)并在非成功时抛出错误并显示 UI 提示(使用 `antd` 的 `message`)。
为了提供鉴权、修改cookie等服务,可以手动修改Header
主要行为说明
```
axios.defaults.headers.common['Authorization'] = 'token'
- `api(path, options)` 会把 `config.apiPrefix` 与 `path` 拼接。
- 当传入 `options.params` 时,会序列化为查询字符串并追加到 URL。
- `options.body` 的处理策略:
- 若为 FormData,直接发送(不要手动设置 Content-Type)。
- 若为字符串或 Blob,直接发送。
- 其余对象会被 `JSON.stringify`,默认设置 `Content-Type: application/json`(除非已在 headers 中指定)。
- 若 localStorage 中有 token 且未在 headers 中显式提供 Authorization,将自动设置 `Authorization: Bearer <token>`。
- 成功响应返回后端 `data` 字段;响应格式不符合约定或后端返回失败时会抛出异常。
使用示例(TypeScript):
```ts
import api from '@/utils/request';
// 带查询参数的 GET
const page = await api('/users', { method: 'GET', params: { page: 1, pageSize: 10 } });
// 发送 JSON 请求体的 POST
const created = await api('/user', { method: 'POST', body: { name: 'Alice' } });
```
或者
```
// 添加请求拦截器
axios.interceptors.request.use(function (config) {
// 在发送请求之前做些什么
config.headers.token = window.localStorage.getItem('token');
return config;
}, function (error) {
return Promise.reject(error);
});
```
详细实现请参阅 `src/utils/request.ts`,文档中仅列出使用建议与约定。
-3
View File
@@ -1,3 +0,0 @@
module.exports = {
testURL: 'http://localhost:8000'
}
+15
View File
@@ -0,0 +1,15 @@
import { Config, configUmiAlias, createConfig } from 'umi/test';
export default async () => {
return (
(await configUmiAlias({
...createConfig({
target: 'browser',
jsTransformer: 'esbuild',
jsTransformerOpts: { jsx: 'automatic' },
}),
// you can override umi default jest config here
setupFilesAfterEnv: ['<rootDir>/src/setupTests.ts'],
})) as Config.InitialOptions
);
};
+53
View File
@@ -0,0 +1,53 @@
import * as adminSvc from '../../src/services/admin';
/**
* Skill 元数据与封装 — Admin
* 目的:为自动化代理或 LLM 提供明确的能力描述与可直接调用的包装函数。
*/
export const meta = {
id: 'admin:manage',
name: 'Admin Management',
description: '登录/登出、获取当前管理员、管理管理员列表(增删改查)',
inputs: {
login: { adminname: 'string', password: 'string' },
getAdmin: { id: 'string' },
createAdmin: { values: 'object' },
updateAdmin: { id: 'string', values: 'object' },
deleteAdmin: { id: 'string' },
deleteAdmins: { ids: 'string[]' },
listAdmins: { params: 'object | undefined' },
},
outputs: 'JSON (see src/types/admin.ts for schema)',
};
export const actions = {
async login(payload: { adminname: string; password: string }) {
return adminSvc.login(payload);
},
async logout() {
return adminSvc.logout();
},
async currentAdmin() {
return adminSvc.currentAdmin();
},
async listAdmins(params?: Record<string, string | number | boolean>) {
return adminSvc.listAdmins(params as any);
},
async createAdmin(values: Record<string, unknown>) {
return adminSvc.createAdmin(values);
},
async getAdmin(id: string) {
return adminSvc.getAdmin(id);
},
async updateAdmin(id: string, values: Record<string, unknown>) {
return adminSvc.updateAdmin(id, values);
},
async deleteAdmin(id: string) {
return adminSvc.deleteAdmin(id);
},
async deleteAdmins(ids: string[]) {
return adminSvc.deleteAdmins(ids);
},
};
export default { meta, actions };
+17
View File
@@ -0,0 +1,17 @@
import * as dashSvc from '../../src/services/dashboard';
export const meta = {
id: 'dashboard:view',
name: 'Dashboard View',
description: '获取仪表盘汇总数据',
inputs: {},
outputs: 'JSON summary data from /dashboard',
};
export const actions = {
async getDashboard() {
return dashSvc.getDashboard();
},
};
export default { meta, actions };
+32
View File
@@ -0,0 +1,32 @@
/**
* Skills registry
*
* 目的:集中导出 llm/skills 下的 skill 模块,便于运行时自动发现或静态引入。
* 导出:
* - `skills`:按短名映射的 skill 模块集合。
* - `listSkills()`:返回所有 skill 的 meta 数组,便于展示或自动选择。
* - `getSkillById(id)`:基于 meta.id 查找对应 skill 模块。
*/
import admin from './admin.skill';
import dashboard from './dashboard.skill';
import menu from './menu.skill';
import user from './user.skill';
const skills: Record<string, any> = {
admin,
menu,
user,
dashboard,
};
export function listSkills() {
return Object.values(skills).map((s) => s.meta);
}
export function getSkillById(id: string) {
return Object.values(skills).find((s) => s.meta && s.meta.id === id);
}
export { skills };
export default skills;
+35
View File
@@ -0,0 +1,35 @@
import * as menuSvc from '../../src/services/menu';
export const meta = {
id: 'menu:manage',
name: 'Menu Management',
description: '列出、创建、更新、删除与排序菜单项',
inputs: {
listMenus: {},
createMenu: { values: 'MenuFormValues' },
updateMenu: { id: 'number | string', values: 'Partial<MenuFormValues>' },
deleteMenu: { id: 'number | string' },
sortMenus: { order: 'Array<number | string>' },
},
outputs: 'JSON (see src/types/menu.ts for schema)',
};
export const actions = {
async listMenus() {
return menuSvc.listMenus();
},
async createMenu(values: any) {
return menuSvc.createMenu(values);
},
async updateMenu(id: number | string, values: any) {
return menuSvc.updateMenu(id, values);
},
async deleteMenu(id: number | string) {
return menuSvc.deleteMenu(id);
},
async sortMenus(order: Array<number | string>) {
return menuSvc.sortMenus(order);
},
};
export default { meta, actions };
+39
View File
@@ -0,0 +1,39 @@
import * as userSvc from '../../src/services/user';
export const meta = {
id: 'user:manage',
name: 'User Management',
description: '用户列表/分页、创建、获取、更新、删除与批量删除',
inputs: {
listUsers: { params: 'object | undefined' },
createUser: { values: 'object' },
getUser: { id: 'string' },
updateUser: { id: 'string', values: 'object' },
deleteUser: { id: 'string' },
deleteUsers: { ids: 'string[]' },
},
outputs: 'JSON (see src/types/user.ts for schema)',
};
export const actions = {
async listUsers(params?: Record<string, string | number | boolean>) {
return userSvc.listUsers(params as any);
},
async createUser(values: Record<string, unknown>) {
return userSvc.createUser(values);
},
async getUser(id: string) {
return userSvc.getUser(id);
},
async updateUser(id: string, values: Record<string, unknown>) {
return userSvc.updateUser(id, values);
},
async deleteUser(id: string) {
return userSvc.deleteUser(id);
},
async deleteUsers(ids: string[]) {
return userSvc.deleteUsers(ids);
},
};
export default { meta, actions };
+36
View File
@@ -0,0 +1,36 @@
项目:antd-admin_next
目标:将仓库中的关键信息写成对大模型(LLM)友好的简短说明,便于自动化理解、代码导航和提示生成。
概览:
- 技术栈:React + Ant Design + TypeScript(前端单页/多页面结构),源码位于 `src/`。
- 路由/页面:页面文件放在 `src/pages/` 目录;布局在 `src/layouts/`;组件在 `src/components/`。
- 重要工具:`src/utils/request.ts` 为 HTTP 请求封装,使用 `fetch`,默认 API 前缀由 `src/utils/config.ts` 提供。
API 与约定:
- 全局 API 前缀:`/api/v1`(见 `src/utils/config.ts`)。
- 请求函数 `api(path, options)`:
- 自动把 `options.params` 转为查询字符串。
- 对对象 body 自动 JSON 序列化并设置 `Content-Type: application/json`(FormData 会被保留)。
- 当响应状态为 `204` 返回空对象;当 `res.ok` 为 false 时抛出 Error,错误信息优先使用响应体中的 `message` 字段。
如何使用(对模型说明):
- 若要调用后端资源,请调用 `api('/resource', { method: 'GET' | 'POST', params, body })`。
- 成功响应应为 JSON,失败会抛出 Error。处理调用时应捕获异常并展示 `error.message`。
本文件用途:
- 作为 LLM 的快速上下文:当模型在代码中自动生成、补全或审阅代码时,可引用此文件以获得仓库结构、关键约定和请求行为的摘要。
快速运行(可能依赖 package manager):
- 常用:`npm run dev` 或 `pnpm dev` 启动开发服务器。
如需更详细的接口契约或后端响应示例,请查看对应的 `src/services/` 目录下的 API 封装文件。
Agent Skills:
- 为方便自动化代理(Agent/LLM)调用,项目在 `llm/skills/` 下提供了若干能力描述与包装:
- `llm/skills/admin.skill.ts`:管理员管理相关操作(login、logout、list/create/update/delete)
- `llm/skills/menu.skill.ts`:菜单管理操作(list/create/update/delete/sort)
- `llm/skills/user.skill.ts`:用户管理操作(list/create/get/update/delete/batch)
- `llm/skills/dashboard.skill.ts`:获取仪表盘数据的读取操作
这些 skill 文件导出 `meta`(能力描述)和 `actions`(可直接调用的异步函数),便于代理在运行时发现并调用对应后端逻辑。
-4008
View File
File diff suppressed because it is too large Load Diff
-143
View File
@@ -1,143 +0,0 @@
import Mock from 'mockjs'
import { Constant } from './utils'
const { ApiPrefix, Color } = Constant
const Dashboard = Mock.mock({
'sales|8': [
{
'name|+1': 2008,
'Clothes|200-500': 1,
'Food|180-400': 1,
'Electronics|300-550': 1,
},
],
cpu: {
'usage|50-600': 1,
space: 825,
'cpu|40-90': 1,
'data|20': [
{
'cpu|20-80': 1,
},
],
},
browser: [
{
name: 'Google Chrome',
percent: 43.3,
status: 1,
},
{
name: 'Mozilla Firefox',
percent: 33.4,
status: 2,
},
{
name: 'Apple Safari',
percent: 34.6,
status: 3,
},
{
name: 'Internet Explorer',
percent: 12.3,
status: 4,
},
{
name: 'Opera Mini',
percent: 3.3,
status: 1,
},
{
name: 'Chromium',
percent: 2.53,
status: 1,
},
],
user: {
name: 'github',
sales: 3241,
sold: 3556,
},
'completed|12': [
{
'name|+1': 2008,
'Task complete|200-1000': 1,
'Cards Complete|200-1000': 1,
},
],
'comments|5': [
{
name: '@last',
'status|1-3': 1,
content: '@sentence',
avatar() {
return Mock.Random.image(
'48x48',
Mock.Random.color(),
'#757575',
'png',
this.name.substr(0, 1)
)
},
date() {
return `2016-${Mock.Random.date('MM-dd')} ${Mock.Random.time(
'HH:mm:ss'
)}`
},
},
],
'recentSales|36': [
{
'id|+1': 1,
name: '@last',
'status|1-4': 1,
date() {
return `${Mock.Random.integer(2015, 2016)}-${Mock.Random.date(
'MM-dd'
)} ${Mock.Random.time('HH:mm:ss')}`
},
'price|10-200.1-2': 1,
},
],
quote: {
name: 'Joho Doe',
title: 'Graphic Designer',
content:
"I'm selfish, impatient and a little insecure. I make mistakes, I am out of control and at times hard to handle. But if you can't handle me at my worst, then you sure as hell don't deserve me at my best.",
avatar:
'//cdn.antd-admin.zuiidea.com/bc442cf0cc6f7940dcc567e465048d1a8d634493198c4-sPx5BR_fw236',
},
numbers: [
{
icon: 'pay-circle-o',
color: Color.green,
title: 'Online Review',
number: 2781,
},
{
icon: 'team',
color: Color.blue,
title: 'New Customers',
number: 3241,
},
{
icon: 'message',
color: Color.purple,
title: 'Active Projects',
number: 253,
},
{
icon: 'shopping-cart',
color: Color.red,
title: 'Referrals',
number: 4324,
},
],
})
export default {
[`GET ${ApiPrefix}/dashboard`](req, res) {
res.json(Dashboard)
},
}
-2
View File
@@ -1,2 +0,0 @@
declare module 'mockjs'
declare module 'qs'
+373
View File
@@ -0,0 +1,373 @@
// Consolidated mock server for development (simplified)
const Mock = require('mockjs');
const qs = require('qs');
const ApiPrefix = '/api/v1';
// simple in-memory admin users with richer mock fields
const adminList = [
{
id: 1,
username: 'admin',
password: 'admin',
real_name: '李四',
nick_name: '超级管理员',
mobile: '13800000000',
avatar: Mock.Random.image('100x100', '#4096ff', '#fff', 'png', 'A'),
role: '管理员',
department: '运维部',
permissions: '*',
status: 1,
remark: '拥有所有权限',
lastLogin: Mock.Random.datetime(),
createdBy: 'system',
},
{
id: 2,
username: 'guest',
password: 'guest',
real_name: '访客',
nick_name: '访客',
mobile: '15100000000',
avatar: Mock.Random.image('100x100', '#ff7f50', '#fff', 'png', 'G'),
role: '访客',
department: '外部',
permissions: '/dashboard,/users,/users/list',
status: 1,
remark: '',
lastLogin: Mock.Random.datetime(),
createdBy: 'system',
},
];
// users list
let users = Mock.mock({
'data|20-30': [
{
id: '@id',
name: '@name',
nickName: '@last',
phone: /^1[34578]\d{9}$/,
'age|18-60': 1,
address: '@county(true)',
isMale: '@boolean',
email: '@email',
createTime: '@datetime',
avatar() {
return Mock.Random.image(
'100x100',
'#4096ff',
'#757575',
'png',
this.nickName ? this.nickName.substr(0, 1) : '',
);
},
},
],
}).data;
// routes database (source of truth)
const ROUTES_DB = [
{ id: '1', name: '仪表盘', icon: 'home', route: '/dashboard' },
{ id: '2', name: 'Ai会话', icon: 'robot', route: '/ai/chat' },
{ id: '3', name: '用户管理', icon: 'user', route: '/users' },
{
id: '4',
breadcrumbParentId: '3',
name: '用户列表',
icon: 'team',
route: '/users/list',
},
{
id: '5',
menuParentId: '-1',
breadcrumbParentId: '4',
name: '用户详情',
route: '/users/:id',
},
{ id: '6', name: '系统设置', icon: 'settings', route: '/sys' },
{
id: '7',
breadcrumbParentId: '6',
name: '成员列表',
icon: 'team',
route: '/admin/list',
},
{
id: '8',
menuParentId: '-1',
breadcrumbParentId: '6',
name: '成员详情',
icon: 'user',
route: '/admin/:id',
},
{
id: '9',
breadcrumbParentId: '6',
name: '菜单设置',
icon: 'tool',
route: '/sys/menu',
},
{ id: '10', name: '项目介绍', icon: 'info-c', route: '/guide' },
];
// convert routes DB into menus tree used by UI
function buildMenusFromRoutes(db) {
const items = db
// exclude routes that should not appear in menu (explicit menuParentId === '-1')
.filter((r) => !(r.menuParentId === '-1' || r.menuParentId === -1))
.map((r, idx) => {
const id = Number(r.id) || r.id;
// prefer explicit menuParentId, fall back to breadcrumbParentId
const parentIdRaw = r.breadcrumbParentId ?? null;
const parentId =
parentIdRaw === undefined || parentIdRaw === null
? null
: parentIdRaw === '-1'
? null
: Number(parentIdRaw);
return {
id,
title: r.name,
icon: r.icon,
route: r.route,
parentId,
status: 1,
sort: idx + 1,
children: [],
};
});
const map = new Map();
items.forEach((it) => map.set(it.id, it));
const roots = [];
items.forEach((it) => {
if (it.parentId == null || !map.has(it.parentId)) {
roots.push(it);
} else {
map.get(it.parentId).children.push(it);
}
});
// sort recursively by sort
const sortRec = (arr) => {
arr.sort((a, b) => (a.sort || 0) - (b.sort || 0));
arr.forEach((c) => {
if (c.children && c.children.length) sortRec(c.children);
});
};
sortRec(roots);
return roots;
}
const menus = buildMenusFromRoutes(ROUTES_DB);
// dashboard
const Dashboard = Mock.mock({
'sales|6': [
{
'name|+1': 2008,
'Clothes|200-500': 1,
'Food|180-400': 1,
'Electronics|300-550': 1,
},
],
cpu: { 'usage|50-600': 1, space: 825, 'cpu|40-90': 1 },
browser: [
{ name: 'Google Chrome', percent: 43.3, status: 1 },
{ name: 'Mozilla Firefox', percent: 33.4, status: 2 },
],
});
// simple helper to read cookie token
function parseTokenFromCookie(headers) {
const cookie = headers.cookie || '';
const cookies = qs.parse(cookie.replace(/\s/g, ''), { delimiter: ';' });
if (!cookies.token) return null;
try {
return JSON.parse(cookies.token);
} catch (e) {
return null;
}
}
module.exports = {
[`GET ${ApiPrefix}/dashboard`](req, res) {
res.json({ success: true, data: Dashboard });
},
[`GET ${ApiPrefix}/menus`](req, res) {
res.json({ success: true, data: menus });
},
[`POST ${ApiPrefix}/admin/login`](req, res) {
const { username, password } = req.body || {};
const admin = adminList.find(
(u) => u.username === username && u.password === password,
);
if (admin) {
const now = new Date();
now.setDate(now.getDate() + 1);
res.cookie(
'token',
JSON.stringify({ id: admin.id, deadline: now.getTime() }),
{ maxAge: 24 * 3600 * 1000, httpOnly: true },
);
res.json({ success: true, message: 'Ok', data: null });
} else {
res
.status(400)
.json({ success: false, message: 'Invalid credentials', data: null });
}
},
[`GET ${ApiPrefix}/admin/logout`](req, res) {
res.clearCookie('token');
res.json({ success: true, data: null });
},
[`GET ${ApiPrefix}/admin`](req, res) {
const token = parseTokenFromCookie(req.headers);
const response = {};
let admin = {};
if (!token) {
res
.status(200)
.json({ success: false, message: 'Not Login', data: null });
return;
}
response.success = token.deadline > new Date().getTime();
if (response.success) {
const adminItem = adminList.find((u) => u.id === token.id);
if (adminItem) {
const { password, ...other } = adminItem;
admin = other;
}
}
res.json({ success: response.success, data: admin || null });
},
[`GET ${ApiPrefix}/users`](req, res) {
const { query } = req;
let { pageSize, page, ...other } = query || {};
pageSize = Number(pageSize) || 10;
page = Number(page) || 1;
let newData = users.slice();
for (const key in other) {
if (Object.prototype.hasOwnProperty.call(other, key)) {
newData = newData.filter(
(item) => String(item[key]).indexOf(String(other[key])) > -1,
);
}
}
res.status(200).json({
success: true,
data: {
data: newData.slice((page - 1) * pageSize, page * pageSize),
total: newData.length,
},
});
},
[`GET ${ApiPrefix}/user/:id`](req, res) {
const { id } = req.params || {};
let item = users.find((u) => String(u.id) === String(id));
// 如果找不到用户,则生成一个带有相同 id 的 mock 用户,避免 404
if (!item) {
item = Mock.mock({
id: String(id),
name: '@name',
nickName: '@last',
phone: /^1[34578]\d{9}$/,
'age|18-60': 1,
address: '@county(true)',
isMale: '@boolean',
email: '@email',
createTime: '@datetime',
avatar() {
return Mock.Random.image(
'100x100',
'#4096ff',
'#757575',
'png',
this.nickName ? this.nickName.substr(0, 1) : '',
);
},
});
}
// enrich with some additional mock fields: phone model and browsing history
const enriched = {
...item,
// ensure lastLogin exists for user detail view (used by UI)
lastLogin: item.lastLogin || Mock.Random.datetime(),
phoneModel: Mock.Random.pick([
'iPhone 13',
'iPhone 14 Pro',
'Samsung S22',
'Huawei P50',
'Xiaomi 12',
]),
browsingHistory: Mock.mock({
'data|3-6': [
{
url: '@url',
title: '@title',
time: '@datetime',
},
],
}).data,
};
const { ...other } = enriched;
res.status(200).json({ success: true, data: other });
},
[`GET ${ApiPrefix}/routes`](req, res) {
res.status(200).json({ success: true, data: ROUTES_DB });
},
// admin accounts CRUD
[`GET ${ApiPrefix}/admins`](req, res) {
res.status(200).json({
success: true,
data: { data: adminList, total: adminList.length },
});
},
[`GET ${ApiPrefix}/admin/:id`](req, res) {
const { id } = req.params || {};
const item = adminList.find((u) => String(u.id) === String(id));
if (!item)
return res
.status(404)
.json({ success: false, message: 'Not found', data: null });
const { password, ...other } = item;
res.status(200).json({ success: true, data: other });
},
[`POST ${ApiPrefix}/admin`](req, res) {
const body = req.body || {};
const id = adminList.length
? Math.max(...adminList.map((u) => u.id)) + 1
: 1;
const next = { id, ...body };
adminList.push(next);
const { password, ...other } = next;
res.status(200).json({ success: true, data: other });
},
[`PATCH ${ApiPrefix}/admin/:id`](req, res) {
const { id } = req.params || {};
const body = req.body || {};
const idx = adminList.findIndex((u) => String(u.id) === String(id));
if (idx === -1)
return res
.status(404)
.json({ success: false, message: 'Not found', data: null });
adminList[idx] = { ...adminList[idx], ...body };
const { password, ...other } = adminList[idx];
res.status(200).json({ success: true, data: other });
},
};
-155
View File
@@ -1,155 +0,0 @@
import { Constant } from './utils'
const { ApiPrefix } = Constant
const database = [
{
id: '1',
icon: 'dashboard',
name: 'Dashboard',
zh: {
name: '仪表盘',
},
'pt-br': {
name: 'Dashboard',
},
route: '/dashboard',
},
{
id: '2',
breadcrumbParentId: '1',
name: 'Users',
zh: {
name: '用户管理',
},
'pt-br': {
name: 'Usuário',
},
icon: 'user',
route: '/user',
},
{
id: '7',
breadcrumbParentId: '1',
name: 'Posts',
zh: {
name: '用户管理',
},
'pt-br': {
name: 'Posts',
},
icon: 'shopping-cart',
route: '/post',
},
{
id: '21',
menuParentId: '-1',
breadcrumbParentId: '2',
name: 'User Detail',
zh: {
name: '用户详情',
},
'pt-br': {
name: 'Detalhes do usuário',
},
route: '/user/:id',
},
{
id: '3',
breadcrumbParentId: '1',
name: 'Request',
zh: {
name: 'Request',
},
'pt-br': {
name: 'Requisição',
},
icon: 'api',
route: '/request',
},
{
id: '4',
breadcrumbParentId: '1',
name: 'UI Element',
zh: {
name: 'UI组件',
},
'pt-br': {
name: 'Elementos UI',
},
icon: 'camera-o',
},
{
id: '45',
breadcrumbParentId: '4',
menuParentId: '4',
name: 'Editor',
zh: {
name: 'Editor',
},
'pt-br': {
name: 'Editor',
},
icon: 'edit',
route: '/editor',
},
{
id: '5',
breadcrumbParentId: '1',
name: 'Charts',
zh: {
name: 'Charts',
},
'pt-br': {
name: 'Graficos',
},
icon: 'code-o',
},
{
id: '51',
breadcrumbParentId: '5',
menuParentId: '5',
name: 'ECharts',
zh: {
name: 'ECharts',
},
'pt-br': {
name: 'ECharts',
},
icon: 'line-chart',
route: '/chart/ECharts',
},
{
id: '52',
breadcrumbParentId: '5',
menuParentId: '5',
name: 'HighCharts',
zh: {
name: 'HighCharts',
},
'pt-br': {
name: 'HighCharts',
},
icon: 'bar-chart',
route: '/chart/highCharts',
},
{
id: '53',
breadcrumbParentId: '5',
menuParentId: '5',
name: 'Rechartst',
zh: {
name: 'Rechartst',
},
'pt-br': {
name: 'Rechartst',
},
icon: 'area-chart',
route: '/chart/Recharts',
},
]
export default {
[`GET ${ApiPrefix}/routes`](req, res) {
res.status(200).json(database)
},
}
-262
View File
@@ -1,262 +0,0 @@
import Mock from 'mockjs'
import qs from 'qs'
import { Constant, randomAvatar, waitTime } from './utils'
const { ApiPrefix } = Constant
const usersListData = Mock.mock({
'data|80-100': [
{
id: '@id',
name: '@name',
nickName: '@last',
phone: /^1[34578]\d{9}$/,
'age|11-99': 1,
address: '@county(true)',
isMale: '@boolean',
email: '@email',
createTime: '@datetime',
avatar() {
return randomAvatar()
},
},
],
})
let database = usersListData.data
const EnumRoleType = {
ADMIN: 'admin',
DEFAULT: 'guest',
DEVELOPER: 'developer',
}
const userPermission = {
DEFAULT: {
visit: ['1', '2', '21', '7', '5', '51', '52', '53'],
role: EnumRoleType.DEFAULT,
},
ADMIN: {
role: EnumRoleType.ADMIN,
},
DEVELOPER: {
role: EnumRoleType.DEVELOPER,
},
}
const adminUsers = [
{
id: 0,
username: 'admin',
password: 'admin',
permissions: userPermission.ADMIN,
avatar: randomAvatar(),
},
{
id: 1,
username: 'guest',
password: 'guest',
permissions: userPermission.DEFAULT,
avatar: randomAvatar(),
},
{
id: 2,
username: '吴彦祖',
password: '123456',
permissions: userPermission.DEVELOPER,
avatar: randomAvatar(),
},
]
const queryArray = (array, key, keyAlias = 'key') => {
if (!(array instanceof Array)) {
return null
}
let data
for (let item of array) {
if (item[keyAlias] === key) {
data = item
break
}
}
if (data) {
return data
}
return null
}
const NOTFOUND = {
message: 'Not Found',
documentation_url: 'http://localhost:8000/request',
}
const authorized = (req, res) => {
const cookie = req.headers.cookie || ''
const cookies = qs.parse(cookie.replace(/\s/g, ''), { delimiter: ';' })
if (!cookies.token) {
res.status(401).send({ message: 'Not Login' })
return false
}
const token = JSON.parse(cookies.token)
if (cookies.token && token && token.deadline > new Date().getTime()) {
return token
}
res.status(401).send({ message: 'Not Login' })
return false
}
export default {
async [`POST ${ApiPrefix}/user/login`](req, res) {
await waitTime()
const { username, password } = req.body
const user = adminUsers.filter((item) => item.username === username)
if (user.length > 0 && user[0].password === password) {
const now = new Date()
now.setDate(now.getDate() + 1)
res.cookie(
'token',
JSON.stringify({ id: user[0].id, deadline: now.getTime() }),
{
maxAge: 900000,
httpOnly: true,
}
)
res.json({ success: true, message: 'Ok' })
} else {
res.status(400).end()
}
},
async [`GET ${ApiPrefix}/user/logout`](req, res) {
await waitTime()
res.clearCookie('token')
res.status(200).end()
},
async [`GET ${ApiPrefix}/user`](req, res) {
await waitTime()
const token = authorized(req, res)
if (!token) {
return
}
const userItem = adminUsers.find((_) => _.id === token.id)
if (userItem) {
const { password, ...rest } = userItem
res.json(rest)
} else {
res.status(401).send({ message: 'Not Login' })
}
},
[`GET ${ApiPrefix}/users`](req, res) {
const { query } = req
let { pageSize, page, ...other } = query
pageSize = pageSize || 10
page = page || 1
let newData = database
for (let key in other) {
if ({}.hasOwnProperty.call(other, key)) {
newData = newData.filter((item) => {
if ({}.hasOwnProperty.call(item, key)) {
if (key === 'address') {
return other[key].every((iitem) => item[key].indexOf(iitem) > -1)
} else if (key === 'createTime') {
const start = new Date(other[key][0]).getTime()
const end = new Date(other[key][1]).getTime()
const now = new Date(item[key]).getTime()
if (start && end) {
return now >= start && now <= end
}
return true
}
return (
String(item[key]).trim().indexOf(decodeURI(other[key]).trim()) >
-1
)
}
return true
})
}
}
res.status(200).json({
list: newData.slice((page - 1) * pageSize, page * pageSize),
total: newData.length,
})
},
[`POST ${ApiPrefix}/users/delete`](req, res) {
const { ids = [] } = req.body
database = database.filter((item) => !ids.some((_) => _ === item.id))
res.status(204).end()
},
[`POST ${ApiPrefix}/user`](req, res) {
const newData = req.body
newData.createTime = Mock.mock('@now')
newData.avatar =
newData.avatar ||
Mock.Random.image(
'100x100',
Mock.Random.color(),
'#757575',
'png',
newData.nickName.substr(0, 1)
)
newData.id = Mock.mock('@id')
database.unshift(newData)
res.status(200).end()
},
[`GET ${ApiPrefix}/user/:id`](req, res) {
const { id } = req.params
const data = queryArray(database, id, 'id')
if (data) {
res.status(200).json(data)
} else {
res.status(200).json(NOTFOUND)
}
},
[`DELETE ${ApiPrefix}/user/:id`](req, res) {
const { id } = req.params
const data = queryArray(database, id, 'id')
if (data) {
database = database.filter((item) => item.id !== id)
res.status(204).end()
} else {
res.status(200).json(NOTFOUND)
}
},
[`PATCH ${ApiPrefix}/user/:id`](req, res) {
const { id } = req.params
const editItem = req.body
let isExist = false
database = database.map((item) => {
if (item.id === id) {
isExist = true
return Object.assign({}, item, editItem)
}
return item
})
if (isExist) {
res.status(201).end()
} else {
res.status(200).json(NOTFOUND)
}
},
}
-66
View File
@@ -1,66 +0,0 @@
/**
* Query objects that specify keys and values in an array where all values are objects.
* @param {array} array An array where all values are objects, like [{key:1},{key:2}].
* @param {string} key The key of the object that needs to be queried.
* @param {string} value The value of the object that needs to be queried.
* @return {object|undefined} Return frist object when query success.
*/
export function queryArray(array, key, value) {
if (!Array.isArray(array)) {
return
}
return array.filter((_) => _[key] === value)
}
export function randomNumber(min, max) {
return Math.floor(Math.random() * (max - min) + min)
}
export function randomAvatar() {
const avatarList = [
'photo-1549492864-2ec7d66ffb04.jpeg',
'photo-1480535339474-e083439a320d.jpeg',
'photo-1523419409543-a5e549c1faa8.jpeg',
'photo-1519648023493-d82b5f8d7b8a.jpeg',
'photo-1523307730650-594bc63f9d67.jpeg',
'photo-1522962506050-a2f0267e4895.jpeg',
'photo-1489779162738-f81aed9b0a25.jpeg',
'photo-1534308143481-c55f00be8bd7.jpeg',
'photo-1519336555923-59661f41bb45.jpeg',
'photo-1551438632-e8c7d9a5d1b7.jpeg',
'photo-1525879000488-bff3b1c387cf.jpeg',
'photo-1487412720507-e7ab37603c6f.jpeg',
'photo-1510227272981-87123e259b17.jpeg',
]
return `//image.zuiidea.com/${
avatarList[randomNumber(0, avatarList.length - 1)]
}?imageView2/1/w/200/h/200/format/webp/q/75|imageslim`
}
export const waitTime = (time: number = 300) => {
return new Promise((resolve) => {
setTimeout(() => {
resolve(true)
}, time)
})
}
export const Constant = {
ApiPrefix: '/api/v1',
NotFound: {
message: 'Not Found',
documentation_url: '',
},
Color: {
green: '#64ea91',
blue: '#8fc9fb',
purple: '#d897eb',
red: '#f69899',
yellow: '#f8c82e',
peach: '#f797d6',
borderBase: '#e5e5e5',
borderSplit: '#f4f4f4',
grass: '#d6fbb5',
sky: '#c1e0fc',
},
}
+47 -117
View File
@@ -1,126 +1,56 @@
{
"name": "antd-admin",
"version": "6.0.0-a.1",
"license": "MIT",
"version": "6.0.0",
"description": "An admin dashboard application demo built upon Ant Design and UmiJS",
"license": "MIT",
"scripts": {
"build": "umi build",
"dev": "umi dev",
"test": "jest",
"test:watch": "jest --watch",
"format": "prettier --write .",
"lint": "eslint --ext .ts,.tsx src",
"lint:fix": "eslint --ext .ts,.tsx src --fix",
"start": "npm run dev"
},
"dependencies": {
"@ant-design/icons": "^4.7.0",
"@ant-design/pro-layout": "^6.37.0",
"@lingui/core": "^3.13.3",
"@lingui/detect-locale": "^3.13.3",
"@lingui/react": "^3.13.3",
"antd": "^4.20.1",
"axios": "^0.27.2",
"classnames": "^2.3.1",
"dva-model-extend": "^0.1.2",
"echarts": "^5.3.2",
"echarts-for-react": "^3.0.2",
"echarts-gl": "^2.0.9",
"echarts-liquidfill": "^3.1.0",
"json-format": "^1.0.1",
"lodash": "^4.17.21",
"make-plural": "^7.1.0",
"md5": "^2.3.0",
"nprogress": "^0.2.0",
"path-to-regexp": "^6.2.0",
"prop-types": "^15.8.1",
"qs": "^6.10.3",
"react": "^18.1.0",
"react-countup": "^6.2.0",
"react-dom": "^18.1.0",
"react-helmet": "^6.1.0",
"react-highcharts": "^16.1.0",
"react-perfect-scrollbar": "^1.5.8",
"react-router-dom": "^6.3.0",
"recharts": "^2.1.9",
"store": "^2.0.12"
"@ant-design/icons": "^6.1.0",
"@ant-design/x": "^2.3.0",
"@ant-design/x-sdk": "^2.3.0",
"@umijs/plugins": "^4.6.32",
"antd": "^6.3.2",
"react": "^19.2.4",
"react-dom": "^19.2.4",
"umi": "^4.6.32",
"zustand": "^5.0.0"
},
"devDependencies": {
"@babel/preset-react": "^7.16.7",
"@lingui/babel-preset-react": "^2.9.2",
"@lingui/cli": "^3.13.3",
"@lingui/loader": "^3.13.3",
"@lingui/macro": "^3.13.3",
"@typescript-eslint/eslint-plugin": "^5.21.0",
"@typescript-eslint/parser": "^5.21.0",
"babel-plugin-dev-expression": "^0.2.3",
"babel-plugin-import": "^1.13.5",
"babel-plugin-macros": "^3.1.0",
"babel-plugin-module-resolver": "^4.1.0",
"cross-env": "^7.0.3",
"eslint": "^8.14.0",
"eslint-config-prettier": "^8.5.0",
"eslint-config-react-app": "^7.0.1",
"eslint-plugin-babel": "^5.3.1",
"eslint-plugin-flowtype": "^8.0.3",
"eslint-plugin-import": "^2.26.0",
"eslint-plugin-jsx-a11y": "^6.5.1",
"eslint-plugin-prettier": "^4.0.0",
"eslint-plugin-react": "^7.29.4",
"eslint-plugin-react-hooks": "^4.5.0",
"husky": "^7.0.4",
"less-vars-to-js": "^1.3.0",
"lint-staged": "^12.4.1",
"@testing-library/jest-dom": "^6.1.1",
"@testing-library/react": "^14.0.0",
"@types/jest": "^29.5.3",
"@types/react": "19.2.14",
"@types/react-dom": "^19.2.3",
"@typescript-eslint/eslint-plugin": "^6.9.0",
"@typescript-eslint/parser": "^6.9.0",
"@umijs/test": "^4.6.32",
"eslint": "^8.47.0",
"eslint-config-prettier": "^10.1.8",
"eslint-import-resolver-typescript": "^4.4.4",
"eslint-plugin-import": "^2.29.1",
"eslint-plugin-jsx-a11y": "^6.7.1",
"eslint-plugin-prettier": "^5.1.0",
"eslint-plugin-react": "^7.33.2",
"eslint-plugin-react-hooks": "^4.6.0",
"eslint-plugin-unused-imports": "^2.0.0",
"jest": "^29.6.1",
"mockjs": "^1.1.0",
"prettier": "^2.6.2",
"stylelint": "^14.8.0",
"stylelint-config-prettier": "^9.0.3",
"stylelint-config-standard": "^25.0.0",
"typescript": "^4.6.4",
"umi": "4.0.0-canary.20220429.4"
},
"engines": {
"node": ">= 10.0.0"
},
"lint-staged": {
"*.{ts,tsx,js,jsx}": [
"npm run eslint",
"npm run prettier"
],
"*.less": [
"npm run stylelint",
"npm run prettier"
]
},
"lingui": {
"fallbackLocales": {
"default": "en"
},
"sourceLocale": "en",
"locales": [
"en",
"zh",
"pt-br"
],
"catalogs": [
{
"path": "src/locales/{locale}/messages",
"include": [
"src"
],
"exclude": [
"**/node_modules/**"
]
}
],
"format": "minimal",
"runtimeConfigModule": [
"@/hooks/useIntlProvider",
"i18n"
]
},
"scripts": {
"start": "umi dev",
"build": "cross-env UMI_ENV=prod umi build",
"test": "umi test",
"analyze": "cross-env ANALYZE=1 umi dev",
"eslint": "eslint --fix 'src/**/*.{ts,tsx,js.jsx}'",
"stylelint": "stylelint src/**/*.less --syntax less",
"prettier": "prettier --write 'src/**/*.{ts,tsx,js.jsx,less}'",
"precommit": "lint-staged",
"add-locale": "lingui add-locale",
"extract": "lingui extract",
"trans": "lingui extract --clean && node ./scripts/translate.js",
"doc": "docsify serve docs"
"prettier": "^2.8.8",
"prettier-plugin-organize-imports": "^3.2.2",
"prettier-plugin-packagejson": "^2.4.3",
"ts-jest": "^29.1.0",
"ts-node": "^10.9.2",
"typescript": "^5.9.3",
"jest-environment-jsdom": "^29.6.1",
"jsdom": "^21.1.1"
}
}
-63
View File
@@ -1,63 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- Generator: Adobe Illustrator 19.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="0 0 512 512" style="enable-background:new 0 0 512 512;" xml:space="preserve">
<rect style="fill:#F0F0F0;" width="512" height="512"/>
<g>
<rect y="64" style="fill:#D80027;" width="512" height="64"/>
<rect y="192" style="fill:#D80027;" width="512" height="64"/>
<rect y="320" style="fill:#D80027;" width="512" height="64"/>
<rect y="448" style="fill:#D80027;" width="512" height="64"/>
</g>
<rect style="fill:#2E52B2;" width="256" height="275.69"/>
<g>
<polygon style="fill:#F0F0F0;" points="51.518,115.318 45.924,132.529 27.826,132.529 42.469,143.163 36.875,160.375
51.518,149.741 66.155,160.375 60.56,143.163 75.203,132.529 57.106,132.529 "/>
<polygon style="fill:#F0F0F0;" points="57.106,194.645 51.518,177.434 45.924,194.645 27.826,194.645 42.469,205.279
36.875,222.49 51.518,211.857 66.155,222.49 60.56,205.279 75.203,194.645 "/>
<polygon style="fill:#F0F0F0;" points="51.518,53.202 45.924,70.414 27.826,70.414 42.469,81.047 36.875,98.259 51.518,87.625
66.155,98.259 60.56,81.047 75.203,70.414 57.106,70.414 "/>
<polygon style="fill:#F0F0F0;" points="128.003,115.318 122.409,132.529 104.311,132.529 118.954,143.163 113.36,160.375
128.003,149.741 142.64,160.375 137.045,143.163 151.689,132.529 133.591,132.529 "/>
<polygon style="fill:#F0F0F0;" points="133.591,194.645 128.003,177.434 122.409,194.645 104.311,194.645 118.954,205.279
113.36,222.49 128.003,211.857 142.64,222.49 137.045,205.279 151.689,194.645 "/>
<polygon style="fill:#F0F0F0;" points="210.076,194.645 204.489,177.434 198.894,194.645 180.797,194.645 195.44,205.279
189.845,222.49 204.489,211.857 219.125,222.49 213.531,205.279 228.174,194.645 "/>
<polygon style="fill:#F0F0F0;" points="204.489,115.318 198.894,132.529 180.797,132.529 195.44,143.163 189.845,160.375
204.489,149.741 219.125,160.375 213.531,143.163 228.174,132.529 210.076,132.529 "/>
<polygon style="fill:#F0F0F0;" points="128.003,53.202 122.409,70.414 104.311,70.414 118.954,81.047 113.36,98.259
128.003,87.625 142.64,98.259 137.045,81.047 151.689,70.414 133.591,70.414 "/>
<polygon style="fill:#F0F0F0;" points="204.489,53.202 198.894,70.414 180.797,70.414 195.44,81.047 189.845,98.259
204.489,87.625 219.125,98.259 213.531,81.047 228.174,70.414 210.076,70.414 "/>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 2.7 KiB

-23
View File
@@ -1,23 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 19.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="-49 141 512 512" style="enable-background:new -49 141 512 512;" xml:space="preserve">
<style type="text/css">
.st0{fill:#D80027;}
.st1{fill:#FFDA44;}
</style>
<rect x="-49" y="141" class="st0" width="512" height="512"/>
<g>
<polygon class="st1" points="91.1,296.8 113.2,364.8 184.7,364.8 126.9,406.9 149,474.9 91.1,432.9 33.2,474.9 55.4,406.9
-2.5,364.8 69,364.8 "/>
<polygon class="st1" points="254.5,537.5 237.6,516.7 212.6,526.4 227.1,503.9 210.2,483 236.1,489.9 250.7,467.4 252.1,494.2
278.1,501.1 253,510.7 "/>
<polygon class="st1" points="288.1,476.5 296.1,450.9 274.2,435.4 301,435 308.9,409.4 317.6,434.8 344.4,434.5 322.9,450.5
331.5,475.9 309.6,460.4 "/>
<polygon class="st1" points="333.4,328.9 321.6,353 340.8,371.7 314.3,367.9 302.5,391.9 297.9,365.5 271.3,361.7 295.1,349.2
290.5,322.7 309.7,341.4 "/>
<polygon class="st1" points="255.2,255.9 253.2,282.6 278.1,292.7 252,299.1 250.1,325.9 236,303.1 209.9,309.5 227.2,289
213,266.3 237.9,276.4 "/>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 1.3 KiB

-40
View File
@@ -1,40 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- Generator: Adobe Illustrator 19.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<svg version="1.1" id="Capa_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
viewBox="0 0 512 512" style="enable-background:new 0 0 512 512;" xml:space="preserve">
<rect style="fill:#D80027;" width="512" height="512"/>
<polygon style="fill:#6DA544;" points="196.641,0 196.641,264.348 196.641,512 0,512 0,0 "/>
<circle style="fill:#FFDA44;" cx="196.641" cy="256" r="96"/>
<path style="fill:#D80027;" d="M142.638,208v60c0,29.823,24.178,54,54,54s54-24.178,54-54v-60H142.638z"/>
<path style="fill:#F0F0F0;" d="M196.638,286c-9.925,0-18-8.075-18-18v-24.001h36V268C214.638,277.925,206.563,286,196.638,286z"/>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
<g>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 973 B

View File
-114
View File
@@ -1,114 +0,0 @@
/**
* Youdao Translate, My private account is for testing purposes only.
* Please go to the official account to apply for an account. Thank you for your cooperation.
* APP ID:055c2d71f9a05214
* Secret key:ZcpuQxQW3NkQeKVkqrXIKQYXH57g2KuN
*/
/* eslint-disable */
const md5 = require('md5')
const qs = require('qs')
const fs = require('fs')
const path = require('path')
const axios = require('axios')
const jsonFormat = require('json-format')
const { i18n } = require('../src/utils/config')
const { languages, defaultLanguage } = i18n
const locales = {}
languages.forEach(item => {
locales[item.key] = require(`../src/locales/${item.key}/messages.json`)
})
const youdao = ({ q, from, to }) =>
new Promise((resolve, reject) => {
{
const appid = '055c2d71f9a05214'
const appse = 'ZcpuQxQW3NkQeKVkqrXIKQYXH57g2KuN'
const salt = Date.now()
const sign = md5(appid + q + salt + appse)
const query = qs.stringify({
q,
from,
to,
appKey: appid,
salt,
sign,
})
axios.get(`http://openapi.youdao.com/api?${query}`).then(({ data }) => {
if (data.query && data.translation[0]) {
resolve(data.translation[0])
} else {
resolve(q)
}
})
}
})
const transform = async ({ from, to, locales, outputPath }) => {
for (const key in locales[from]) {
if (locales[to][key]) {
console.log(`add to skip: ${key}`)
} else {
let res = key
let way = 'youdao'
if (key.indexOf('/') !== 0) {
const reg = '{([^{}]*)}'
const tasks = key
.match(new RegExp(`${reg}|((?<=(${reg}|^)).*?(?=(${reg}|$)))`, 'g'))
.map(item => {
if (new RegExp(reg).test(item)) {
return Promise.resolve(item)
}
return youdao({
q: item,
from,
to,
})
})
res = (await Promise.all(tasks)).join('')
} else {
res = `/${to + key}`
way = 'link'
}
if (res !== key) {
locales[to][key] = res
console.log(`${way}: ${from} -> ${to}: ${key} -> ${res}`)
} else {
console.log(`same: ${from} -> ${to}: ${key}`)
}
}
}
await fs.writeFileSync(
path.resolve(__dirname, outputPath),
jsonFormat(locales[to], {
type: 'space',
size: 2,
})
)
}
;(async () => {
const tasks = languages
.map(item => ({
from: defaultLanguage,
to: item.key,
}))
.filter(item => item.from !== item.to)
for (const item of tasks) {
console.log(`start: ${item.from} -> ${item.to}`)
await transform({
from: item.from,
to: item.to,
locales,
outputPath: `../src/locales/${item.to}/messages.json`,
})
console.log(`completed: ${item.from} -> ${item.to}`)
}
console.log('All translations have been completed.')
})()
+82
View File
@@ -0,0 +1,82 @@
import { ConfigProvider } from 'antd';
import 'antd/dist/reset.css';
import enUS from 'antd/locale/en_US';
import zhCN from 'antd/locale/zh_CN';
import React, { useEffect, useState } from 'react';
import AuthGate from './components/AuthGate';
function LocaleWrapper({ children }: { children: React.ReactElement }) {
// read initial locale synchronously so Antd has correct locale on first render
const pick = (l: string | null) => {
if (l === 'zh-CN') return zhCN;
return enUS;
};
let initial: typeof zhCN | typeof enUS | undefined = undefined;
const stored = window.localStorage.getItem('umi_locale') || null;
initial = pick(stored);
const [locale, setLocale] = useState<typeof zhCN | typeof enUS | undefined>(
initial,
);
useEffect(() => {
const read = () => {
let l: string | null = null;
try {
l = window.localStorage.getItem('umi_locale') || null;
} catch (e) {
l = null;
}
setLocale(pick(l));
};
const onStorage = (ev: StorageEvent) => {
if (ev.key === 'umi_locale') read();
};
const onLocaleChange = (ev: Event) => {
// CustomEvent used by TopbarControls with detail = locale string
const possible = ev as CustomEvent | Event;
if (possible && typeof (possible as CustomEvent).detail !== 'undefined') {
const d = (possible as CustomEvent).detail;
if (d) setLocale(pick(String(d)));
}
};
window.addEventListener('storage', onStorage);
window.addEventListener('localechange', onLocaleChange as EventListener);
return () => {
window.removeEventListener('storage', onStorage);
window.removeEventListener(
'localechange',
onLocaleChange as EventListener,
);
};
}, []);
return <ConfigProvider locale={locale}>{children}</ConfigProvider>;
}
export function rootContainer(container: React.ReactElement) {
return (
<LocaleWrapper>
<AuthGate>{container}</AuthGate>
</LocaleWrapper>
);
}
// ensure mobile viewport meta exists (adds meta tag if not present)
try {
if (typeof window !== 'undefined') {
const hasVp = document.querySelector('meta[name="viewport"]');
if (!hasVp) {
const m = document.createElement('meta');
m.name = 'viewport';
m.content = 'width=device-width,initial-scale=1,maximum-scale=1';
document.head.appendChild(m);
}
}
} catch (e) {
// ignore in non-DOM environments
}
+63
View File
@@ -0,0 +1,63 @@
import { Spin } from 'antd';
import React, { useEffect, useState } from 'react';
import { history } from 'umi';
import useGlobalSync from '@/hooks/useGlobalSync';
import useIsMounted from '@/hooks/useIsMounted';
import adminService from '../services/admin';
import useGlobalStore from '../store/useGlobalStore';
export default function AuthGate({ children }: { children: React.ReactNode }) {
const isLoggedIn = useGlobalSync((s) => s.isLoggedIn);
const [loading, setLoading] = useState(true);
const isMounted = useIsMounted();
useEffect(() => {
(async () => {
try {
const admin = (await adminService.currentAdmin()) as
| import('@/types/admin').Admin
| undefined;
if (!isMounted()) return;
if (admin) {
useGlobalStore.getState().login();
useGlobalStore.getState().setCurrentUser(admin);
} else {
useGlobalStore.getState().logout();
}
} catch (e) {
useGlobalStore.getState().logout();
} finally {
if (isMounted()) setLoading(false);
}
})();
}, [isMounted]);
useEffect(() => {
const path = history.location.pathname;
if (!isLoggedIn && path !== '/login') {
history.replace('/login');
}
if (isLoggedIn && path === '/login') {
history.replace('/');
}
}, [isLoggedIn]);
if (loading) {
return (
<div
style={{
minHeight: '100vh',
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
}}
>
<Spin size="large" />
</div>
);
}
return <>{children}</>;
}
+64
View File
@@ -0,0 +1,64 @@
import { fireEvent, render, screen } from '@testing-library/react';
import React from 'react';
import DropOption from './DropOption';
// Mock antd Dropdown to expose menu items for testing
jest.mock('antd', () => {
return {
Dropdown: ({ menu, children }: any) =>
React.createElement(
'div',
null,
React.createElement('div', { 'data-testid': 'trigger' }, children),
React.createElement(
'div',
{ 'data-testid': 'menu' },
menu?.items?.map((it: any) =>
React.createElement(
'button',
{
key: it.key,
'data-key': it.key,
onClick: () => menu.onClick?.({ key: it.key }),
},
typeof it.label === 'string'
? it.label
: React.createElement('span', null, it.label),
),
),
),
),
};
});
jest.mock('@ant-design/icons', () => ({
BarsOutlined: () => React.createElement('span', null, 'Bars'),
DownOutlined: () => React.createElement('span', null, 'Down'),
}));
test('renders default trigger when no children provided', () => {
render(<DropOption menuOptions={[]} />);
const trigger = screen.getByTestId('trigger');
// default trigger in component is an <a>
expect(trigger.querySelector('a')).toBeTruthy();
});
test('wraps plain text children in a span', () => {
render(<DropOption menuOptions={[]}>PlainChild</DropOption>);
const trigger = screen.getByTestId('trigger');
expect(screen.getByText('PlainChild')).toBeTruthy();
expect(trigger.firstElementChild?.tagName.toLowerCase()).toBe('span');
});
test('clicking menu item calls onMenuClick with key', () => {
const onMenuClick = jest.fn();
render(
<DropOption
menuOptions={[{ key: 'one', label: 'One' }]}
onMenuClick={onMenuClick}
/>,
);
const item = screen.getByText('One');
fireEvent.click(item);
expect(onMenuClick).toHaveBeenCalledWith('one');
});
+48
View File
@@ -0,0 +1,48 @@
import { BarsOutlined, DownOutlined } from '@ant-design/icons';
import { Dropdown } from 'antd';
import React from 'react';
type Option = { key: string; label: React.ReactNode };
interface DropOptionProps {
menuOptions: Option[];
onMenuClick?: (key: string) => void;
children?: React.ReactNode;
}
const DropOption: React.FC<DropOptionProps> = ({
menuOptions,
onMenuClick,
children,
}) => {
const items = menuOptions.map((o) => ({ key: o.key, label: o.label }));
const menu = {
items,
onClick: ({ key }: { key: string }) => onMenuClick?.(key),
};
// ensure Dropdown receives a single React element as child
let triggerNode: React.ReactElement;
if (React.Children.count(children) === 1 && React.isValidElement(children)) {
triggerNode = children as React.ReactElement;
} else if (children) {
// wrap non-element children (like plain text) in a span
triggerNode = <span>{children}</span>;
} else {
triggerNode = (
<a onClick={(e) => e.preventDefault()}>
<BarsOutlined style={{ marginRight: 2 }} />
<DownOutlined />
</a>
);
}
return (
<Dropdown menu={menu} trigger={['click']}>
{triggerNode}
</Dropdown>
);
};
export default DropOption;
-17
View File
@@ -1,17 +0,0 @@
.filterItem {
display: flex;
justify-content: space-between;
.labelWrap {
width: 64px;
line-height: 28px;
margin-right: 12px;
justify-content: space-between;
display: flex;
overflow: hidden;
}
.item {
flex: 1;
}
}
-25
View File
@@ -1,25 +0,0 @@
import React from 'react'
import styles from './index.less'
interface FilterItemProps {
label: string
}
const FilterItem: React.FC<FilterItemProps> = ({ label = '', children }) => {
const labelArray = label.split('')
return (
<div className={styles.filterItem}>
{labelArray.length > 0 && (
<div className={styles.labelWrap}>
{labelArray.map((item, index) => (
<span className="labelText" key={index}>
{item}
</span>
))}
</div>
)}
<div className={styles.item}>{children}</div>
</div>
)
}
export default FilterItem
+34
View File
@@ -0,0 +1,34 @@
import React from 'react';
interface LinkItem {
title: string;
href: string;
}
interface GlobalFooterProps {
links?: LinkItem[];
copyright?: React.ReactNode;
className?: string;
}
const GlobalFooter: React.FC<GlobalFooterProps> = ({
links = [],
copyright,
}) => {
return (
<footer style={{ textAlign: 'center', padding: '24px 0', color: '#666' }}>
{links.length > 0 && (
<div style={{ marginBottom: 8 }}>
{links.map((l, i) => (
<a key={i} href={l.href} style={{ margin: '0 8px' }}>
{l.title}
</a>
))}
</div>
)}
<div>{copyright ?? `© ${new Date().getFullYear()}`}</div>
</footer>
);
};
export default GlobalFooter;
-29
View File
@@ -1,29 +0,0 @@
@import '~antd/lib/style/themes/default.less';
.globalFooter {
margin: 48px 0 24px 0;
padding: 0 16px;
text-align: center;
.links {
margin-bottom: 8px;
a {
color: @text-color-secondary;
transition: all 0.3s;
&:not(:last-child) {
margin-right: 16px;
}
&:hover {
color: @text-color;
}
}
}
.copyright {
color: @text-color-secondary;
font-size: @font-size-base;
}
}
-40
View File
@@ -1,40 +0,0 @@
import React from 'react'
import styles from './index.less'
interface LinkItem {
key: string
title: React.ReactNode
href?: string
blankTarget?: boolean
}
interface GlobalFooterProps {
links?: LinkItem[]
copyright?: React.ReactNode
}
const GlobalFooter: React.FC<GlobalFooterProps> = ({
links = [],
copyright,
}) => {
return (
<footer className={styles.globalFooter}>
<div className={styles.links}>
{links.map((link) => (
<a
key={link.key}
title={link.key}
target={link.blankTarget ? '_blank' : '_self'}
href={link.href}
rel="noreferrer"
>
{link.title}
</a>
))}
</div>
{copyright && <div className={styles.copyright}>{copyright}</div>}
</footer>
)
}
export default GlobalFooter
+33
View File
@@ -0,0 +1,33 @@
import {
AppstoreOutlined,
HomeOutlined,
InfoCircleOutlined,
ProfileOutlined,
RobotOutlined,
SettingOutlined,
TeamOutlined,
ToolOutlined,
UserAddOutlined,
UserOutlined,
} from '@ant-design/icons';
import React from 'react';
export const ICON_MAP: Record<string, React.ReactNode> = {
home: <HomeOutlined />,
'info-c': <InfoCircleOutlined />,
user: <UserOutlined />,
team: <TeamOutlined />,
profile: <ProfileOutlined />,
'user-add': <UserAddOutlined />,
settings: <SettingOutlined />,
tool: <ToolOutlined />,
robot: <RobotOutlined />,
'app-store': <AppstoreOutlined />,
};
export function Icon({ name }: { name?: string }) {
if (!name) return null;
return ICON_MAP[name] || null;
}
export default Icon;
-67
View File
@@ -1,67 +0,0 @@
.loader {
background-color: #fff;
width: 100%;
position: absolute;
top: 0;
bottom: 0;
left: 0;
z-index: 100000;
display: flex;
justify-content: center;
align-items: center;
opacity: 1;
text-align: center;
&.fullScreen {
position: fixed;
}
.warpper {
width: 100px;
height: 100px;
display: inline-flex;
flex-direction: column;
justify-content: space-around;
}
.inner {
width: 40px;
height: 40px;
margin: 0 auto;
text-indent: -12345px;
border-top: 1px solid rgba(0, 0, 0, 0.08);
border-right: 1px solid rgba(0, 0, 0, 0.08);
border-bottom: 1px solid rgba(0, 0, 0, 0.08);
border-left: 1px solid rgba(0, 0, 0, 0.7);
border-radius: 50%;
z-index: 100001;
:local {
animation: spinner 600ms infinite linear;
}
}
.text {
width: 100px;
height: 20px;
text-align: center;
font-size: 12px;
letter-spacing: 4px;
color: #000;
}
&.hidden {
z-index: -1;
opacity: 0;
transition: opacity 1s ease 0.5s, z-index 0.1s ease 1.5s;
}
}
@keyframes spinner {
0% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
-26
View File
@@ -1,26 +0,0 @@
import React from 'react'
import classNames from 'classnames'
import styles from './index.less'
interface LoaderProps {
spinning?: boolean
fullScreen?: boolean
}
const Loader: React.FC<LoaderProps> = ({ spinning = false, fullScreen }) => {
return (
<div
className={classNames(styles.loader, {
[styles.hidden]: !spinning,
[styles.fullScreen]: fullScreen,
})}
>
<div className={styles.warpper}>
<div className={styles.inner} />
<div className={styles.text}>LOADING</div>
</div>
</div>
)
}
export default Loader
-16
View File
@@ -1,16 +0,0 @@
@import '~@/themes/vars.less';
.contentInner {
background: #fff;
padding: 24px;
box-shadow: @shadow-1;
min-height: ~'calc(100vh - 230px)';
position: relative;
}
@media (max-width: 767px) {
.contentInner {
padding: 12px;
min-height: ~'calc(100vh - 160px)';
}
}
-32
View File
@@ -1,32 +0,0 @@
import React from 'react'
import classnames from 'classnames'
import Loader from '../Loader'
import styles from './index.less'
interface IPageProps {
inner?: boolean
loading?: boolean
className?: string
}
const Page: React.FC = (props: IPageProps) => {
const { className, children, loading = false, inner = false } = props
const loadingStyle = {
height: 'calc(100vh - 184px)',
overflow: 'hidden',
}
return (
<div
className={classnames(className, {
[styles.contentInner]: inner,
})}
style={loading ? loadingStyle : null}
>
{loading ? <Loader spinning /> : ''}
{children}
</div>
)
}
export default Page
-31
View File
@@ -1,31 +0,0 @@
:global {
.ps--active-x > .ps__rail-x,
.ps--active-y > .ps__rail-y {
background-color: transparent;
}
.ps__rail-x:hover > .ps__thumb-x,
.ps__rail-x:focus > .ps__thumb-x {
height: 8px;
}
.ps__rail-y:hover > .ps__thumb-y,
.ps__rail-y:focus > .ps__thumb-y {
width: 8px;
}
.ps__rail-y,
.ps__rail-x {
z-index: 9;
}
.ps__thumb-y {
width: 4px;
right: 4px;
}
.ps__thumb-x {
height: 4px;
bottom: 4px;
}
}
-5
View File
@@ -1,5 +0,0 @@
import ScrollBar from 'react-perfect-scrollbar'
import 'react-perfect-scrollbar/dist/css/styles.css'
import './index.less'
export default ScrollBar
+138
View File
@@ -0,0 +1,138 @@
import useGlobalSync from '@/hooks/useGlobalSync';
import {
BulbOutlined,
FullscreenExitOutlined,
FullscreenOutlined,
GlobalOutlined,
UserOutlined,
} from '@ant-design/icons';
import { Avatar, Button, Dropdown, Tooltip, type MenuProps } from 'antd';
import { useEffect, useState } from 'react';
import { setLocale as setUmiLocale } from 'umi';
type Props = {
goProfile?: () => void;
onLogout?: () => void;
};
export default function TopbarControls({ goProfile, onLogout }: Props) {
const [isFullscreen, setIsFullscreen] = useState(false);
const [darkMode, setDarkMode] = useState(false);
const currentAdmin = useGlobalSync((s) => s.currentAdmin);
const isLoggedIn = useGlobalSync((s) => s.isLoggedIn);
useEffect(() => {
const dm = localStorage.getItem('app-dark-mode');
if (dm === 'true') {
setDarkMode(true);
document.documentElement.classList.add('dark-mode');
}
const onFs = () => setIsFullscreen(!!document.fullscreenElement);
document.addEventListener('fullscreenchange', onFs);
return () => document.removeEventListener('fullscreenchange', onFs);
}, []);
const toggleFullscreen = async () => {
try {
if (!document.fullscreenElement)
await document.documentElement.requestFullscreen();
else await document.exitFullscreen();
} catch (e) {
void 0;
}
};
const toggleDarkMode = () => {
const next = !darkMode;
setDarkMode(next);
if (next) document.documentElement.classList.add('dark-mode');
else document.documentElement.classList.remove('dark-mode');
localStorage.setItem('app-dark-mode', String(next));
};
const changeLocale = (l: string) => {
try {
// ensure umi locale stored, then notify app to update Antd locale immediately
setUmiLocale(l, true);
localStorage.setItem('umi_locale', l);
window.dispatchEvent(new CustomEvent('localechange', { detail: l }));
} catch (e) {
window.location.reload();
}
};
const localeMenuItems: MenuProps['items'] = [
{ key: 'en-US', label: 'English' },
{ key: 'zh-CN', label: '中文' },
];
const profileMenuItems: MenuProps['items'] = [
{ key: 'profile', label: '个人信息' },
{ key: 'logout', label: '注销' },
];
const handleProfileClick = (key: string) => {
if (key === 'profile') {
goProfile && goProfile();
} else if (key === 'logout') {
onLogout && onLogout();
}
};
return (
<div style={{ display: 'flex', alignItems: 'center', gap: 12 }}>
<Tooltip title={isFullscreen ? '退出全屏' : '全屏'}>
<Button
type="text"
onClick={toggleFullscreen}
icon={
isFullscreen ? <FullscreenExitOutlined /> : <FullscreenOutlined />
}
/>
</Tooltip>
<Tooltip title={darkMode ? '浅色模式' : '暗黑模式'}>
<Button type="text" onClick={toggleDarkMode} icon={<BulbOutlined />} />
</Tooltip>
<Dropdown
menu={{
items: localeMenuItems,
onClick: ({ key }) => changeLocale(String(key)),
}}
placement="bottomRight"
>
<Button type="text" icon={<GlobalOutlined />} />
</Dropdown>
{isLoggedIn && currentAdmin ? (
<Dropdown
menu={{
items: profileMenuItems,
onClick: ({ key }) => handleProfileClick(String(key)),
}}
placement="bottomRight"
>
<div
style={{
display: 'flex',
alignItems: 'center',
gap: 8,
cursor: 'pointer',
}}
>
<Avatar
size={20}
src={currentAdmin.avatar}
icon={!currentAdmin.avatar ? <UserOutlined /> : undefined}
/>
<span style={{ color: 'inherit' }}>
{currentAdmin.real_name || currentAdmin.username}
</span>
</div>
</Dropdown>
) : null}
</div>
);
}
-7
View File
@@ -1,7 +0,0 @@
import FilterItem from './FilterItem'
import Loader from './Loader'
import ScrollBar from './ScrollBar'
import GlobalFooter from './GlobalFooter'
import Page from './Page'
export { GlobalFooter, FilterItem, Loader, ScrollBar, Page }
-1
View File
@@ -1 +0,0 @@
export const LOCALE_LANGUAGE = 'LOCALE_LANGUAGE'
-33
View File
@@ -1,33 +0,0 @@
import { IConfig, ISupportedLocales } from '@/typings'
import { LOCALE_LANGUAGE } from '@/configs/constants'
import checkLanguage from '@/utils/checkLanguage'
import {
detect,
fromUrl,
fromStorage,
fromNavigator,
} from '@lingui/detect-locale'
const language = detect(
checkLanguage(fromUrl('lang')),
checkLanguage(fromStorage(LOCALE_LANGUAGE)),
checkLanguage(fromNavigator()),
'en'
)
export const config: IConfig = {
title: 'Antd Admin',
logo: 'logo.svg',
copyright: 'Ant Design Admin © 2021 zuiidea',
language: language as ISupportedLocales,
apiPrefix: '/api/v1',
/* Layout configuration, specify which layout to use for route. */
layouts: [
{
name: 'primary',
include: [/.*/],
exlude: [/\/login/],
},
],
}
-8
View File
@@ -1,8 +0,0 @@
import menus from './menus'
import menuIcon from './menus/icon'
export * from './default'
export * from './languages'
export * from './constants'
export { menus, menuIcon }
-32
View File
@@ -1,32 +0,0 @@
import { ILanguage, ILanguages, IAntdI18nMap } from '@/typings'
/**
* Countrys flags: https://www.flaticon.com/packs/countrys-flags
*/
export const language: ILanguage = {
en: {
flag: '/america.svg',
value: 'English',
},
zh: {
flag: '/china.svg',
value: '简体中文',
},
'pt-br': {
flag: '/portugal.svg',
value: 'Português',
},
}
export const languages: ILanguages[] = Object.entries(language).map(
([key, value]: any) => ({
key,
...value,
})
)
export const antdI18nMap: IAntdI18nMap = {
zh: 'zh_CN',
en: 'en_US',
'pt-br': 'pt_BR',
}
-34
View File
@@ -1,34 +0,0 @@
import {
PayCircleOutlined,
ShoppingCartOutlined,
MessageOutlined,
TeamOutlined,
UserOutlined,
DashboardOutlined,
ApiOutlined,
CameraOutlined,
EditOutlined,
CodeOutlined,
LineOutlined,
BarChartOutlined,
AreaChartOutlined,
} from '@ant-design/icons'
import { IMenuIcon } from '@/typings'
const menuIcon: IMenuIcon = {
'pay-circle-o': <PayCircleOutlined />,
'shopping-cart': <ShoppingCartOutlined />,
'camera-o': <CameraOutlined />,
'line-chart': <LineOutlined />,
'code-o': <CodeOutlined />,
'area-chart': <AreaChartOutlined />,
'bar-chart': <BarChartOutlined />,
message: <MessageOutlined />,
team: <TeamOutlined />,
dashboard: <DashboardOutlined />,
user: <UserOutlined />,
api: <ApiOutlined />,
edit: <EditOutlined />,
}
export default menuIcon
-22
View File
@@ -1,22 +0,0 @@
import { t } from '@lingui/macro'
/*
* Note:
* Menu items with children need to set a key starting with "/"
* @see https://github.com/umijs/route-utils/blob/master/src/transformRoute/transformRoute.ts#L219
*/
const menus = [
{
path: '/',
name: t`Dashboard`,
icon: 'dashboard',
},
{
path: '/user',
name: t`User`,
icon: 'user',
},
]
export default menus
-8
View File
@@ -1,8 +0,0 @@
import { SettingDrawerProps } from '@ant-design/pro-layout'
const defaultSettings: SettingDrawerProps['settings'] = {
navTheme: 'light',
primaryColor: '#006EFF',
}
export default defaultSettings
-41
View File
@@ -1,41 +0,0 @@
import puppeteer from 'puppeteer'
describe('Login', () => {
let browser
let page
beforeAll(async () => {
browser = await puppeteer.launch({ args: ['--no-sandbox'] })
})
beforeEach(async () => {
page = await browser.newPage()
await page.goto('http://localhost:8000/en/login', {
waitUntil: 'networkidle2',
})
})
afterEach(() => page.close())
it('should login with failure', async () => {
await page.waitFor((selector) => !!document.querySelector('#username'), {
timeout: 3000,
})
await page.type('#username', 'wrong_user')
await page.type('#password', 'wrong_password')
await page.click('button[type="button"]')
await page.waitForSelector('.anticon-close-circle') // should display error
})
it('should login successfully', async () => {
await page.waitForSelector('#username', { timeout: 3000 })
await page.type('#username', 'admin')
await page.type('#password', 'admin')
await page.click('button[type="button"]')
await page.waitForSelector('.ant-layout-footer')
const text = await page.evaluate(() => document.body.innerHTML)
expect(text).toContain('Ant Design Admin')
})
afterAll(() => browser.close())
})
-16
View File
@@ -1,16 +0,0 @@
import { useNavigate, useLocation } from 'react-router-dom';
import { useLingui } from '@lingui/react';
import useConfig from './useConfig'
import useIntlProvider from './useIntlProvider'
import useLocalStorage from './useLocalStorage';
import useRequest from './useRequest';
export {
useConfig,
useNavigate,
useLocation,
useRequest,
useLocalStorage,
useIntlProvider,
useLingui,
}
-8
View File
@@ -1,8 +0,0 @@
import { useContext } from 'react'
import { ConfigContext } from '@/utils/context'
const useConfig = () => {
return useContext(ConfigContext)
}
export default useConfig
+17
View File
@@ -0,0 +1,17 @@
import type { GlobalState } from '@/store/useGlobalStore';
import useGlobalStore from '@/store/useGlobalStore';
import { useSyncExternalStore } from 'react';
type Selector<T> = (s: GlobalState) => T;
export default function useGlobalSync<T>(selector: Selector<T>) {
return useSyncExternalStore(
(listener: () => void) => {
// subscribe returns unsubscribe
const unsub = useGlobalStore.subscribe(listener);
return unsub;
},
() => selector(useGlobalStore.getState()),
() => selector(useGlobalStore.getState()),
);
}
-47
View File
@@ -1,47 +0,0 @@
import { useEffect, useContext, useState } from 'react';
import { setupI18n } from '@lingui/core';
import { LOCALE_LANGUAGE } from '@/configs/constants';
import { ConfigContext } from '@/utils/context';
import { useLocalStorage } from '@/hooks';
import { antdI18nMap } from '@/configs';
import { SupportedLocales } from '@/typings';
import { ConfigProviderProps } from 'antd/lib/config-provider';
import { en, zh } from 'make-plural/plurals';
export const i18n = setupI18n({
localeData: {
en: { plurals: en },
zh: { plurals: zh },
},
});
const useIntlProvider = () => {
const { language: defaultLocale } = useContext(ConfigContext);
const [language, setLanguage] = useLocalStorage<SupportedLocales>(
LOCALE_LANGUAGE,
defaultLocale
);
const [locale, setLocale] = useState<ConfigProviderProps['locale']>();
useEffect(() => {
import(`@/locales/${language}/messages.json`).then(data => {
i18n.load(language, data.default);
i18n.activate(language);
});
const path = antdI18nMap[language];
import(`antd/lib/locale/${path}.js`).then(data => {
setLocale(data.default);
});
}, [language]);
return {
language,
setLanguage,
locale,
i18n,
};
};
export default useIntlProvider;
+13
View File
@@ -0,0 +1,13 @@
import { useCallback, useEffect, useRef } from 'react';
// Simple hook that returns a stable function to check mounted state
export default function useIsMounted(): () => boolean {
const ref = useRef(true);
useEffect(() => {
ref.current = true;
return () => {
ref.current = false;
};
}, []);
return useCallback(() => ref.current, []);
}
-29
View File
@@ -1,29 +0,0 @@
import { useState } from 'react';
const useLocalStorage = <T>(
key: string,
initialValue?: T
): [T, (value: T) => void] => {
let defaultValue = initialValue;
try {
const item = window.localStorage.getItem(key);
defaultValue = item ? JSON.parse(item) : initialValue;
} catch (error) {
defaultValue = initialValue;
}
const [state, setState] = useState(defaultValue as T);
const setValue = (value: T) => {
try {
const valueToStore = value instanceof Function ? value(state) : value;
setState(valueToStore);
window.localStorage.setItem(key, JSON.stringify(valueToStore));
} catch (error) {
console.log(error);
}
};
return [state, setValue];
};
export default useLocalStorage;
-56
View File
@@ -1,56 +0,0 @@
import { useEffect, useState, useCallback } from 'react'
interface Options<R, P, RR> {
onSuccess?: (data: R, params?: P) => void
onError?: (e: Error, params?: P) => void
formatResult?: (data: RR) => R
manual?: boolean
initialData?: R
}
const useFetch = <R = any, P = any, RR = any>(
service: any,
options: Options<R, P, RR>
) => {
const { initialData, manual, formatResult, onSuccess, onError } = options
const [loading, setLoading] = useState<boolean>(false)
const [data, setData] = useState<R>(initialData as R)
const [error, setError] = useState<any>(null)
const run = useCallback(
(params?: P) => {
setLoading(true)
return service(params)
.then((result) => {
const resultData = formatResult ? formatResult(result) : result
setData(resultData)
onSuccess && onSuccess(resultData, params)
})
.catch((result) => {
setError(result || new Error())
onError && onError(result, params)
})
.finally(() => {
setLoading(false)
})
},
[formatResult, onError, onSuccess, service]
)
useEffect(() => {
if (manual) {
return
}
run()
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [])
return {
run,
data,
error,
loading,
}
}
export default useFetch
-30
View File
@@ -1,30 +0,0 @@
import { config } from '@/configs/default'
import { setupI18n, I18n } from '@lingui/core'
import { en, zh, pt } from 'make-plural/plurals'
import { messages as zhMessages } from '@/locales/zh/messages.po'
import { messages as enMessages } from '@/locales/en/messages.po'
import { messages as ptMessages } from '@/locales/pt-br/messages.po'
const i18nBase: I18n = setupI18n()
i18nBase.loadLocaleData({
en: {
plurals: en,
},
zh: {
plurals: zh,
},
'pt-br': {
plurals: pt,
},
})
i18nBase.load({
zh: zhMessages,
en: enMessages,
'pt-br': ptMessages,
})
i18nBase.activate(config.language)
export const i18n = i18nBase
-74
View File
@@ -1,74 +0,0 @@
@import '~@/themes/vars.less';
@import '~@/themes/index.less';
:global {
#nprogress {
pointer-events: none;
.bar {
position: fixed;
top: 0;
right: 0;
left: 0;
z-index: 2048;
width: 100%;
height: 2px;
background: @primary-color;
}
.peg {
position: absolute;
right: 0;
display: block;
width: 100px;
height: 100%;
box-shadow: 0 0 10px @primary-color, 0 0 5px @primary-color;
transform: rotate(3deg) translate(0, -4px);
opacity: 1;
}
.spinner {
position: fixed;
top: 15px;
right: 15px;
z-index: 1031;
display: block;
}
.spinner-icon {
box-sizing: border-box;
width: 18px;
height: 18px;
border: solid 2px transparent;
border-top-color: @primary-color;
border-left-color: @primary-color;
border-radius: 50%;
:local {
animation: nprogress-spinner 400ms linear infinite;
}
}
}
.nprogress-custom-parent {
position: relative;
overflow: hidden;
#nprogress {
.bar,
.spinner {
position: absolute;
}
}
}
}
@keyframes nprogress-spinner {
0% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
+29 -19
View File
@@ -1,21 +1,31 @@
import React from 'react'
import { useLocation } from '@/hooks'
import { queryLayout } from '@/utils'
import { config } from '@/configs'
import { Outlet } from 'umi'
import PublicLayout from './PublicLayout'
import PrimaryLayout from './PrimaryLayout/index'
import './BaseLayout.less'
import GlobalFooter from '@/components/GlobalFooter';
import config from '@/utils/config';
import { Layout as AntdLayout } from 'antd';
import React from 'react';
const LayoutMap = {
primary: PrimaryLayout,
public: PublicLayout,
const { Content } = AntdLayout;
type Props = {
sider?: React.ReactNode;
header?: React.ReactNode;
children?: React.ReactNode;
className?: string;
};
export default function BaseLayout({
sider,
header,
children,
className,
}: Props) {
return (
<AntdLayout style={{ minHeight: '100vh' }} className={className}>
{sider}
<AntdLayout>
{header}
<Content className="app-content">{children}</Content>
<GlobalFooter className="footer" copyright={config.copyright} />
</AntdLayout>
</AntdLayout>
);
}
const BaseLayout: React.FC = (props) => {
const location = useLocation()
const Container = LayoutMap[queryLayout(config.layouts, location.pathname)]
return <Container><Outlet /></Container>
}
export default BaseLayout
+577
View File
@@ -0,0 +1,577 @@
import { MenuFoldOutlined, MenuUnfoldOutlined } from '@ant-design/icons';
import { Breadcrumb, Button, Drawer, Layout, Menu, message } from 'antd';
import React, { useEffect, useMemo, useState } from 'react';
import { history, Link, useLocation } from 'umi';
import { ICON_MAP } from '@/components/IconMap';
import TopbarControls from '@/components/TopbarControls';
import useGlobalSync from '@/hooks/useGlobalSync';
import useIsMounted from '@/hooks/useIsMounted';
import { Admin } from '@/types/admin';
import config from '@/utils/config';
import api from '@/utils/request';
import useGlobalStore from '../store/useGlobalStore';
import adminService from '../services/admin';
import menuService from '../services/menu';
import { MenuItem } from '../types/menu';
import BaseLayout from './BaseLayout';
import './index.less';
const { Sider, Header } = Layout;
// keep warned paths module-level so dev StrictMode remounts don't re-show warnings
const WARNED_PATHS = new Set<string>();
type FrontendMenu = {
key: string;
title: string;
icon?: string;
path?: string;
children?: FrontendMenu[];
};
type RouteEntry = {
id: number | string;
route?: string;
name?: string;
breadcrumbParentId?: number | string | null;
icon?: string;
};
type BreadcrumbItem = {
key: string;
title: string;
path: string;
icon?: string;
};
function buildMenuItems(items: FrontendMenu[]): any[] {
return items.map((it: FrontendMenu) => {
const iconKey = it.icon || it.key;
if (it.children && it.children.length) {
return {
key: it.key,
icon: ICON_MAP[iconKey],
label: it.title,
children: buildMenuItems(it.children),
};
}
return {
key: it.key,
icon: ICON_MAP[iconKey],
label: <Link to={it.path || '/'}>{it.title}</Link>,
};
});
}
export default function PrimaryLayout({
children,
}: {
children?: React.ReactNode;
}) {
const { pathname } = useLocation();
const currentAdmin = useGlobalSync((s) => s.currentAdmin) as
| Admin
| undefined;
const [collapsed, setCollapsed] = useState(false);
const [isMobile, setIsMobile] = useState<boolean>(
typeof window !== 'undefined' ? window.innerWidth <= 768 : false,
);
const [mobileOpen, setMobileOpen] = useState(false);
const [menus, setMenus] = useState<MenuItem[] | null>(null);
const [routesDb, setRoutesDb] = useState<RouteEntry[] | null>(null);
useEffect(() => {
const v = localStorage.getItem('app-sider-collapsed');
if (v !== null) setCollapsed(v === 'true');
}, []);
useEffect(() => {
const onResize = () => setIsMobile(window.innerWidth <= 768);
window.addEventListener('resize', onResize);
return () => window.removeEventListener('resize', onResize);
}, []);
// load menus from API so admin changes (status/sort) reflect immediately
const isMounted = useIsMounted();
useEffect(() => {
(async () => {
const res = await menuService.listMenus();
if (!isMounted()) return;
// 服务现在保证返回统一的 data(即数组或期望类型),不再兼容旧格式
setMenus(res as MenuItem[]);
})();
}, [isMounted]);
// load raw routes DB to support breadcrumb for parameterized routes not present in menus
useEffect(() => {
(async () => {
try {
const r = await api('/routes');
if (!isMounted()) return;
setRoutesDb(r as RouteEntry[]);
} catch (e) {
void e;
}
})();
}, [isMounted]);
const filteredMenu = useMemo(() => {
// normalize currentAdmin.permissions to an array of paths or '*' string
const permsRaw: Admin['permissions'] | null =
(currentAdmin && currentAdmin.permissions) || null;
let perms: string[] = [];
if (typeof permsRaw === 'string') {
perms = permsRaw
.split(',')
.map((s: string) => s.trim())
.filter(Boolean);
}
const isAllowed = (item: FrontendMenu): boolean => {
// if no permissions configured for this user, deny access to guarded items
if (!perms || !perms.length) return false;
if (item.path && perms.includes(item.path)) return true;
// also allow matching by menu key (e.g. perms may contain '/dashboard' while item.path is '/')
if (item.key && perms.includes('/' + String(item.key))) return true;
if (item.children && item.children.length) {
return item.children.some((c: FrontendMenu) => isAllowed(c));
}
return false;
};
// choose source menu: API-loaded menus (if available) transformed to front-end shape
const source = (() => {
if (!menus || !menus.length) return [];
// helper to normalize a tree node to expected front-end shape
const normalizeNode = (m: MenuItem): FrontendMenu => ({
key: m.route
? String(m.route).replace(/^\//, '') || String(m.id)
: String(m.id),
title: m.title,
icon: m.icon || String(m.id),
path: m.route || '/',
children: Array.isArray(m.children)
? m.children.map(normalizeNode)
: [],
});
// detect if API returned a nested tree (children present) or flat list (parentId fields)
const looksNested = menus.some(
(m: MenuItem) => Array.isArray(m.children) && m.children.length,
);
if (looksNested) {
const tree = menus
.filter((m: MenuItem) => m.status === undefined || m.status === 1)
.map(normalizeNode) as FrontendMenu[];
// sort recursively
const sortRec = (arr: FrontendMenu[]) => {
arr.sort((a: any, b: any) => (a.sort || 0) - (b.sort || 0));
arr.forEach(
(c) => c.children && sortRec(c.children as FrontendMenu[]),
);
};
sortRec(tree);
return tree;
}
// otherwise treat as flat list with parentId
const map = new Map<number, FrontendMenu>();
const active = menus.filter(
(m: MenuItem) => m.status === undefined || m.status === 1,
);
active.forEach((m: MenuItem) =>
map.set(m.id, normalizeNode(m) as FrontendMenu),
);
const roots: FrontendMenu[] = [];
active.forEach((m: MenuItem) => {
const node = map.get(m.id) as FrontendMenu;
if (m.parentId === null || m.parentId === undefined) roots.push(node);
else {
const parent = map.get(m.parentId);
if (parent) {
parent.children = parent.children || [];
parent.children.push(node);
} else roots.push(node);
}
});
const sortRec = (arr: FrontendMenu[]) => {
arr.sort((a: any, b: any) => (a.sort || 0) - (b.sort || 0));
arr.forEach((c) => c.children && sortRec(c.children as FrontendMenu[]));
};
sortRec(roots);
return roots;
})();
// treat '*' as full access (return everything from source)
if (permsRaw === '*') return source;
return source.filter((it: FrontendMenu) => isAllowed(it));
}, [currentAdmin, menus]);
// route-level guard: prevent access to routes not covered by currentAdmin.permissions
useEffect(() => {
const path = pathname;
// allow public paths
if (!currentAdmin) return;
const permsRaw: Admin['permissions'] | null =
currentAdmin.permissions || null;
if (permsRaw === '*') return;
const perms =
typeof permsRaw === 'string'
? permsRaw
.split(',')
.map((s) => s.trim())
.filter(Boolean)
: [];
const pathAllowedByPerm = (perm: string) => {
if (!perm) return false;
if (perm === path) return true;
// treat perm as pattern if it contains ':'
if (perm.indexOf(':') >= 0) {
try {
const pattern = '^' + perm.replace(/:[^/]+/g, '[^/]+') + '$';
const re = new RegExp(pattern);
return re.test(path);
} catch (e) {
return false;
}
}
return false;
};
const allowed = perms.some(pathAllowedByPerm);
if (!allowed) {
// also allow if filteredMenu contains a matching path/pattern
const menuAllows = (() => {
const checkItem = (it: FrontendMenu): boolean => {
if (it.path === path) return true;
if (typeof it.path === 'string' && it.path.indexOf(':') >= 0) {
try {
const pattern = '^' + it.path.replace(/:[^/]+/g, '[^/]+') + '$';
const re = new RegExp(pattern);
if (re.test(path)) return true;
} catch (e) {
void e;
}
}
if (it.children && it.children.length)
return it.children.some(checkItem);
return false;
};
return filteredMenu && filteredMenu.some(checkItem);
})();
if (!menuAllows) {
if (!WARNED_PATHS.has(path)) {
WARNED_PATHS.add(path);
message.warning('没有权限访问此页面');
}
if (history.location.pathname !== '/') history.replace('/');
}
}
}, [pathname, currentAdmin, filteredMenu, routesDb]);
const menuItems = useMemo(
() => buildMenuItems(filteredMenu as FrontendMenu[]),
[filteredMenu],
);
// try to find the active key from pathname
const selectedKeys = useMemo(() => {
const findKey = (items: FrontendMenu[]): string | null => {
for (const it of items) {
if (it.path === pathname) return it.key;
if (it.children) {
const child = findKey(it.children);
if (child) return child;
}
}
return null;
};
const k = findKey(filteredMenu);
return k ? [k] : [];
}, [pathname, filteredMenu]);
// find parent keys to open corresponding submenu
const defaultOpenKeys = useMemo(() => {
if (!selectedKeys.length) return [];
const target = selectedKeys[0];
const findParent = (items: FrontendMenu[]): string | null => {
for (const it of items) {
if (
it.children &&
it.children.some((c: FrontendMenu) => c.key === target)
)
return it.key;
if (it.children) {
const sub = findParent(it.children as FrontendMenu[]);
if (sub) return sub;
}
}
return null;
};
const p = findParent(filteredMenu);
return p ? [p] : [];
}, [selectedKeys, filteredMenu]);
const handleCollapse = (c: boolean) => {
setCollapsed(c);
localStorage.setItem('app-sider-collapsed', String(c));
};
const logout = useGlobalStore.getState().logout;
const sider = (
<Sider
collapsible
collapsed={collapsed}
onCollapse={handleCollapse}
className="app-sider"
>
<div className="logo">{config.siteName}</div>
<Menu
theme="light"
mode="inline"
items={menuItems}
selectedKeys={selectedKeys}
defaultOpenKeys={defaultOpenKeys}
/>
</Sider>
);
const header = (
<Header className="app-header">
<div
style={{
display: 'flex',
alignItems: 'center',
justifyContent: 'space-between',
}}
>
<div>
<Button
type="text"
onClick={() => {
if (isMobile) setMobileOpen(true);
else handleCollapse(!collapsed);
}}
style={{ fontSize: 18 }}
>
{collapsed ? <MenuUnfoldOutlined /> : <MenuFoldOutlined />}
</Button>
</div>
<div style={{ display: 'flex', alignItems: 'center', gap: 12 }}>
<div style={{ color: '#fff', minWidth: 80, textAlign: 'right' }}>
{currentAdmin
? currentAdmin.real_name || currentAdmin.username
: ''}
</div>
<TopbarControls
onLogout={async () => {
await adminService.logout();
logout();
history.push('/login');
}}
goProfile={() => {
// Navigate to profile page
history.push(`/admin/${currentAdmin?.id || 0}`);
}}
/>
</div>
</div>
</Header>
);
// build breadcrumb trail from MENU based on pathname
const breadcrumb = useMemo(() => {
const find = (
items: FrontendMenu[],
path: string,
): FrontendMenu[] | null => {
for (const it of items) {
if (it.path === path) return [it];
if (it.children) {
const sub = find(it.children, path);
if (sub) return [it, ...sub];
}
}
return null;
};
// exact match first
let trail = find(filteredMenu, pathname);
if (!trail) {
// attempt pattern matching for param routes like /admin/:id
const patternFind = (
items: FrontendMenu[],
path: string,
): FrontendMenu[] | null => {
for (const it of items) {
if (typeof it.path === 'string' && it.path.indexOf(':') >= 0) {
try {
const pattern = '^' + it.path.replace(/:[^/]+/g, '[^/]+') + '$';
const re = new RegExp(pattern);
if (re.test(path)) return [it];
} catch (e) {
void e;
}
}
if (it.children) {
const sub = patternFind(it.children, path);
if (sub) return [it, ...sub];
}
}
return null;
};
// attempt prefix matching (e.g., /users -> /users/list)
const prefixFind = (
items: FrontendMenu[],
path: string,
): FrontendMenu[] | null => {
for (const it of items) {
if (it.path && path.startsWith(it.path) && it.path !== '/')
return [it];
if (it.children) {
const sub = prefixFind(it.children, path);
if (sub) return [it, ...sub];
}
}
return null;
};
trail =
patternFind(filteredMenu, pathname) ||
prefixFind(filteredMenu, pathname);
// try matching against raw routes DB (includes entries excluded from menu via menuParentId === '-1')
if (!trail && routesDb && routesDb.length) {
const matchRoute = (routes: RouteEntry[]): RouteEntry | null => {
for (const it of routes) {
if (!it.route) continue;
// exact match
if (it.route === pathname) return it;
// param pattern match
if (typeof it.route === 'string' && it.route.indexOf(':') >= 0) {
try {
const pattern =
'^' + it.route.replace(/:[^/]+/g, '[^/]+') + '$';
const re = new RegExp(pattern);
if (re.test(pathname)) return it;
} catch (e) {
void e;
}
}
}
return null;
};
const found = matchRoute(routesDb);
if (found) {
const idToRoute = (id: number | string) =>
routesDb.find((x: RouteEntry) => String(x.id) === String(id));
const chain: BreadcrumbItem[] = [];
let cur: RouteEntry | null = found;
while (cur) {
// for the current (param) route, use the actual pathname so link works
chain.unshift({
key: String(cur.id),
title: String(cur.name || ''),
path: cur === found ? pathname : cur.route || '/',
icon: cur.icon,
});
if (!cur.breadcrumbParentId) break;
cur = idToRoute(cur.breadcrumbParentId) || null;
}
trail = chain.length ? chain : null;
}
}
trail = trail || [{ key: 'dashboard', title: 'Dashboard', path: '/' }];
}
return trail;
}, [pathname, filteredMenu, routesDb]);
// update document title from breadcrumb
useEffect(() => {
if (breadcrumb && breadcrumb.length) {
const last = breadcrumb[breadcrumb.length - 1];
document.title = `${last.title} - ${config.siteName}`;
} else {
document.title = config.siteName;
}
}, [breadcrumb]);
const pageBody = (
<div className="page-container">
<Breadcrumb
className="page-breadcrumb"
items={breadcrumb.map(
(b: FrontendMenu | BreadcrumbItem, idx: number) => {
const IconNode =
ICON_MAP[(b as any).icon || (b as any).key] || null;
const titleNode = (
<span
style={{ display: 'inline-flex', alignItems: 'center', gap: 8 }}
>
{IconNode}
<span>{(b as any).title}</span>
</span>
);
return {
key: (b as any).key,
title:
idx < breadcrumb.length - 1 ? (
<Link to={(b as any).path}>{titleNode}</Link>
) : (
titleNode
),
};
},
)}
/>
<div className="page-content">{children}</div>
</div>
);
return (
<>
<BaseLayout sider={!isMobile ? sider : undefined} header={header}>
{pageBody}
</BaseLayout>
<Drawer
open={mobileOpen}
placement="left"
onClose={() => setMobileOpen(false)}
styles={{ body: { padding: 0 } }}
className="mobile-menu-drawer"
>
<div
className="logo"
style={{
height: 56,
display: 'flex',
alignItems: 'center',
padding: '0 16px',
}}
>
{config.siteName}
</div>
<Menu
theme="light"
mode="inline"
items={menuItems}
selectedKeys={selectedKeys}
defaultOpenKeys={defaultOpenKeys}
onClick={() => setMobileOpen(false)}
/>
</Drawer>
</>
);
}
@@ -1,69 +0,0 @@
import React from 'react'
import { Dropdown, Menu, Avatar } from 'antd'
import { language, languages } from '@/configs'
import { ISupportedLocales } from '@/typings'
import { Trans } from '@lingui/macro'
import { history } from 'umi'
import { useRequest, useConfig } from '@/hooks'
import { logoutUser } from '@/services'
import styles from './index.less'
const { SubMenu } = Menu
const NotFoundPage: React.FC = () => {
const { language: locale, setLanguage, userInfo } = useConfig()
const currentLanguage = language[locale]
const { run: runLogoutUser } = useRequest(logoutUser, {
manual: true,
onSuccess: () => history.push('/login'),
})
return (
<>
<Dropdown
overlay={
<Menu
selectedKeys={[currentLanguage.value]}
onClick={(data) => {
setLanguage(data.key as ISupportedLocales)
}}
>
{languages.map((item) => (
<Menu.Item key={item.key}>
<Avatar
size="small"
style={{ marginRight: 8 }}
src={item.flag}
/>
{item.value}
</Menu.Item>
))}
</Menu>
}
>
<div className={styles.headerButton}>
<Avatar size="small" src={currentLanguage.flag} />
</div>
</Dropdown>
<Menu key="user" mode="horizontal">
<SubMenu
title={
<>
<span style={{ color: '#999', marginRight: 4 }}>
<Trans>Hi,</Trans>
</span>
<span>{userInfo?.username}</span>
<Avatar style={{ marginLeft: 8 }} src={userInfo?.avatar} />
</>
}
>
<Menu.Item key="SignOut" onClick={() => runLogoutUser()}>
<Trans>Sign out</Trans>
</Menu.Item>
</SubMenu>
</Menu>
</>
)
}
export default NotFoundPage
-62
View File
@@ -1,62 +0,0 @@
@import '~@/themes/vars.less';
:global {
#root {
height: 100%;
}
}
.backTop {
right: 50px;
:global {
.ant-back-top-content {
background: @primary-color;
opacity: 0.3;
transition: all 0.3s;
box-shadow: 0 0 15px 1px rgba(69, 65, 78, 0.1);
&:hover {
opacity: 1;
}
}
}
}
.content {
padding: 24px;
min-height: ~'calc(100% - 72px)';
// overflow-y: scroll;
}
.container {
height: 100vh;
flex: 1;
width: ~'calc(100% - 256px)';
overflow-y: scroll;
overflow-x: hidden;
}
.footer {
background: #fff;
margin-top: 0;
margin-bottom: 0;
padding-top: 24px;
padding-bottom: 24px;
min-height: 72px;
}
@media (max-width: 767px) {
.content {
padding: 12px;
}
.backTop {
right: 20px;
bottom: 20px;
}
.container {
height: 100vh;
flex: 1;
width: 100%;
}
}
-77
View File
@@ -1,77 +0,0 @@
import React, { useState, useEffect, useMemo, useCallback } from 'react'
import ProBasicLayout, {
getMenuData,
MenuDataItem,
SettingDrawerProps,
} from '@ant-design/pro-layout'
import { Link, Outlet } from 'umi'
import { useLocation } from '@/hooks'
import { menus, menuIcon, config } from '@/configs'
import defaultSettings from '@/defaultSettings'
import type { MenuProps } from 'antd/es/menu'
import HeaderRightContent from './HeaderRightContent'
const renderMenuItem = (menus: MenuDataItem[]): MenuDataItem[] =>
menus.map(({ icon, children, ...item }) => ({
...item,
icon: icon && menuIcon[icon as string],
children: children && renderMenuItem(children),
}))
const PrimaryLayout: React.FC = (props) => {
const location = useLocation()
const [settings] = useState<SettingDrawerProps['settings']>(defaultSettings)
const [openKeys, setOpenKeys] = useState<string[]>([])
const [selectedKeys, setSelectedKeys] = useState<string[]>(['/'])
const { pathname } = location
const { breadcrumbMap, menuData } = useMemo(() => getMenuData(menus), [])
useEffect(() => {
const select = breadcrumbMap.get(pathname)
if (select) {
setOpenKeys((select as MenuDataItem)['pro_layout_parentKeys'])
setSelectedKeys([(select as MenuDataItem)['key'] as string])
}
}, [breadcrumbMap, pathname])
const menuDataRender = useCallback(() => renderMenuItem(menuData), [menuData])
const menuItemRender = useCallback((menuItemProps, defaultDom) => {
if (menuItemProps.isUrl || !menuItemProps.path) {
return defaultDom
}
return <Link to={menuItemProps.path}>{defaultDom}</Link>
}, [])
const handleOnOpenChange = useCallback(
(keys) => setOpenKeys(keys as string[]),
[]
)
const menuProps = useMemo<MenuProps>(
() => ({
selectedKeys,
openKeys,
onOpenChange: handleOnOpenChange,
}),
[handleOnOpenChange, openKeys, selectedKeys]
)
return (
<>
<ProBasicLayout
{...settings}
title={config.title}
logo={config.logo}
menuDataRender={menuDataRender}
menuItemRender={menuItemRender}
menuProps={menuProps}
rightContentRender={() => <HeaderRightContent />}
>
<Outlet />
</ProBasicLayout>
</>
)
}
export default PrimaryLayout
+36 -6
View File
@@ -1,8 +1,38 @@
import React from 'react'
import { Outlet } from 'umi'
import { Layout } from 'antd';
import React from 'react';
const PublicLayout: React.FC = (props) => {
return <><Outlet /></>
import TopbarControls from '@/components/TopbarControls';
const { Content } = Layout;
export default function PublicLayout({
children,
}: {
children?: React.ReactNode;
}) {
return (
<Layout style={{ minHeight: '100vh' }}>
<div
style={{
position: 'absolute',
right: 12,
top: 12,
zIndex: 20,
display: 'flex',
gap: 8,
}}
>
<TopbarControls />
</div>
<Content
style={{
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
}}
>
<div style={{ width: 480 }}>{children}</div>
</Content>
</Layout>
);
}
export default PublicLayout
+227 -14
View File
@@ -1,22 +1,235 @@
:global {
#root {
height: 100%;
.navs {
ul {
padding: 0;
list-style: none;
display: flex;
}
li {
margin-right: 1em;
}
}
.headerButton {
display: flex;
align-items: center;
height: 100%;
padding: 0 12px;
cursor: pointer;
transition: all 0.3s;
.content {
padding: 24px;
min-height: calc(100vh - 64px);
}
&:hover {
background: rgba(0, 0, 0, 0.025);
.footer {
background: #fff;
margin-top: 0;
margin-bottom: 0;
padding-top: 24px;
padding-bottom: 24px;
min-height: 72px;
}
.app-sider {
.logo {
height: 64px;
color: rgba(0, 0, 0, 0.85);
font-weight: 600;
font-size: 18px;
display: flex;
align-items: center;
justify-content: center;
padding: 0 24px;
box-shadow: 0 1px 9px -3px rgba(0, 0, 0, 0.2);
}
}
.headerFlag {
margin-right: 8px;
/* Sider visual refinements (light) */
.app-sider {
background: #ffffff;
color: rgba(0, 0, 0, 0.85);
.logo {
background: transparent;
letter-spacing: 0.2px;
}
/* Antd light menu tweaks */
.ant-menu {
padding-top: 6px;
}
.ant-menu-light {
background: transparent;
}
.ant-menu-light .ant-menu-item,
.ant-menu-light .ant-menu-submenu-title {
color: rgba(0, 0, 0, 0.75);
padding-left: 20px;
}
.ant-menu-light .ant-menu-item:hover {
background: rgba(0, 0, 0, 0.03);
color: rgba(0, 0, 0, 0.9);
}
.ant-menu-light .ant-menu-item-selected {
background: rgba(24, 144, 255, 0.08) !important;
color: rgba(0, 0, 0, 0.9) !important;
}
.ant-menu-light .ant-menu-item .anticon {
color: rgba(0, 0, 0, 0.55);
font-size: 16px;
}
}
.app-header {
background: #fff;
padding: 0 16px;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.06);
}
.app-header .ant-btn {
color: rgba(0, 0, 0, 0.65);
}
.app-header .ant-btn:hover {
color: rgba(0, 0, 0, 0.85);
}
.app-content {
min-height: 0;
}
.page-container {
padding: 12px 16px 16px;
}
.page-breadcrumb {
margin: 0 0 12px 6px;
}
.page-content {
min-height: calc(100vh - 180px);
}
/* Mobile responsive tweaks */
@media (max-width: 768px) {
.app-sider {
display: none !important;
}
.app-header {
padding: 0 8px;
}
.logo {
font-size: 16px;
padding: 0 12px;
}
.page-container {
padding: 8px;
}
.page-breadcrumb {
display: none;
}
.page-content {
min-height: auto;
}
.ant-menu-item,
.ant-menu-submenu-title {
padding-left: 12px !important;
}
.mobile-menu-drawer .ant-drawer-body {
padding: 0;
}
/* allow tables to scroll horizontally on small screens */
.ant-table-wrapper {
overflow-x: auto;
}
.ant-table-thead > tr > th,
.ant-table-tbody > tr > td {
white-space: nowrap;
}
}
/* Dark mode overrides */
.dark-mode {
--bg: #121212;
--muted: rgba(255, 255, 255, 0.65);
--panel: #1f1f1f;
color: rgba(255, 255, 255, 0.88);
background: var(--bg);
}
.dark-mode .app-header {
background: #141414;
box-shadow: none;
}
.dark-mode .app-sider {
background: #111111;
}
/* Stronger dark-mode sider contrast */
.dark-mode .app-sider {
background: linear-gradient(180deg, #08090b 0%, #0b0f13 100%);
}
.dark-mode .app-sider .logo {
background: rgba(255, 255, 255, 0.02);
}
.dark-mode .logo {
color: #fff;
}
.dark-mode .app-content,
.dark-mode .page-content {
background: var(--panel);
}
.dark-mode .page-content {
background: transparent;
}
.page-content .ant-card {
border-radius: 10px;
}
.dark-mode .ant-breadcrumb,
.dark-mode .page-breadcrumb {
color: var(--muted);
}
.dark-mode .ant-menu-dark .ant-menu-item,
.dark-mode .ant-menu-dark .ant-menu-submenu-title {
color: var(--muted);
}
/* smooth transition for mode change */
html,
body,
.ant-layout,
.ant-layout .ant-layout {
transition: background 0.25s ease, color 0.25s ease;
}
/* Ensure sider collapse trigger / bottom area stays white */
.app-sider .ant-layout-sider-trigger {
background: #ffffff;
color: rgba(0, 0, 0, 0.85);
}
/* Button styling: primary buttons use black background, general buttons have dark text */
.ant-btn {
color: rgba(0, 0, 0, 0.85);
}
.ant-btn-primary {
background: #000000;
border-color: #000000;
color: #ffffff;
}
+16 -46
View File
@@ -1,53 +1,23 @@
import React from 'react'
import { history } from 'umi'
import { ConfigProvider } from 'antd'
import { I18nProvider } from '@lingui/react'
import {
useIntlProvider,
useRequest,
} from '@/hooks'
// @ts-ignore
import { Outlet } from 'umi'
import { ConfigContext } from '@/utils/context'
import request from '@/utils/request'
import { queryUserInfo, IUserInfo } from '@/services'
import BaseLayout from './BaseLayout'
import { Outlet, useLocation } from 'umi';
const Layout: React.FC = (props) => {
const { language, setLanguage, i18n, locale } = useIntlProvider()
import PrimaryLayout from './PrimaryLayout';
import PublicLayout from './PublicLayout';
const {
data: userInfo,
run: runQueryUserInfo,
loading,
} = useRequest<IUserInfo>(queryUserInfo, {
onError: (data: any) => {
if (data.statusCode === 401) {
history.push('/login')
}
},
})
export default function LayoutWrapper() {
const { pathname } = useLocation();
const globalConfig = {
language,
setLanguage,
userInfo: userInfo as IUserInfo,
queryUserInfo: runQueryUserInfo,
}
if (loading) {
return <div>loading</div>
// Simple rule: use PublicLayout for authentication/public routes
if (pathname.startsWith('/public') || pathname === '/login') {
return (
<PublicLayout>
<Outlet />
</PublicLayout>
);
}
return (
<ConfigContext.Provider value={globalConfig}>
<I18nProvider i18n={i18n}>
<ConfigProvider locale={locale}>
<BaseLayout><Outlet /></BaseLayout>
</ConfigProvider>
</I18nProvider>
</ConfigContext.Provider>
)
<PrimaryLayout>
<Outlet />
</PrimaryLayout>
);
}
export default Layout

Some files were not shown because too many files have changed in this diff Show More