Mira

Mobile-first editorial calendar application for an advertising agency and its clients.

The application UI must be localized in Brazilian Portuguese (pt-BR), while developer documentation can stay in English.

Stack

• Frontend: React 19, JavaScript, shadcn/ui direction, CSS variables for light/dark themes.
• Backend: Go 1.25, Gin.
• Database: PostgreSQL.
• Calendar provider: BrasilAPI for Brazilian national holidays.
• Deployment: Docker Compose/Portainer.
• Repository and CI/CD: Gitea.

Local Start

1. Copy .env.example to .env.
2. Replace secrets and passwords.
3. Start the stack:

docker compose up --build

Default local URLs:

• Frontend: http://localhost:5173
• Backend health: http://localhost:8080/healthz
• Backend API: http://localhost:8080/api/v1

Current Status

This is the initial scaffold. The structure is ready for MVP implementation, but authentication, persistence, invitations, and calendar item CRUD are still placeholders.

Key Decisions

• Use PostgreSQL, not NoSQL.
• Use BrasilAPI as the initial holiday provider.
• Add regional holidays and agency/client-specific commemorative dates manually through the app.
• Keep a backend calendar provider abstraction for future provider changes.
• Keep uploaded files protected.
• Include audit logs from the beginning of the real MVP implementation.
• Use orange as the main color and support light/dark themes.