steedos-builtin-objects

Steedos Built-in Objects | Steedos 内置对象

CRITICAL: Object Name Mappings | 重要：对象名称映射

ALWAYS use the exact API names below — do NOT guess object names based on common conventions:

When referencing built-in objects in lookup fields, permissions, or code, you MUST use the API names from the table above. Consult the full object index at the end of this document if unsure.

Overview | 概述

Steedos ships with ~93 built-in objects that provide core platform functionality. This skill documents the most commonly used objects — their fields, relationships, and purpose. Custom packages can extend these objects or reference them via lookup fields.

Steedos 平台内置约 93 个对象，提供核心平台功能。本技能文档记录最常用的对象——字段、关系和用途。自定义软件包可以扩展这些对象或通过 lookup 字段引用它们。

Standard auto-generated fields (present on ALL objects, not listed in tables below):

Users & Organizations | 用户与组织

spaces — Workspace | 工作区

The top-level tenant object. Each workspace is an isolated data environment.

users — User | 用户

Platform-wide user account. A user can belong to multiple workspaces via space_users.

organizations — Department | 部门

Hierarchical department tree within a workspace.

space_users — Space User | 工作区用户

Associates a user with a workspace, carrying workspace-specific profile info (department, profile, manager).

company — Division | 分部

Multi-company / division structure. Records are scoped to divisions via company_id/company_ids.

Permissions | 权限

roles — Role | 角色

Role-based access hierarchy. Users are assigned to roles, and data sharing can cascade through the role tree.

permission_set — Permission Set | 权限集

Permission profiles that control object access, field access, and security policies. Users are assigned a profile via space_users.profile.

permission_objects — Object Permission | 对象权限

Per-object permission rules attached to a permission set.

Applications & UI | 应用与界面

apps — Application | 应用

Application definitions with tab navigation and optional OAuth2/SAML SSO.

tabs — Tab | 标签页

Navigation tabs for applications. Each tab points to an object, page, or URL.

pages — Micro Page | 微页面

Custom UI pages built with the Amis framework.

Business Objects | 业务对象

accounts — Account | 业务伙伴

CRM-style business partner (customer/supplier) records.

contacts — Contact | 联系人

Contacts associated with business accounts (master-detail to accounts).

Collaboration | 协作

tasks — Task | 任务

Built-in task management with assignments and due dates.

notifications — Notification | 通知

System notifications sent to users (record changes, mentions, workflow actions, etc.).

cms_files — Attachment | 附件

File attachments linked to any object record.

System | 系统配置

api_keys — API Key | API 密钥

API keys for programmatic access to the platform.

datasources — Data Source | 数据源

External database connections.

audit_records — Audit Record | 审计记录

Field-level change history for objects with enable_audit: true.

Object Relationships | 对象关系

spaces ─────────┬──→ organizations (departments)
                │         ↑ parent (self-referencing tree)
                │         ↑ organization ←── company (divisions)
                │
                ├──→ users ←──┐
                │             │ user (master_detail)
                ├──→ space_users ──→ organizations (multiple)
                │         │
                │         └──→ permission_set (profile)
                │                    │
                │                    └──→ permission_objects ──→ objects
                │
                ├──→ apps ──→ tabs ──→ pages
                │                  ──→ objects
                │
                ├──→ roles (tree via parent)
                │         └──→ users (multiple)
                │
                ├──→ accounts ←── contacts (master_detail)
                │       ↑ parent_id (self-referencing)
                │
                ├──→ tasks ──→ users (assignees)
                ├──→ notifications ──→ users (from)
                └──→ cms_files ──→ (any object via parent)

Key relationships:

• space_users bridges users ↔ spaces, carrying per-workspace profile and department
• permission_objects is a child of permission_set (master_detail), linking permissions to objects
• contacts is a child of accounts (master_detail, cascade delete)
• organizations forms a tree via parent (self-referencing lookup)
• company maps to organizations for multi-division data isolation
• tabs connect apps to objects or pages

All Built-in Objects Index | 全部内置对象索引

service-core-objects (56 objects)

standard-accounts (2 objects)

standard-permission (5 objects)

standard-process-approval (4 objects)

service-pages (4 objects)

standard-ui (1 object)

service-package-registry (1 object)

Other Services