Arah é uma plataforma digital comunitária orientada ao território.
Um espaço onde tecnologia serve à vida local, à convivência e à autonomia das comunidades.
Não é uma rede social genérica.
É uma extensão digital do território vivo.
Vivemos um tempo em que plataformas digitais:
O Arah nasce como um contraponto consciente a esse modelo.
Território como referência.
Comunidade como prioridade.
Tecnologia como ferramenta — não como fim.
A proposta é simples e profunda:
recolocar o território no centro da experiência digital.
O Arah é um aplicativo/plataforma que permite:
Tudo isso sem algoritmos de manipulação,
sem feed global infinito,
sem extração de dados para publicidade.
No Arah, territory representa apenas um lugar físico real:
Ele não contém lógica social.
O território existe antes do app
e continua existindo mesmo sem usuários.
Essa decisão arquitetural evita:
Relações humanas como:
não pertencem ao território.
Elas pertencem a camadas sociais que referenciam o território.
Isso torna o sistema:
O Arah não é:
Ele é uma infraestrutura digital comunitária, pensada para:
O backend segue princípios de Clean Architecture, com separação clara de responsabilidades:
backend/ ├── Arah.Api # API HTTP (controllers, endpoints) ├── Arah.Application # Casos de uso / regras de aplicação ├── Arah.Domain # Modelo de domínio (territory, regras centrais) ├── Arah.Infrastructure # Persistência, integrações, adapters ├── Arah.Shared # Tipos e utilitários compartilhados └── Arah.Tests # Testes automatizados
📋 Índice Completo da Documentação - Navegação estruturada de toda a documentação
Documentação técnica das fases de implementação: Instalador, Modularização, BFF e Frontend.
Membership
Relação entre uma pessoa e um território (morador, visitante, etc.).
Feed / Map
Informação contextual, sempre relacionada a um território específico.
GET /api/v1/map/pins (MapEntity + GeoAnchors de posts).GET /api/v1/territories/{territoryId}/featuresPUT /api/v1/territories/{territoryId}/features (curadoria)GET /api/v1/territories/nearby?lat=-23.37&lng=-45.02&radiusKm=25&limit=20GET /api/v1/map/pins?territoryId={territoryId}GET /api/v1/reports?territoryId={territoryId}&targetType=POST&status=OPENGET /api/v1/notifications?skip=0&take=50POST /api/v1/notifications/{id}/readGET /api/v1/territories/{territoryId}/chat/channelsGET /api/v1/territories/{territoryId}/chat/groupspackages.lock.json)O projeto está em evolução ativa, com foco em solidez antes de escala.
git clone https://github.com/sraphaz/Arah.git
cd Arah
dotnet restore
dotnet build
dotnet test
dotnet run --project backend/Arah.Api
docker compose up --build
Para rodar localmente com Postgres sem compose, defina:
Persistence__Provider=Postgres
ConnectionStrings__Postgres=Host=localhost;Port=5432;Database=Arah;Username=Arah;Password=Arah
Aplicar migrations manualmente (recomendado quando não usar auto-migrate):
dotnet ef database update \
--project backend/Arah.Infrastructure \
--startup-project backend/Arah.Api
Auto-migrate (opcional, desligado por padrão): defina Persistence__ApplyMigrations=true.
A autenticação utiliza JWT assinado (HS256). O fluxo principal é:
POST /api/v1/auth/social retorna o token JWT.Authorization: Bearer <token> em endpoints protegidos.Exemplo rápido:
curl -s -X POST http://localhost:8080/api/v1/auth/social \
-H "Content-Type: application/json" \
-d '{
"provider":"google",
"externalId":"demo-user",
"displayName":"Demo",
"cpf":"123.456.789-00",
"foreignDocument":null,
"phoneNumber":"(11) 99999-0000",
"address":"Rua das Flores, 100",
"email":"demo@Arah.com"
}' | jq
Configuração JWT (via appsettings/env):
Jwt__Issuer, Jwt__Audience, Jwt__SigningKey, Jwt__ExpirationMinutes
A chave padrão é apenas para DEV. Troque em produção.
POST /api/v1/territories/{territoryId}/membershipGET /api/v1/territories/{territoryId}/membership/meRegras:
VISITOR e o usuário pede RESIDENT, o vínculo é atualizado para RESIDENT com status PENDING.RESIDENT e pede VISITOR, mantém RESIDENT (sem downgrade).Configuração: PresencePolicy:Policy (None | ResidentOnly | VisitorAndResident).
Padrão: ResidentOnly (somente RESIDENT exige geo).
VisitorAndResident: visitor também exige X-Geo-Latitude / X-Geo-Longitude.None: nenhum vínculo exige geo.POST /api/v1/territories/selection e como fallback de territoryId em feed/mapa.session:{id}).PresencePolicy (default: somente para RESIDENT).A página inicial da API (/) serve um portal estático com explicação do produto,
domínios, fluxos e quickstart. Em desenvolvimento, acesse também:
/swagger (documentação da API)/health (status simples)Quando a API está rodando localmente em ambiente de desenvolvimento, o portal exibe um preview do Swagger para navegação e testes rápidos.
Para publicação como site estático, o portal também está disponível em docs/ e
pode ser hospedado via GitHub Pages (basta apontar a origem para a pasta docs).
A versão do GitHub Pages inclui links diretos para documentação, user stories e changelog.
Consulte o guia em CONTRIBUTING.md.
O Arah é aberto à colaboração, especialmente de pessoas interessadas em:
tecnologia com impacto social
comunidades locais
território, cultura e soberania
arquitetura de software consciente
regeneração e autonomia
Formas de contribuir:
código
testes
documentação
ideias
feedback conceitual
Antes de abrir PRs grandes, abra uma issue para alinharmos a direção.
Algumas direções possíveis (não promessas fechadas):
economias e moedas locais
trocas de serviços comunitários
governança distribuída
integração com iniciativas regenerativas
tecnologia como guardiã do território, não como exploradora
O Arah não quer crescer rápido. Quer criar raízes profundas.
✨ Uma nota pessoal
Este projeto nasce de uma escuta atenta:
da vida
do território
das comunidades
e dos limites do modelo digital atual
Se você chegou até aqui e sentiu que isso faz sentido, você já faz parte da conversa.
Este projeto é distribuído sob uma licença aberta orientada à comunidade e ao território.
LICENSELICENSE.pt-BR🐦 Arah canta para avisar, proteger e comunicar. Que esta plataforma faça o mesmo.