This is a read only archive of pad.okfn.org. See the shutdown announcement for details.

cuidando2-detalhamento DETALHAMENTO DAS FUNCIONALIDADES QUE REALMENTE SERÃO IMPLEMENTAS
(repasso para uma wiki quando estiver melhor consolidado)


# Descrição alto nível do Cuidando 2.0

A nova versão do Cuidando do Meu Bairro busca manter e aprimorar as características ofertadas pela ferramenta agora disponível em www.cuidando.org.br. A saber:

- geolocalização de gastos individuais da execução do orçamento da Cidade de São Paulo
- exibição da porcentagem do que é mapeado (tanto em termos absolutos de quantidade de projetos/atividades, tanto em termos de recursos financeiros)
- oferta em formato aberto dos dados geolocalizados

Essa versão também oferecerá novas funcionalidades que permitirão maior interação de seus usuários na construção coletiva do acompanhamento do gasto público.
Com a possibilidade de ter um perfil na ferramenta ou de aproveitar perfil existente em plataformas de redes sociais posssibilitará aos intressados:

- comentar pontualmente
- compartilhar informações sobre o gasto público
- realizar pedido de informação às autoridades competentes
- registrar o diálogo (perguntas e respostas) realizado

# Páginas do Site

## Página do Ano
Essa é a página mais parecida com o Cuidando 1, e poderia ser a página principal e de entrada no site.
Ela possui o mapa com todos os pontos do ano e a tabela sobre todos os pontos do ano também.
Além disso são exibidos também os gráficos analisando quanto foi mapeado para aquele ano e há um link para a explicação de como a geolocalizaçao é feita e suas limitações.
É possível trocar de ano ou selecionar pontos para serem vistos em maior detalhe.
Se forem muitos gráficos para essa página, que já possui um mapa e uma tabela, talvez fosse o caso de colocar apenas um gráfico aqui, com link para ver mais em outra página.

## Página do Ponto
Cada ponto, mapeado ou não, possui uma página própria onde há todas as informações sobre ele, incluindo os comentários dos usuários.
Se o ponto foi mapeado, o mapa é centralizado no ponto. Se foi apenas regionalizado, o mapa e centralizado na região e ela é exibida no mapa.
Há nessa página os comentários de usuáriso relativos ao ponto.
Para evitar muitos elementos nessa página, uma vez que já há todas as informações sobre o ponto específico, a tabela com todos os pontos é escondida.

## Página de Perfil
Quando uma pessoa loga pela primeira vez no site, ela ganha uma página de perfil.
A princípio essa página só possui o nome de usuário e, talvez, a lista de comentários que a pessoa fez, em ordem cronológica.
Caso a pessoa queira, ela poderá adicionar uma descrição sobre si, e nela colocar como gostaria de ser contatada (e-mail, facebook, etc).

## Outras páginas com informações
Há também uma página com infomações sobre o projeto e possivelmente outras sobre orçamento.


# Descrição das funcionalidades

## Geolocalização dos gastos
Os dados são baixados da SMG, processados em busca de elementos geolocalizáveis (nomes de ruas, praças, bairros etc), geolocalizados e inseridos no banco de dados (BD).
As despesas mapeadas podem ser de dois tipos: a pontual, quando se obteve a latitude e longitude onde o gasto ocorreu; e a regionalizada, quando se obteve apenas região (subprefeitura) onde o gasto ocorreu.
O geolocalizador busca sempre obter a geolocalizaçao pontual, se não for possível, tenta ao menos a regionalizada, se ainda não for possível, a despesa fica como não mapeada.

- Automatizar download dos dados da SMG
- Automatizar tratamento dos dados
- Automatizar inserçao dos dados no BD
- Refazer/aprimorar expressões regulares [minimamente feito]
- Eliminar pontos fora de São Paulo [feito]

## Visualizações
Uma vez no BD, os dados podem ser visualizados pelo site em um mapa ou uma tabela.

### Mapa
A visualização principal é um mapa onde cada gasto geolocalizado é representado por um ponto.
Devido ao número de pontos mapeados (na ordem de milhares), eles são agrupados de acordo com o nível de zoom, quanto menor o zoom, mais agrupados.
Os pontos podem ser desenhados com cores diferentes de acordo com o estágio em que a despeza se encontra (orçado, liquidado etc).
Porém, quando estão agrupados, a principio parece impossível representar as cores individuais de cada ponto.
Outra questão é como representar as despesas que só foram regionalizadas? Talvez uma camada onde cada subprefeitura tem uma cor representando quanto dinheiro foi gasto nela? Talvez uma camada estágio das despesas?
Que outros filtros são interessantes? Despesas correntes ou de capital, já que foi pedido e implementado no Cuidando 1?
Quando se seleciona um ponto, vai-se para a **Página do Ponto**, nelas são exibidas as informações e comentários relativos a ele.
Como são muitas informações, elas não podem aparecer todas no "balãozinho" do ponto, mas sim em outro espaço da página. Teremos mesmo assim um balãozinho? O que ele mostrará?

- Aprimorar carregamento dos dados para deixar site mais leve [minimamente feito]
- Mostrar mais dados sobre cada ponto quando clicar nele [minimamente feito]
- Separar por estágios (liquidado, orçado, etc). Como?
- Como exibiremos os pontos? (manteremos cores? 3? 4? clusterizaremos? mapa de calor?)
- Teremos regiões? Como exibi-las? Que valores representarao?

