إرسال بريد إلكتروني لإنشاء حساب الموظف تلقائيًا في Spring Boot | Fullstack Yazan

إرسال بريد إلكتروني لإنشاء حساب الموظف تلقائيًا في Spring Boot | Fullstack Yazan

كود الدرس

بدرسة رح نبني نظام Onboarding للموظفين عن طريق إرسال إيميل تلقائي يحتوي على رابط إنشاء الحساب.

الـ Flow

الفلو الكامل بيصير كالتالي:

المدير يعمل Create Employee
السيرفر يحفظ الموظف ويرسل إيميل على عنوانه
الموظف يفتح الإيميل ويضغط على الرابط
الرابط يودي على صفحة Sign Up
الموظف يدخل Username وPassword وينشئ حسابه

الرابط يحتوي على Token خاص بالموظف يضمن إنه بس هو يقدر ينشئ الحساب.

إضافة حقول جديدة للـ Employee Entity

بنضيف حقلين للـ Employee Entity:

@Column(name = "is_verified", columnDefinition = "boolean default false")
private Boolean isVerified = false;

@Column(name = "account_creation_token")
private String accountCreationToken;

isVerified: هل الموظف عمل Sign Up بعد؟ Default = false
accountCreationToken: الـ Token اللي رح نرفقه بالرابط

الـ columnDefinition = "boolean default false" بيضمن إنه حتى لو نسينا نحط قيمة، قاعدة البيانات بتحط false تلقائياً.

إعداد Gmail والـ Dependency

أولاً، نضيف الـ Dependency:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-mail</artifactId>

اشترك في النشرة البريدية

دروس جديدة، مقالات، وأدوات مباشرة لبريدك.

spring.mail.host=smtp.gmail.com
spring.mail.port=587
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.username=${GMAIL_APP_USERNAME}
spring.mail.password=${GMAIL_APP_PASSWORD}

backend.origin=http://localhost:8080

@Service
public class EmailService {

    @Autowired
    private JavaMailSender mailSender;

    @Value("${spring.mail.username}")
    private String fromEmail;

    @Value("${backend.origin}")
    private String origin;

    public void sendAccountCreationEmail(String toEmail, String token) {
        String link = origin + "/auth/sign-up?token=" + token;

        SimpleMailMessage message = new SimpleMailMessage();
        message.setFrom(fromEmail);
        message.setTo(toEmail);
        message.setSubject("Create Your Account");
        message.setText("Hi, please create your account using the link below:\n" + link);

        mailSender.send(message);
    }
}

@Override
public Employee create(EmployeeCreate dto) {
    String token = UUID.randomUUID().toString();

    Employee employee = new Employee();
    employee.setFirstName(dto.firstName());
    employee.setLastName(dto.lastName());
    employee.setEmail(dto.email());
    employee.setIsVerified(false);
    employee.setAccountCreationToken(token);

    employeeRepository.save(employee);

    emailService.sendAccountCreationEmail(employee.getEmail(), token);

    return employee;
}

@PostMapping("/sign-up")
public ResponseEntity<GlobalResponse<String>> signUp(
        @Valid @RequestBody SignUpRequest request,
        @RequestParam String token) {
    authService.signUp(request, token);
    return new ResponseEntity<>(
        new GlobalResponse<>("Signed up successfully"), HttpStatus.CREATED
    );
}

Optional<Employee> findOneByAccountCreationToken(String token);

public void signUp(SignUpRequest request, String token) {
    Employee employee = employeeRepository
        .findOneByAccountCreationToken(token)
        .orElseThrow(() -> CustomResponseException.badRequest("Invalid token"));

    UserAccount account = new UserAccount();
    account.setUsername(request.username());
    account.setPassword(passwordEncoder.encode(request.password()));
    account.setEmployee(employee);

    userAccountRepository.save(account);

    // نمسح التوكن بعد الاستخدام ونضع الموظف كـ verified
    employee.setAccountCreationToken(null);
    employee.setIsVerified(true);
    employeeRepository.save(employee);
}