Este repositório consiste em um monorepo onde está sendo desenvolvido o Inithub, uma plataforma de gestão de iniciativas colaborativas com suporte a inteligência artificial.
O repositório monolítico inclui os serviços de frontend, backend, agente de IA e banco de dados, todos orquestrados via Docker. Cada serviço possui um README específico, no qual são descritos em mais detalhes os objetivos, estrutura e funcionamento de cada um.
inithub/
├── frontend/ # Interface web (React + Vite)
├── backend/ # API principal (NestJS)
├── agent/ # Serviço IA (FastAPI)
├── docker-compose.yml
└── .env # Variáveis de ambiente
ℹ️ Cada serviço possui seu próprio diretório e README com instruções específicas.
O Inithub está organizado como um monorepo, ou seja, todos os serviços e componentes da aplicação estão agrupados em um único repositório. Essa abordagem facilita o desenvolvimento integrado, o versionamento sincronizado e a orquestração dos serviços com Docker.
| Serviço | Descrição |
|---|---|
| Frontend | Aplicação React + Vite que oferece a interface para os usuários interagirem com a plataforma. |
| Backend | API principal construída em NestJS com Prisma, responsável por gerenciar iniciativas, recursos sociais e banco de dados. |
| Agente de IA | Serviço dedicado a funcionalidades de inteligência artificial, como geração de texto, recomendações e chat, usando OpenAI. |
| Banco de Dados | PostgreSQL com extensão pgvector para armazenamento e busca eficiente de vetores, fundamental para IA. |
Os serviços do Inithub se comunicam principalmente por meio de APIs REST e WebSockets, garantindo uma arquitetura desacoplada, modular e com suporte a funcionalidades em tempo real.
As APIs REST são usadas para operações padrão, como gerenciamento de dados, enquanto os WebSockets possibilitam interações em tempo real e experiências interativas, como chats e recomendações inteligentes.
- Frontend: React, Vite, TypeScript, TailwindCSS
- Backend: NestJS, Prisma, PostgreSQL
- Agente IA: FastAPI, OpenAI
- Banco de Dados: PostgreSQL + pgvector
- Infraestrutura: Docker, Docker Compose
# Configuração Inicial:
Copie os arquivos `.env.example` para `.env` (remova a extensão `.example`).
# Requisitos:
Verifique se o Docker e o Docker Compose estão instalados e funcionando corretamente em sua máquina.
# Diretório de Trabalho:
Navegue até o diretório raiz do projeto (`/inithub`).
# Construção e Execução:
Execute o comando abaixo para construir as imagens e iniciar todos os containers:
docker compose up --buildCada serviço possui documentação específica com informações detalhadas: