Feat/ci developer ex

Merge Request: Enhance CI/CD and Developer Experience (DX)

Overview This PR significantly upgrades the project's infrastructure by migrating the codebase to TypeScript, implementing a robust CI/CD pipeline, and establishing high-standard Developer Experience (DX) patterns. These changes align our workflow with modern engineering practices and ensure long-term maintainability.

---

Key Changes

1. Infrastructure & CI/CD

• GitLab CI/CD: Implemented a fast, 4-stage pipeline (Install ➔ Lint ➔ Test ➔ Build) in .gitlab-ci.yml, following the "Minimal & Clean" philosophy.
• Automated Quality Gates: Configured the pipeline to run on every push/merge request to ensure no broken code reaches the main branch.

2. Developer Experience (DX)

• Pre-commit Hooks (Husky): Integrated Husky to automatically run lint and test before every commit, preventing technical debt at the source.
• Relaxed Type Safety: Optimized TypeScript and ESLint rules to allow rapid prototyping while still catching critical bugs.
• Auto-Formatting: Pre-configured Prettier and VS Code settings for seamless, consistent code styling.

3. TypeScript Migration

• Full Conversion: Migrated all React components, custom hooks, services, and utility functions from .js/jsx to .ts/tsx.
• Type Safety: Established core interfaces for agricultural data, API responses, and component props to reduce runtime errors.

4. Comprehensive Testing Suite

• Vitest Integration: Added 31 unit and integration tests across 8 test files.
• Coverage:
  • Logic: Validated search parsing, fuzzy matching, and currency formatting.
  • Services: Tested API request queuing, pagination, and AI assistant prompt logic.
  • UI: Component tests for critical dashboard widgets (PriceCard, StatCard).

5. Documentation & Tooling

• README.md: Rewritten to include architecture mapping, technical rationales (e.g., Vite proxy usage), and a command reference table.
• CONTRIBUTING.md: Established a clear onboarding path for new developers with Conventional Commit guidelines and quality requirements.
• Dead-Code Detection: Integrated Knip to identify and remove unused exports and dependencies.

---

Verification Results

• ✅ Linting: Clean (0 errors).
• ✅ Tests: 31 tests passed (100% success rate).
• ✅ Build: Production build verified and stable.
• ✅ CI: GitLab pipeline configuration validated.

How to Test

1. Run npm install to set up new dependencies and Husky hooks.
2. Run npm run lint to verify code quality.
3. Run npm run test to execute the full testing suite.
4. Run npm run build to verify the production compilation.