feat: add general registration module input use locations

.agents/skills/idr-web-module-generator/idr-web-module-generator/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: idr-web-module-generator
+description: Guide for creating a new module from scratch following IDR Web Clean Architecture standards. Use this skill when asked to create a new module, entity, feature, or CRUD operations in the IDR Web project.
+---
+
+# IDR Web Module Generator
+
+This skill contains the procedural knowledge required to build a new module from scratch in the IDR Web project. It ensures that the generated code strictly follows the project's Clean Architecture conventions and specific module structures.
+
+## Core Mandates
+
+The IDR Web project strictly follows a layered Clean Architecture structure. Every module typically consists of these layers:
+- `domain`: Models, Types, and Use Cases interfaces.
+- `data`: Implementations of domain use cases (e.g., `RemoteGet...`).
+- `main`: Factories that instantiate the use cases to be consumed by the UI.
+- `presentation`: UI components (Screens, Components, Forms, Contexts, Hooks, Types, Validations).
+- `mocks`: Mock Service Worker handlers for local development.
+
+## Step-by-Step Workflow
+
+When asked to create a new module (e.g., "machines"), follow these steps precisely:
+
+### 1. Domain Layer (`src/app/modules/{module-name}/domain`)
+- Create `models/{module-name}-model.ts` with `WithId` type.
+- Create `use-cases/{module-name}-use-cases/` directory.
+- Define `RequestInterface` for all CRUD operations:
+  - `create-{entity}-use-case.ts`
+  - `update-{entity}-use-case.ts`
+  - `delete-{entity}-use-case.ts`
+  - `get-{entity}-use-case.ts` (Get One)
+  - `get-{entities}-use-case.ts` (Get All/Paginated list)
+- Export everything via `index.ts`.
+
+### 2. Data Layer (`src/app/modules/{module-name}/data`)
+- Create `use-cases/{module-name}-use-cases/` directory.
+- Implement the domain interfaces using `HttpClient` from `@/core/data/protocols/http`:
+  - `remote-create-{entity}-use-case.ts`
+  - `remote-update-{entity}-use-case.ts`
+  - `remote-delete-{entity}-use-case.ts`
+  - `remote-get-{entity}-use-case.ts`
+  - `remote-get-{entities}-use-case.ts`
+- Throw custom errors on failure (e.g., `BadRequestError`, `ForbiddenError`, `UnexpectedError`).
+- Export everything via `index.ts`.
+
+### 3. Main Layer (`src/app/modules/{module-name}/main`)
+- Create `factories/use-cases/{module-name}-use-cases/` directory.
+- Create factory functions utilizing `makeApiHttpClient()` to instantiate the Data layer classes:
+  - `remote-create-{entity}-use-case-factory.ts`
+  - `remote-update-{entity}-use-case-factory.ts`
+  - `remote-delete-{entity}-use-case-factory.ts`
+  - `remote-get-{entity}-use-case-factory.ts`
+  - `remote-get-{entities}-use-case-factory.ts`
+- Export everything via `index.ts`.
+
+### 4. Mocks Layer (`src/app/modules/{module-name}/mocks`)
+- Create `handlers/{module-name}-handlers/` directory.
+- Implement MSW handlers for all operations:
+  - `create-{entity}-handler.ts`
+  - `update-{entity}-handler.ts`
+  - `delete-{entity}-handler.ts`
+  - `get-{entity}-handler.ts`
+  - `get-{entities}-handler.ts` (Implement pagination and sorting logic from `mock/utils`)
+- Export handlers via `index.ts`.
+- Important: Register the new handlers inside `src/core/mocks/browser.ts`.
+
+### 5. Presentation Layer (`src/app/modules/{module-name}/presentation`)
+This layer requires a highly specific file organization:
+
+#### Validations and Types
+- Create `validations/{entity}-form-schema.ts` with `zod`.
+- Create `types/{entity}-types.ts` defining `Filters` and `Sort` types.
+
+#### Queries Hooks
+- Create `hooks/queries/{entities}-query.hook.ts` using `@tanstack/react-query` to fetch lists. Handle `toast.error` for errors.
+- Create `hooks/queries/{entity}-query.hook.ts` for fetching single items.
+- Always use the factories from the `main` layer.
+
+#### Context API
+- Create `contexts/{entity}-context.tsx` controlling:
+  - Form open/close states (New and Edit).
+  - Delete dialog open/close states.
+  - Selected item state.
+  - Filter and sort states.
+- Create `hooks/{entity}-context.hook.ts` to consume the context securely.
+
+#### UI Components
+- **Data Table**: `components/{entity}-data-table/`
+  - Implement a hook (`.hook.tsx`) mapping columns and returning `react-table` configuration.
+  - Include an action column with a `DropdownMenu` for "Editar" and "Excluir".
+  - Implement the table (`.tsx`) using the generic `<DataTable />` component from `@/core/presentation/components/ui`.
+- **Delete Dialog**: `components/{entity}-delete-dialog/`
+  - Implement `.tsx` with `<AlertDialog />` and a `useMutation` calling the delete factory.
+  - Invalidates react-query cache on success.
+- **Forms**: `forms/{entity}-form/`
+  - Needs 5 files:
+    - `create-{entity}-form.tsx` (using `<Sheet />`)
+    - `edit-{entity}-form.tsx` (fetches the item via Get One hook, displays `<Loading />` while fetching)
+    - `{entity}-form-inputs.tsx` (UI inputs mapped to `react-hook-form` via `useFormContext`)
+    - `{entity}-initial-form-data.ts` (Empty initial data object)
+    - `{entity}-form.tsx` (Wrapper rendering Create or Edit based on `id` prop presence).
+
+#### Screens
+- Create `screens/{entities}-screen.tsx` which glues everything together:
+  - Wraps content in `{Entity}Provider` and `{Entity}Context.Consumer`.
+  - Header with a "Add" button and a search `<Input />`.
+  - Renders `<{Entity}DataTable />`.
+  - Conditionally renders `<{Entity}DeleteDialog />` and `<{Entity}Form />`.
+
+## Example and Reference Check
+**CRITICAL MANDATE:** To guarantee that the generated code has the exact same conditionals, React hooks usage, types, and architectural structure as the rest of the project, you **MUST ALWAYS** read the files in the `src/app/modules/input-uses` or `src/app/modules/cultivations` modules before writing any code.
+
+**DO NOT** rely on your general knowledge to generate the file contents. You must treat the existing modules as strict templates. For every single file you create (e.g., the Delete Dialog, the Create Form, the Data Table, the Use Cases), you must read its equivalent in the reference module, copy its exact implementation logic, and adapt only the entity names, variables, and specific domain fields. This is the only way to ensure 100% fidelity to the project's internal patterns.
+
+**Once the files are created:** Always run formatting (`pnpm format:fix`) and linting (`pnpm lint:fix`) for the newly created module folder, and run `pnpm type:check` to ensure no errors were introduced.

