Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
properties
What it is
Part of the Databases and CRM features. Entity properties: definitions,
selectable options (including tags), per-entity values, and the CRM
pipeline/stage definitions built on them. Publishes property mutation
events to the macro.properties Kafka topic.
Start here
README.md: the published event catalog (property.created,entity_property.updated, ...) — read before changing anything that writes a property or option.src/domain/service_impl.rs+src/domain/ports.rs: the service and the writer/notification/permission ports it composes.src/domain/model.rs:EntityPropertiesKey,PropertyTargetKey, and the CRM team-stage definition constant.src/outbound/properties_pg_repo.rs+src/outbound/*_queries.rs: the Postgres adapters, one file per concern (definitions, options, entity values, metadata, tag promotion).src/domain/service.rs: property reads and mutations; Soup does not require a separate definition-reader collaborator.
Scope
- Owns: property definitions/options/values and tag promotion across entity types.
- Not here: the generic database engine (tables/columns/cells) →
databases; notification delivery →notification.
Boundaries
- Depends on:
entity_access,macro_event_broker,model_owner,notification(optional,outboundfeature). - Used by:
databases,ai_tools,agent_trigger,initiative,messages,search_service,soup,crm,graphql_properties,properties_service,services/document_storage_service,services/agent_trigger_service,services/search_processing_service. - Keep Soup sort/group SQL in Soup; property-definition authorization must be designed consistently across filters, grouping, and sorting, not added to one path.
Recipes
- Add a property event:
src/domain/events.rs→ emit it insrc/domain/service_impl.rsafter the write succeeds → document it inREADME.md's event table. - Add a query:
src/outbound/<concern>_queries.rs→ its sibling_test.rs.
Tool contracts
- AI property/tag adapters omit legacy chat targets; this does not change persisted property entity types.
Checks
cargo test -p properties(SQLX_OFFLINEunset; requires local MacroDB).cargo test -p properties --no-default-features --features outboundto check the outbound-only build other services depend on.ExternalChatcurrently has no property-storage mapping.
Related
- Rules:
.agents/rules/rust/architecture.md· Docs:README.md