# mms-unix

**Repository Path**: LumeCode/mms-unix

## Basic Information

- **Project Name**: mms-unix
- **Description**: MMS 官方 uni-app x（uvue）跨端基础组件库，一套组件编译 Android / iOS / Web 多端，配合 mms 移动端使用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://mmsadmin.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
   <br/>
   <a href="https://mmsadmin.cn">
     <img width="150" src="https://mmsadmin.cn/logo.png" alt="MMS logo">
   </a>
   <h1>模块化管理系统</h1>
   <p>MMS · Modular Management System</p>
   <p><strong>mms-unix · uni-app x 移动端基座（登录 / 会员 / 请求封装）</strong></p>
   <p><a href="https://mmsadmin.cn/">📘 在线文档 · mmsadmin.cn</a> · <a href="https://gitee.com/LumeCode/mms-unix">Gitee</a> · <a href="https://github.com/MrShanDev/mms-unix">GitHub</a> · <a href="https://ext.dcloud.net.cn/plugin?id=27396">DCloud 插件市场</a></p>
   <br/>
</div>

# mUnix（m-unix）

基于 uni-app-x 的移动端项目，内置登录、注册、找回密码、会员中心等基础功能。

## 功能概览

- **登录**：快捷登录（手机号+验证码）、账号密码登录
- **注册**：手机号、验证码、用户名、密码
- **找回密码**：手机验证码重置
- **会员中心**：头像、昵称、收藏/足迹/优惠券、我的订单、服务工具宫格
- **接口请求**：`common/utils/request.uts` 封装 `uni.request`，支持 token、401 自动跳转登录
- **全局存储**：`common/utils/storage.uts` 读写 token、userInfo
- **登录拦截**：`common/utils/auth.uts`，会员中心等页面未登录自动跳转登录并带回跳

## 目录结构

```
m-unix/
├── common/
│   ├── config.uts          # 全局配置（baseUrl、storage key 等）
│   ├── api/               # API：`baseApi`（基础/登录/业务，免登录与需登录分组）
│   └── utils/
│       ├── storage.uts     # 存储工具
│       ├── request.uts    # 请求封装
│       └── auth.uts       # 登录校验
├── pages/
│   ├── index/             # 首页
│   ├── login/             # 登录
│   ├── register/          # 注册
│   ├── forgot-password/   # 找回密码
│   └── user/              # 我的
├── static/
└── uni_modules/
    └── m-unix/          # m-unix 组件模块
```

## 配置说明

- **API 地址**：在 `common/config.uts` 中修改 `baseUrl`
- **登录态存储**：使用 `storage.getToken()`、`storage.setUserInfo()` 等
- **需要登录的页面**：在 `config.loginRequiredPaths` 中配置，或在页面内手动调用 `checkLogin(path)` 做拦截

## 开发说明

- 业务 HTTP 统一从 `common/api/baseApi.uts` 引用（含 `loginByCode`、`phoneSmsLogin`、`mallSendSmsCode` 等；见文件内分组注释）
- 会员中心各入口（收藏、订单、地址等）可根据业务需求进行扩展
- TabBar 图标可替换为自定义图标