scripts/seed/data/index.mjs

@@ -24,3 +24,4 @@ export * from './cultivation-diseases.mjs'
 export * from './general-cultivation-pests.mjs'
 export * from './cultivation-pests.mjs'
 export * from './nutritional-balancings.mjs'
+export * from './input-use-locations.mjs'

scripts/seed/data/input-use-locations.mjs

@@ -0,0 +1,14 @@
+import { faker } from '@faker-js/faker/locale/pt_BR'
+
+export const inputUseLocationsData = Array.from(
+  {
+    length: faker.number.int({
+      min: 50,
+      max: 150,
+    }),
+  },
+  (_, index) => ({
+    id: index + 1,
+    description: `${faker.location.street()}, ${faker.number.int({ min: 1, max: 100 })}`,
+  })
+)

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/index.ts

@@ -0,0 +1,5 @@
+export * from './remote-create-input-use-location-use-case'
+export * from './remote-update-input-use-location-use-case'
+export * from './remote-delete-input-use-location-use-case'
+export * from './remote-get-input-use-location-use-case'
+export * from './remote-get-input-use-locations-use-case'

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/remote-create-input-use-location-use-case.ts

@@ -0,0 +1,39 @@
+import { type HttpClient, HttpStatusCode } from '@/core/data/protocols/http'
+import {
+  BadRequestError,
+  ForbiddenError,
+  UnexpectedError,
+} from '@/core/domain/errors'
+
+import type { CreateInputUseLocationUseCase } from '../../../domain/use-cases/input-use-locations-use-cases'
+
+export class RemoteCreateInputUseLocationUseCase
+  implements CreateInputUseLocationUseCase
+{
+  constructor(
+    private readonly url: string,
+    private readonly httpClient: HttpClient
+  ) {}
+
+  execute: CreateInputUseLocationUseCase['execute'] = async ({
+    inputUseLocation,
+  }) => {
+    const { statusCode } = await this.httpClient.request({
+      url: this.url,
+      method: 'post',
+      body: inputUseLocation,
+    })
+
+    if (statusCode === HttpStatusCode.created) return
+
+    if (statusCode === HttpStatusCode.badRequest) throw new BadRequestError()
+
+    if (statusCode === HttpStatusCode.forbidden) {
+      throw new ForbiddenError(
+        'Você não tem permissão para criar um local de utilização.'
+      )
+    }
+
+    throw new UnexpectedError()
+  }
+}

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/remote-delete-input-use-location-use-case.ts

