feat(cpp-object-oriented-modular-refactoring): step 3 - foundation-google-style

include/fesa/solvers/linear/linear_solver.h

@@ -0,0 +1,30 @@
+#ifndef FESA_SOLVERS_LINEAR_LINEAR_SOLVER_H_
+#define FESA_SOLVERS_LINEAR_LINEAR_SOLVER_H_
+
+#include "fesa/core/status.h"
+
+namespace fesa {
+
+class SparseMatrix;
+class Vector;
+
+/// @brief Separates reusable factorization from RHS substitution.
+class LinearSolver {
+ public:
+  /// @brief Destroys a backend-neutral linear solver.
+  virtual ~LinearSolver() = default;
+
+  /// @brief Factorizes a validated free-equation matrix for reuse.
+  /// @return Success or a structured solver failure.
+  virtual Status Factorize(const SparseMatrix& matrix) = 0;
+
+  /// @brief Substitutes one right-hand side using retained factorization.
+  /// @param rhs Immutable right-hand side in free-equation order.
+  /// @param solution Updated only after successful finite substitution.
+  /// @return Success or a structured solver failure.
+  virtual Status Solve(const Vector& rhs, Vector& solution) const = 0;
+};
+
+}  // namespace fesa
+
+#endif  // FESA_SOLVERS_LINEAR_LINEAR_SOLVER_H_

include/fesa/solvers/linear/linear_solver.hpp

@@ -1,18 +0,0 @@
-#pragma once
-
-#include "fesa/core/status.hpp"
-
-namespace fesa {
-
-class SparseMatrix;
-class Vector;
-
-// Separates reusable matrix factorization from right-hand-side substitution.
-class LinearSolver {
-public:
-    virtual ~LinearSolver() = default;
-    virtual Status factorize(const SparseMatrix& matrix) = 0;
-    virtual Status solve(const Vector& rhs, Vector& solution) const = 0;
-};
-
-} // namespace fesa

include/fesa/solvers/linear/mkl_pardiso_solver.h

@@ -0,0 +1,32 @@
+#ifndef FESA_SOLVERS_LINEAR_MKL_PARDISO_SOLVER_H_
+#define FESA_SOLVERS_LINEAR_MKL_PARDISO_SOLVER_H_
+
+#include <memory>
+
+#include "fesa/solvers/linear/linear_solver.h"
+
+namespace fesa {
+
+/// @brief Adapts retained oneMKL PARDISO state behind LinearSolver.
+class MklPardisoSolver final : public LinearSolver {
+ public:
+  /// @brief Constructs an empty, unfactorized PARDISO adapter.
+  MklPardisoSolver();
+
+  /// @brief Releases retained PARDISO backend state.
+  ~MklPardisoSolver() override;
+
+  /// @brief Validates and factorizes a symmetric free-equation matrix.
+  Status Factorize(const SparseMatrix& matrix) override;
+
+  /// @brief Substitutes one right-hand side without refactorization.
+  Status Solve(const Vector& rhs, Vector& solution) const override;
+
+ private:
+  class Impl;
+  std::unique_ptr<Impl> impl_;
+};
+
+}  // namespace fesa
+
+#endif  // FESA_SOLVERS_LINEAR_MKL_PARDISO_SOLVER_H_

include/fesa/solvers/linear/mkl_pardiso_solver.hpp

@@ -1,23 +0,0 @@
-#pragma once
-
-#include "fesa/solvers/linear/linear_solver.hpp"
-
-#include <memory>
-
-namespace fesa {
-
-// Keeps every oneMKL type and the retained factorization in the private Impl.
-class MklPardisoSolver final : public LinearSolver {
-public:
-    MklPardisoSolver();
-    ~MklPardisoSolver() override;
-
-    Status factorize(const SparseMatrix& matrix) override;
-    Status solve(const Vector& rhs, Vector& solution) const override;
-
-private:
-    class Impl;
-    std::unique_ptr<Impl> impl_;
-};
-
-} // namespace fesa