Skip to content

Commit 8afdac8

Browse files
author
Erick Moreira
committed
📝 docs: Tradução do README para português e atualização das funcionalidades
1 parent bae5169 commit 8afdac8

File tree

7 files changed

+299
-292
lines changed

7 files changed

+299
-292
lines changed

‎README.md

+130-81
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
1-
# CloudNest - Modern Storage Management Solution
1+
# CloudNest - Solução Moderna de Gerenciamento de Armazenamento
22

33
<div align="center">
44
<br />
55
<img
66
src="https://raw.githubusercontent.com/heryckmp/CloudNest/main/public/assets/images/cloudnest-banner.png"
7-
alt="CloudNest - Modern Storage Management Solution"
7+
alt="CloudNest - Solução Moderna de Gerenciamento de Armazenamento"
88
style="width: 100%; max-width: 1200px; border-radius: 10px;"
99
/>
1010
<br />
1111

1212
<div>
13-
<img src="https://img.shields.io/badge/-Next_JS-black?style=for-the-badge&logoColor=white&logo=nextdotjs&color=000000" alt="nextdotjs" />
14-
<img src="https://img.shields.io/badge/-TypeScript-black?style=for-the-badge&logoColor=white&logo=typescript&color=3178C6" alt="typescript" />
13+
<img src="https://img.shields.io/badge/-Next_JS_15-black?style=for-the-badge&logoColor=white&logo=nextdotjs&color=000000" alt="nextdotjs" />
14+
<img src="https://img.shields.io/badge/-TypeScript_5-black?style=for-the-badge&logoColor=white&logo=typescript&color=3178C6" alt="typescript" />
1515
<img src="https://img.shields.io/badge/-Tailwind_CSS-black?style=for-the-badge&logoColor=white&logo=tailwindcss&color=06B6D4" alt="tailwindcss" />
1616
<img src="https://img.shields.io/badge/-Appwrite-black?style=for-the-badge&logoColor=white&logo=appwrite&color=FD366E" alt="appwrite" />
1717
</div>
@@ -31,74 +31,95 @@
3131
5. 🤸 [Início Rápido](#início-rápido)
3232
6. 🎨 [Sistema de Design](#sistema-de-design)
3333
7. 🔒 [Segurança](#segurança)
34-
8. 🤖 [Assistente AI](#assistente-ai)
34+
8. 🤖 [Assistente IA](#assistente-ia)
3535
9. 🔄 [Atualizações Recentes](#atualizações-recentes)
3636

3737
## 🚀 Introdução
3838

39-
CloudNest é uma plataforma de gerenciamento de armazenamento e compartilhamento de arquivos de última geração que revoluciona a forma como os usuários interagem com seu conteúdo digital. Construída com as mais recentes tecnologias web, oferece uma experiência segura, intuitiva e sem complicações para gerenciar e compartilhar arquivos na nuvem.
39+
O CloudNest é uma plataforma moderna de gerenciamento e compartilhamento de arquivos que revoluciona a forma como os usuários interagem com seu conteúdo digital. Construída com as mais recentes tecnologias web, oferece uma experiência segura, intuitiva e sem complicações para gerenciar e compartilhar arquivos na nuvem.
4040

4141
## ⚙️ Tecnologias
4242

43-
- **Frontend**: React 19 com Next.js 15
44-
- **Backend**: Appwrite Cloud
45-
- **Estilização**: TailwindCSS com ShadCN
46-
- **Linguagem**: TypeScript
47-
- **Gerenciamento de Estado**: React Context API
48-
- **Autenticação**: Appwrite Auth
43+
- **Frontend**:
44+
- Next.js 15 com App Router
45+
- React 19
46+
- TypeScript 5
47+
- **Backend**:
48+
- Appwrite Cloud
49+
- API de IA Hugging Face
50+
- **Estilização**:
51+
- TailwindCSS 3.4
52+
- ShadcnUI
53+
- Radix UI
54+
- **Gerenciamento de Estado**:
55+
- React Context API
56+
- Server Actions
57+
- **Visualização de Dados**:
58+
- Recharts
59+
- **Autenticação**:
60+
- Appwrite Auth com OTP
4961

5062
## 🔋 Funcionalidades
5163

5264
- **Gerenciamento Inteligente de Arquivos**
53-
- Organização avançada com categorização inteligente
54-
- Suporte a operações em lote
55-
- Histórico de versões
56-
57-
- **Segurança Aprimorada**
58-
- Criptografia ponta a ponta para arquivos sensĂ­veis
59-
- Autenticação de dois fatores
60-
- Controles granulares de permissĂŁo
65+
- Organização automática por tipo de arquivo
66+
- Cálculo de armazenamento total por categoria
67+
- Visualização de uso de espaço em tempo real
68+
- Suporte a mĂşltiplos formatos de arquivo
6169

6270
- **Interface Moderna**
63-
- Suporte a tema claro/escuro
64-
- Design responsivo para todos os dispositivos
65-
- Interface intuitiva com arrastar e soltar
66-
67-
- **Busca Inteligente**
68-
- Capacidade de busca em texto completo
69-
- Indexação de conteúdo de arquivos
70-
- Opções avançadas de filtro
71-
72-
- **Colaboração em Tempo Real**
73-
- Compartilhamento de arquivos com permissões personalizáveis
74-
- Suporte a espaço de trabalho em equipe
75-
- Rastreamento de atividades e notificações
71+
- Design responsivo mobile-first
72+
- Tema claro/escuro automático
73+
- Animações suaves e feedback visual
74+
- Painel interativo com gráficos
75+
76+
- **Busca Avançada**
77+
- Pesquisa em tempo real
78+
- Filtros por tipo de arquivo
79+
- Ordenação personalizada
80+
- Visualização prévia de resultados
81+
82+
- **Gerenciamento de Arquivos**
83+
- Upload com arrastar e soltar
84+
- Renomeação de arquivos
85+
- Compartilhamento seguro
86+
- Download direto
87+
- Visualização de detalhes
7688

7789
## 🌟 Inovações
7890

79-
CloudNest introduz várias características inovadoras que o destacam:
91+
O CloudNest apresenta várias características inovadoras:
8092

8193
1. **Otimização Inteligente de Armazenamento**
82-
- Detecção automática de duplicatas
83-
- Algoritmos inteligentes de compressĂŁo
84-
- Cache preditivo
94+
- Monitoramento de uso em tempo real
95+
- Gráficos interativos de utilização
96+
- Análise de tendências de uso
8597

8698
2. **Organização Baseada em IA**
87-
- Categorização automática de arquivos
88-
- Sugestões baseadas em conteúdo
89-
- Sistema inteligente de tags
99+
- Assistente de IA integrado
100+
- Respostas contextuais
101+
- Sugestões inteligentes
90102

91103
3. **Medidas Avançadas de Segurança**
92-
- Criptografia de conhecimento zero
93-
- Integridade de arquivos verificada por blockchain
94-
- Detecção avançada de ameaças
104+
- Autenticação OTP
105+
- Proteção contra uploads maliciosos
106+
- Controle granular de permissões
95107

96108
## 🤸 Início Rápido
97109

110+
### Pré-requisitos
111+
112+
- Node.js (v18 ou superior)
113+
- npm (v9 ou superior)
114+
- Conta no Appwrite Cloud
115+
- Credenciais do projeto Appwrite
116+
117+
### Passo a Passo
118+
98119
1. **Clone o repositĂłrio**
99120
```bash
100-
git clone https://github.com/heryckmp/cloudnest.git
101-
cd cloudnest
121+
git clone https://github.com/heryckmp/CloudNest.git
122+
cd CloudNest
102123
```
103124

104125
2. **Instale as dependĂŞncias**
@@ -107,25 +128,50 @@ npm install
107128
```
108129

109130
3. **Configure as variáveis de ambiente**
110-
Crie um arquivo `.env.local`:
131+
132+
Crie um arquivo `.env.local` na raiz do projeto com:
133+
111134
```env
135+
# Configurações públicas (client-side)
112136
NEXT_PUBLIC_APPWRITE_ENDPOINT="https://cloud.appwrite.io/v1"
113-
NEXT_PUBLIC_APPWRITE_PROJECT=""
114-
NEXT_PUBLIC_APPWRITE_DATABASE=""
115-
NEXT_PUBLIC_APPWRITE_USERS_COLLECTION=""
116-
NEXT_PUBLIC_APPWRITE_FILES_COLLECTION=""
117-
NEXT_PUBLIC_APPWRITE_BUCKET=""
118-
NEXT_APPWRITE_KEY=""
137+
NEXT_PUBLIC_APPWRITE_PROJECT="sua_project_id_aqui"
138+
NEXT_PUBLIC_APPWRITE_DATABASE="sua_database_id_aqui"
139+
NEXT_PUBLIC_APPWRITE_USERS_COLLECTION="sua_collection_id_usuarios"
140+
NEXT_PUBLIC_APPWRITE_FILES_COLLECTION="sua_collection_id_arquivos"
141+
NEXT_PUBLIC_APPWRITE_BUCKET="sua_bucket_id_aqui"
142+
143+
# Chave secreta (server-side apenas)
144+
NEXT_APPWRITE_KEY="sua_api_key_secreta_aqui"
119145
```
120146

121-
4. **Inicie o servidor de desenvolvimento**
147+
4. **Obtenha as credenciais do Appwrite**
148+
149+
Siga estes passos para conseguir os valores:
150+
151+
- **Endpoint**: Já pré-configurado (não altere)
152+
- **Project ID**: Painel do Appwrite → Configurações → Geral
153+
- **Database ID**: Appwrite → Bancos de Dados → Seu Banco → Configurações
154+
- **Collection IDs**: Dentro do Banco de Dados, clique em cada coleção → Configurações
155+
- **Bucket ID**: Appwrite → Armazenamento → Seu Bucket → Configurações
156+
- **API Key**: Appwrite → Visão Geral → Chaves de API → Criar Chave de API
157+
- Selecione escopos: users.read, users.write, files.read, files.write
158+
159+
5. **Inicie o servidor**
122160
```bash
123161
npm run dev
124162
```
125163

164+
6. Acesse: `http://localhost:3000`
165+
166+
### đź’ˇ Dicas Importantes
167+
168+
- Nunca faça commit de suas credenciais! O arquivo `.env.local` já está no `.gitignore` por padrão
169+
- Para ambientes de produção, use variáveis de ambiente no seu serviço de hospedagem
170+
- Em caso de erros de permissĂŁo, verifique os escopos da Chave de API no Appwrite
171+
126172
## 🎨 Sistema de Design
127173

128-
CloudNest possui um sistema de design abrangente que garante consistĂŞncia e acessibilidade:
174+
O CloudNest possui um sistema de design abrangente que garante consistĂŞncia e acessibilidade:
129175

130176
- **Paleta de Cores**: Cores cuidadosamente selecionadas para temas claro e escuro
131177
- **Tipografia**: Hierarquia de fontes moderna e legĂ­vel
@@ -142,45 +188,48 @@ A segurança está no núcleo da arquitetura do CloudNest:
142188
- Protocolos seguros de compartilhamento de arquivos
143189
- Controle avançado de acesso
144190

145-
## 🤖 Assistente AI
191+
## 🤖 Assistente IA
146192

147-
O CloudNest agora inclui um assistente AI integrado que oferece:
193+
O CloudNest agora inclui um assistente de IA integrado que oferece:
148194

149-
- **Chat Interativo**: Interface de chat amigável para interação com IA
195+
- **Chat Interativo**: Interface amigável para interação com IA
150196
- **Modelo Avançado**: Integração com o modelo BlenderBot da Hugging Face
151197
- **Respostas Contextuais**: Respostas inteligentes baseadas no contexto da conversa
152198
- **Tratamento de Erros**: Sistema robusto de tratamento de erros e feedback ao usuário
153-
- **Interface Responsiva**: Design adaptativo que funciona em qualquer dispositivo
199+
- **Interface Responsiva**: Design adaptativo para qualquer dispositivo
154200

155-
Para usar o assistente AI:
156-
1. Navegue até a seção AI Assistant
201+
Para usar o assistente IA:
202+
1. Navegue até a seção Assistente IA
157203
2. Digite sua mensagem na caixa de texto
158204
3. Aguarde a resposta do assistente
159205
4. Continue a conversa naturalmente
160206

161207
## 🔄 Atualizações Recentes
162208

163-
### VersĂŁo 0.2.0 (Fevereiro 2024)
164-
165-
1. **Novo Assistente AI**
166-
- Implementação do chat com IA usando Hugging Face
167-
- Interface de usuário moderna e responsiva
168-
- Sistema de tratamento de erros aprimorado
169-
170-
2. **Melhorias na Interface**
171-
- Novos Ă­cones animados para tipos de arquivo
172-
- Efeitos hover aprimorados nos cards
173-
- Correções no tema escuro
174-
175-
3. **Otimizações Técnicas**
176-
- Migração para App Router do Next.js
177-
- Melhor tratamento de erros na API
178-
- Correções de tipagem TypeScript
179-
180-
4. **Segurança**
181-
- Implementação segura de variáveis de ambiente
182-
- Melhor proteção das chaves de API
183-
- Validação aprimorada de requisições
209+
### Versão 0.3.0 (Março 2024)
210+
211+
1. **Melhorias no Painel**
212+
- Novo gráfico de armazenamento com Recharts
213+
- Visualização de atividade do usuário
214+
- Cálculo de espaço usado por categoria
215+
216+
2. **Interface Aprimorada**
217+
- Novo tema escuro otimizado
218+
- ĂŤcones animados para tipos de arquivo
219+
- Menu de ações com três pontos
220+
- BotĂŁo de logout com texto responsivo
221+
222+
3. **Funcionalidades de Arquivo**
223+
- Visualização prévia de imagens melhorada
224+
- Suporte a mais tipos de arquivo
225+
- Ordenação avançada de arquivos
226+
- Busca em tempo real aprimorada
227+
228+
4. **Segurança e Desempenho**
229+
- Autenticação OTP implementada
230+
- Melhor tratamento de erros
231+
- Otimização de carregamento
232+
- Feedback visual aprimorado
184233

185234
---
186235

‎app/globals.css

+6-6
Original file line numberDiff line numberDiff line change
@@ -192,10 +192,10 @@
192192

193193
/* Sidebar & MobileNavigation */
194194
.nav-icon {
195-
@apply w-6 filter invert opacity-25 !important;
195+
@apply size-6 opacity-60 transition-opacity !important;
196196
}
197197
.nav-icon-active {
198-
@apply invert-0 opacity-100 !important;
198+
@apply opacity-100 !important;
199199
}
200200

201201
/* ===== STYLE CLASSES */
@@ -413,7 +413,7 @@
413413
@apply flex-center min-w-fit gap-4 !important;
414414
}
415415
.sign-out-button {
416-
@apply flex-center h-[52px] min-w-[54px] items-center rounded-full bg-[#3B82F6] text-white hover:bg-[#2563eb] dark:bg-[#3B82F6] dark:text-white dark:hover:bg-[#2563eb] shadow-none transition-all !important;
416+
@apply h-[52px] rounded-full bg-brand/10 p-4 text-brand shadow-none transition-all hover:bg-brand/20 dark:bg-brand-dark/10 dark:text-brand-dark dark:hover:bg-brand-dark/20;
417417
}
418418

419419
/* Mobile Navigation */
@@ -433,7 +433,7 @@
433433
@apply flex flex-1 flex-col gap-4 !important;
434434
}
435435
.mobile-nav-item {
436-
@apply flex text-dark-100 dark:text-white gap-4 rounded-xl lg:w-full justify-center lg:justify-start items-center h5 lg:px-[30px] h-[52px] lg:rounded-full !important;
436+
@apply flex text-dark-100 dark:text-white gap-4 rounded-xl lg:w-full justify-center lg:justify-start items-center h5 lg:px-[30px] h-[52px] lg:rounded-full bg-white hover:bg-gray-50 dark:bg-[#1E293B] dark:hover:bg-[#334766] transition-colors !important;
437437
}
438438
.mobile-sign-out-button {
439439
@apply h5 flex h-[52px] w-full items-center gap-4 rounded-full bg-[#3B82F6]/10 px-6 text-[#3B82F6] dark:bg-[#FFB5C5]/10 dark:text-[#FFB5C5] shadow-none transition-all hover:bg-[#3B82F6]/20 dark:hover:bg-[#FFB5C5]/20 !important;
@@ -469,7 +469,7 @@
469469
@apply h5 mt-9 flex-1 gap-1 text-brand !important;
470470
}
471471
.sidebar-nav-item {
472-
@apply flex text-black gap-4 rounded-xl lg:w-full justify-center lg:justify-start items-center h5 lg:px-[30px] h-[52px] lg:rounded-full !important;
472+
@apply flex text-dark-100 dark:text-white gap-4 rounded-xl lg:w-full justify-center lg:justify-start items-center h5 lg:px-[30px] h-[52px] lg:rounded-full bg-white hover:bg-gray-50 dark:bg-[#1E293B] dark:hover:bg-[#334766] transition-colors !important;
473473
}
474474
.sidebar-user-info {
475475
@apply mt-4 flex items-center justify-center gap-2 rounded-full bg-brand/10 p-1 text-light-100 lg:justify-start lg:p-3 !important;
@@ -479,7 +479,7 @@
479479
}
480480

481481
.shad-active {
482-
@apply bg-[#3B82F6] text-white shadow-drop-2 !important;
482+
@apply bg-brand/10 text-brand dark:bg-brand-dark/10 dark:text-brand-dark !important;
483483
}
484484

485485
/* Sort */

0 commit comments

Comments
 (0)