Architecture
=============

Module Layout
--------------

.. code-block:: none

   psipose/
   ├── base.py                      # QuantumEstimator base class
   ├── encoders/                    # Data encoding circuits
   │   ├── _base.py                # BaseEncoder abstract class
   │   ├── angle.py                # AngleEncoder
   │   └── amplitude.py            # AmplitudeEncoder
   ├── ansatze/                    # Parameterized quantum circuits
   │   ├── _base.py               # BaseAnsatz abstract class
   │   ├── hardware_efficient.py   # HardwareEfficientAnsatz
   │   └── strongly_entangling.py  # StronglyEntanglingAnsatz
   ├── estimators/                 # sklearn-compatible estimators
   │   ├── vqc.py                 # VQCClassifier
   │   ├── qsvc.py                # QSVC
   │   └── vqc_regressor.py       # VQCRegressor
   └── kernels/                    # Quantum kernels
       └── fidelity.py             # FidelityQuantumKernel

Key Abstractions
-----------------

**Encoder:** Takes classical features and applies them to qubits.

**Ansatz:** A parametrized quantum circuit with trainable weights.

**Estimator:** The sklearn-compatible class combining encoder + ansatz + optimizer.