{"id":28864911,"url":"https://github.com/gersonrocha9/canteiro-app","last_synced_at":"2026-04-29T23:05:19.479Z","repository":{"id":299318353,"uuid":"1002646010","full_name":"GersonRocha9/canteiro-app","owner":"GersonRocha9","description":"O Canteiro é um aplicativo mobile desenvolvido especificamente para o mercado brasileiro de construção civil, oferecendo uma solução completa para gestão de ferramentas e equipamentos em canteiros de obra.","archived":false,"fork":false,"pushed_at":"2025-06-15T23:01:17.000Z","size":1028,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-15T23:58:55.130Z","etag":null,"topics":["expo","react-native","supabase"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GersonRocha9.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-06-15T22:42:59.000Z","updated_at":"2025-06-15T23:01:20.000Z","dependencies_parsed_at":"2025-06-16T00:09:39.151Z","dependency_job_id":null,"html_url":"https://github.com/GersonRocha9/canteiro-app","commit_stats":null,"previous_names":["gersonrocha9/canteiro-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GersonRocha9/canteiro-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GersonRocha9%2Fcanteiro-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GersonRocha9%2Fcanteiro-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GersonRocha9%2Fcanteiro-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GersonRocha9%2Fcanteiro-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GersonRocha9","download_url":"https://codeload.github.com/GersonRocha9/canteiro-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GersonRocha9%2Fcanteiro-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266822176,"owners_count":23989823,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-24T02:00:09.469Z","response_time":99,"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":["expo","react-native","supabase"],"created_at":"2025-06-20T10:00:51.372Z","updated_at":"2026-04-29T23:05:19.403Z","avatar_url":"https://github.com/GersonRocha9.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🏗️ Canteiro - Gestão de Ferramentas de Construção\n\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- \u003cimg src=\"assets/icon.png\" alt=\"Canteiro Logo\" width=\"120\" height=\"120\" /\u003e --\u003e\n  \n  **Sistema completo de gestão de ferramentas para canteiros de obra**\n  \n  [![React Native](https://img.shields.io/badge/React%20Native-0.74-blue.svg)](https://reactnative.dev/)\n  [![Expo](https://img.shields.io/badge/Expo-51-black.svg)](https://expo.dev/)\n  [![Supabase](https://img.shields.io/badge/Supabase-Backend-green.svg)](https://supabase.com/)\n  [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\u003c/div\u003e\n\n## 📱 Sobre o Projeto\n\nO **Canteiro** é um aplicativo mobile desenvolvido especificamente para o mercado brasileiro de construção civil, oferecendo uma solução completa para gestão de ferramentas e equipamentos em canteiros de obra.\n\n### 🎯 Principais Funcionalidades\n\n- **📊 Dashboard Inteligente** - Visão geral com estatísticas em tempo real\n- **🔧 Gestão de Ferramentas** - Cadastro, listagem e controle completo\n- **📝 Atividades Recentes** - Histórico detalhado de movimentações\n- **👥 Controle de Usuários** - Sistema de perfis e permissões\n- **🏢 Multi-empresa** - Suporte a múltiplas construtoras\n- **📱 Interface Moderna** - Design responsivo e intuitivo\n- **🔍 Busca e Filtros** - Localização rápida de ferramentas\n- **⚡ Tempo Real** - Sincronização instantânea entre dispositivos\n\n## 🚀 Tecnologias Utilizadas\n\n### Frontend\n- **React Native** - Framework para desenvolvimento mobile\n- **Expo** - Plataforma de desenvolvimento e deploy\n- **TypeScript** - Tipagem estática para JavaScript\n- **Expo Router** - Navegação baseada em arquivos\n- **NativeWind** - Tailwind CSS para React Native\n- **React Hook Form** - Gerenciamento de formulários\n- **Zod** - Validação de schemas\n\n### Backend\n- **Supabase** - Backend-as-a-Service\n- **PostgreSQL** - Banco de dados relacional\n- **Row Level Security (RLS)** - Segurança a nível de linha\n- **Real-time Subscriptions** - Atualizações em tempo real\n\n## 📋 Pré-requisitos\n\n- **Node.js** 18+ \n- **npm** ou **yarn**\n- **Expo CLI** (`npm install -g @expo/cli`)\n- **Conta no Supabase** (gratuita)\n\n## ⚙️ Instalação e Configuração\n\n### 1. Clone o repositório\n```bash\ngit clone https://github.com/GersonRocha9/canteiro-app.git\ncd canteiro-app\n```\n\n### 2. Instale as dependências\n```bash\nyarn install\n# ou\nnpm install\n```\n\n### 3. Configure o Supabase\n\n1. Crie um projeto no [Supabase](https://supabase.com)\n2. Crie um arquivo `.env` na raiz do projeto\n3. Adicione suas credenciais do Supabase:\n\n```env\nEXPO_PUBLIC_SUPABASE_URL=https://seu-projeto.supabase.co\nEXPO_PUBLIC_SUPABASE_ANON_KEY=sua_chave_anonima_aqui\n```\n\n\u003e 💡 **Dica**: Encontre essas informações em Settings \u003e API no painel do Supabase\n\n### 4. Configure o banco de dados\n\nExecute o arquivo SQL no Supabase SQL Editor:\n\n```bash\n# Copie o conteúdo de canteiro_setup_completo.sql\n# Cole no SQL Editor do Supabase e execute\n```\n\n### 5. Execute o aplicativo\n\n```bash\nyarn start\n# ou\nnpm start\n```\n\n## 🏗️ Estrutura do Projeto\n\n```\ncanteiro-app/\n├── app/                          # Telas do aplicativo (Expo Router)\n│   ├── (protected)/             # Área protegida (logado)\n│   │   ├── (tabs)/              # Navegação por abas\n│   │   │   ├── index.tsx        # Dashboard\n│   │   │   ├── tools.tsx        # Listagem de ferramentas\n│   │   │   └── profile.tsx      # Perfil do usuário\n│   │   ├── add-tool.tsx         # Cadastro de ferramentas\n│   │   ├── activities.tsx       # Atividades recentes\n│   │   ├── tool-details.tsx     # Detalhes da ferramenta\n│   │   └── modal.tsx           # Tela modal\n│   ├── welcome.tsx             # Tela de boas-vindas\n│   ├── sign-up.tsx            # Cadastro\n│   └── sign-in.tsx            # Login\n├── components/                 # Componentes reutilizáveis\n│   ├── ui/                    # Componentes de UI base\n│   └── safe-area-view.tsx     # SafeAreaView customizado\n├── hooks/                     # Hooks customizados\n│   ├── useDashboard.ts       # Hook do dashboard\n│   ├── useProfile.ts         # Hook do perfil\n│   ├── useTools.ts           # Hook das ferramentas\n│   └── useActivities.ts      # Hook das atividades\n├── context/                  # Contextos React\n│   └── supabase-provider.tsx # Provider de autenticação\n├── types/                    # Tipos TypeScript\n│   └── database.types.ts     # Tipos do banco de dados\n├── config/                   # Configurações\n│   └── supabase.ts          # Cliente Supabase\n└── canteiro_setup_completo.sql # Setup do banco de dados\n```\n\n## 🎨 Design System\n\nO app utiliza um design system consistente baseado em:\n\n- **Cores**: Paleta profissional para construção civil\n- **Tipografia**: Hierarquia clara e legível\n- **Componentes**: Biblioteca reutilizável de UI\n- **Ícones**: Material Icons para consistência\n- **Espaçamento**: Sistema baseado em múltiplos de 4px\n\n## 👥 Tipos de Usuário\n\n### Roles Disponíveis:\n- **👨‍💼 Admin** - Acesso total ao sistema\n- **👷‍♂️ Encarregado** - Gestão de ferramentas e equipe\n- **🔨 Mestre de Obras** - Supervisão e controle\n- **📦 Almoxarife** - Controle de estoque\n- **⚒️ Operário** - Uso básico de ferramentas\n\n## 🔐 Segurança\n\n- **Autenticação** via Supabase Auth\n- **Row Level Security (RLS)** no banco de dados\n- **Políticas de acesso** por empresa e role\n- **Validação** de dados no frontend e backend\n- **Criptografia** de dados sensíveis\n\n## 📊 Funcionalidades Detalhadas\n\n### Dashboard\n- Estatísticas em tempo real\n- Gráficos de utilização\n- Atividades recentes\n- Ações rápidas\n\n### Gestão de Ferramentas\n- Cadastro completo com fotos\n- QR Code para identificação\n- Controle de localização\n- Histórico de movimentações\n- Status em tempo real\n\n### Atividades\n- Log completo de ações\n- Filtros por tipo e período\n- Busca avançada\n- Exportação de relatórios\n\n## 🤝 Contribuindo\n\n1. Faça um fork do projeto\n2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)\n3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)\n4. Push para a branch (`git push origin feature/AmazingFeature`)\n5. Abra um Pull Request\n\n## 📄 Licença\n\nEste projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.\n\n## 📞 Suporte\n\n- **Email**: gersonrocha9@gmail.com\n- **Issues**: [GitHub Issues](https://github.com/GersonRocha9/canteiro-app/issues)\n- **Documentação**: [Wiki do Projeto](https://github.com/GersonRocha9/canteiro-app/wiki)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  Desenvolvido com ❤️ para a construção civil brasileira\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgersonrocha9%2Fcanteiro-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgersonrocha9%2Fcanteiro-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgersonrocha9%2Fcanteiro-app/lists"}