数据建模与 Schema 设计规范

// 推荐：语义清晰、风格统一
{
    "_id": ObjectId("..."),
    "userName": "张三",           // camelCase 风格
    "createTime": ISODate("..."),
    "orderItems": [...],
    "totalAmount": 199.00
}

// 不推荐：命名混乱
{
    "_id": ObjectId("..."),
    "UN": "张三",                 // 缩写不清晰
    "Create_Time": ISODate("..."), // 混合风格
    "oi": [...],                  // 含义不明
    "_total": 199.00              // 业务字段以 _ 开头，易与系统字段冲突
}

// 查看单个文档大小
Object.bsonsize(db.collection.findOne({ _id: xxx }))

// 查看集合平均文档大小（单位：字节）
db.collection.stats().avgObjSize

// 推荐：嵌套层级适中（2-3 层）
{
    "_id": ObjectId("..."),
    "orderId": "ORD202403001",
    "customer": {                    // 第 1 层
        "name": "张三",
        "contact": {                 // 第 2 层
            "phone": "13800138000",
            "email": "zhangsan@example.com"
        }
    },
    "items": [{ "productId": "P001", "quantity": 2 }]  // 第 1 层（数组）
}

// 不推荐：嵌套过深
{
    "level1": {
        "level2": {
            "level3": {
                "level4": {
                    "level5": {
                        "data": "太深了，无法维护"
                    }
                }
            }
        }
    }
}

// 订单 + 订单项：嵌入式（总是一起查询，订单项不会独立存在）
{
    "_id": ObjectId("..."),
    "orderId": "ORD202403001",
    "customerId": "C001",
    "items": [
        { "productId": "P001", "name": "商品A", "quantity": 2, "price": 99.00 },
        { "productId": "P002", "name": "商品B", "quantity": 1, "price": 199.00 }
    ],
    "totalAmount": 397.00,
    "status": "paid",
    "createTime": ISODate("2024-03-15T10:30:00Z")
}

// 用户 + 文章：引用式（文章经常独立查询，且数量无限增长）
// 用户文档
{
    "_id": ObjectId("user_001"),
    "userName": "张三",
    "email": "zhangsan@example.com"
}

// 文章文档（通过 authorId 引用用户）
{
    "_id": ObjectId("article_001"),
    "title": "MongoDB 最佳实践",
    "authorId": ObjectId("user_001"),  // 引用用户
    "content": "...",
    "createTime": ISODate("...")
}

// ✅ 混合模式：订单中冗余商品名称和价格（快照），同时保留 productId 引用
{
    "orderId": "ORD001",
    "items": [
        {
            "productId": ObjectId("..."),  // 引用（用于关联最新商品信息）
            "name": "商品A",               // 冗余（下单时快照，避免商品改名影响历史订单）
            "price": NumberDecimal("99.00") // 冗余（下单时价格快照）
        }
    ]
}

// 不推荐：无边界、无限增长的数组

{
    "userId": "user_10001",
    "orders": [
        { "orderId": "ORD_001", "amount": 99.00, "date": ISODate("...") },
        { "orderId": "ORD_002", "amount": 158.00, "date": ISODate("...") },
        // ... 活跃用户可能累积数万条订单，触发 16MB 限制
    ]
}

// 推荐：将数组元素拆分为独立文档，通过外键关联
// 用户文档
{
    "userId": "user_10001",
    "name": "张三",
    "orderCount": 1024
}

// 订单文档（独立集合）
{
    "orderId": "ORD_001",
    "userId": "user_10001",   // 外键关联
    "amount": 99.00,
    "date": ISODate("2024-03-15T10:30:00Z")
}

// 正确的类型使用
{
    "_id": ObjectId("65f3a2b8c1d2e3f4a5b6c7d8"),  // ObjectId
    "orderId": NumberLong("20240315000001"),       // 大整数
    "amount": NumberDecimal("199.99"),             // 金额用 Decimal128
    "createTime": ISODate("2024-03-15T10:30:00Z"), // 日期用 Date
    "status": "paid"                               // 状态用字符串枚举
}

// 错误的类型使用
{
    "_id": "random-uuid-string",          // 随机字符串影响性能
    "orderId": "20240315000001",          // 字符串无法数值排序
    "amount": 199.99,                     // Double 有精度问题
    "createTime": "2024-03-15 10:30:00",  // 字符串无法日期运算
    "status": 1                           // 数字含义不明
}

// 推荐：使用默认 ObjectId
{ "_id": ObjectId("65f3a2b8c1d2e3f4a5b6c7d8") }

// 可以：自定义递增 ID（需确保递增特性）
{ "_id": NumberLong("20240315000001") }

// 禁止：随机字符串（影响写入性能）
{ "_id": "550e8400-e29b-41d4-a716-446655440000" }

// 创建带验证规则的集合
db.createCollection("t_users", {
    validator: {
        $jsonSchema: {
            bsonType: "object",
            required: ["userName", "email", "createTime"],
            properties: {
                userName: {
                    bsonType: "string",
                    minLength: 2,
                    maxLength: 50,
                    description: "用户名，必填，2-50 个字符"
                },
                email: {
                    bsonType: "string",
                    pattern: "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\\\.[a-zA-Z]{2,}$",
                    description: "邮箱，必填，需符合邮箱格式"
                },
                age: {
                    bsonType: "int",
                    minimum: 0,
                    maximum: 150,
                    description: "年龄，可选，0-150 的整数"
                },
                status: {
                    enum: ["active", "inactive", "deleted"],
                    description: "状态，枚举值"
                },
                createTime: {
                    bsonType: "date",
                    description: "创建时间，必填"
                }
            }
        }
    },
    validationLevel: "strict",    // strict: 所有写入都验证
    validationAction: "error"     // error: 验证失败则拒绝写入
});