ComFi/GEMINI.md

Project: ComFi Management System

Overview

ComFi is a React-based financial and management dashboard.

• Frontend: React 19, Vite, TypeScript.
• Serving (Production): Node.js (Express) via server.js.
• State Management: Context API (ComFiContext, ToastContext).
• Styling: CSS / Lucide React icons.

Architecture

Current (Local)

• Dev Server: vite (HMR, local dev).
• Prod Preview: node server.js serving dist/.

Target (Production)

• Containerization: Docker (Multi-stage build).
• Orchestration: Docker Swarm (managed via Portainer).
• CI/CD: Gitea Actions.
• Reverse Proxy: Traefik or Nginx (implied by Swarm/Portainer setup, usually handles SSL termination).

Deployment Roadmap

1. Dockerization

• Create Dockerfile:
  • Stage 1 (Builder): Install deps, run npm run build to generate dist/.
  • Stage 2 (Runner): Alpine Node image, copy dist/, server.js, and package.json. Run npm install --production.
• Create docker-compose.yml for local testing of the production build.

2. CI/CD (Gitea Actions)

• Define workflow .gitea/workflows/deploy.yaml.
• Steps:
  • Checkout code.
  • Login to Container Registry.
  • Build and Push Docker Image (tagged with commit SHA and latest).
  • Trigger Deployment (Portainer Webhook).

3. Portainer & Swarm Configuration

• Stack Definition: A docker-compose style file for Swarm.
• Secrets Management:
  • Registry Credentials (if private).
  • Environment variables (if any, e.g., API endpoints).
• Update Mechanism: Webhook URL provided by Portainer Service.

Required Configuration & Secrets

To proceed, we will need to define:

1. Registry URL: gitea.blyzer.com.br
2. Image Name: gitea.blyzer.com.br/blyzer/comfi
3. Portainer Webhook: The URL Portainer provides to trigger a service update.

Secrets (Gitea)

Set these in your Gitea repository settings (Settings > Actions > Secrets):

• REGISTRY_USERNAME: Your Gitea username.
• REGISTRY_TOKEN: Your Gitea password or token.
• PORTAINER_WEBHOOK: The full webhook URL from Portainer.
• API_KEY: (Optional) Google GenAI API key.

Directives

• Conventions: Follow existing TypeScript and React patterns.
• Safety: Do not commit .env files.
• Style: Maintain the clean, dashboard-style UI.