/**
 * 登録処理
 * @throws std::invalid_argument 入力不正
 * @throws DatabaseUnavailable DB障害
 * @throws ExternalServiceFailure 外部依存失敗
 */
void registerUser(const User& user);

throw std::invalid_argument("Invalid user id");
throw DatabaseUnavailable("DB unreachable");
throw ExternalServiceFailure("External system error");

void save();
@Reviewer
API契約にスロー例外型が一切記述されていません。利用者側が捕捉不能です。契約整理してください。

/**
 * @throws DatabaseUnavailable
 */
void save();

throw DBError("fail");
throw ExternalError("fail");
throw LoggerError("fail");
@Reviewer
細粒度型乱発で利用者catchが網羅困難です。層粒度型整理してください。

throw StorageSubsystemFailure("fail");

// ドキュメント記述ゼロ
void process();
@Reviewer
契約が設計者記憶依存になっています。契約型文書文化を整備してください。

/**
 * @throws ValidationException
 * @throws StorageSubsystemFailure
 */
void process();

/**
 * ユーザ登録API
 *
 * - 入力:
 *     - User構造体
 * - 正常系: 登録完了
 * - 異常系:
 *     - std::invalid_argument: 入力違反
 *     - DatabaseUnavailable: DB障害
 *     - ExternalServiceFailure: 外部依存障害
 */
void registerUser(const User& user);

try {
    api.registerUser(u);
} catch (const std::invalid_argument& e) {
    handleValidationError(e);
} catch (const DatabaseUnavailable& e) {
    handleDBError(e);
} catch (const ExternalServiceFailure& e) {
    handleExternalError(e);
}

catch (const std::invalid_argument& e) {
    logger.warn("Validation error: {}", e.what());
}
catch (const DatabaseUnavailable& e) {
    logger.error("DB failure: {}", e.what());
}