- Renomear métodos e propriedades para português (Linguagem Ubíqua) - Aplicar Intent-Revealing Names na entidade Colaborador - Corrigir mapToSafeProfile para suportar nomes da entidade DDD - Remover comentários redundantes (nomes auto-explicativos) Arquivos modificados: - Colaborador.ts: fromDto → criarAPartirDoDto, ehRCA → ehRepresentanteComercial - profile.service.ts: getMe → obterColaboradorAtual - ProfilePage.tsx: atualizar referências aos novos nomes - mappers.ts: suportar ambos formatos (entidade e DTO) |
||
|---|---|---|
| .scannerwork | ||
| .storybook | ||
| .vscode | ||
| app | ||
| public | ||
| src | ||
| .gitignore | ||
| .prettierrc | ||
| README.md | ||
| eslint.config.mjs | ||
| jest.config.js | ||
| jest.setup.js | ||
| mui-license.ts | ||
| next.config.ts | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.mjs | ||
| sonnar.bat | ||
| tsconfig.json | ||
README.md
Portal Web V2
This repository contains the source code for the Portal Web V2 application, a modern enterprise web interface built with Next.js 16 and React 19.
Overview
The application is designed to provide a robust and scalable frontend interface for the Portal system. It leverages a modern technology stack to ensure performance, maintainability, and type safety.
Technology Stack
- Framework: Next.js 16 (App Router)
- UI Library: React 19 with Material UI (MUI) v7
- State Management: Zustand and TanStack Query (React Query)
- Styling: Tailwind CSS v4 and Emotion
- Form Management: React Hook Form with Zod validation
- Testing: Jest
Prerequisites
- Node.js (Latest LTS version recommended)
- npm or yarn package manager
Installation
-
Clone the repository:
git clone <repository-url> -
Navigate to the project directory:
cd portal-web-v2 -
Install dependencies:
npm install
Key Scripts
The following scripts are available in package.json for development and operations:
| Script | Description |
|---|---|
npm run dev |
Starts the development server with hot-reloading. |
npm run build |
Compiles the application for production deployment. |
npm start |
Runs the compiled production build locally. |
npm run lint |
Runs ESLint to analyze code quality and fix issues. |
npm test |
Executes the test suite using Jest. |
npm run test:coverage |
Runs tests and generates a code coverage report. |
Project Structure
The project follows the standard Next.js App Router structure:
src/: Contains the source code.app/: Next.js App Router pages and layouts.components/: Shared UI components.features/: Feature-specific modules (Deep Domain Design).hooks/: Custom React hooks.utils/: Utility functions and helpers.styles/: Global styles and theme configurations.
Development Standards
- Strict Typing: TypeScript is enforced throughout the codebase.
- Code Quality: ESLint and Prettier configurations are in place to maintain code consistency.
- Component Architecture: Components should be atomic and reusable where possible.
License
Private and Confidential. All rights reserved.