An open API service indexing awesome lists of open source software.

https://github.com/fernandozuchi/docs-challenge-vii

Este repositório contém toda a documentação do Challenge Codi Cash, o projeto de gestão financeira das unidades da Codi Academy. Este projeto será feito pelos alunos, em grupo, divididos por turmas
https://github.com/fernandozuchi/docs-challenge-vii

Last synced: 6 months ago
JSON representation

Este repositório contém toda a documentação do Challenge Codi Cash, o projeto de gestão financeira das unidades da Codi Academy. Este projeto será feito pelos alunos, em grupo, divididos por turmas

Awesome Lists containing this project

README

          

# **Challenge - Projeto Codi Cash**

**Período do Challenge:** 29/04/2025 a 11/07/2025
**Projeto:** Sistema "Codi Cash"
**Objetivo:** Criar a interface (Front-end) completa e funcional de um software de gestão financeira voltado para as unidades da Codi Academy, considerando responsividade, usabilidade e integração futura com APIs.

---

## 1. Descrição Geral do Projeto

O **Codi Cash** é um software de gestão financeira que visa facilitar o controle das finanças de cada unidade da Codi Academy. O sistema permitirá o cadastro, visualização e gestão de vendas, despesas e indicadores financeiros através de uma interface web moderna, responsiva e intuitiva.

---

## 2. Escopo do Desafio

Vocês serão responsáveis por desenvolver **apenas o frontend** da aplicação, utilizando tecnologias modernas como **HTML, CSS (Tailwind ou Bootstrap), JavaScript (React ou Vanilla)**, garantindo:

- Interfaces responsivas
- Boa usabilidade
- Componentização e reutilização de código
- Estrutura limpa e organizada

---

## 3. Funcionalidades Requeridas (Frontend)

### 3.1. Dashboard Principal
- Exibir resumos mensais de receitas, despesas e balanço
- Gráficos de barras/linhas para mostrar dados por período (semana, mês, ano)
- Cards com KPIs (Key performance indicators): *total de vendas*, *total de despesas*, *saldo líquido*

### 3.2. Módulo de Vendas
- Formulário de cadastro de venda:
- Tipo de curso: online ou presencial
- Cliente (nome, e-mail, telefone)
- Valor bruto
- Descontos aplicados
- Impostos, comissões e taxas de cartão
- Valor final da venda (após débitos automáticos)
- Lista de vendas cadastradas com filtros por período e tipo de curso

### 3.3. Módulo de Gastos
- Cadastro de despesas fixas (luz, água, aluguel, internet, folha de pagamento, vale transporte, imposto sobre folha)
- Cadastro de despesas variáveis (manutenção, suprimentos, etc.)
- Edição e exclusão de lançamentos
- Visualização de histórico de gastos

### 3.4. Visualizações e Gráficos
- Gráfico comparativo de receitas e despesas
- Gráfico de pizza para distribuição de gastos
- Filtros de visualização por intervalo de tempo e categoria

### 3.5. Experiência do Usuário
- Layout limpo, responsivo, com navegação intuitiva
- Feedback visual para ações (ex: cadastro realizado, erro de preenchimento)
- Utilização de modal para confirmações e formulários

---

## 4. Requisitos Técnicos

- HTML5, CSS3 e JavaScript
- TailwindCSS (ou outro framework de UI)
- ReactJS (opcional, mas recomendado)
- Responsividade obrigatória (mobile first)
- Estrutura modular de componentes

---

## 5. Critérios de Avaliação

- Interface responsiva e funcional
- Boa organização do código
- Reutilização de componentes
- Alinhamento com a proposta do desafio
- Apresentação final do projeto (pitch ou demonstração em vídeo)

---

## 6. Entregáveis

- Código-fonte neste repositório GitHub onde está a documentação
- Link do deploy (Vercel, Netlify ou outro)
- Documentação de como rodar localmente
- Documentação do frontend
- Apresentação final

---