Menu
三层租户隔离 SQL 模式、pgvector 记忆表、遥测时序(TimescaleDB)与特征库(Feast)、迁移规范。编写数据库相关代码时使用。见 ADR-0004/0010/0013。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
IoT AI Platform 的 TypeScript 严格模式、错误处理、测试策略、依赖管理、Git commit 规范、安全编码守则。编写任何代码前先读本 Skill。
接入层（Tap）集成模式：MQTT Tap、Webhook Tap、Shifu 可选连接器；统一 Event Envelope、幂等/DLQ。编写设备接入代码时使用。见 ADR-0016。
Mastra Model Router、多 provider、成本控制（3 道闸门）、Vertical Skill（垂类模型经 MCP 发现 + 独立推理端点）、Embedding。编写 LLM/模型调用代码时使用。见 ADR-0008。
Mastra Agent/Tool/Workflow 定义模式、config-as-data 函数式壳、Concierge/Vertical Agent、注册中心、流式响应、自定义路由。编写 src/mastra/ 下代码前必读。
IoT AI Platform 目标架构（分面）、层间契约、数据流、可扩展性核心。理解系统全局、做跨层决策、新增能力前使用。真相源是 CONTEXT.md + docs/adr/。
| name | memory-schema |
| description | 三层租户隔离 SQL 模式、pgvector 记忆表、遥测时序(TimescaleDB)与特征库(Feast)、迁移规范。编写数据库相关代码时使用。见 ADR-0004/0010/0013。 |
隔离边界 = Account（ADR-0004）。设备/遥测/观测数据按
tenant_id+account_id隔离；个人记忆再叠user_id。
| 数据 | 存储 | 说明 |
|---|---|---|
| Mastra 记忆 | pgvector schema platform_memory | 对话/语义记忆，Mastra 自动管理 |
| 业务/观测 | Postgres public | 设备、Twin、观测，参数化查询 |
| 历史遥测 | TimescaleDB（hypertable） | 时序，藏在可切换 repo 接口后，高容量可切 ClickHouse |
| 特征 | Feast（online/offline） | entity key 带 tenant_id+account_id，喂垂类模型 |
业务表必须含 tenant_id + account_id 列并有联合索引（个人化数据再加 user_id）：
CREATE TABLE device_events (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
tenant_id TEXT NOT NULL,
account_id TEXT NOT NULL, -- 数据归属单元 = 隔离边界
device_id TEXT NOT NULL,
raw_event_id TEXT NOT NULL UNIQUE, -- 幂等
event_type TEXT NOT NULL,
payload JSONB,
captured_at TIMESTAMPTZ NOT NULL,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
embedding vector(1024)
);
CREATE INDEX idx_device_events_tenant_account ON device_events(tenant_id, account_id);
CREATE INDEX idx_device_events_device ON device_events(tenant_id, account_id, device_id);
WHERE tenant_id = $1 AND account_id = $2；个人记忆类再叠 AND user_id = $3m=16, ef_construction=64）src/mastra/runtime/migrations.ts，启动时 applyPendingMigrations() 自动运行IF NOT EXISTS / DO $$ ... END $$）tenant_id+user_id）数据需迁到三层（加 account_id 维度，ADR-0004）