kso-base
Template Next.js (App Router) para sistemas administrativos internos: autenticação, controle de usuários/papéis/permissões e um conjunto de módulos de cadastro genéricos — organização (lojas, colaboradores, fornecedores...) e inventário/financeiro (itens, depósitos, tabelas de preço...) — prontos para ligar/desligar por cliente.
Não contém nenhuma regra de negócio de um domínio específico (hotelaria, varejo, saúde). Isso nasce no projeto derivado, seguindo o mesmo padrão de módulo descrito aqui.
Este site está rodando em modo demo
Sem backend real: os dados vêm de um "banco" fake gerado com Faker e a autenticação está desligada. Veja Dados fake (Faker) para entender o mecanismo e como trocar por uma API real no seu projeto.
Stack
- Next.js 15 (App Router) + React 19 + TypeScript
- Tailwind CSS v4 + componentes estilo shadcn/base-ui (
@base-ui/react) - TanStack Query + TanStack Table
- react-hook-form + zod
- Axios para HTTP, sessão via cookies (JWT) + middleware
Módulos incluídos
Núcleo administrativo — Usuários, Papéis, Permissões, Módulos (grupos de permissão), Sistemas.
Organização — Lojas, Grupo de Lojas, Setores, Gerências, Cargos, Colaboradores, Pessoas, Fornecedores.
Inventário/financeiro — Unidade de Medida, Grupos de Itens, Sub Grupos de Itens, Itens, Depósitos, Tabelas de Preço, Centro de Custos, Formas de Pagamento, Motivos de Trocas.
Cada módulo tem uma única entrada em src/modules/registry.ts — é ali que se
liga/desliga um módulo, não no código da feature. Veja Módulos.
Por onde começar
- Instalação — rodar localmente.
- Visão geral de arquitetura — como o projeto se organiza.
- Registry (@kso) — reaproveitar módulos entre projetos.