3.3. ソフトウェアコード及びテスト結果の評価基準

/**
 * ユーザー登録処理を行うクラス
 */
public class UserRegistration {

    /**
     * ユーザー登録を実行するメソッド
     * @param username ユーザー名
     * @param email メールアドレス
     * @param password パスワード
     * @return 登録成功時はtrue、失敗時はfalse
     */
    public boolean registerUser(String username, String email, String password) {
        // REQ-001: ユーザー名の妥当性チェック
        if (!isValidUsername(username)) {
            return false;
        }

        // REQ-002: メールアドレスの妥当性チェック
        if (!isValidEmail(email)) {
            return false;
        }

        // REQ-003: パスワードの強度チェック
        if (!isStrongPassword(password)) {
            return false;
        }

        // REQ-004: ユーザー情報のデータベース登録
        boolean registrationSuccess = saveUserToDatabase(username, email, password);

        // REQ-005: 登録完了メールの送信
        if (registrationSuccess) {
            sendWelcomeEmail(email);
        }

        return registrationSuccess;
    }

    // 各メソッドの実装は省略
    private boolean isValidUsername(String username) { /* 実装省略 */ }
    private boolean isValidEmail(String email) { /* 実装省略 */ }
    private boolean isStrongPassword(String password) { /* 実装省略 */ }
    private boolean saveUserToDatabase(String username, String email, String password) { /* 実装省略 */ }
    private void sendWelcomeEmail(String email) { /* 実装省略 */ }
}

/**
 * 従業員情報を管理するクラス
 */
public class EmployeeManager {
    // 定数は大文字のスネークケースで定義
    private static final int MAX_EMPLOYEES = 100;
    
    // インスタンス変数はキャメルケースで定義
    private List<Employee> employeeList;
    
    /**
     * コンストラクタ
     */
    public EmployeeManager() {
        this.employeeList = new ArrayList<>();
    }
    
    /**
     * 従業員を追加するメソッド
     * @param firstName 名
     * @param lastName 姓
     * @param age 年齢
     * @return 追加に成功した場合はtrue、失敗した場合はfalse
     */
    public boolean addEmployee(String firstName, String lastName, int age) {
        // ローカル変数もキャメルケース
        Employee newEmployee = new Employee(firstName, lastName, age);
        
        if (employeeList.size() < MAX_EMPLOYEES) {
            return employeeList.add(newEmployee);
        } else {
            return false;
        }
    }
    
    /**
     * 指定された名前の従業員を検索するメソッド
     * @param firstName 名
     * @param lastName 姓
     * @return 見つかった従業員、見つからない場合はnull
     */
    public Employee findEmployee(String firstName, String lastName) {
        for (Employee emp : employeeList) {
            if (emp.getFirstName().equals(firstName) && emp.getLastName().equals(lastName)) {
                return emp;
            }
        }
        return null;
    }
    
    /**
     * 従業員クラス（内部クラス）
     */
    private class Employee {
        private String firstName;
        private String lastName;
        private int age;
        
        // コンストラクタと getter/setter メソッドは省略
    }
}

public class Example {
    public void exampleMethod() {
        if (condition) {
            // 処理
        }
    }
}

/**
 * ユーザー情報を管理するクラス。
 */
public class UserManager {
    /**
     * 指定されたIDのユーザーを取得する。
     * @param userId ユーザーID
     * @return ユーザーオブジェクト、存在しない場合はnull
     */
    public User getUser(int userId) {
        // ユーザー取得ロジック
    }
}

/**
 * 顧客管理システム
 * REQ-001: システムは顧客情報を管理できること
 */
public class CustomerManagementSystem {

    private List<Customer> customers;
    private CustomerValidator validator;
    private CustomerDatabase database;

    public CustomerManagementSystem() {
        this.customers = new ArrayList<>();
        this.validator = new CustomerValidator();
        this.database = new CustomerDatabase();
    }

    /**
     * 新規顧客を登録する
     * REQ-002: システムは新規顧客を登録できること
     * REQ-002.1: 登録時に顧客情報のバリデーションを行うこと
     */
    public boolean registerCustomer(Customer customer) {
        // REQ-002.1: 顧客情報のバリデーション
        if (!validator.isValid(customer)) {
            log.error("Invalid customer data: " + customer);
            return false;
        }

        // REQ-002.2: 重複チェック
        if (isDuplicateCustomer(customer)) {
            log.warn("Duplicate customer: " + customer.getEmail());
            return false;
        }

        // REQ-002.3: データベースへの保存
        boolean saved = database.saveCustomer(customer);
        if (saved) {
            customers.add(customer);
            log.info("Customer registered successfully: " + customer.getId());
        }

        return saved;
    }

    /**
     * 顧客情報を更新する
     * REQ-003: システムは既存の顧客情報を更新できること
     */
    public boolean updateCustomer(Customer updatedCustomer) {
        // REQ-003.1: 更新対象の顧客が存在することを確認
        Customer existingCustomer = findCustomerById(updatedCustomer.getId());
        if (existingCustomer == null) {
            log.error("Customer not found: " + updatedCustomer.getId());
            return false;
        }

        // REQ-003.2: 更新データのバリデーション
        if (!validator.isValid(updatedCustomer)) {
            log.error("Invalid customer data: " + updatedCustomer);
            return false;
        }

        // REQ-003.3: データベースの更新
        boolean updated = database.updateCustomer(updatedCustomer);
        if (updated) {
            int index = customers.indexOf(existingCustomer);
            customers.set(index, updatedCustomer);
            log.info("Customer updated successfully: " + updatedCustomer.getId());
        }

        return updated;
    }

    /**
     * 顧客を検索する
     * REQ-004: システムは顧客情報を検索できること
     */
    public List<Customer> searchCustomers(CustomerSearchCriteria criteria) {
        // REQ-004.1: 検索条件のバリデーション
        if (!validator.isValidSearchCriteria(criteria)) {
            log.error("Invalid search criteria: " + criteria);
            return Collections.emptyList();
        }

        // REQ-004.2: データベースから顧客を検索
        List<Customer> searchResults = database.searchCustomers(criteria);
        log.info("Found " + searchResults.size() + " customers matching criteria");

        return searchResults;
    }

    /**
     * 顧客を削除する
     * REQ-005: システムは顧客情報を削除できること
     */
    public boolean deleteCustomer(String customerId) {
        // REQ-005.1: 削除対象の顧客が存在することを確認
        Customer customer = findCustomerById(customerId);
        if (customer == null) {
            log.error("Customer not found: " + customerId);
            return false;
        }

        // REQ-005.2: データベースから顧客を削除
        boolean deleted = database.deleteCustomer(customerId);
        if (deleted) {
            customers.remove(customer);
            log.info("Customer deleted successfully: " + customerId);
        }

        return deleted;
    }

    // ヘルパーメソッド（実装は省略）
    private boolean isDuplicateCustomer(Customer customer) {
        // REQ-002.2の実装
        // ...
    }

    private Customer findCustomerById(String customerId) {
        // 顧客IDに基づいて顧客を検索する実装
        // ...
    }
}