feat: Sentinela v0.2.0 — Brazilian Financial Data API in Go

- 20 Go source files, single 16MB binary - SQLite + FTS5 full-text search (pure Go, no CGO) - BCB integration: Selic, CDI, IPCA, USD/BRL, EUR/BRL - CVM integration: 2,524 companies from registry - Fiber v2 REST API with 42 handlers - Auto-seeds on first run (~5s for BCB + CVM) - Token bucket rate limiter, optional API key auth - Periodic sync scheduler (configurable) - Graceful shutdown, structured logging (slog) - All endpoints tested with real data
2026-02-10 11:15:54 -03:00
commit f7c8b446bf
28 changed files with 1763 additions and 0 deletions
--- a/internal/api/handlers/companies.go
+++ b/internal/api/handlers/companies.go
@@ -0,0 +1,63 @@
+package handlers
+
+import (
+	"strconv"
+
+	"github.com/gofiber/fiber/v2"
+)
+
+func (h *Handler) ListCompanies(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	offset, _ := strconv.Atoi(c.Query("offset", "0"))
+	status := c.Query("status")
+	sector := c.Query("sector")
+
+	companies, total, err := h.db.ListCompanies(limit, offset, status, sector)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": companies, "total": total, "limit": limit, "offset": offset})
+}
+
+func (h *Handler) GetCompany(c *fiber.Ctx) error {
+	id, err := strconv.ParseInt(c.Params("id"), 10, 64)
+	if err != nil {
+		return c.Status(400).JSON(fiber.Map{"error": "invalid id"})
+	}
+	company, err := h.db.GetCompany(id)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	if company == nil {
+		return c.Status(404).JSON(fiber.Map{"error": "not found"})
+	}
+	return c.JSON(fiber.Map{"data": company})
+}
+
+func (h *Handler) CompanyFilings(c *fiber.Ctx) error {
+	id, err := strconv.ParseInt(c.Params("id"), 10, 64)
+	if err != nil {
+		return c.Status(400).JSON(fiber.Map{"error": "invalid id"})
+	}
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	offset, _ := strconv.Atoi(c.Query("offset", "0"))
+
+	filings, total, err := h.db.ListFilingsByCompany(id, limit, offset)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": filings, "total": total, "limit": limit, "offset": offset})
+}
+
+func (h *Handler) SearchCompanies(c *fiber.Ctx) error {
+	q := c.Query("q")
+	if q == "" {
+		return c.Status(400).JSON(fiber.Map{"error": "query parameter 'q' required"})
+	}
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	companies, err := h.db.SearchCompanies(q, limit)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": companies, "total": len(companies)})
+}
--- a/internal/api/handlers/filings.go
+++ b/internal/api/handlers/filings.go
@@ -0,0 +1,58 @@
+package handlers
+
+import (
+	"strconv"
+
+	"github.com/gofiber/fiber/v2"
+)
+
+func (h *Handler) ListFilings(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	offset, _ := strconv.Atoi(c.Query("offset", "0"))
+	category := c.Query("category")
+	from := c.Query("from")
+	to := c.Query("to")
+
+	filings, total, err := h.db.ListFilings(limit, offset, category, from, to)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": filings, "total": total, "limit": limit, "offset": offset})
+}
+
+func (h *Handler) GetFiling(c *fiber.Ctx) error {
+	id, err := strconv.ParseInt(c.Params("id"), 10, 64)
+	if err != nil {
+		return c.Status(400).JSON(fiber.Map{"error": "invalid id"})
+	}
+	filing, err := h.db.GetFiling(id)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	if filing == nil {
+		return c.Status(404).JSON(fiber.Map{"error": "not found"})
+	}
+	return c.JSON(fiber.Map{"data": filing})
+}
+
+func (h *Handler) RecentFilings(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	filings, err := h.db.RecentFilings(limit)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": filings, "total": len(filings)})
+}
+
+func (h *Handler) SearchFilings(c *fiber.Ctx) error {
+	q := c.Query("q")
+	if q == "" {
+		return c.Status(400).JSON(fiber.Map{"error": "query parameter 'q' required"})
+	}
+	limit, _ := strconv.Atoi(c.Query("limit", "20"))
+	filings, err := h.db.SearchFilings(q, limit)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": filings, "total": len(filings)})
+}
--- a/internal/api/handlers/health.go
+++ b/internal/api/handlers/health.go
@@ -0,0 +1,21 @@
+package handlers
+
+import (
+	"github.com/gofiber/fiber/v2"
+	"github.com/sentinela-go/internal/db"
+)
+
+type Handler struct {
+	db *db.DB
+}
+
+func New(database *db.DB) *Handler {
+	return &Handler{db: database}
+}
+
+func (h *Handler) Health(c *fiber.Ctx) error {
+	return c.JSON(fiber.Map{
+		"status":  "ok",
+		"service": "sentinela",
+	})
+}
--- a/internal/api/handlers/market.go
+++ b/internal/api/handlers/market.go
@@ -0,0 +1,107 @@
+package handlers
+
+import (
+	"strconv"
+
+	"github.com/gofiber/fiber/v2"
+)
+
+func (h *Handler) ListSelic(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "30"))
+	from := c.Query("from")
+	to := c.Query("to")
+	data, err := h.db.ListSelic(limit, from, to)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": data, "total": len(data)})
+}
+
+func (h *Handler) CurrentSelic(c *fiber.Ctx) error {
+	r, err := h.db.CurrentSelic()
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	if r == nil {
+		return c.Status(404).JSON(fiber.Map{"error": "no data"})
+	}
+	return c.JSON(fiber.Map{"data": r})
+}
+
+func (h *Handler) ListCDI(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "30"))
+	from := c.Query("from")
+	to := c.Query("to")
+	data, err := h.db.ListCDI(limit, from, to)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": data, "total": len(data)})
+}
+
+func (h *Handler) CurrentCDI(c *fiber.Ctx) error {
+	r, err := h.db.CurrentCDI()
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	if r == nil {
+		return c.Status(404).JSON(fiber.Map{"error": "no data"})
+	}
+	return c.JSON(fiber.Map{"data": r})
+}
+
+func (h *Handler) ListIPCA(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "30"))
+	from := c.Query("from")
+	to := c.Query("to")
+	data, err := h.db.ListIPCA(limit, from, to)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": data, "total": len(data)})
+}
+
+func (h *Handler) CurrentIPCA(c *fiber.Ctx) error {
+	r, err := h.db.CurrentIPCA()
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	if r == nil {
+		return c.Status(404).JSON(fiber.Map{"error": "no data"})
+	}
+	return c.JSON(fiber.Map{"data": r})
+}
+
+func (h *Handler) ListFX(c *fiber.Ctx) error {
+	limit, _ := strconv.Atoi(c.Query("limit", "30"))
+	pair := c.Query("pair")
+	from := c.Query("from")
+	to := c.Query("to")
+	data, err := h.db.ListFX(limit, pair, from, to)
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": data, "total": len(data)})
+}
+
+func (h *Handler) CurrentFX(c *fiber.Ctx) error {
+	data, err := h.db.CurrentFX()
+	if err != nil {
+		return c.Status(500).JSON(fiber.Map{"error": err.Error()})
+	}
+	return c.JSON(fiber.Map{"data": data})
+}
+
+func (h *Handler) MarketOverview(c *fiber.Ctx) error {
+	selic, _ := h.db.CurrentSelic()
+	cdi, _ := h.db.CurrentCDI()
+	ipca, _ := h.db.CurrentIPCA()
+	fx, _ := h.db.CurrentFX()
+
+	return c.JSON(fiber.Map{
+		"selic": selic,
+		"cdi":   cdi,
+		"ipca":  ipca,
+		"fx":    fx,
+	})
+}
--- a/internal/api/handlers/search.go
+++ b/internal/api/handlers/search.go
@@ -0,0 +1,23 @@
+package handlers
+
+import (
+	"strconv"
+
+	"github.com/gofiber/fiber/v2"
+)
+
+func (h *Handler) GlobalSearch(c *fiber.Ctx) error {
+	q := c.Query("q")
+	if q == "" {
+		return c.Status(400).JSON(fiber.Map{"error": "query parameter 'q' required"})
+	}
+	limit, _ := strconv.Atoi(c.Query("limit", "10"))
+
+	companies, _ := h.db.SearchCompanies(q, limit)
+	filings, _ := h.db.SearchFilings(q, limit)
+
+	return c.JSON(fiber.Map{
+		"companies": fiber.Map{"data": companies, "total": len(companies)},
+		"filings":   fiber.Map{"data": filings, "total": len(filings)},
+	})
+}