# cmall-fronted

**Repository Path**: netherworld/cmall-fronted

## Basic Information

- **Project Name**: cmall-fronted
- **Description**: # CMall 管理平台

CMall 内部管理端前端，根据系统内用户与系统设置设计文档实现，并逐步接入 `cmall-platform` 服务端。

## 技术栈

- **React 18**：使用函数组件和 Hook 构建管理端页面。
- **TypeScript 5**：启用严格类型检查，编译目标为 ES2022。
- **Vite 6**：负责本地开发、接口代理和生产构建。
- **MU
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CMall 管理平台

CMall 内部管理端前端，根据系统内用户与系统设置设计文档实现，并逐步接入 `cmall-platform` 服务端。

## 技术栈

- **React 18**：使用函数组件和 Hook 构建管理端页面。
- **TypeScript 5**：启用严格类型检查，编译目标为 ES2022。
- **Vite 6**：负责本地开发、接口代理和生产构建。
- **MUI 7 + Emotion**：提供基础组件、主题能力和 CSS-in-JS 样式支持。
- **React Router 7**：负责页面路由和管理端导航。
- **Phosphor Icons**：提供界面图标。
- **pinyin-pro**：用于中文内容的拼音转换与检索辅助。
- **原生 Fetch API**：通过 `src/api/client.ts` 统一处理接口根地址、认证、业务主体请求头和异常响应。

## 工程目录

```text
cmall-fronted/
├─ src/
│  ├─ api/          # API 客户端、接口契约、数据映射和领域请求封装
│  ├─ components/   # 跨页面复用的通用组件和业务组件
│  ├─ data/         # 设计预览或明确演示场景使用的本地数据
│  ├─ layout/       # 管理端整体布局
│  ├─ navigation/   # 菜单规范化、页面注册和业务导航配置
│  ├─ pages/        # 路由级页面及其领域子页面
│  ├─ services/     # 预留的业务服务与页面编排层
│  ├─ utils/        # 标签转换等无界面通用工具
│  ├─ App.tsx       # 路由、登录状态和应用级页面入口
│  ├─ main.tsx      # React 应用启动入口
│  ├─ theme.ts      # MUI 全局主题
│  ├─ styles.css    # 全局基础样式
│  └─ types.ts      # 前端共享类型
├─ index.html       # Vite HTML 入口
├─ package.json     # 依赖和 npm 命令
├─ tsconfig*.json   # TypeScript 编译配置
└─ vite.config.ts   # Vite、开发代理和构建配置
```

`dist/`、`node_modules/`、`*.tsbuildinfo`、`vite.config.js` 和 `vite.config.d.ts` 属于构建产物、依赖或生成文件，不应手工修改。

## 本地开发

```bash
npm install
npm run dev
```

开发服务器默认将 `/api` 和 `/uploads` 代理到 `http://localhost:18087`。如核心服务位于其他地址，可在启动前设置 `VITE_API_PROXY_TARGET`。生产环境使用 `VITE_API_BASE_URL` 指定接口根地址。

## 质量检查

```bash
npm run typecheck
npm run build
```

登录、当前用户和用户管理已使用真实服务端接口。授权上下文与服务端统一使用业务主体模型。

## 业务设计预览

侧边栏读取 `/api/admin/me/menus` 返回的当前管理用户有效菜单，并将“角色管理”“菜单管理”统一归入“用户与登录安全”。角色管理页负责角色的新建、编辑和启停；菜单管理页负责菜单配置以及菜单、页面权限与角色绑定。

- `/business-map`：对照 `D:/workspace/mall-j` 的移动端原型，检查所有移动端入口是否具有管理端责任归属和异常闭环。
- `/platform/roles`：维护角色定义和角色状态。
- `/platform/menus`：维护双端导航、权限条件、同级排序以及角色权限绑定。
- `/property/*`：空间资产、人员档案、人房关系、关系审核、公告和报修。
- `/devices/*`：设备资产、门禁点、通行授权、设备事件、命令和告警。
- `/secondhand`：继续使用已经接入真实接口的二手运营工作台。
- `/local-life/*`：餐厅、菜品、促销与餐饮订单运营页面。
- `/short-video/*`：视频、审核、互动治理与内容统计页面。
- `/im-governance/*`：会话治理、举报处置与通知监控页面。

未登录评审时，本地开发环境仍可访问 `/design-preview/business-map`、`/design-preview/property` 与 `/design-preview/devices`。`/design-preview/menus` 已停用并跳转到真实菜单管理页。

如需在本地关闭未登录业务预览地址，设置 `VITE_DISABLE_DESIGN_PREVIEW=true`。