80835138e9
- README: orientation, doc map, target package layout (pointers only, no duplicated architecture content) - CLAUDE.md: agent operating manual — invariants as code-review rules, conventions, do-not list, task reading order - ROADMAP: M1-M5 with verifiable acceptance criteria, phase-2 fence - GLOSSARY: canonical Chinese-term → code-name mapping - docs/adr/: eight ADRs recording settled decisions and rejected alternatives - docs/open-questions.md: consolidated TODO(业务) tracker by owner and blocking milestone - .gitignore; untrack .DS_Store Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019u5SLNweVio6ozJX7yfxQr 🔮 View transcript: https://logs.lojong.info/s/e8u90k3t33w590r7b5y7yzqh
69 lines
4.6 KiB
Markdown
69 lines
4.6 KiB
Markdown
# GLOSSARY — 术语 → canonical code names
|
||
|
||
Docs are Chinese, code is English. **Use these exact names**; do not coin
|
||
alternatives. Columns: term, code name (type/identifier), meaning, defining doc.
|
||
|
||
## Core business objects
|
||
|
||
| 中文 | Code name | Meaning | Doc |
|
||
|---|---|---|---|
|
||
| 建议 | `Proposal` | Any action the AI wants taken; carries digest + lineage | 03 |
|
||
| 运行包络（授权） | `Envelope` | Pre-approved autonomy bounds (authority, downward) | 03 |
|
||
| 灵活性包络（能力） | `FlexibilityEnvelope` | Adjustable capability report (capability, upward; federation artifact) | 04/10 |
|
||
| 执行许可 | `ExecutionPermit` | Short-lived revocable execution credential | 03 |
|
||
| 审批 | `Approval` | Human decision bound to a proposal digest + validity window | 03 |
|
||
| 持仓账本 | `PositionLedger` / `PositionUpdate` | Shared per-timescale position & constraint cascade | 00/04 |
|
||
| 运营工单 | `DecisionCase` | Operator's unit of accountability (one objective/owner/deadline) | 02 |
|
||
| 政策包 | `PolicyPack` | Versioned, tested, executable rule bundle | 05 |
|
||
| 态势报告 | `SituationReport` | Analysis agent output: state, anomalies, risk | 02 |
|
||
| 资源画像 | `ResourceProfile` | Capacity, constraints, reliability score | 02 |
|
||
| 预测集 | `ForecastBundle` | Curves + quantile intervals + model version | 05 |
|
||
| 承诺 | `Commitment` | User or inter-province delivery commitment | 10 |
|
||
| 执行回执 / 执行报告 | `ExecutionReceipt` / `ExecutionReport` | Idempotent effect receipt / execution outcome | 04 |
|
||
| 复盘结论 | `ReviewFinding` | Structured lesson from review, written back to memory | 02 |
|
||
| 调度指令 | `DispatchOrder` | Post-permit decomposed instruction | 04 |
|
||
| 结算 | `Settlement` | Settlement facts from metering | 06 |
|
||
|
||
## Processes & components
|
||
|
||
| 中文 | Code name | Meaning | Doc |
|
||
|---|---|---|---|
|
||
| 可信执行链 | safety chain, `proposal-lifecycle` workflow | Rule check → simulation → gate → permit → release | 03 |
|
||
| 规则校核 | rule check, `PolicyEnginePort` | Deterministic compliance/constraint validation | 03/11 |
|
||
| 仿真验证 | simulation, `SimulationPort` | Revenue backtest (bids) / power-balance (control) | 03 |
|
||
| 现势复核 | fresh-state check, `FRESH_CHECK` | Pre-release re-verification; failure → `STALE` | 03 |
|
||
| 包络检查 | envelope gate, `EnvelopePort.match` | Within-bounds → auto-approve | 03 |
|
||
| 授权 | `AuthorityPort.authorize` | Issues ExecutionPermit | 11 |
|
||
| 复盘 | review (not "replay", not "retrospective" in code) | D+1 deviation attribution loop | 02 |
|
||
| 血缘 | lineage | Tool-call provenance attached to proposals | 03/09 |
|
||
| 事件信封 | `EventEnvelope` | Typed event wrapper with schemaVersion/causation | 11 |
|
||
| 认知平面 / 控制平面 | cognitive plane / control plane | Slow LLM loop / fast deterministic loop | 00 |
|
||
| 聚合单元 | `AggregationUnit` | VPP aggregation layer between province and sites | 04 |
|
||
| 边缘控制终端 | edge terminal | Second-level local closed loop | 04 |
|
||
| 熔断 | circuit breaker / kill switch (L0–L4) | Graduated shutdown hierarchy | 13 |
|
||
| 影子运行 | shadow run/mode | Full loop, simulated external effects | 08 |
|
||
|
||
## Market & domain terms
|
||
|
||
| 中文 | Code name / abbrev | Meaning |
|
||
|---|---|---|
|
||
| 虚拟电厂 | VPP | Virtual power plant |
|
||
| 现货市场 | spot market | Hubei electricity spot market |
|
||
| 日前 / 日内 / 实时 | `DAY_AHEAD` / `INTRADAY` / `REALTIME` | Timescale enum values (also `ANNUAL`, `MONTHLY`) |
|
||
| 申报 | bid (submission: declaration) | Market bid/declaration; `Proposal{type: BID}` |
|
||
| 出清 / 中标 | clearing / award | Market clearing result |
|
||
| 96 点 | 96 intervals | 15-min intervals per day; `{date, interval_index}` |
|
||
| 需求响应 | DR, demand response | |
|
||
| 辅助服务 / 调频 | ancillary services / frequency regulation | |
|
||
| 可调资源 / 可调负荷 | flexible resource / flexible load | Adjustable capacity |
|
||
| 可中断负荷 | interruptible load | Contracted curtailable load |
|
||
| 邀约 / 履约 | invitation / fulfillment | User solicitation; commitment delivery |
|
||
| 基线 | baseline | DR measurement baseline |
|
||
| 偏差考核 | deviation assessment | Penalty regime for plan-vs-actual gaps |
|
||
| 代理购电 | proxy purchase / retail agency | Buying on behalf of contracted users |
|
||
| 源网荷储 | source-grid-load-storage | Coordinated optimization scope |
|
||
| 光明电力大模型 | GuangMing power LLM (`guangming` adapter id) | State Grid's foundation model |
|
||
| 等保 | MLPS | Multi-Level Protection Scheme (security compliance) |
|
||
| 电科院 | EPRI (Hubei) | State Grid Hubei Electric Power Research Institute |
|
||
| 3060 平台 | legacy `3060` platform | Existing platform being overlaid (docs/06 §4) |
|