Giai đoạn 2 — App Di động

CREATE TABLE t_huca_event_attendances (
    Id              BIGINT IDENTITY(1,1) PRIMARY KEY,
    EventId         BIGINT NOT NULL,    -- FK -> t_huca_events
    UserId          BIGINT NOT NULL,    -- FK -> t_huca_users
    -- Thông tin điểm danh
    CheckInTime     DATETIME2 NOT NULL DEFAULT GETUTCDATE(),
    CheckOutTime    DATETIME2,
    Method          NVARCHAR(20) NOT NULL,      -- QR, GPS, Manual
    -- Vị trí GPS
    Latitude        DECIMAL(10,7),
    Longitude       DECIMAL(10,7),
    IsWithinGeofence BIT,              -- So sánh với Events.GeoFenceRadius
    -- Thiết bị (chống gian lận)
    DeviceInfo      NVARCHAR(200),
    DeviceId        NVARCHAR(100),
    -- Trạng thái xác thực
    Status          NVARCHAR(20) NOT NULL DEFAULT 'Valid',
    Note            NVARCHAR(500)
);

CSV mở App → Nhấn nút Điểm danh
    → Quét mã QR sự kiện (Events.EventQrCode)
    → App ghi nhận GPS tại thời điểm quét
    → So sánh GPS với tọa độ sự kiện + GeoFenceRadius
    → IsWithinGeofence = true/false
    → Lưu vào t_huca_event_attendances
    → Cập nhật EventRegistrations.Status = 'Attended'

CSV mở App tại địa điểm sự kiện
    → App tự động phát hiện khi vào GeoFence
    → Ghi nhận điểm danh tự động
    → Method = 'GPS', IsWithinGeofence = true

CREATE TABLE t_huca_user_locations (
    Id              BIGINT IDENTITY(1,1) PRIMARY KEY,
    UserId          BIGINT NOT NULL UNIQUE,    -- 1 bản ghi/người dùng
    Latitude        DECIMAL(10,7) NOT NULL,
    Longitude       DECIMAL(10,7) NOT NULL,
    -- Vị trí xấp xỉ (bảo vệ riêng tư)
    ApproxDistrict  NVARCHAR(100),
    ApproxProvince  NVARCHAR(100),
    -- Cài đặt chia sẻ
    SharingMode     NVARCHAR(20) NOT NULL DEFAULT 'Never',
    ShowExactLocation BIT NOT NULL DEFAULT 0,
    LastUpdatedAt   DATETIME2 NOT NULL DEFAULT GETUTCDATE()
);

-- Truy vấn tìm CSV trong bán kính R km (dùng Haversine formula)
-- Hoặc bổ sung SQL Server Spatial Index cho hiệu năng cao hơn

SELECT u.Id, u.FullName, u.AvatarUrl, u.AcademicYearId,
       -- Khoảng cách (km)
       6371 * ACOS(
           COS(RADIANS(@UserLat)) * COS(RADIANS(l.Latitude))
           * COS(RADIANS(l.Longitude) - RADIANS(@UserLng))
           + SIN(RADIANS(@UserLat)) * SIN(RADIANS(l.Latitude))
       ) AS DistanceKm,
       -- Hiển thị theo setting riêng tư
       CASE WHEN l.ShowExactLocation = 1 THEN l.Latitude ELSE NULL END AS Latitude,
       CASE WHEN l.ShowExactLocation = 1 THEN l.Longitude ELSE NULL END AS Longitude,
       l.ApproxDistrict,
       l.ApproxProvince
FROM t_huca_user_locations l
JOIN t_huca_users u ON u.Id = l.UserId
WHERE l.SharingMode != 'Never'
  AND l.LastUpdatedAt > DATEADD(HOUR, -1, GETUTCDATE())   -- Vị trí cập nhật trong 1h
  AND 6371 * ACOS(...) <= @RadiusKm                        -- Trong bán kính R km
ORDER BY DistanceKm;

ALTER TABLE t_huca_user_locations
    ADD LocationGeo AS geography::Point(Latitude, Longitude, 4326) PERSISTED;
CREATE SPATIAL INDEX SIX_user_locations ON t_huca_user_locations(LocationGeo);

CREATE TABLE t_huca_device_tokens (
    Id              BIGINT IDENTITY(1,1) PRIMARY KEY,
    UserId          BIGINT NOT NULL,
    DeviceToken     NVARCHAR(500) NOT NULL,    -- FCM token (Android) / APNs token (iOS)
    Platform        NVARCHAR(10) NOT NULL,      -- iOS, Android
    DeviceModel     NVARCHAR(100),
    AppVersion      NVARCHAR(20),
    IsActive        BIT NOT NULL DEFAULT 1,
    CreatedAt       DATETIME2 NOT NULL DEFAULT GETUTCDATE(),
    UpdatedAt       DATETIME2
);

Trigger (Event/Message/...)
    → Insert t_huca_notifications (Channel = 'Push')
    → Query t_huca_device_tokens (UserId, IsActive = 1)
    → Gửi qua FCM (Android) / APNs (iOS)
    → Cập nhật notifications.ReadAt khi người dùng tap