CodeSpirit.Charts 智能图表组件使用文档

CodeSpirit.Charts/             # 智能图表组件
├── Attributes/                # 特性定义
│   ├── ChartAttribute.cs      # 基础图表特性
│   ├── ChartTypeAttribute.cs  # 图表类型特性
│   ├── ChartDataAttribute.cs  # 数据源特性
│   └── ...
├── Analysis/                  # 数据分析引擎
│   ├── DataAnalyzer.cs        # 数据分析器
│   ├── ChartRecommender.cs    # 图表推荐器
│   └── ...
├── Models/                    # 数据模型
│   ├── ChartConfig.cs         # 图表配置
│   ├── ChartDataSource.cs     # 图表数据源
│   └── ...
├── Services/                  # 服务实现
│   ├── IChartService.cs       # 图表服务接口
│   ├── ChartService.cs        # 图表服务实现
│   └── ...
├── Helpers/                   # 辅助类
│   ├── ChartHelper.cs         # 图表帮助类
│   └── ...
├── Extensions/                # 扩展方法
│   ├── ChartExtensions.cs     # 图表扩展方法
│   └── ...
├── CodeSpirit.Charts.csproj   # 项目文件
└── ChartConfigBuilder.cs      # 图表配置构建器

<ItemGroup>
    <ProjectReference Include="..\..\Components\CodeSpirit.Charts\CodeSpirit.Charts.csproj" />
</ItemGroup>

// Program.cs
var builder = WebApplication.CreateBuilder(args);
// 添加图表服务
builder.Services.AddChartsService();

/// <summary>
/// 获取用户增长趋势图的配置
/// </summary>
/// <param name="dateRange">日期范围</param>
/// <returns>图表配置</returns>
[HttpGet("usergrowth")]
[Display(Name = "用户增长趋势")]
[Chart("用户增长趋势", "展示用户随时间的增长趋势")]
[ChartType(ChartType.Line)]
[ChartData(dimensionField: "Date", metricFields: new[] { "UserCount" })]
public async Task<IActionResult> GetUserGrowthStatisticsAsync([FromQuery] DateTime[] dateRange)
{
    DateTimeOffset startDate = dateRange?.Length > 0 ? dateRange[0] : DateTimeOffset.Now.AddMonths(-1);
    DateTimeOffset endDate = dateRange?.Length > 1 ? dateRange[1] : DateTimeOffset.Now.AddDays(1);

    // 获取数据
    var dailyGrowth = await _userService.GetUserGrowthAsync(startDate, endDate);
    return this.AutoChartResult(dailyGrowth);
}

[HttpGet("custom-chart")]
public async Task<ActionResult> GetCustomChart()
{
    var data = await _dataService.GetData();
    
    var chartBuilder = new ChartConfigBuilder(
        _serviceProvider, 
        _memoryCache, 
        _httpContextAccessor,
        _recommender,
        _echartGenerator);
    
    var chartConfig = await chartBuilder
        .SetTitle("自定义图表")
        .SetSubtitle("数据分析")
        .BuildChartConfigForDataAsync(data, ChartType.Bar);
    
    return Ok(new { data, chartConfig });
}

[HttpGet("recommend-charts")]
public async Task<ActionResult> GetRecommendedCharts()
{
    var data = await _dataService.GetData();
    
    var chartBuilder = new ChartConfigBuilder(
        _serviceProvider, 
        _memoryCache, 
        _httpContextAccessor,
        _recommender,
        _echartGenerator);
    
    // 获取最多3种推荐的图表配置
    var recommendedCharts = await chartBuilder.GetRecommendedChartConfigsAsync(data, 3);
    
    return Ok(new { data, recommendedCharts });
}

[HttpGet("sales-trend")]
[Chart(
    Title = "销售趋势分析", 
    Description = "按月份显示销售趋势",
    AutoRefresh = true,
    RefreshInterval = 300,
    ShowToolbox = true,
    Theme = "dark",
    Height = 500,
    EnableExport = true
)]
public async Task<ActionResult> GetSalesTrend()
{
    var data = await _salesService.GetTrendData();
    return Ok(data);
}

public class SalesViewModel
{
    [ChartData(FieldType = ChartFieldType.Category, AxisType = "x")]
    public string Month { get; set; }
    
    [ChartData(FieldType = ChartFieldType.Value, SeriesName = "销售额")]
    public decimal Sales { get; set; }
    
    [ChartData(FieldType = ChartFieldType.Value, SeriesName = "利润")]
    public decimal Profit { get; set; }
}

var config = new ChartConfig
{
    XAxis = new AxisConfig
    {
        Name = "月份",
        Type = "category",
        Data = new List<string> { "1月", "2月", "3月", "4月", "5月", "6月" }
    },
    YAxis = new AxisConfig
    {
        Name = "销售额",
        Type = "value"
    }
};

var config = new ChartConfig
{
    Series = new List<SeriesConfig>
    {
        new SeriesConfig
        {
            Name = "销售额",
            Type = "line",
            Data = new List<object> { 120, 132, 101, 134, 90, 230 },
            Label = new Dictionary<string, object>
            {
                { "show", true },
                { "position", "top" }
            }
        },
        new SeriesConfig
        {
            Name = "利润",
            Type = "line",
            Data = new List<object> { 220, 182, 191, 234, 290, 330 }
        }
    }
};