sequenceDiagram
    participant User
    participant App (Flutter)
    participant API (Node.js)
    participant DB (MongoDB)

    User->>App: 1. กรอก Email/Password
    App->>API: 2. ส่ง POST /api/auth/login
    API->>DB: 3. ค้นหา User
    DB-->>API: พบ User (ได้ Password Hash)
    API->>API: 4. ตรวจสอบรหัสผ่าน (bcrypt)
    
    alt รหัสผ่านถูกต้อง
        API->>API: 5. สร้าง JWT Token
        API-->>App: 6. ส่ง Token กลับไป { token, user }
        App->>App: 7. บันทึก Token ลงเครื่อง (Session)
        App-->>User: 8. เข้าสู่หน้า Home
    else รหัสผ่านผิด
        API-->>App: Error (401 Unauthorized)
        App-->>User: แสดงแจ้งเตือน
    end

/* backend/src/models/User.js */
import mongoose from "mongoose";

**อธิบายทีละบรรทัด (Imports):**

- `import mongoose from "mongoose"`
  - Library สำหรับเชื่อมต่อ MongoDB และสร้าง Schema Model

**อธิบาย:**

const UserSchema = new mongoose.Schema(
  {
    email: { 
      type: String, 
      unique: true, // สำคัญ: ห้ามอีเมลซ้ำ
      required: true, 
      index: true // ช่วยให้ค้นหาเร็วขึ้น
    },
    passwordHash: { 
      type: String, 
      required: true // เราไม่เก็บ password ดิบ แต่เก็บ Hash
    },
    displayName: { 
      type: String, 
      default: "" 
    },
    role: { 
      type: String, 
      enum: ["user", "admin"], // กำหนดสิทธิ์ผู้ใช้
      default: "user" 
    },
    profile: { // เก็บข้อมูลส่วนตัวแยกเป็น object
      bio: { type: String, default: '' },
      avatar: { type: String, default: '' },
      phone: { type: String, default: '' }
    }
  },
  { timestamps: true } // สร้าง createdAt, updatedAt อัตโนมัติ
);

export const User = mongoose.model("User", UserSchema);

/* backend/src/routes/auth.js */

// 1. รับข้อมูลจาก Client
authRouter.post("/register", async (req, res) => {
  // 1.1 ตรวจสอบความถูกต้องของข้อมูล (Validation)
  const schema = z.object({
    email: z.string().email(),
    password: z.string().min(6), // รหัสผ่านขั้นต่ำ 6 ตัว
    displayName: z.string().optional()
  });
  const data = schema.parse(req.body);

  // 1.2 เช็คว่าอีเมลนี้มีคนใช้ไปหรือยัง?
  const exists = await User.findOne({ email: data.email });
  if (exists) {
    return res.status(409).json({ ok: false, message: "Email already used" });
  }

  // 1.3 ⚠️ ขั้นตอนสำคัญ: Hash Password
  // ห้ามบันทึกรหัสผ่านดิบๆ ลง Database เด็ดขาด!
  const passwordHash = await bcrypt.hash(data.password, 10);
  
  // 1.4 บันทึกลงฐานข้อมูล
  const user = await User.create({
    email: data.email,
    passwordHash, // เก็บตัวที่ Hash แล้ว
    displayName: data.displayName || ""
  });

  // 1.5 สร้าง Token ให้ทันที (เพื่อให้ User ใช้งานได้เลยไม่ต้อง Login ซ้ำ)
  const token = jwt.sign(
    { _id: user._id, role: user.role }, 
    process.env.JWT_SECRET, 
    { expiresIn: "30d" }
  );
  
  // 1.6 ส่งผลลัพธ์กลับไป
  res.json({ ok: true, token, user });
});

