Data Lineage

                        +---------------------------+
                        |   Lineage Visualization   |
                        |      Controller           |
                        |  /api/v1/lineage/viz      |
                        +------------+--------------+
                                     |
              +----------------------+----------------------+
              |                      |                      |
    +---------v--------+   +---------v--------+   +---------v--------+
    | LineageController|   | ColumnLineage    |   | Impact Analysis  |
    | /v1/lineage      |   | Controller       |   | Service          |
    |                  |   | /v1/catalog/     |   |                  |
    +--------+---------+   | lineage/column   |   +--------+---------+
             |             +--------+---------+            |
             |                      |                      |
    +--------v----------------------v----------------------v--------+
    |                      LineageService                           |
    |  - Edge CRUD, traversal, path finding, statistics             |
    +--------+-----------------------------------+---------+--------+
             |                                   |         |
    +--------v--------+              +-----------v-+   +---v--------+
    | LineageRepository|             | Column      |   | OpenLineage|
    | (PostgreSQL)     |             | Lineage Svc |   | Parser     |
    +------------------+             +-------------+   +------------+

// LineageEdge entity structure
public class LineageEdge {
    private UUID id;
    private UUID tenantId;
    private UUID sourceEntityId;
    private String sourceEntityFqn;
    private String sourceEntityType;    // "table", "view", "pipeline"
    private UUID targetEntityId;
    private String targetEntityFqn;
    private String targetEntityType;
    private LineageType lineageType;     // DIRECT, INDIRECT, DERIVED
    private LineageSource lineageSource; // PIPELINE, QUERY_ANALYSIS, MANUAL, OPENMETADATA, INTEGRATION
    private UUID pipelineId;
    private UUID pipelineRunId;
    private String sqlQuery;
    private String description;
    private Double confidence;           // 0.0 to 1.0
    private boolean manual;
    private List<ColumnLineageMapping> columnLineage;
    private Map<String, Object> metadata;
    private List<String> tags;
    private String createdBy;
}