1
- # CloudNest - Modern Storage Management Solution
1
+ # CloudNest - Solução Moderna de Gerenciamento de Armazenamento
2
2
3
3
<div align =" center " >
4
4
<br />
5
5
<img
6
6
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 "
8
8
style="width: 100%; max-width: 1200px; border-radius: 10px;"
9
9
/>
10
10
<br />
11
11
12
12
<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" />
15
15
<img src="https://img.shields.io/badge/-Tailwind_CSS-black?style=for-the-badge&logoColor=white&logo=tailwindcss&color=06B6D4" alt="tailwindcss" />
16
16
<img src="https://img.shields.io/badge/-Appwrite-black?style=for-the-badge&logoColor=white&logo=appwrite&color=FD366E" alt="appwrite" />
17
17
</div >
31
31
5 . 🤸 [ InĂcio Rápido] ( #inĂcio-rápido )
32
32
6 . 🎨 [ Sistema de Design] ( #sistema-de-design )
33
33
7 . 🔒 [ Segurança] ( #segurança )
34
- 8 . 🤖 [ Assistente AI ] ( #assistente-ai )
34
+ 8 . 🤖 [ Assistente IA ] ( #assistente-ia )
35
35
9 . 🔄 [ Atualizações Recentes] ( #atualizações-recentes )
36
36
37
37
## 🚀 Introdução
38
38
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.
40
40
41
41
## ⚙️ Tecnologias
42
42
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
49
61
50
62
## 🔋 Funcionalidades
51
63
52
64
- ** 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
61
69
62
70
- ** 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
76
88
77
89
## 🌟 Inovações
78
90
79
- CloudNest introduz várias caracterĂsticas inovadoras que o destacam :
91
+ O CloudNest apresenta várias caracterĂsticas inovadoras:
80
92
81
93
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
85
97
86
98
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
90
102
91
103
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
95
107
96
108
## 🤸 InĂcio Rápido
97
109
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
+
98
119
1 . ** Clone o repositĂłrio**
99
120
``` 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
102
123
```
103
124
104
125
2 . ** Instale as dependĂŞncias**
@@ -107,25 +128,50 @@ npm install
107
128
```
108
129
109
130
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
+
111
134
``` env
135
+ # Configurações públicas (client-side)
112
136
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"
119
145
```
120
146
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**
122
160
``` bash
123
161
npm run dev
124
162
```
125
163
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
+
126
172
## 🎨 Sistema de Design
127
173
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:
129
175
130
176
- ** Paleta de Cores** : Cores cuidadosamente selecionadas para temas claro e escuro
131
177
- ** Tipografia** : Hierarquia de fontes moderna e legĂvel
@@ -142,45 +188,48 @@ A segurança está no núcleo da arquitetura do CloudNest:
142
188
- Protocolos seguros de compartilhamento de arquivos
143
189
- Controle avançado de acesso
144
190
145
- ## 🤖 Assistente AI
191
+ ## 🤖 Assistente IA
146
192
147
- O CloudNest agora inclui um assistente AI integrado que oferece:
193
+ O CloudNest agora inclui um assistente de IA integrado que oferece:
148
194
149
- - ** Chat Interativo** : Interface de chat amigável para interação com IA
195
+ - ** Chat Interativo** : Interface amigável para interação com IA
150
196
- ** Modelo Avançado** : Integração com o modelo BlenderBot da Hugging Face
151
197
- ** Respostas Contextuais** : Respostas inteligentes baseadas no contexto da conversa
152
198
- ** 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
154
200
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
157
203
2 . Digite sua mensagem na caixa de texto
158
204
3 . Aguarde a resposta do assistente
159
205
4 . Continue a conversa naturalmente
160
206
161
207
## 🔄 Atualizações Recentes
162
208
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
184
233
185
234
---
186
235
0 commit comments