@@ -0,0 +1,38 @@
+import { type HttpClient, HttpStatusCode } from '@/core/data/protocols/http'
+import {
+  UnexpectedError,
+  NotFoundError,
+  ForbiddenError,
+} from '@/core/domain/errors'
+
+import type { DeleteInputUseLocationUseCase } from '../../../domain/use-cases/input-use-locations-use-cases'
+
+export class RemoteDeleteInputUseLocationUseCase
+  implements DeleteInputUseLocationUseCase
+{
+  constructor(
+    private readonly url: string,
+    private readonly httpClient: HttpClient
+  ) {}
+
+  execute: DeleteInputUseLocationUseCase['execute'] = async ({ id }) => {
+    const { statusCode } = await this.httpClient.request({
+      url: `${this.url}/${id}`,
+      method: 'delete',
+    })
+
+    if (statusCode === HttpStatusCode.noContent) return
+
+    if (statusCode === HttpStatusCode.notFound) {
+      throw new NotFoundError('Local de Utilização')
+    }
+
+    if (statusCode === HttpStatusCode.forbidden) {
+      throw new ForbiddenError(
+        'Você não tem permissão para excluir um local de utilização.'
+      )
+    }
+
+    throw new UnexpectedError()
+  }
+}

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/remote-get-input-use-location-use-case.ts

@@ -0,0 +1,50 @@
+import { type HttpClient, HttpStatusCode } from '@/core/data/protocols/http'
+import {
+  BadRequestError,
+  ForbiddenError,
+  NotFoundError,
+  UnexpectedError,
+} from '@/core/domain/errors'
+
+import type {
+  InputUseLocationDetailsApiResponse,
+  InputUseLocationDetailsModel,
+} from '../../../domain/models/input-use-locations-model'
+import type { GetInputUseLocationUseCase } from '../../../domain/use-cases/input-use-locations-use-cases'
+
+export class RemoteGetInputUseLocationUseCase
+  implements GetInputUseLocationUseCase
+{
+  constructor(
+    private readonly url: string,
+    private readonly httpClient: HttpClient<
+      InputUseLocationDetailsModel,
+      InputUseLocationDetailsApiResponse
+    >
+  ) {}
+
+  execute: GetInputUseLocationUseCase['execute'] = async ({ id }) => {
+    const { statusCode, body } = await this.httpClient.request({
+      url: `${this.url}/${id}`,
+      method: 'get',
+    })
+
+    if (statusCode === HttpStatusCode.ok && !!body)
+      return {
+        description: body.description,
+      }
+
+    if (statusCode === HttpStatusCode.badRequest) throw new BadRequestError()
+
+    if (statusCode === HttpStatusCode.notFound)
+      throw new NotFoundError('Local de Utilização')
+
+    if (statusCode === HttpStatusCode.forbidden) {
+      throw new ForbiddenError(
+        'Você não tem permissão para acessar os dados deste local de utilização.'
+      )
+    }
+
+    throw new UnexpectedError()
+  }
+}

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/remote-get-input-use-locations-use-case.ts