### Tabela
Há também a visualização por tabela, que mostra alguns dados de todos os pontos.
Como cada ponto possui muitas informações, a tabela não mostra todas as colunas.
Clicando em uma linha vai para a **Página do Ponto**, e nessa sim estão todas as informações.
A tabela permitiria filtragem entre mapeados e não mapeados? Quais seriam as colunas exibidas?
Talvez colocar uma cor para cada linha na tabela, explicitando se foi mapeado ou não? Se for dificíl, colocar essa informação em uma coluna extra para permitir fácil identificação.

- Colocar uma tabela de pontos mapeados e outra de não mapeados, ou ter apenas uma tabela e permitir filtrar o que está mapeado e o que não está?

## Gráficos sobre Mapeado
Para permitir uma maior noção sobre o quão representativas são as visualizações do mapa, são exibidos graficos apontando o quanto foi mapeado ou regionalizado do total de despesas.
São usados dois gráficos, o primeiro comparando o número de despesas, e o segundo comparando o valor total das despesas.

## Oferta de dados abertos
Os dados geolocalizados podem ser consultados ou via API REST ou baixando a base completa em CSV.
Colocar link para a base oficial não geolocalizada.

- Dados acessíveis via API [feito]
- Fornecer dados brutos (CSV)

## Características Sociais
Além de ver a informações no site, as pessoas poderão interagir com ele e de duas maneiras principais: postando comentários na página de cada despesa e fazendo pedidos de informação.
Para tal é possível fazer login no site. A pessoa poderá ou criar uma conta no próprio site, ou utilizar uma conta de outro site (facebook etc).
Essas atividades poderão ser feitas de forma anonima? Vamos integrar com o DeOlho?

- ter um login podendo optar por fazer tanto pelo Cuidando (perfil anônimo ? fake?) ou via outras redes sociais (quais ? quantas ?) [falta ver se vamos mesmo interagir com o DeOlho]

### Agir - Comentar
Cada **Página do Ponto** possui um espaço para comentários relativos àquela despesa.
Nos comentários são permitidos apenas texto, porém, é possível colocar links para vídeos ou imagens hospedados em outros sites.

- fotos e vídeos (link para ferramentas de terceiros ex. FB, youtube, etc.) [se é só colocar o link, já está ok]

### Agir - Compartilhar
O URL da página irá sendo alterado conforme a pessoa for navegando pelo site, de forma a representar o que está sendo exibido no momento.
Assim, compartilhando o URL para outra pessoa, essa nova pessoa, quando abrir o URL, verá a página da mesma forma que a primeira estava vendo quando fez o compartilhamento.
Ex.: Cada ponto tem seu URL. Logo, compartilhando o URL de um ponto, a pessoa que abrir o link já irá ver as informações específicas daquele ponto.
Para facilitar o processo para pessoas que não saibam que podem compartilhar uma página apenas copiando o URL dela, podem existir botões que compartilhem em sites específicos (facebook etc).

### Agir - Perguntar
A **Página do Ponto** possui um link para permitir às pessoas fazerem perguntas sobre a despesa em questão.
Essas perguntas serão encaminhadas como pedidos de acesso à informação via Queremos Saber.
Como os pedidos feitos serão linkados na **Página do Ponto**? E as respostas? Talvez só encaminhar para o Queremos Saber fazendo a busca por aquele ponto? Pensar...

- Pedidos de informaçao via Queremos Saber

## Espaço de Diálogo - perguntas e respostas

Pretende-se que o diálogo esteja registrado tanto para fins de accountability, como também para aquisição e compartilhamento da informação.
Isso é papel do Queremos Saber não?


## Geral

- Site responsivo
- Suporte a multi idiomas
- Ajustar URL conforme clica no ponto, e atualizar resto da interface de acordo



## Especificar melhor:

5. Notificação e correção de erros de geolocalização [sugiro um botão de aviso sobre isso]
4. moderação (autoridade paga ou eleita pela comunidade?)?   formulário para denúncia de abuso


## Tarefas de design/informação:

+ Design geral do site

2. Infográficos?
3. Interface "balaozinho" com mais explicações simples de alguns conceitos. + intuitiva, + lúdica 
4. Mais material didático (links para terceiros)


## Acessibilidade

Até onde vi, não há como representar o mapa de forma acessível. Logo isso estaria descartado...
Porém, buscaríamos deixar o resto do site acessível da seguinte forma:

- Buscar seguir recomendações gerais de acessibilidade para desenvolvimento web
- Ter sempre tabelas alternativas aos gráficos
- Ter uma funcionalidade (semi-)nova:
    1. Um campo para busca de endereços (como o Cuidando 1 já tem) e talvez um campo para especificar uma distância X
    2. Quando a busca é feita, o mapa centraliza no lugar buscado, e exibe apenas os pontos no máximo X distantes dessa localidade.
    3. A tabela abaixo do mapa também lista apenas os pontos no máximo X distantes dessa localidade.

O item 2 descrito acima (filtrar os pontos no mapa), não contribui para a acessibilidade, já que o mapa não é acessível.
Mas me parece interessante para manter a coerência da interface (imagina se filtrasse na tabela, mas não no mapa) e é uma funcionalidade extra que pessoas "videntes" ganhariam.
Dessa forma, para "não-videntes", o Cuidando seria um site onde a pessoa pode procurar despesas próximas a um ponto, e analisá-las na tabela.

O problema é: e quando o javascript estiver desativado? =/