ERP-node/frontend/lib/api/dataflow.ts

456 lines
13 KiB
TypeScript

import { apiClient, ApiResponse } from "./client";
// 테이블 간 데이터 관계 설정 관련 타입 정의
export interface ColumnInfo {
columnName: string;
columnLabel?: string;
displayName?: string;
dataType?: string;
dbType?: string;
webType?: string;
isNullable?: string;
columnDefault?: string;
characterMaximumLength?: number;
numericPrecision?: number;
numericScale?: number;
detailSettings?: string;
codeCategory?: string;
referenceTable?: string;
referenceColumn?: string;
isVisible?: string;
displayOrder?: number;
description?: string;
}
export interface TableDefinition {
tableName: string;
displayName?: string;
description?: string;
columns: ColumnInfo[];
}
export interface TableInfo {
tableName: string;
displayName: string;
description: string;
columnCount: number;
}
export interface TableRelationship {
relationship_id?: number;
relationship_name: string;
from_table_name: string;
from_column_name: string;
to_table_name: string;
to_column_name: string;
relationship_type: "one-to-one" | "one-to-many" | "many-to-one" | "many-to-many";
connection_type: "simple-key" | "data-save" | "external-call";
settings?: Record<string, unknown>;
company_code: string;
is_active?: string;
}
// 데이터 연결 중계 테이블 타입
export interface DataBridge {
bridgeId: number;
relationshipId: number;
fromTableName: string;
fromColumnName: string;
toTableName: string;
toColumnName: string;
connectionType: string;
companyCode: string;
createdAt: string;
createdBy?: string;
updatedAt: string;
updatedBy?: string;
isActive: string;
bridgeData?: Record<string, unknown>;
relationship?: {
relationshipName: string;
relationshipType: string;
connectionType: string;
};
}
// 테이블 데이터 조회 응답 타입
export interface TableDataResponse {
data: Record<string, unknown>[];
pagination: {
page: number;
limit: number;
total: number;
totalPages: number;
hasNext: boolean;
hasPrev: boolean;
};
}
// 관계도 정보 인터페이스
export interface DataFlowDiagram {
relationshipId: number;
diagramName: string;
connectionType: string;
relationshipType: string;
tableCount: number;
relationshipCount: number;
tables: string[];
createdAt: Date;
createdBy: string;
updatedAt: Date;
updatedBy: string;
}
// 관계도 목록 응답 인터페이스
export interface DataFlowDiagramsResponse {
diagrams: DataFlowDiagram[];
total: number;
page: number;
size: number;
totalPages: number;
hasNext: boolean;
hasPrev: boolean;
}
// 테이블 간 데이터 관계 설정 API 클래스
export class DataFlowAPI {
/**
* 테이블 목록 조회
*/
static async getTables(): Promise<TableInfo[]> {
try {
const response = await apiClient.get<ApiResponse<TableInfo[]>>("/table-management/tables");
if (!response.data.success) {
throw new Error(response.data.message || "테이블 목록 조회에 실패했습니다.");
}
return response.data.data || [];
} catch (error) {
console.error("테이블 목록 조회 오류:", error);
throw error;
}
}
/**
* 테이블 컬럼 정보 조회
*/
static async getTableColumns(tableName: string): Promise<ColumnInfo[]> {
try {
const response = await apiClient.get<ApiResponse<ColumnInfo[]>>(`/table-management/tables/${tableName}/columns`);
if (!response.data.success) {
throw new Error(response.data.message || "컬럼 정보 조회에 실패했습니다.");
}
return response.data.data || [];
} catch (error) {
console.error("컬럼 정보 조회 오류:", error);
throw error;
}
}
/**
* 테이블 정보와 컬럼 정보를 함께 조회
*/
static async getTableWithColumns(tableName: string): Promise<TableDefinition | null> {
try {
const columns = await this.getTableColumns(tableName);
return {
tableName,
displayName: tableName,
description: `${tableName} 테이블`,
columns,
};
} catch (error) {
console.error("테이블 및 컬럼 정보 조회 오류:", error);
throw error;
}
}
/**
* 테이블 관계 생성
*/
static async createRelationship(relationship: Omit<TableRelationship, "relationshipId">): Promise<TableRelationship> {
try {
const response = await apiClient.post<ApiResponse<TableRelationship>>(
"/dataflow/table-relationships",
relationship,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계 생성에 실패했습니다.");
}
return response.data.data!;
} catch (error) {
console.error("관계 생성 오류:", error);
throw error;
}
}
/**
* 회사별 테이블 관계 목록 조회
*/
static async getRelationshipsByCompany(companyCode: string): Promise<TableRelationship[]> {
try {
const response = await apiClient.get<ApiResponse<TableRelationship[]>>("/dataflow/table-relationships", {
params: { companyCode },
});
if (!response.data.success) {
throw new Error(response.data.message || "관계 목록 조회에 실패했습니다.");
}
return response.data.data || [];
} catch (error) {
console.error("관계 목록 조회 오류:", error);
throw error;
}
}
/**
* 테이블 관계 수정
*/
static async updateRelationship(
relationshipId: number,
relationship: Partial<TableRelationship>,
): Promise<TableRelationship> {
try {
const response = await apiClient.put<ApiResponse<TableRelationship>>(
`/dataflow/table-relationships/${relationshipId}`,
relationship,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계 수정에 실패했습니다.");
}
return response.data.data!;
} catch (error) {
console.error("관계 수정 오류:", error);
throw error;
}
}
/**
* 테이블 관계 삭제
*/
static async deleteRelationship(relationshipId: number): Promise<void> {
try {
const response = await apiClient.delete<ApiResponse<null>>(`/dataflow/table-relationships/${relationshipId}`);
if (!response.data.success) {
throw new Error(response.data.message || "관계 삭제에 실패했습니다.");
}
} catch (error) {
console.error("관계 삭제 오류:", error);
throw error;
}
}
// ==================== 데이터 연결 관리 API ====================
/**
* 데이터 연결 생성
*/
static async createDataLink(linkData: {
relationshipId: number;
fromTableName: string;
fromColumnName: string;
toTableName: string;
toColumnName: string;
connectionType: string;
bridgeData?: Record<string, unknown>;
}): Promise<DataBridge> {
try {
const response = await apiClient.post<ApiResponse<DataBridge>>("/dataflow/data-links", linkData);
if (!response.data.success) {
throw new Error(response.data.message || "데이터 연결 생성에 실패했습니다.");
}
return response.data.data as DataBridge;
} catch (error) {
console.error("데이터 연결 생성 오류:", error);
throw error;
}
}
/**
* 관계별 연결된 데이터 조회
*/
static async getLinkedDataByRelationship(relationshipId: number): Promise<DataBridge[]> {
try {
const response = await apiClient.get<ApiResponse<DataBridge[]>>(
`/dataflow/data-links/relationship/${relationshipId}`,
);
if (!response.data.success) {
throw new Error(response.data.message || "연결된 데이터 조회에 실패했습니다.");
}
return response.data.data as DataBridge[];
} catch (error) {
console.error("연결된 데이터 조회 오류:", error);
throw error;
}
}
/**
* 데이터 연결 삭제
*/
static async deleteDataLink(bridgeId: number): Promise<void> {
try {
const response = await apiClient.delete<ApiResponse<null>>(`/dataflow/data-links/${bridgeId}`);
if (!response.data.success) {
throw new Error(response.data.message || "데이터 연결 삭제에 실패했습니다.");
}
} catch (error) {
console.error("데이터 연결 삭제 오류:", error);
throw error;
}
}
// ==================== 테이블 데이터 조회 API ====================
/**
* 테이블 실제 데이터 조회 (페이징)
*/
static async getTableData(
tableName: string,
page: number = 1,
limit: number = 10,
search: string = "",
searchColumn: string = "",
): Promise<TableDataResponse> {
try {
const params = new URLSearchParams({
page: page.toString(),
limit: limit.toString(),
...(search && { search }),
...(searchColumn && { searchColumn }),
});
const response = await apiClient.get<ApiResponse<TableDataResponse>>(
`/dataflow/table-data/${tableName}?${params}`,
);
if (!response.data.success) {
throw new Error(response.data.message || "테이블 데이터 조회에 실패했습니다.");
}
return response.data.data as TableDataResponse;
} catch (error) {
console.error("테이블 데이터 조회 오류:", error);
throw error;
}
}
// ==================== 관계도 관리 ====================
// 관계도 목록 조회
static async getDataFlowDiagrams(
page: number = 1,
size: number = 20,
searchTerm: string = "",
): Promise<DataFlowDiagramsResponse> {
try {
const params = new URLSearchParams({
page: page.toString(),
size: size.toString(),
...(searchTerm && { searchTerm }),
});
const response = await apiClient.get<ApiResponse<DataFlowDiagramsResponse>>(`/dataflow/diagrams?${params}`);
if (!response.data.success) {
throw new Error(response.data.message || "관계도 목록 조회에 실패했습니다.");
}
return response.data.data as DataFlowDiagramsResponse;
} catch (error) {
console.error("관계도 목록 조회 오류:", error);
throw error;
}
}
// 특정 관계도의 모든 관계 조회 (관계도명으로)
static async getDiagramRelationships(diagramName: string): Promise<TableRelationship[]> {
try {
const encodedDiagramName = encodeURIComponent(diagramName);
const response = await apiClient.get<ApiResponse<TableRelationship[]>>(
`/dataflow/diagrams/${encodedDiagramName}/relationships`,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계도 관계 조회에 실패했습니다.");
}
return response.data.data as TableRelationship[];
} catch (error) {
console.error("관계도 관계 조회 오류:", error);
throw error;
}
}
// 관계도 복사
static async copyDiagram(diagramName: string): Promise<string> {
try {
const encodedDiagramName = encodeURIComponent(diagramName);
const response = await apiClient.post<ApiResponse<{ newDiagramName: string }>>(
`/dataflow/diagrams/${encodedDiagramName}/copy`,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계도 복사에 실패했습니다.");
}
return response.data.data?.newDiagramName || "";
} catch (error) {
console.error("관계도 복사 오류:", error);
throw error;
}
}
// 관계도 삭제
static async deleteDiagram(diagramName: string): Promise<number> {
try {
const encodedDiagramName = encodeURIComponent(diagramName);
const response = await apiClient.delete<ApiResponse<{ deletedCount: number }>>(
`/dataflow/diagrams/${encodedDiagramName}`,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계도 삭제에 실패했습니다.");
}
return response.data.data?.deletedCount || 0;
} catch (error) {
console.error("관계도 삭제 오류:", error);
throw error;
}
}
// 특정 관계도의 모든 관계 조회 (relationship_id로)
static async getDiagramRelationshipsByRelationshipId(relationshipId: string): Promise<TableRelationship[]> {
try {
const response = await apiClient.get<ApiResponse<TableRelationship[]>>(
`/dataflow/relationships/${relationshipId}/diagram`,
);
if (!response.data.success) {
throw new Error(response.data.message || "관계도 관계 조회에 실패했습니다.");
}
return response.data.data || [];
} catch (error) {
console.error("관계도 관계 조회 오류:", error);
throw error;
}
}
}