Urbis is an open-source territorial and municipal management platform designed to empower city governments with high-performance geospatial mapping (GIS), urban data management, legislation tracking, and citizen service workflows.
O Urbis é uma plataforma de código aberto para gestão pública municipal e mapeamento territorial (GIS), permitindo a visualização de dados urbanos, gestão legislativa e processos administrativos voltados à transparência e tomada de decisão orientada a dados.
- 🌐 Portal Público (Mosaico): urbis.prefeitura.sp.gov.br
- 🗺️ Mapa Urbis (Web GIS): mapa.urbis.prefeitura.sp.gov.br
- ⚖️ Legis (Legislação e Normas Urbanísticas): legis.urbis.prefeitura.sp.gov.br
- 👤 Contas / Accounts (Portal de Identidade & SSO): conta.urbis.prefeitura.sp.gov.br
- 📝 Viabiliza (Workflows & Formulários Inteligentes): viabiliza.urbis.prefeitura.sp.gov.br
- 📊 Dados Abertos (Catálogo de Dados CKAN): dadosabertos.urbis.prefeitura.sp.gov.br
- 📖 Documentação Técnica Completa:
apps/docs| docs.urbis.prefeitura.sp.gov.br - 🛠️ Guia de Instalação & Setup:
apps/docs/content/docs/general/development/setup.mdx| Online - 🏛️ Arquitetura & Módulos:
apps/docs/content/docs/general/architecture/index.mdx| Online
O Urbis é composto por repositórios modulares e desacoplados sob a organização OpenUrbis:
| Repositório | Stack / Tecnologias | Descrição & Finalidade |
|---|---|---|
OpenUrbis/urbis-agent |
Markdown, Bash, Python, MCPs | Central de inteligência, guia mestre de arquitetura, mapeamento de clusters Azure AKS e orquestração de submódulos (liberação pública em breve). |
OpenUrbis/urbis |
Next.js, React 18, Angular, NestJS, Deck.gl, Tailwind | Monorepo Turborepo com o portal Mosaico, Web GIS (Mapa Urbis), Legis, Contas, Docs e API Gateway. |
OpenUrbis/urbis-datalake |
Python 3.11+, Dagster, PostGIS, GeoPandas, GeoServer | Datalake geoespacial com pipelines de ingestão, higienização e catálogo de dados em arquitetura medalhão (liberação pública em breve). |
OpenUrbis/urbis-ckan |
Python, CKAN 2.10, PostgreSQL, Solr, Docker | Portal de Dados Abertos e catálogo de metadados territoriais do Município de São Paulo. |
OpenUrbis/urbis-workflows |
React, Next.js, Radix UI, Tailwind | Frontend do Viabiliza: formulários inteligentes, caixas de entrada de processos e interface administrativa. |
OpenUrbis/urbis-workflows-api |
NestJS, TypeScript, PostgreSQL, TypeORM | Backend e API Gateway do Viabiliza: validações de regras urbanísticas, integração com o SEI e motor de processos. |
OpenUrbis/urbis-projeto-inteligente |
.NET 8, C#, AutoCAD ObjectARX, accoreconsole, GeoJSON | Motor para extração geométrica, validação topológica, conversão CAD (DWG/DXF) e aplicação de chancela digital. |
Gerenciado com Turborepo e pnpm:
| Aplicação | Diretório | Tecnologia | Descrição |
|---|---|---|---|
| API Backend | apps/api |
NestJS, PostgreSQL, Redis, MinIO | API REST principal, provedor OIDC, filas Bull e serviços. |
| Web GIS | apps/web |
React 18, Deck.gl 9, MapLibre GL | Painel e visualizador cartográfico interativo de alta performance. |
| Accounts | apps/accounts |
Angular 20, Angular Material | Portal de identidade, autenticação OIDC e gestão de perfis. |
| Legis | apps/legis |
React 18, Tiptap, Tailwind | Editor e gestor de legislação territorial com controle normativo. |
| Site | apps/site |
React 18, Vite SSG | Portal institucional e público. |
| Docs | apps/docs |
Next.js 16, Fumadocs MDX | Portal de documentação técnica e referência interativa de APIs. |
| Pacote | Diretório | Descrição |
|---|---|---|
@open-urbis/map |
packages/map |
Componentes e engine de mapa reutilizável para integração externa. |
@open-urbis/endereco-digital |
packages/endereco-digital |
Algoritmo de geocodificação métrica (Plus Code / Endereço Digital). |
@open-urbis/map-auth |
packages/auth |
Biblioteca cliente de autenticação OIDC e sincronização PostHog. |
@open-urbis/map-shared |
packages/shared |
Tipos TypeScript, DTOs, Feature Flags e telemetria compartilhada. |
@open-urbis/map-ui |
packages/ui |
Biblioteca de componentes visuais baseada em Radix UI e Tailwind. |
@open-urbis/map-eslint-config |
packages/eslint-config |
Configurações compartilhadas de ESLint. |
@open-urbis/map-typescript-config |
packages/typescript-config |
Configurações base de TypeScript (tsconfig). |
- Node.js v20.x ou v22.x
- pnpm v9.15.0+
- Docker & Docker Compose
# 1. Clonar repositório
git clone https://github.com/OpenUrbis/urbis.git
cd urbis-map
# 2. Instalar dependências
pnpm install
# 3. Configurar variáveis de ambiente
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env
# 4. Iniciar infraestrutura (Postgres 16, Redis 7, MinIO S3)
pnpm composer:up
# 5. Executar migrations e seeds no banco de dados
pnpm --filter @open-urbis/map-api migration:run
pnpm --filter @open-urbis/map-api seed:run
# 6. Iniciar todas as aplicações em modo desenvolvimento
pnpm dev🔐 Autenticação OIDC & SSL Local no Accounts: Para executar o portal de contas com HTTPS local e suporte OIDC completo, consulte o Guia de Configuração ou apps/accounts/README.md.
| Aplicação / Serviço | URL / Porta | Descrição |
|---|---|---|
| Web GIS (Mapa) | http://localhost:5173 |
Interface principal de mapas GIS |
| API Backend | http://localhost:3000 |
REST API |
| Swagger OpenAPI | http://localhost:3000/swagger/docs |
Documentação interativa de endpoints |
| Portal Accounts | https://conta.urbis.prefeitura.sp.gov.br |
Portal de contas e OIDC (Porta 443 SSL) |
| Legis | http://localhost:5175 |
Editor e inspetor legislativo |
| Site Institucional | http://localhost:5174 |
Site público institucional |
| Portal de Docs | http://localhost:3010 |
Portal de documentação técnica |
| MinIO Console | http://localhost:9001 |
Object storage local (minioadmin / minioadmin123) |
- 📖 Instalação e Ambiente:
apps/docs/content/docs/general/development/setup.mdx(Online) - 🏛️ Arquitetura do Sistema:
apps/docs/content/docs/general/architecture/index.mdx(Online) - 🤝 Como Contribuir:
CONTRIBUTING.md(Guia Detalhado) - 📐 Design System:
apps/docs/content/docs/general/design-system/index.mdx(Online) - 🗺️ Gestão e Cadastro de Camadas:
apps/docs/content/docs/general/mapa/index.mdx(Online) - 🌊 Datalake e Engenharia de Dados:
apps/docs/content/docs/datalake/index.mdx(Online) - 🔌 Referência de APIs (OpenAPI):
apps/docs/content/docs/openapi/reference.mdx(Online)
Contribuições são muito bem-vindas! Consulte o guia CONTRIBUTING.md para detalhes sobre fluxo de branches, convenções de código e abertura de Pull Requests.
O Urbis é distribuído sob a licença AGPL-3.0.
Agradecemos imensamente a todos que contribuem para tornar o Urbis uma ferramenta de transformação urbana:
 Douglas Gabriel Cardoso 💻 📖 🚧 |
 Renan Tashiro 💻 📆 📖 🚧 |
 Fernando Dorst 💻 📖 |
 laysmorimoto 📖 |
 Junior Anzolin 💻 📖 🚧 |
 Henrique Pougy 📖 🚧 |
 mauryascm 📖 🚧 |
 gvrDev 💻 |
 Luka Zinkoski 💻 🎨 |
 Diogo Arthur Gulhak 💻 |
Dúvidas ou sugestões? Entre em contato pelo e-mail codataurbis@prefeitura.sp.gov.br ou participe das discussões no repositório.