← Voltar à visão geral

GUIA DO SISTEMA | ESTABILIDADE E VALIDAÇÃO

Conheça a base
do seu sistema.

O sistema reúne cadastros, previsões, baixas, créditos, transferências, investimentos, relatórios, conciliação e fechamento. Operações preservam histórico e respeitam permissões. O trabalho atual reforça estabilidade e segurança. A homologação em VM limpa foi adiada por falta de recursos do equipamento; validações operacionais continuam pendentes.

Onde cada parte fica

src/app/page.tsx
Define o conteúdo da página inicial. Uma função descreve o que aparece na tela.
src/app/layout.tsx
Compartilha cabeçalho, navegação e rodapé entre as páginas.
src/app/globals.css
Define cores, tamanhos e adaptação para telas menores.
package.json
Lista dependências e comandos do projeto. O arquivo de lock fixa a instalação.
compose.curso.yaml
Descreve o PostgreSQL exclusivo do curso. Não é executado pelos comandos da aplicação.
src/db/client.ts
Prepara transações com a conta restrita da aplicação, verificando o destino exclusivo do curso.
src/server/access/
Contém as regras testadas de permissões, vigências, senhas e auditoria.
src/server/finance/
Valida cadastros, previsões, baixas, créditos, transferências, investimentos, relatórios, conciliação e fechamento.
src/app/financeiro/
Reúne as telas operacionais, consultas e exportações financeiras.
src/db/transaction.ts
Mantém transações, snapshots dos relatórios e liberação de bloqueios.
docs/
Guarda requisitos, regras, arquitetura e plano de desenvolvimento.

Comandos da aplicação

Execute no PowerShell, dentro de C:\Projetos\Curso-Codex. Use npm.cmd para evitar depender da política de execução de scripts do PowerShell.

Verificar o código

npm.cmd run check

Confere formatação, testes sem banco e tipos. Não inicia Docker ou PostgreSQL.

Compilar

npm.cmd run build

Verifica se o projeto pode ser preparado para execução.

Executar localmente

npm.cmd run dev

Abre o servidor em 127.0.0.1:3210. Encerre com Ctrl+C. Verifique antes se a porta está livre.

ADMINISTRAÇÃO DE ACESSO

Uma pessoa, vários perfis.

Usuário identifica a pessoa; perfil reúne permissões; atribuição define o período em que essas permissões podem ser usadas. O administrador cadastra responsáveis com perfil completo automático e define os períodos de responsabilidade de cada área. Uma pessoa pode responder por várias áreas. Em Minha equipe, o responsável cria os perfis, cadastra seus colaboradores e gera convites. Usuários e perfis são editados ou inativados, preservando os vínculos e a auditoria.

Abrir administração →