# MagistralaUi

**Repository Path**: kdisi_admin/magistrala-ui

## Basic Information

- **Project Name**: MagistralaUi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-24
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Traction UI

Traction IoT Platform 的前端管理界面，基于 Next.js 14 构建。

## 技术栈

- **框架**: Next.js 14 (App Router)
- **语言**: TypeScript
- **样式**: Tailwind CSS + shadcn/ui
- **国际化**: next-intl (支持中文 / 英文)
- **图表**: Recharts
- **组件库**: Radix UI

## 目录结构

```
├── app/                    # Next.js App Router 页面
│   └── [locale]/           # 国际化路由 (en/zh)
│       ├── bootstrap/       # 设备引导配置
│       ├── channels/       # 消息通道管理
│       ├── dashboards/     # 运营分析
│       ├── domains/        # 域管理
│       ├── groups/         # 分组管理
│       ├── invitations/    # 邀请管理
│       ├── login/          # 登录页面
│       ├── profile/        # 个人中心
│       ├── settings/       # 控制台设置
│       ├── things/         # 设备管理
│       └── users/          # 用户管理
├── components/            # 业务组件
│   └── ui/                 # UI 组件 (shadcn/ui)
├── lib/                    # 核心库
│   ├── api/                # API 调用层
│   ├── auth-context.tsx    # 认证上下文
│   ├── domain-context.tsx  # 域上下文
│   └── theme-context.tsx    # 主题上下文
├── i18n/                   # 国际化配置
└── messages/               # 翻译文件 (en.json, zh.json)
```

## 功能模块

| 模块 | 说明 |
|------|------|
| Overview | 物联网运营总览 |
| Users | 用户管理 |
| Devices | 设备管理 |
| Message Channels | 消息通道管理 |
| Groups | 设备分组管理 |
| Domains | 域管理 |
| Invitations | 邀请管理 |
| Profile | 个人中心 |
| Settings | 控制台设置 |

## 快速开始

```bash
# 安装依赖
bun install

# 启动开发服务器
bun dev

# 构建生产版本
bun build

# 启动生产服务器
bun start
```

访问 http://localhost:3000

## 环境变量

```env
NEXT_PUBLIC_API_URL=<后端 API 地址>
```

## 认证机制

- JWT Access Token + Refresh Token 双令牌机制
- Token 存储于 localStorage
- 路由中间件自动处理国际化和认证重定向

## 开发规范

- 使用 `cn()` 工具函数合并 Tailwind 类名
- UI 组件统一使用 shadcn/ui
- 页面级组件使用 `use client` 指令
- 使用 `useResourceTable` hook 统一资源表格逻辑
- 使用 `usePaginatedData` hook 管理分页数据