HackTown - Achados e Perdidos

Sistema de achados e perdidos para eventos de tecnologia, desenvolvido para o HackTown 2025.

Projeto desenvolvido com Amazon Q Developer CLI para fins de estudo e apresentação no AWS Developer Hub.

Funcionalidades

• ✅ Cadastro de itens perdidos e encontrados
• ✅ Geração automática de imagens usando IA (Pollinations - 100% GRATUITO)
• ✅ Interface responsiva com React e Tailwind CSS
• ✅ API REST com Node.js e Express

Tecnologias

Backend

• Node.js
• Express
• Pollinations AI (100% Gratuito)
• Multer (upload de arquivos)

Frontend

• React com TypeScript
• Tailwind CSS
• Axios
• Componentes UI customizados

Configuração

Backend

1. Entre na pasta do backend:

cd backend

2. Instale as dependências:

npm install

3. Configure as variáveis de ambiente:

cp .env.example .env

4. Não precisa de chaves de API - funciona imediatamente!

5. Execute o servidor:

npm run dev

Frontend

1. Entre na pasta do frontend:

cd frontend

2. Instale as dependências:

npm install

3. Execute a aplicação:

npm start

Como usar

1. Acesse http://localhost:3000
2. Preencha o formulário com os dados do item
3. A IA gerará automaticamente uma imagem baseada na descrição
4. O item aparecerá na lista de itens reportados

API Endpoints

• POST /api/items - Criar novo item
• GET /api/items - Listar todos os itens
• GET /api/items/:id - Buscar item específico

Preview