How rosanarezende/balanceamento-de-investimentos works
Project Type and Purpose
• EquilibreInvest is a full-stack, single-page web application built with Next.js (App Router) and React.
• It assists users in balancing stock portfolios, offering CRUD on assets, balance simulations, history tracking, dashboards, and watchlists.
• It integrates Firebase for authentication and data storage, external market-data APIs, and AI services for recommendations.
File Structure
• Top-level config & tooling: ESLint, Prettier, Jest, Tailwind, GitHub Actions, Vercel config.
• src/app – Next.js routing structure: pages (login, dashboard, calculadora-balanceamento, historico, carteira, editar-ativos), and API routes under src/app/api (stock-price, ai-recommendation).
• src/components – UI primitives (components/ui), domain components (dashboard, carteira, watchlist, calculators, modals).
• src/core – application schemas (Zod), global state (AuthContext, PortfolioContext, ThemeContext), common types and utilities.
• src/services – external integrations: Firebase config & Firestore, market-data API clients, AI text-generation.
• src/hooks, src/utils, src/styles – cross-cutting concerns and styling.
• tests – unit and integration tests for key features (auth, calculator, performance).
README Insights
• Frontend layer (App Shell, ThemeProvider, UI Library, Pages)
• Contexts for state management
• Next.js API routes as backend
• Firebase as the data layer
• External services (Alpha Vantage/Yahoo, AI text)
• CI/CD via GitHub Actions & Vercel