{"id":28864877,"url":"https://github.com/warlleyrocha/imobi-facil","last_synced_at":"2026-05-09T19:32:46.418Z","repository":{"id":299713975,"uuid":"1003960370","full_name":"warlleyrocha/imobi-facil","owner":"warlleyrocha","description":"Front do app mobile android para simplificar a vida do corretor de imóveis, oferecendo uma ferramenta móvel especializada que vai além dos CRMs. Um projeto Pipoca Ágil.","archived":false,"fork":false,"pushed_at":"2025-11-26T03:31:25.000Z","size":4060,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-11-29T05:37:40.418Z","etag":null,"topics":["corretor-de-imoveis","crm","expo","imobiliaria","pipocaagil","react-native"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/warlleyrocha.png","metadata":{"files":{"readme":"READMe.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-17T22:57:37.000Z","updated_at":"2025-10-23T20:38:36.000Z","dependencies_parsed_at":"2025-08-14T06:16:28.602Z","dependency_job_id":"065d839f-d89a-41dd-8d0c-85f5c3db9d7c","html_url":"https://github.com/warlleyrocha/imobi-facil","commit_stats":null,"previous_names":["warlleyrocha/imobi-facil"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/warlleyrocha/imobi-facil","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warlleyrocha%2Fimobi-facil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warlleyrocha%2Fimobi-facil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warlleyrocha%2Fimobi-facil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warlleyrocha%2Fimobi-facil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/warlleyrocha","download_url":"https://codeload.github.com/warlleyrocha/imobi-facil/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/warlleyrocha%2Fimobi-facil/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32832959,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["corretor-de-imoveis","crm","expo","imobiliaria","pipocaagil","react-native"],"created_at":"2025-06-20T10:00:33.791Z","updated_at":"2026-05-09T19:32:46.409Z","avatar_url":"https://github.com/warlleyrocha.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏠 ImobiFácil\n\n## 📋 Sobre o Projeto\n\nO **ImobiFácil** é uma aplicação mobile desenvolvida com React Native e Expo, projetada especificamente para corretores de imóveis gerenciarem seus negócios de forma eficiente e profissional. A aplicação oferece uma interface intuitiva e funcionalidades completas para gestão de propriedades, clientes e relacionamento comercial.\n\n## 🎯 Funcionalidades Principais\n\n### 🔐 Autenticação e Perfil\n\n- **Login com Google**: Autenticação OAuth integrada com backend\n- **Cadastro de Corretor**: Formulário completo com validação de dados\n- **Perfil Profissional**: Gestão de informações pessoais e profissionais\n- **Verificação de Código**: Sistema de verificação por email\n- **Persistência de Sessão**: Login automático com armazenamento local\n\n### 🏘️ Gestão de Imóveis\n\n- **Cadastro de Propriedades**: Formulário completo com:\n  - Informações básicas (título, tipo, finalidade, preço, área)\n  - Localização detalhada (CEP, endereço, bairro, cidade, estado)\n  - Descrição personalizada\n  - Upload de fotos\n- **Listagem de Imóveis**: Visualização organizada de todas as propriedades\n- **Edição de Propriedades**: Modificação de dados existentes\n- **Organização em Pastas**: Criação de pastas personalizadas para atendimento (feature futura)\n\n### 📊 Dashboard e Estatísticas\n\n- **Resumo Semanal**: Métricas importantes como:\n  - Visitas agendadas\n  - Novos contatos\n  - Documentos pendentes\n- **Acesso Rápido**: Botões diretos para principais funcionalidades\n- **Notificações**: Sistema de alertas e lembretes (feature futura)\n\n### 👥 Gestão de Clientes (feature futura)\n\n- **Cadastro de Clientes**: Formulário para novos clientes\n- **Minhas Pastas**: Organização de clientes por pastas\n- **Histórico de Atendimento**: Acompanhamento de interações\n\n### 📅 Agenda e Compromissos (feature futura)\n\n- **Agenda Inteligente**: Agendamento de visitas e compromissos\n- **Controle de Rotina**: Organização completa da agenda profissional\n\n### 💬 Comunicação (feature futura)\n\n- **Chat Integrado**: Comunicação direta com clientes\n- **Relacionamento Ativo**: Manutenção de contato contínuo\n\n## 🛠️ Tecnologias Utilizadas\n\n### Core Framework\n\n- **React Native 0.81.4**: Framework principal para desenvolvimento mobile\n- **Expo 54.0.13**: Plataforma de desenvolvimento e deploy\n- **TypeScript 5.9.2**: Tipagem estática para maior segurança\n\n### Navegação e Roteamento\n\n- **Expo Router 6.0.12**: Sistema de roteamento baseado em arquivos\n- **React Navigation 7.0.3**: Navegação entre telas\n\n### Interface e Estilização\n\n- **NativeWind 4.1.23**: Tailwind CSS para React Native\n- **Tailwind CSS 3.4.0**: Framework de estilização utilitária\n- **React Native SVG 15.12.1**: Suporte a ícones SVG\n- **Expo Vector Icons 15.0.2**: Biblioteca de ícones\n- **Expo Blur 15.0.7**: Efeitos visuais\n\n### Formulários e Validação\n\n- **React Hook Form 7.58.1**: Gerenciamento de formulários\n- **Zod 3.25.67**: Validação de schemas\n- **React Native Element Dropdown 2.12.4**: Componentes de seleção\n\n### Autenticação e Armazenamento\n\n- **Expo Auth Session 7.0.8**: Gerenciamento de sessões OAuth\n- **Expo Web Browser 15.0.8**: Navegador in-app para autenticação\n- **AsyncStorage 2.2.0**: Armazenamento local\n\n### Mídia e Recursos\n\n- **Expo Image Picker 17.0.8**: Seleção de imagens\n- **Expo Location 19.0.7**: Serviços de localização\n- **Expo Constants 18.0.9**: Constantes da aplicação\n- **Expo Crypto 15.0.7**: Funções criptográficas\n\n### Comunicação com Backend\n\n- **Axios 1.11.0**: Cliente HTTP para comunicação com API\n- **Expo Dev Client 6.0.15**: Cliente de desenvolvimento\n\n### Desenvolvimento e Qualidade\n\n- **ESLint 9.25.1**: Análise estática de código\n- **Prettier 3.2.5**: Formatação de código\n- **Jest 29.7.0**: Framework de testes\n- **SonarQube**: Análise de qualidade de código\n\n## 🔗 Integração com Backend\n\n### Fluxo OAuth Integrado\n\nO sistema de autenticação é totalmente integrado com o backend:\n\n1. **Inicialização**: Frontend redireciona para endpoint do backend (`/auth/google`)\n2. **Processamento**: Backend gerencia todo o fluxo OAuth com Google\n3. **Callback**: Backend retorna usuário e token via deep link\n4. **Armazenamento**: Frontend salva dados localmente via AsyncStorage\n\n## 📱 Estrutura do Projeto\n\n```\nimobi-facil/\n├── app/\n│   ├── (auth)/                                 # Rotas autenticadas\n│   │   ├── corretor/                           # Área do corretor\n│   │   │   ├── (tabs)/                         # Navegação por abas\n│   │   │   │   ├── imoveis/                    # Gestão de imóveis\n│   │   │   │   ├── agenda.tsx\n│   │   │   │   ├── chat.tsx\n│   │   │   │   └── home.tsx                    # Tela inicial\n│   │   │   ├── profile/                        # Perfil do corretor\n│   │   │   └── signup/                         # Página de cadastro\n│   │   ├── onboard.tsx                         # Tutorial inicial\n│   │   └── select-profile.tsx                  # Seleção de perfil\n│   ├── (public)/                               # Rotas públicas\n│   │   └── sign-in.tsx                         # Tela de login\n│   ├── _layout.tsx                             # Layout raiz\n├── components/                                 # Componentes reutilizáveis\n│   ├── Profile/                                # Componentes de perfil\n│   ├── forms/                                  # Componentes de formulário\n│   ├── layouts/                                # Layouts e seções\n│   │   ├── Sections/\n│   │   └── Header.tsx\n│   └── ui/                                     # Componentes de interface\n├── contexts/                                   # Contextos React\n│   └── authContext.tsx                         # Contexto de autenticação\n├── hooks/                                      # Custom hooks\n│   ├── useGoogleAuth.ts                        # Hook de autenticação Google\n│   └── usePropertyManagement.tsx               # Hook de gestão de imóveis\n├── services/                                   # Serviços e APIs\n│   ├── api.ts                                  # Configuração da API\n│   └── googleAuth.service.ts                   # Serviço de autenticação\n├── types/                                      # Definições TypeScript\n└── utils/                                      # Funções utilitárias\n\n\n```\n\n## 🚀 Como Executar o Projeto\n\n### Pré-requisitos\n\n- Node.js 18+ instalado\n- Expo CLI instalado globalmente\n- Android Studio (para Android) ou Xcode (para iOS)\n- Backend rodando na porta 3000\n\n### Instalação\n\n1. **Clone o repositório**\n\n```bash\ngit clone \u003curl-do-repositorio\u003e\ncd imobi-facil\n```\n\n2. **Instale as dependências**\n\n```bash\nnpm install\n```\n\n3. **Configure o backend**\n\n```bash\n# Certifique-se de que o backend está rodando\n# Backend deve estar configurado com Google OAuth\n```\n\n4. **Execute o projeto**\n\n```bash\n# Desenvolvimento\nnpm run dev\n\n# Android\nnpm run android\n\n# iOS\nnpm run ios\n\n# Web\nnpm run web\n```\n\n### Scripts Disponíveis\n\n```bash\n# Desenvolvimento\nnpm run dev              # Inicia o servidor de desenvolvimento\nnpm run dev:client       # Inicia com dev client\nnpm start               # Inicia o Expo\n\n# Build\nnpm run android         # Build para Android\nnpm run ios             # Build para iOS\nnpm run web             # Build para Web\nnpm run prebuild        # Prepara build nativo\n\n# Qualidade de Código\nnpm run lint            # Executa ESLint\nnpm run format          # Formata código com Prettier\nnpm run test            # Executa testes\nnpm run test:coverage   # Testes com cobertura\n\n# SonarQube\nnpm run sonar:scan      # Análise de qualidade\nnpm run sonar:coverage  # Análise com cobertura\n```\n\n## 🔐 Sistema de Autenticação\n\n### Fluxo OAuth com Backend\n\n1. **Inicialização**: Usuário clica em \"Login com Google\"\n2. **Redirecionamento**: App redireciona para backend (`/auth/google`)\n3. **Processamento**: Backend gerencia OAuth com Google\n4. **Callback**: Backend retorna via deep link com dados do usuário\n5. **Armazenamento**: Frontend salva dados localmente\n6. **Navegação**: Usuário é direcionado para área autenticada\n\n### Gerenciamento de Sessão\n\n- **AsyncStorage**: Armazenamento persistente de dados do usuário\n- **Restauração**: Login automático ao abrir o app\n- **Logout**: Limpeza completa de dados locais\n\n## 🏘️ Gestão de Imóveis\n\n### Cadastro de Propriedades\n\n- **Informações Básicas**: Título, tipo, finalidade (venda/aluguel), preço, área\n- **Localização**: CEP, endereço completo, bairro, cidade, estado\n- **Descrição**: Campo de texto livre para detalhes\n- **Mídias**: Upload de fotos e vídeos\n- **Validação**: Validação completa com Zod\n\n### Armazenamento Local\n\n- **AsyncStorage**: Dados temporários até sincronização com backend\n- **Estrutura**: Array de objetos com ID único\n- **Operações**: CRUD completo (Create, Read, Update, Delete)\n\n## 📊 Dashboard do Corretor\n\n### Métricas Principais\n\n- **Visitas Agendadas**: Contador de visitas programadas\n- **Novos Contatos**: Novos clientes em potencial\n- **Documentos Pendentes**: Documentação em análise\n\n### Acesso Rápido\n\n- **Cadastrar Imóvel**: Acesso direto ao formulário\n- **Meus Imóveis**: Lista de propriedades\n- **Cadastrar Cliente**: Formulário de novo cliente\n- **Minhas Pastas**: Organização por pastas\n\n## 🎨 Design System\n\n### Cores Principais\n\n- **Primária**: Azul corporativo para elementos principais\n- **Secundária**: Cinza para textos e elementos secundários\n- **Sucesso**: Verde para ações positivas\n- **Aviso**: Amarelo para alertas\n- **Erro**: Vermelho para erros\n\n### Tipografia\n\n- **Inter**: Fonte principal para textos\n- **Mulish**: Fonte para títulos e destaques\n- **Tamanhos**: Sistema escalável de 12px a 32px\n\n### Componentes\n\n- **Botões**: Estilos consistentes para diferentes ações\n- **Formulários**: Campos padronizados com validação\n- **Cards**: Layouts para exibição de informações\n- **Modais**: Popups para confirmações e formulários\n\n## 📱 Compatibilidade\n\n### Plataformas Suportadas\n\n- **Android**: 6.0+ (API level 23+)\n\n### Padrões de Código\n\n- **TypeScript**: Tipagem estática obrigatória\n- **ESLint**: Regras de linting configuradas\n- **Prettier**: Formatação automática\n- **Conventional Commits**: Padrão de commits\n- **Análise com sonar**: Análise de código antes de fazer o merge\n\n**ImobiFácil** - Um projeto feito através do programa Pipoca Ágil.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarlleyrocha%2Fimobi-facil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwarlleyrocha%2Fimobi-facil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwarlleyrocha%2Fimobi-facil/lists"}