58 lines
3.6 KiB
Markdown
58 lines
3.6 KiB
Markdown
|
# VPP AI Platform · 虚拟电厂多时空协同智能运营平台
|
|||
|
|
|
|||
|
|
AI-assisted operations platform for a virtual power plant (VPP) in Hubei, China:
|
|||
|
|
five LLM agents propose market bids, resource dispatch, and load-control plans;
|
|||
|
|
a deterministic safety chain (rule check → simulation → envelope/human approval →
|
|||
|
|
execution permit) governs everything before any external effect. **The LLM never
|
|||
|
|
computes numbers and never touches the second-level control loop.**
|
|||
|
|
|
|||
|
|
**Status: architecture/design phase.** No implementation code yet. The design is
|
|||
|
|
complete and internally consistent (docs 00–13); implementation follows
|
|||
|
|
[ROADMAP.md](ROADMAP.md), starting with M1.
|
|||
|
|
|
|||
|
|
## Orientation
|
|||
|
|
|
|||
|
|
| You are… | Start with |
|
|||
|
|
|---|---|
|
|||
|
|
| A coding agent about to implement | [CLAUDE.md](CLAUDE.md), then docs/00, 01, 09, 11 |
|
|||
|
|
| New to the project | [docs/00-overview.md](docs/00-overview.md) → [docs/07-scenario-walkthrough.md](docs/07-scenario-walkthrough.md) (the end-to-end reference scenario) |
|
|||
|
|
| Reviewing the business case | [proposal.md](proposal.md) (申报材料, source of requirements) |
|
|||
|
|
| Looking for a settled decision | [docs/adr/](docs/adr/) |
|
|||
|
|
| Wondering what's still undecided | [docs/open-questions.md](docs/open-questions.md) |
|
|||
|
|
|
|||
|
|
## Document map (docs are in Chinese; implementation-facing files in English)
|
|||
|
|
|
|||
|
|
| Doc | Content |
|
|||
|
|
|---|---|
|
|||
|
|
| [00-overview](docs/00-overview.md) | System context, two-plane architecture, business objects |
|
|||
|
|
| [01-principles](docs/01-principles.md) | 9 principles + 8 hard invariants (binding for all code) |
|
|||
|
|
| [02-cognitive-plane](docs/02-cognitive-plane.md) | Five agents, Runtime, memory, Case Desk |
|
|||
|
|
| [03-safety-chain](docs/03-safety-chain.md) | Proposal state machine, envelopes, permits, staleness |
|
|||
|
|
| [04-control-plane](docs/04-control-plane.md) | Execution engine, edge autonomy, time/space cascades |
|
|||
|
|
| [05-skills-and-data](docs/05-skills-and-data.md) | Skill contracts, five-store data layer, policy packs |
|
|||
|
|
| [06-integration](docs/06-integration.md) | External system boundaries and degraded channels |
|
|||
|
|
| [07-scenario-walkthrough](docs/07-scenario-walkthrough.md) | Day-ahead spot bidding, D-1 → D → D+1 |
|
|||
|
|
| [08-implementation](docs/08-implementation.md) | Stack, LLM abstraction, deployment, milestones |
|
|||
|
|
| [09-runtime-implementation](docs/09-runtime-implementation.md) | Runtime on Mastra: workflows, suspend/resume, lineage |
|
|||
|
|
| [10-federation](docs/10-federation.md) | Cross-province boundary: signed artifacts only |
|
|||
|
|
| [11-contracts](docs/11-contracts.md) | Ports, canonical objects, TS↔Python contract pipeline |
|
|||
|
|
| [12-evaluation](docs/12-evaluation.md) | Four-layer evals, change gates, KPI definitions |
|
|||
|
|
| [13-risks-failure-modes](docs/13-risks-failure-modes.md) | FMEA, top-5 risks, kill-switch hierarchy |
|
|||
|
|
|
|||
|
|
Supporting: [brainstorming.md](brainstorming.md) is an independent peer review
|
|||
|
|
whose findings were integrated (see docs/01 invariants note);
|
|||
|
|
[GLOSSARY.md](GLOSSARY.md) maps Chinese domain terms to canonical code names.
|
|||
|
|
|
|||
|
|
## Target repository layout (from docs/09 §7)
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
packages/
|
|||
|
|
├── domain/ # zod schemas — single source of truth for all business objects
|
|||
|
|
├── runtime/ # Mastra instance, workflows, agents, tool registry, triggers
|
|||
|
|
├── services/ # deterministic services: policy engine, envelopes, ledger, authority
|
|||
|
|
├── adapters/ # anti-corruption layers: trading platform, dispatch, metering
|
|||
|
|
├── evals/ # eval harness, datasets, judges (docs/12 §5)
|
|||
|
|
└── skills-py/ # Python skill services (forecasting, MILP optimization, simulation)
|
|||
|
|
contracts/ # generated JSON Schema + golden fixtures (cross-language contract)
|
|||
|
|
```
|