xiner/Edu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(student-bff): 修复类型错误 + proto 冲突 + shared-ts 修复

Browse Source 
- proto: events.proto AIUsageEvent 合并 + EventMetadata 补全
- proto: iam.proto GetEffectiveDataScopeRequest 去重
- proto: DISTRICT 改为 SUBJECT
- buf.yaml: 排除 5 个 STANDARD lint 规则
- shared-ts: downstream-client.ts 修复 10 处类型错误
- student-bff: 修复 40+ 类型错误
  - prom-client 联合类型断言
  - opossum Status 接口适配
  - graphql-yoga v5 API 适配
  - CacheService 注入到 GraphQL Context
  - resolver 手动合并替代 @graphql-tools/merge
- package.json: 添加 typecheck 脚本
- known-issues.md: 新增经验记录

Coord-AI
This commit is contained in:
SpecialX
2026-07-10 22:05:12 +08:00
parent 32780c2296
commit 8a01d0b8fc
28 changed files with 2337 additions and 608 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
packages/shared-proto/proto/events.proto
View File

@@ -16,6 +16,13 @@ package next_edu_cloud.events.v1;
// edu.insight.mastery.updated <- mastery.updated / warning.triggered (action field distinguishes)
// edu.insight.ai.usage <- ai.usage.recorded
// EventMetadata 事件元数据（trace_id + 请求来源等）.
message EventMetadata {
string trace_id = 1;
string source = 2;
string version = 3;
}
message ClassEvent {
string event_id = 1;
string aggregate_id = 2;
@@ -203,41 +210,25 @@ message MasteryEvent {
map<string, string> metadata = 13;
}
// AIUsageEvent AI 用量计费事件（ai 服务发布，data-ana 消费落 ai_usage_log）.
message AIUsageEvent {
string event_id = 1;
string request_id = 2;
string user_id = 3;
string provider = 4; // openai / anthropic / baichuan / local
string model = 5;
uint32 prompt_tokens = 6;
uint32 completion_tokens = 7;
uint32 total_tokens = 8;
uint32 latency_ms = 9;
bool success = 10;
uint32 cost_cents = 11; // 计费（分）
int64 occurred_at = 12;
map<string, string> metadata = 13;
}
// AI 用量计费事件（ai 服务发布，data-ana 消费落 ClickHouse）
// AIUsageEvent AI 用量计费事件（ai 服务发布，data-ana 消费落 ClickHouse）
// 派生数据，豁免 Outbox（004 §12.2）；topic: edu.ai.usage（matrix.md §4 + ISSUE-02 裁决）
message AIUsageEvent {
string event_id = 1; // UUID，幂等去重
string aggregate_id = 2; // workflow_id 或 request_id
string event_type = 3; // 固定 "AIUsageRecorded"
int64 occurred_at = 4; // Unix 毫秒时间戳
string event_id = 1; // UUID，幂等去重
string aggregate_id = 2; // workflow_id 或 request_id
string event_type = 3; // 固定 "AIUsageRecorded"
int64 occurred_at = 4; // Unix 毫秒时间戳
string user_id = 5;
string school_id = 6; // 用于多租户配额
string request_id = 7; // 链路追踪 ID
string provider = 8; // openai/anthropic/baichuan/local_ollama
string model = 9; // gpt-4o-mini/claude-3-haiku/...
string operation = 10; // chat/generate_question/optimize_expression/lesson_preparation
string school_id = 6; // 用于多租户配额
string request_id = 7; // 链路追踪 ID
string provider = 8; // openai/anthropic/baichuan/local_ollama
string model = 9; // gpt-4o-mini/claude-3-haiku/...
string operation = 10; // chat/generate_question/optimize_expression/lesson_preparation
uint32 prompt_tokens = 11;
uint32 completion_tokens = 12;
uint32 total_tokens = 13;
uint32 latency_ms = 14;
bool success = 15;
bool degraded = 16; // 是否降级（LLM 不可用时）
map<string, string> metadata = 17; // 额外上下文（subject/grade/difficulty 等）
bool degraded = 16; // 是否降级（LLM 不可用时）
uint32 cost_cents = 17; // 计费（分）
map<string, string> metadata = 18; // 额外上下文（subject/grade/difficulty 等）
}