edge split

src/device_bus/tree/DeviceTreeModel.h

@@ -5,6 +5,8 @@
 #include <QVector>
 #include <QString>
 #include <QHash>
+#include <atomic>
+#include <QMutex>
 
 // 轻量级设备树模型：从 daemon_config.json 的 device_tree 字段加载
 
@@ -53,8 +55,35 @@ public:
     // 当外部直接修改 nodesMutable() 后，需要重建索引
     void rebuildIndex();
 
+    // 与 D-Bus patch / 边缘 CTRL_TREE_PROPOSE 共用的写锁与 revision（见 docs/EDGE_UPLINK_PROTOCOL_v1.md）
+    QMutex& writeMutex() { return m_writeMutex; }
+    qint64 treeRevision() const { return m_treeRevision.load(std::memory_order_relaxed); }
+    void bumpTreeRevision();
+    bool applyPatchToNodeById(const QString& id, const QJsonObject& patch);
+
+    struct EdgeProposeResult
+    {
+        bool ok{false};
+        QString code;       // OK, CONFLICT, FORBIDDEN_SCOPE, NODE_NOT_FOUND, INVALID_JSON
+        QString message;
+        qint64 newRevision{0};
+        qint64 currentRevision{0};
+    };
+    EdgeProposeResult applyEdgePropose(const QString& edgeId, qint64 baseRevision, const QJsonArray& entries);
+
+    /** 导出属于该 edge 的节点子集（与 applyEdgePropose 作用域规则一致），用于下行 TREE_FULL。
+     *  若传入 outRevisionAtExport，则写入导出时刻的 treeRevision（与 nodes 同一快照）。 */
+    QJsonArray exportSubtreeForEdge(const QString& edgeId, qint64* outRevisionAtExport = nullptr) const;
+
+    /** 节点若处于边缘作用域（params.edgeId 或 id 前缀 edges/<edgeId>/...），返回应尝试下行 TREE_FULL 的 edgeId（去重）。 */
+    QVector<QString> downlinkEdgeIdsForNode(const DeviceTreeNode& node) const;
+
 private:
+    static bool nodeBelongsToEdge(const DeviceTreeNode& node, const QString& edgeId);
+
     QVector<DeviceTreeNode> m_nodes;
     QHash<QString, int>     m_indexById;
+    mutable QMutex          m_writeMutex;
+    std::atomic<qint64>     m_treeRevision{1};
 };