Intexa ArCa

Financial management platform for cash flow control, transaction tracking, projections, and reporting — built for Latin American businesses with SIIGO accounting integration.

---

Features

• Dashboard — real-time KPIs: current balance, monthly income/expenses, net flow, cash flow chart, full expense distribution by category (all categories, palette colors for top 5 then extended colors), and liquidity alerts.
• Movements — paginated transaction list with search, type/status filters, CSV export, and color-coded category badges.
• Cash Flow — day/week/month navigator showing ingresos and egresos per period, projected 30-day balance, and liquidity alerts.
• Projections — forward-looking financial scenarios and simulations.
• Reports — exportable financial summaries.
• Settings — user management, base currency preference (COP, USD, EUR, CLP, MXN), automatic exchange rate toggle, and activity audit log.
• SIIGO integration — connect and sync transactions directly from SIIGO accounting software.
• Auth — email/password login and Microsoft OAuth (Azure AD).

Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Vite 8
Styling	Tailwind CSS 4, Lucide icons
Charts	Recharts
Animation	Motion (Framer Motion)
Backend	Go, Chi router
Storage	In-memory (dev) / PostgreSQL (prod)

Project Structure

intexa-arca/        # Frontend (this repo)
intexa-arca-api/    # Go REST API

Getting Started

Frontend

Prerequisites: Node.js 18+

npm install
npm run dev          # http://localhost:3000

Copy .env.example to .env.local and set VITE_API_BASE_URL if your API runs on a different port (default proxies to http://localhost:8080).

API

Prerequisites: Go 1.21+

cd ../intexa-arca-api
go run ./cmd/server

Without DATABASE_URL set, the server starts in dev mode with an in-memory store pre-seeded with 12 months of realistic transaction data.

Default credentials: [email protected] / admin

Production

Set the following environment variables on the API:

Variable	Description
DATABASE_URL	PostgreSQL connection string
PORT	Server port (default 8080)
ALLOWED_ORIGINS	Comma-separated allowed CORS origins
JWT_SECRET	Secret for signing tokens

Set on the frontend:

Variable	Description
VITE_API_BASE_URL	API base URL (or configure public/config.js at runtime)

npm run build        # outputs to dist/

API Reference

Full collection: intexa-arca-api/intexa-arca-api.postman_collection.json

Base path: /api/v1

Method	Path	Description
POST	/auth/login	Email/password login
GET	/auth/microsoft	Microsoft OAuth redirect
GET	/dashboard	Dashboard summary
GET	/transactions	List transactions (paginated)
POST	/transactions	Create transaction
GET	/cashflow	Cash flow summary
GET	/projections	Projections summary
POST	/projections/simulate	Run simulation
GET	/reports	Reports summary
GET	/reports/export	Export report
GET	/categories	List categories
POST	/siigo/connect	Connect SIIGO account
POST	/siigo/sync	Sync transactions from SIIGO