archihub

🏗️ ArchiHub – Plataforma Inteligente de Gestão Arquitetônica O ArchiHub é uma plataforma digital completa voltada para gestão integrada de projetos de arquitetura e engenharia, unindo colaboração, controle técnico e visualização avançada em um único ambiente fluido. Seu diferencial está na simplicidade da interface combinada com recursos de última geração, permitindo que arquitetos, engenheiros e equipes técnicas gerenciem projetos, tarefas, arquivos e modelos 3D de forma intuitiva, com total rastreabilidade e segurança. 🎨 1. FRONTEND Base tecnológica moderna e performática: React 18 – Framework principal de interface (SPA) Tailwind CSS – Design responsivo e minimalista (mobile, tablet e desktop) React Router v6 – Navegação entre páginas e rotas dinâmicas Axios – Integração eficiente com a API Bibliotecas e recursos interativos: @dnd-kit – Drag & Drop nativo (Kanban de tarefas) Fabric.js – Canvas 2D (esboços e anotações sobre plantas) Three.js + web-ifc-three – Visualização e manipulação de modelos BIM/IFC em 3D Lucide React – Ícones modernos e leves react-toastify – Notificações elegantes e não intrusivas date-fns – Manipulação e formatação de datas Mapeamento e Geolocalização: MapLibre GL + OSM (OpenStreetMap) – Mapas interativos e leves Nominatim API – Geocoding e reverse geocoding Arquitetura organizada (exemplo): frontend/src/ ├── components/ # Componentes principais de UI │ ├── Dashboard.js │ ├── QuickSketch.js │ ├── ProjectDetail.js │ └── project/ │ ├── UnifiedTaskBoard.jsx │ ├── TaskDetailModal.js │ ├── FileManager.js │ └── TerrainAnalysis.js ├── contexts/ # Contextos globais (Auth, Language) ├── services/ # Serviços externos e APIs └── utils/ # Funções auxiliares e formatadores 🔧 2. BACKEND Núcleo rápido, seguro e escalável com FastAPI (Python 3.10+). Framework & Core FastAPI – API moderna, assíncrona e de alta performance Motor (MongoDB) – Driver assíncrono de banco de dados Pydantic – Validação e serialização de dados Autenticação e Segurança JWT (JSON Web Tokens) – Autenticação stateless bcrypt – Hash de senhas e proteção de credenciais CORS Middleware – Controle de acesso cross-origin Storage e Arquivos Sistema de armazenamento modular: LocalStorageBackend – Armazenamento local organizado por projeto S3StorageBackend – Estrutura pronta para migração futura à AWS S3 Pillow – Thumbnails automáticos de imagens PyMuPDF – Extração e pré-visualização de PDFs Banco de Dados: MongoDB – Estrutura flexível para múltiplos tipos de documento Coleções principais: users – Usuários (arquiteto, engenheiro, funcionário) projects – Projetos e metadados tasks – Tarefas globais e vinculadas project_files – Arquivos de projeto task_attachments – Anexos task_comments – Comentários e áudios Organização do backend: backend/ ├── server.py # API principal e rotas ├── storage_manager.py # Módulo de armazenamento (Local/S3) ├── task_endpoints.py # Rotas específicas de tarefas ├── document_ocr.py # OCR de documentos ├── document_classifier.py # Classificação inteligente de arquivos ├── thumbnail_generator.py # Miniaturas automáticas └── init_db.py # Inicialização do banco 🔄 3. ENDPOINTS PRINCIPAIS (API REST) Autenticação POST /api/auth/register – Cadastro de usuário POST /api/auth/login – Login com JWT Projetos GET /api/projects – Listar POST /api/projects – Criar PUT /api/projects/{id} – Atualizar DELETE /api/projects/{id} – Remover Tarefas GET /api/tasks – Tarefas globais GET /api/projects/{id}/tasks – Tarefas por projeto POST /api/tasks – Criar tarefa PATCH /api/tasks/{id}/status – Atualizar status DELETE /api/tasks/{id} – Remover Arquivos e Anexos POST /api/projects/{id}/files – Upload GET /api/projects/{id}/files – Listagem DELETE /api/projects/{id}/files/{id} – Exclusão POST /api/projects/{id}/tasks/{id}/attachments – Upload de anexos POST /api/projects/{id}/tasks/{id}/comments/audio – Comentários de áudio 🎯 4. FUNCIONALIDADES-CHAVE Gestão de Projetos – Criação, edição e acompanhamento centralizado Kanban Interativo – Tarefas por status com drag & drop fluido Anexos e Comentários Multimídia – Upload, preview e áudio Esboço Rápido (QuickSketch) – Anotações em planta via Fabric.js Renderização 3D (IFC/BIM) – Visualização técnica com Three.js Mapas Interativos – Localização e georreferenciamento dos projetos Registro de Atividades (Activity Trail) – Auditoria completa de ações Sistema de Permissões – Diferenciação entre Arquiteto, Engenheiro e Funcionário Deep Linking – Acesso direto a tarefas (/tasks/:id) OCR Inteligente – Reconhecimento e preenchimento automático de dados de documentos 🧠 5. DIFERENCIAIS TÉCNICOS Integração fluida entre 2D e 3D: do esboço ao modelo IFC Arquitetura modular: separação clara entre camadas (API, storage, frontend) Desenvolvimento escalável: pronto para nuvem (Render, AWS, Vercel) Segurança e logs detalhados: auditoria de todas as ações Design focado na experiência: rápido, fluido e responsivo Preparado para IA: módulos de OCR e classificação inteligente de documentos 📦 6. TECNOLOGIAS COMPLEMENTARES Python 3.10+ / FastAPI / Pydantic / Motor React 18 / Vite / Tailwind CSS MongoDB / Docker / AWS (futuro) Fabric.js / Three.js / MapLibre GL / OSM 🌍 7. OBJETIVO O ArchiHub nasce com o propósito de simplificar a rotina de arquitetos e engenheiros, centralizando em um só ambiente tudo o que hoje é fragmentado em múltiplas plataformas: Tarefas e cronogramas Controle de arquivos e revisões Comunicação entre equipes Visualização técnica 2D e 3D Relatórios e auditorias automáticas “É como dar ao usuário um estúdio criativo centralizado, em vez de obrigá-lo a mudar de sala a cada ação.” 🎯 💡 8. ESTADO ATUAL DO PROJETO MVP funcional rodando no Emergent.sh Frontend e Backend integrados (FastAPI + React + MongoDB) Todos os módulos principais operacionais (Projetos, Tarefas, Arquivos, Esboço, 3D) Em fase de otimização de performance e migração para ambiente local + Claude.ai 🚀 9. PRÓXIMOS PASSOS Migração do desenvolvimento para ambiente local (Claude + GitHub) Refino de UX e padronização visual (layout responsivo unificado) Integração futura com IA (reconhecimento automático de plantas e materiais) Deploy escalável via Vercel (frontend) e Render (backend) Beta público e onboarding de equipes de arquitetura ArchiHub – Onde a arquitetura encontra a inteligência. 🏛️