如何构建专业的访客管理系统

// 访客预约接口定义
interface VisitorBooking {
  id: string;
  visitorName: string;
  phoneNumber: string;
  idCardNumber: string;
  visitDate: Date;
  hostEmployeeId: string;
  status: BookingStatus;
}

// 预约状态枚举
enum BookingStatus {
  Pending = 'pending',
  Approved = 'approved',
  Rejected = 'rejected',
  Completed = 'completed'
}

// 访客登记组件
class VisitorRegistration {
  private validateIdCard(idCard: string): boolean {
    // 身份证号码验证逻辑
    const regex = /^\d{17}[\dXx]$/;
    return regex.test(idCard);
  }
  
  public async submitBooking(booking: VisitorBooking): Promise {
    // 提交预约请求
    const response = await fetch('/api/visitor/bookings', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(booking)
    });
    
    if (!response.ok) {
      throw new Error('预约提交失败');
    }
  }
}

// 访客实体类
public class Visitor
{
    public Guid Id { get; set; }
    public string Name { get; set; }
    public string PhoneNumber { get; set; }
    public string IdCardNumber { get; set; }
    public string Company { get; set; }
    public DateTime VisitTime { get; set; }
    public DateTime? LeaveTime { get; set; }
    public Guid HostEmployeeId { get; set; }
    public VisitorStatus Status { get; set; }
    
    // 导航属性
    public virtual Employee HostEmployee { get; set; }
    public virtual ICollection AccessRecords { get; set; }
}

// 访客状态枚举
public enum VisitorStatus
{
    Pending,
    CheckedIn,
    CheckedOut,
    Expired
}

// 访客服务类
public class VisitorService
{
    private readonly ApplicationDbContext _context;
    
    public VisitorService(ApplicationDbContext context)
    {
        _context = context;
    }
    
    // 访客登记方法
    public async Task CheckInVisitorAsync(Visitor visitor)
    {
        visitor.Status = VisitorStatus.CheckedIn;
        visitor.VisitTime = DateTime.Now;
        
        _context.Visitors.Add(visitor);
        await _context.SaveChangesAsync();
        
        return visitor;
    }
}

// 数据库上下文配置
public class ApplicationDbContext : DbContext
{
    public ApplicationDbContext(DbContextOptions options) 
        : base(options)
    {
    }
    
    public DbSet Visitors { get; set; }
    public DbSet Employees { get; set; }
    public DbSet AccessRecords { get; set; }
    public DbSet VisitorBookings { get; set; }
    
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 访客表配置
        modelBuilder.Entity(entity =>
        {
            entity.HasKey(v => v.Id);
            entity.Property(v => v.Name).IsRequired().HasMaxLength(50);
            entity.Property(v => v.PhoneNumber).IsRequired().HasMaxLength(20);
            entity.Property(v => v.IdCardNumber).IsRequired().HasMaxLength(18);
            entity.Property(v => v.Company).HasMaxLength(100);
            
            // 建立与员工的外键关系
            entity.HasOne(v => v.HostEmployee)
                  .WithMany(e => e.Visitors)
                  .HasForeignKey(v => v.HostEmployeeId);
        });
        
        // 访问记录表配置
        modelBuilder.Entity(entity =>
        {
            entity.HasKey(ar => ar.Id);
            entity.Property(ar => ar.AccessTime).IsRequired();
            entity.Property(ar => ar.AccessPoint).HasMaxLength(50);
            
            // 建立与访客的外键关系
            entity.HasOne(ar => ar.Visitor)
                  .WithMany(v => v.AccessRecords)
                  .HasForeignKey(ar => ar.VisitorId);
        });
    }
}