Elfiee 后端开发指南

概览

Elfiee 后端使用 Rust + Tauri 2 构建，核心架构基于事件溯源（Event Sourcing）和 Actor 模型。本指南涵盖 Extension 开发、Tauri Command 开发和 Engine 修改的完整流程。

五大硬性规则

1. 所有前端接口必须是 Tauri Command - 添加 #[tauri::command] + #[specta] 宏
2. 每个能力必须定义类型化 Payload - 添加 #[derive(Serialize, Deserialize, Type)]
3. Read vs Write 能力的 Entity 不同 - Write: block_id，Read: editor_id
4. 通过 Event 记录状态变更 - 使用 create_event()，不直接修改状态
5. CBAC 授权检查 - Owner 总是授权，非 Owner 需要 Grant

目录结构