authRouter.post("/login", async (req, res) => {
  try {
    const { email, password } = req.body;

    // 1. ค้นหา User จาก Email
    const user = await User.findOne({ email });
    if (!user) {
      // เทคนิค Security: ตอบแบบคลุมเครือว่าผิดที่อะไร
      return res.status(401).json({ ok: false, message: "Invalid credentials" });
    }

    // 2. ตรวจสอบรหัสผ่าน
    // เอา password ที่พิมพ์มา เทียบกับ passwordHash ใน DB
    const isMatch = await bcrypt.compare(password, user.passwordHash);
    if (!isMatch) {
      return res.status(401).json({ ok: false, message: "Invalid credentials" });
    }

    // 3. สร้าง Token (บัตรผ่าน)
    const token = jwt.sign(
      { 
        _id: user._id, 
        email: user.email, 
        role: user.role 
      }, 
      process.env.JWT_SECRET, 
      { expiresIn: "30d" } // หมดอายุใน 30 วัน
    );
    
    res.json({ ok: true, token, user });

  } catch (error) {
    res.status(500).json({ ok: false, message: "Login failed" });
  }
});

class Session {
  static String? token; // เก็บ Token ใน RAM เพื่อความเร็ว
  static Map<String, dynamic>? user; // เก็บข้อมูล User

  // เริ่มต้น Load ข้อมูลจาก Disk ลง RAM
  static Future<void> init() async {
    final prefs = await SharedPreferences.getInstance();
    token = prefs.getString('auth_token');
    
    // Load User object (ที่เก็บเป็น JSON String)
    final userStr = prefs.getString('auth_user');
    if (userStr != null) {
      user = jsonDecode(userStr);
    }
  }

  // เมื่อ Login สำเร็จ ให้บันทึก
  static Future<void> save(String newToken, Map<String, dynamic> newUser) async {
    // 1. save to memory
    token = newToken;
    user = newUser;
    
    // 2. save to disk (persistent)
    final prefs = await SharedPreferences.getInstance();
    await prefs.setString('auth_token', newToken);
    await prefs.setString('auth_user', jsonEncode(newUser));
  }

  // เมื่อ Logout ให้ลบทิ้ง
  static Future<void> clear() async {
    token = null; 
    user = null;
    final prefs = await SharedPreferences.getInstance();
    await prefs.remove('auth_token');
    await prefs.remove('auth_user');
  }

  // เช็คสถานะง่ายๆ ว่า Login อยู่ไหม
  static bool get isLoggedIn => token != null;
}

// ฟังก์ชันเมื่อกดปุ่ม Login
Future<void> _login() async {
  setState(() => loading = true); // หมุนติ้วๆ

  try {
    // 1. เรียก API
    final data = await AuthApi.login(
      email: emailController.text,
      password: passwordController.text,
    );
    
    // 2. ถ้าผ่าน ให้บันทึก Session
    await Session.save(data['token'], data['user']);

    // 3. เปลี่ยนหน้าไป AppShell (หน้าหลัก)
    if (!mounted) return;
    Navigator.pushReplacement(
      context,
      MaterialPageRoute(builder: (_) => const AppShell()),
    );

  } catch (e) {
    // ถ้า Login ไม่ผ่าน แสดง Error
    setState(() => error = "อีเมลหรือรหัสผ่านไม่ถูกต้อง");
  } finally {
    setState(() => loading = false); // หยุดหมุน
  }
}

class _SplashScreenState extends State<SplashScreen> {
  @override
  void initState() {
    super.initState();
    _checkAuth();
  }

  Future<void> _checkAuth() async {
    // 1. โหลดข้อมูล Session
    await Session.init();

    // 2. หน่วงเวลาเล็กน้อย (เพื่อความสวยงาม ไม่ให้แว้บไปมา)
    await Future.delayed(const Duration(seconds: 1));

    if (!mounted) return;

    // 3. ตัดสินใจว่าจะไปไหน?
    if (Session.isLoggedIn) {
      // มี Token -> ไปหน้าหลักเลย
      Navigator.pushReplacement(context, MaterialPageRoute(builder: (_) => const AppShell()));
    } else {
      // ไม่มี Token -> ไปหน้า Login
      Navigator.pushReplacement(context, MaterialPageRoute(builder: (_) => const LoginScreen()));
    }
  }
}