# 配置 mm App 应用

## 规则（Rules）

- app.json 位于 `app/{模块名}/app.json`
- `name` 字段必须与目录名一致，小写英文，全局唯一
- 所有 JSON 字段名用双引号，不可有注释

## 方法（Methods）

### 步骤1：确定 App 基本信息

明确应用名（name，小写蛇形）、中文标题（title）、版本号（version）、排序位置（sort）。

sort 参考值：sys=10, home=10, tool=10, cms=50, iot=50, user=50, dev=80, face=80, wechat=80, eshop=100, source=100, gateway=100, ai=200

### 步骤2：编写 app.json

```json
{
    "name": "myapp",
    "version": "1.0",
    "title": "我的应用",
    "description": "应用描述",
    "author": "作者名",
    "scope": "server",
    "main": "./index.js",
    "func_name": "main",
    "sort": 50,
    "state": 1,
    "show": 0,
    "end": false,
    "identifier": "myapp",
    "icon": "/myapp/img/logo.png"
}
```

### 步骤3：按需添加数据库配置

```json
"sql": {
    "way": "mysql",
    "mysql": {
        "host": "127.0.0.1",
        "port": 3306,
        "username": "root",
        "password": "密码",
        "database": "mm"
    }
}
```

### 步骤4：按需添加缓存配置

```json
"cache": {
    "way": "redis",
    "redis": {
        "host": "127.0.0.1",
        "port": 6379,
        "password": "密码",
        "database": 0
    }
}
```

### 步骤5：验证 JSON 格式

使用 `"路径".loadJson()` 检查 JSON 是否可正确解析。

## 技巧（Tips）

- 如果 App 不需要独立数据库，省略 `sql` 字段即可，框架自动使用全局数据库