Manual Mapas - Espaços

Espaços representam equipamentos culturais físicos e virtuais, como teatros, museus, centros culturais e espaços alternativos.

Um espaço é um local onde atividades culturais acontecem. Espaços podem ser locais físicos com endereço geográfico ou ambientes virtuais. Eles pertencem a agentes e podem sediar eventos ou se vincular a oportunidades.

Espaços físicos

Teatros, cinemas, museus, galerias, centros culturais, bibliotecas, espaços comunitários e qualquer outro equipamento fixo.

Espaços virtuais

Plataformas online, canais de streaming e ambientes digitais onde atividades culturais são realizadas.

Campos principais

Campo	Descrição
`name`	Nome do espaço. Obrigatório.
`shortDescription`	Resumo curto, com até 400 caracteres. Obrigatório.
`longDescription`	Descrição completa com suporte a texto rico.
`type`	Identificador numérico do tipo. Obrigatório. Configurado por instalação.
`public`	Indica se o espaço é aberto ao público geral (`true`) ou de acesso restrito (`false`).
`location`	Ponto geográfico PostGIS (`latitude, longitude`).
`status`	`1` = publicado, `0` = rascunho, `-2` = arquivado, `-9` = desabilitado, `-10` = lixeira.
`createTimestamp`	Momento em que o espaço foi criado. Somente leitura.
`updateTimestamp`	Momento da última modificação do espaço. Somente leitura.

Campos adicionais, como endereço, capacidade, metragem, telefone e site, são armazenados como metadados e podem variar conforme a configuração da instalação.

Geolocalização

Espaços têm suporte geoespacial nativo via PostGIS. A localização é armazenada em duas colunas:

location — uma coluna point usada internamente.
_geo_location — uma coluna geography que suporta consultas espaciais por raio, como "encontre todos os espaços em até 5 km desta coordenada".

A plataforma expõe uma interface de mapa que renderiza as localizações dos espaços como marcadores. Usuários podem buscar espaços por área geográfica diretamente no mapa.

-- Exemplo: encontra espaços em até 10 km de uma coordenada (via PostGIS)
SELECT * FROM space
WHERE ST_DWithin(
    _geo_location,
    ST_GeographyFromText('POINT(-46.6333 -23.5505)'),
    10000
);

Tipos de espaço

Os tipos de espaço são configurados por instalação e categorizados pelo sistema de tipos de entidade. Exemplos comuns incluem:

Teatro
Museu / galeria
Centro cultural
Biblioteca
Espaço comunitário
Espaço ao ar livre / público
Espaço virtual / online

Cada espaço deve ter um tipo atribuído; os tipos disponíveis e seus IDs dependem da configuração da instalação.

Hierarquia de espaços

Espaços suportam hierarquia pai-filho por meio da relação parent / _children. Isso permite modelar equipamentos maiores que contêm subespaços menores, como um centro cultural (pai) com várias salas (filhos).

Quando um espaço filho é atualizado, o histórico de revisões do espaço pai também é atualizado.

Relações com outras entidades

Agente proprietário

Todo espaço pertence a exatamente um agente. O proprietário é definido por agent_id e pode ser alterado conforme as checagens de permissão.

Eventos

Eventos são agendados em espaços por registros EventOccurrence. Um espaço expõe suas ocorrências pela coleção eventOccurrences.

Oportunidades

Espaços podem ser vinculados a oportunidades por relações SpaceOpportunity.

Relações de agente

Agentes adicionais, como colaboradores e gestores, podem se relacionar com um espaço via SpaceAgentRelation.

Selos e verificação

Assim como agentes, espaços podem receber selos que os certificam ou verificam. As relações de selo ficam em SpaceSealRelation. Selos verificados podem travar campos específicos para evitar modificações não autorizadas após a certificação.

Tags e taxonomias

Espaços suportam relações de termos (SpaceTermRelation) para tags, classificação de área e outros vocabulários taxonômicos configurados por instalação.

Ciclo de status

Deixe o espaço em Rascunho enquanto preenche os detalhes. Publique apenas quando as informações estiverem completas e corretas, para que ele apareça adequadamente no mapa público.

Criando um espaço

No painel, selecione Meus Espaços.

Clique em Novo Espaço, escolha o tipo do espaço e preencha os campos obrigatórios: nome e descrição curta.

Informe o endereço ou marque a localização diretamente no mapa. Uma geolocalização precisa é importante para pessoas que buscam por proximidade.

Adicione capacidade, informações de acessibilidade, dados de contato, fotos e tags para ajudar outras pessoas a encontrar o espaço.

Altere o status de Rascunho para Publicado para tornar o espaço visível no mapa público.

Manual Rede das Artes

Espaços