Mapas Culturais - Documentação para Desenvolvedores

O Mapas Culturais é uma plataforma colaborativa de código aberto projetada para mapear e conectar agentes, espaços, eventos, projetos e oportunidades culturais. A plataforma permite que usuários cadastrem suas Entidades culturais, formando um mapa interativo e uma base de dados cultural robusta.

Código-fonte: Redemapas/mapas

Visão Geral da Arquitetura

A plataforma é construída com uma arquitetura moderna e modular que separa claramente as responsabilidades entre frontend e backend:

Estrutura da Documentação

Esta documentação está organizada em seções que cobrem desde conceitos fundamentais até implementações avançadas:

📖 Fundamentos

Visão Geral da Plataforma - Arquitetura, tecnologias e conceitos fundamentais
Entidades (Entities) - Modelos de dados centrais da plataforma

🛠️ Desenvolvimento Frontend

Componentes Vue (Vue Components) - Interface de usuário e componentes reutilizáveis
Classe API - Comunicação entre frontend e backend
Busca (Search) - Sistema de busca e filtros

🎛️ Funcionalidades Principais

Painel de Controle (Panel) - Interface administrativa e de usuário
Oportunidades e Inscrições - Gestão de editais e processos seletivos
Métodos de Avaliação - Sistemas de avaliação e seleção

🔐 Segurança e Autenticação

Plugin de Autenticação Múltipla Local - Sistema de autenticação flexível

🎨 Personalização e Extensões

Índice de Plugins - Catálogo completo de plugins disponíveis
Índice de Temas - Catálogo completo de temas e customizações visuais

Tecnologias Principais

Backend

PHP com framework Slim
Doctrine ORM para persistência de dados
JWT para autenticação segura
Symfony Mailer para comunicações

Frontend

Vue.js para componentes interativos
Webpack e Laravel Mix para build
Sass/SCSS para estilização
JavaScript ES6+ moderno

Infraestrutura

PostgreSQL como banco de dados principal
Redis para cache e sessões
Docker para containerização

Começando

Para começar a desenvolver na plataforma Mapas Culturais:

Leia a Visão Geral da Plataforma para entender a arquitetura
Configure o ambiente seguindo o README do repositório
Explore as Entidades para entender os modelos de dados
Estude os Componentes Vue para desenvolvimento frontend

Contribuindo

O Mapas Culturais é um projeto de código aberto mantido pela comunidade. Contribuições são bem-vindas através de:

Issues para reportar bugs ou sugerir melhorias
Pull Requests com correções ou novas funcionalidades
Documentação para melhorar este guia
Testes para garantir qualidade do código

Esta documentação é mantida pela comunidade de desenvolvedores do Mapas Culturais. Para dúvidas ou sugestões, abra uma issue no repositório oficial.