这个项目能做什么

Privacy-Friendly Analytics 是一个针对 ASP.NET Core 应用的自托管产品遥测参考实现。它允许开发者将使用数据直接收集到自身的 SQL Server 数据库中，而非依赖第三方分析平台，从而保护业务输入和用户提交的域名数据隐私。 该项目基于 .NET 10、ASP.NET Core、EF Core、SQL Server 和 TypeScript 构建，提供了一个极简仪表板，展示总事件数、页面会话、工作流启动/完成率和正面反馈率。 架构采用清晰的分层设计：浏览器向 ASP.NET Core 端点发送白名单事件，由 EF Core 持久化至 SQL Server。采集端点强制执行严格的数据最小化规则——未知事件名返回 400 错误，未知属性被丢弃，嵌套对象和任意载荷被清理器拒绝，字符串属性有大小限制，且不显式持久化任何 IP 地址。 无需账户或持久化的浏览器标识符。会话 ID 仅在页面生命周期内存在。TypeScript 客户端异步发送遥测数据，超时时间短，当分析服务不可用时不会阻塞应用程序流程。演示版包含每分钟每应用实例 60 次请求的速率限制。 预编译的事件包括：demo_opened、workflow_started、workflow_completed、feature_used 和 feedback_submitted。 本项目不构成法律建议；生产部署应根据其所在管辖区和使用场景评估适用的隐私及 ePrivacy 法规。仪表板出于演示便利而仅公开，在生产使用前应添加认证保护。