# mahu-dashboard

**Repository Path**: kk70/mahu-dashboard

## Basic Information

- **Project Name**: mahu-dashboard
- **Description**: Nuxt 4 + Nuxt UI 的 Mahu 业务管理后台，支持仪表盘与系统管理
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mahu-dashboard

基于 [Nuxt UI](https://ui.nuxt.com) 的管理后台，用于 `mahu` 相关业务的日常运营与配置（仪表盘布局、系统管理示例能力等）。

[![Nuxt UI](https://img.shields.io/badge/Made%20with-Nuxt%20UI-00DC82?logo=nuxt&labelColor=020420)](https://ui.nuxt.com)

## 技术栈

- [Nuxt 4](https://nuxt.com/)
- [Vue 3](https://vuejs.org/)
- [TypeScript](https://www.typescriptlang.org/)
- [Nuxt UI](https://ui.nuxt.com/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Pinia](https://pinia.vuejs.org/)
- [TanStack Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview)
- [TanStack Table](https://tanstack.com/table/latest)
- [Valibot](https://valibot.dev/)
- [OpenAPI](https://www.openapis.org/)
- [Hey API · OpenAPI TypeScript](https://heyapi.dev/openapi-ts/)

## 环境要求

- [Node.js](https://nodejs.org/) 20.19+
- [pnpm](https://pnpm.io/) 10.29.3

## 开发

```bash
pnpm install
pnpm dev
```

浏览器访问终端里提示的本地地址（一般为 `http://localhost:3000`）。

需要对接后端地址、站点标题等时，可在环境中设置 `NUXT_PUBLIC_*` 变量（默认值见 `nuxt.config.ts`）。

后端接口 OpenAPI 描述有变更时，在更新描述后执行：

```bash
pnpm gen:oas
```

## 构建与部署

```bash
pnpm build
```

构建完成后，可用下面命令在本地近似生产环境试跑：

```bash
pnpm preview
```

线上发布方式取决于你的部署平台（静态资源、Node 服务等），将构建结果按平台说明发布即可。

## 其他命令

| 命令             | 说明         |
| ---------------- | ------------ |
| `pnpm generate`  | 静态站点生成 |
| `pnpm lint`      | 代码检查     |
| `pnpm format`    | 格式化       |
| `pnpm typecheck` | 类型检查     |

开发与协作中的约定说明见仓库根目录 **`AGENTS.md`**。