docs: add XML documentation and ConfigManager implementation plans
Add comprehensive XML documentation (param/returns tags) across 132 source files to improve IntelliSense and API discoverability. Include ConfigManager design documents and implementation plans for phases 1-9.
This commit is contained in:
@@ -5,56 +5,144 @@ namespace JdeScoping.ConfigManager.Models;
|
||||
/// </summary>
|
||||
public class PipelinesConfigModel
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the pipeline settings.
|
||||
/// </summary>
|
||||
public PipelineSettings Settings { get; set; } = new();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the default schedules for all pipelines.
|
||||
/// </summary>
|
||||
public ScheduleDefaults ScheduleDefaults { get; set; } = new();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the collection of named pipelines.
|
||||
/// </summary>
|
||||
public Dictionary<string, PipelineModel> Pipelines { get; set; } = new();
|
||||
}
|
||||
|
||||
public class PipelineSettings
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the timezone for scheduling operations.
|
||||
/// </summary>
|
||||
public string Timezone { get; set; } = "UTC";
|
||||
}
|
||||
|
||||
public class ScheduleDefaults
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the default mass data refresh schedule.
|
||||
/// </summary>
|
||||
public ScheduleModel Mass { get; set; } = new() { Enabled = true, IntervalMinutes = 10080, PrePurge = true, ReIndex = true };
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the default daily data refresh schedule.
|
||||
/// </summary>
|
||||
public ScheduleModel Daily { get; set; } = new() { Enabled = true, IntervalMinutes = 1440 };
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the default hourly data refresh schedule.
|
||||
/// </summary>
|
||||
public ScheduleModel Hourly { get; set; } = new() { Enabled = true, IntervalMinutes = 60 };
|
||||
}
|
||||
|
||||
public class PipelineModel
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the source configuration for data extraction.
|
||||
/// </summary>
|
||||
public PipelineSource Source { get; set; } = new();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the schedule configurations for this pipeline.
|
||||
/// </summary>
|
||||
public PipelineSchedules Schedules { get; set; } = new();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the destination configuration for data loading.
|
||||
/// </summary>
|
||||
public PipelineDestination Destination { get; set; } = new();
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets optional scripts to execute after pipeline completion.
|
||||
/// </summary>
|
||||
public string[]? PostScripts { get; set; }
|
||||
}
|
||||
|
||||
public class PipelineSource
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the source database connection name.
|
||||
/// </summary>
|
||||
public string Connection { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the query to extract data from the source.
|
||||
/// </summary>
|
||||
public string Query { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the optional mass query for full data extraction.
|
||||
/// </summary>
|
||||
public string? MassQuery { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the query parameters and their definitions.
|
||||
/// </summary>
|
||||
public Dictionary<string, ParameterDefinition> Parameters { get; set; } = new();
|
||||
}
|
||||
|
||||
public class ParameterDefinition
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the parameter name.
|
||||
/// </summary>
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the optional parameter format string.
|
||||
/// </summary>
|
||||
public string? Format { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the optional parameter source or derivation logic.
|
||||
/// </summary>
|
||||
public string? Source { get; set; }
|
||||
}
|
||||
|
||||
public class PipelineSchedules
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the mass refresh schedule for this pipeline.
|
||||
/// </summary>
|
||||
public ScheduleModel? Mass { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the daily refresh schedule for this pipeline.
|
||||
/// </summary>
|
||||
public ScheduleModel? Daily { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the hourly refresh schedule for this pipeline.
|
||||
/// </summary>
|
||||
public ScheduleModel? Hourly { get; set; }
|
||||
}
|
||||
|
||||
public class PipelineDestination
|
||||
{
|
||||
/// <summary>
|
||||
/// Gets or sets the destination table name.
|
||||
/// </summary>
|
||||
public string Table { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the columns used to match existing records for updates.
|
||||
/// </summary>
|
||||
public string[] MatchColumns { get; set; } = [];
|
||||
|
||||
/// <summary>
|
||||
/// Gets or sets the columns to exclude from update operations.
|
||||
/// </summary>
|
||||
public string[] ExcludeFromUpdate { get; set; } = [];
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user