ruffghanor20/Ciclo-de-Inventario

AI Summary: This issue addresses inconsistencies in the repository's local artifacts and environment files, such as `.expo`, `package-lock`, and `app.local.json`. The goal is to standardize dependency management (npm vs. yarn), decide which lockfiles to keep, and remove unnecessary temporary files to prevent accidental commits and ensure a consistent local setup.

AI Summary: This issue proposes adding TypeScript type support for auxiliary files, specifically by including `**/*.d.ts` in the `tsconfig.json`. The goal is to improve type checking for libraries without ready-made typings and reduce friction in builds and IDEs, with a specific example of XLSX.

AI Summary: This issue requests the inclusion of an official import template spreadsheet and a helper script. This will clarify the integration with spreadsheets and prevent users from importing data with incorrect columns, improving the user experience.

AI Summary: This issue proposes improving the root repository documentation by creating a comprehensive README file for the EstoqueAudit project. The README should include setup instructions, requirements, build processes, and API endpoints to address poor technical onboarding, the repository's incomplete appearance, and collaboration difficulties.

AI Summary: This issue proposes a refactor to standardize the naming of divergence metrics. The current use of 'sobra' (surplus) is inconsistent with 'diferenca' (difference) and can lead to confusion in the API, UI, and exports. The goal is to establish a single semantic standard, clearly separating 'diferenca', 'falta' (shortage), and 'sobra', and aligning these across the backend, frontend, and reports.

AI Summary: This is a high-priority bug fix to prevent invalid `quantidade_contada` (counted quantity) values from being persisted in the backend. The backend currently accepts negative, NaN, or infinite quantities, leading to data corruption and inconsistent reports. The fix involves adding validation to POST and PUT endpoints for counts, rejecting invalid values, and returning a clear 422 error.

AI Summary: This issue proposes refactoring the local item model to support recurring inventory operations. It aims to add attributes like scheduling, adjustment cost, and ABC classification to the `EstoqueAudit` model, which is currently too lean. This enhancement is crucial for product evolution, reporting, and prioritizing counts.

AI Summary: This enhancement aims to fix an issue where saving item counts in EstoqueAudit does not update the item's schedule metadata. The goal is to ensure that when an item is counted, its last counted date is updated, and future counts are recalculated consistently, thereby completing the item's operational history and allowing the inventory schedule to evolve correctly.

AI Summary: This issue addresses bugs and enhancements related to the inventory scanner. It aims to prevent duplicate readings, handle malformed manual input, and improve scanner stability by cleaning up timers and normalizing numeric codes. The goal is to make the scanner more robust against duplicate scans and dirty input.

AI Summary: This issue proposes improving the main navigation UX for EstoqueAudit. The current tab-based navigation is becoming cramped and limiting as the product grows. The goal is to explore alternative navigation patterns, such as a side or dropdown menu, to better accommodate more modules and provide a clearer context to the user.

AI Summary: This issue proposes adding a feature to persist the responsible user's name within the application. Currently, the EstoqueAudit lacks this simple persistence, leading to generic exports and reduced operational traceability. The proposed solution involves creating a configuration for the operator's name, allowing it to be edited in the app, and using it for new sessions and exports.

AI Summary: This issue proposes adding XLSX export functionality to the EstoqueAudit feature, complementing existing CSV and PDF exports. The goal is to improve compatibility for users who work directly with Excel and eliminate manual post-processing, by generating a native XLSX file with specific columns and ensuring it opens correctly in Excel.

AI Summary: This issue proposes implementing XLSX spreadsheet import functionality into the application, which is currently missing. The goal is to streamline data onboarding, accelerate real-world adoption, and facilitate integration with external inventory systems by allowing users to import items, update existing ones, and create new ones, with a summary report provided upon completion.

AI Summary: This issue proposes adding ABC curve-based scheduling for inventory recounts to the EstoqueAudit system. Currently, the system lacks visible logic for scheduling recontages, limiting it to point-in-time counts and hindering cyclical inventory management. The proposed solution involves adding new fields, automating next count calculations, and creating a dedicated scheduling screen with filtering capabilities.

AI Summary: This issue proposes creating a dedicated management screen for inventory counting sessions in the EstoqueAudit application. Currently, session management is embedded within the export screen, leading to poor usability and code maintenance challenges. The new screen will allow users to list, create, load, and delete sessions, displaying key information like owner, status, and count totals.