@@ -0,0 +1,73 @@
+import { type HttpClient, HttpStatusCode } from '@/core/data/protocols/http'
+import {
+  UnexpectedError,
+  NotFoundError,
+  ForbiddenError,
+} from '@/core/domain/errors'
+
+import type {
+  InputUseLocationApiResponse,
+  InputUseLocationModel,
+} from '../../../domain/models/input-use-locations-model'
+import type { GetInputUseLocationsUseCase } from '../../../domain/use-cases/input-use-locations-use-cases'
+import type { ListApiResponse, MapApiProperties } from '@/core/domain/types'
+
+export class RemoteGetInputUseLocationsUseCase
+  implements GetInputUseLocationsUseCase
+{
+  constructor(
+    private readonly url: string,
+    private readonly httpClient: HttpClient<
+      InputUseLocationModel,
+      InputUseLocationApiResponse,
+      ListApiResponse<InputUseLocationApiResponse[]>
+    >
+  ) {}
+
+  execute: GetInputUseLocationsUseCase['execute'] = async ({
+    filters,
+    pagination,
+    sort,
+  }) => {
+    const mapApiProperties: MapApiProperties<
+      InputUseLocationModel,
+      InputUseLocationApiResponse
+    > = {
+      id: 'id',
+      description: 'description',
+    }
+
+    const { statusCode, body } = await this.httpClient.request({
+      url: `${this.url}/search`,
+      method: 'post',
+      filters,
+      pagination,
+      sort,
+      mapApiProperties,
+    })
+
+    if (statusCode === HttpStatusCode.ok && !!body) {
+      return {
+        resources: body.content.map((item) => {
+          return {
+            id: item.id,
+            description: item.description,
+          }
+        }),
+        totalPages: Math.ceil(body.numberOfElements / body.pageable.pageSize),
+      }
+    }
+
+    if (statusCode === HttpStatusCode.notFound) {
+      throw new NotFoundError('Local de Utilização')
+    }
+
+    if (statusCode === HttpStatusCode.forbidden) {
+      throw new ForbiddenError(
+        'Você não tem permissão para buscar os locais de utilização.'
+      )
+    }
+
+    throw new UnexpectedError()
+  }
+}

src/app/modules/input-uses/data/use-cases/input-use-locations-use-cases/remote-update-input-use-location-use-case.ts

@@ -0,0 +1,39 @@
+import { type HttpClient, HttpStatusCode } from '@/core/data/protocols/http'
+import {
+  BadRequestError,
+  ForbiddenError,
+  UnexpectedError,
+} from '@/core/domain/errors'
+
+import type { UpdateInputUseLocationUseCase } from '../../../domain/use-cases/input-use-locations-use-cases'
+
+export class RemoteUpdateInputUseLocationUseCase
+  implements UpdateInputUseLocationUseCase
+{
+  constructor(
+    private readonly url: string,
+    private readonly httpClient: HttpClient
+  ) {}
+
+  execute: UpdateInputUseLocationUseCase['execute'] = async ({
+    inputUseLocation: { id, ...inputUseLocation },
+  }) => {
+    const { statusCode } = await this.httpClient.request({
+      url: `${this.url}/${id}`,
+      method: 'patch',
+      body: inputUseLocation,
+    })
+
+    if (statusCode === HttpStatusCode.noContent) return
+
+    if (statusCode === HttpStatusCode.badRequest) throw new BadRequestError()
+
+    if (statusCode === HttpStatusCode.forbidden) {
+      throw new ForbiddenError(
+        'Você não tem permissão para editar um local de utilização.'
+      )
+    }
+
+    throw new UnexpectedError()
+  }
+}