Feat/police fir management case linkage

[Nareshkumawat-star]

Description

This PR addresses the lack of structured police FIR filing and court case linkage by adding full FIR lifecycle management for police officers:

1. FIR Filing Form: Structured fields for complainant details, accused details, offence sections (BNS/IPC), police station code, and incident location.
2. Auto-Generated FIR Numbers: Formats FIR numbers as PS-CODE/YYYY/NNNN (e.g. PS01/2026/0042).
3. FIR Status Tracker Pipeline: Displays status progression (Draft → Filed → Accepted → Linked to Court Case → Closed).
4. Court Case Linkage: Allows police officers to link an FIR to a court case UUID upon judicial cognizance.

Issue Resolved

Closes #1627

Type of Change

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

Key Changes

• backend/nyaysetu-backend/src/main/java/com/nyaysetu/backend/entity/FirRecord.java: Added complainant/accused details, BNS/IPC sections, PS code columns.
• backend/nyaysetu-backend/src/main/java/com/nyaysetu/backend/service/FirService.java: Added PS-CODE/YYYY/NNNN generator and linkFirToCase service method.
• backend/nyaysetu-backend/src/main/java/com/nyaysetu/backend/controller/FirController.java: Added POST /police/fir/{id}/link-case endpoint and updated upload parameters.
• frontend/nyaysetu-frontend/src/pages/police/UploadFirPage.jsx: Extended FIR creation UI form.
• frontend/nyaysetu-frontend/src/pages/police/MyFirsPage.jsx: Rendered status tracker pipeline and linkage badges.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• New and existing unit tests pass locally with my changes

[vercel]

Someone is attempting to deploy a commit to the CodeBlooded's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

Hi @Nareshkumawat-star, thanks for contributing to Nyay Setu! 🎉

I have automatically:

• 👤 Assigned this PR to you.
• 🏷️ Applied the gssoc:approved label.

Our workflows will now analyze your changes to classify:

• 📈 PR Difficulty: level:*
• 🧩 PR Type: type:*
• 🌟 PR Quality: quality:*

Tip

Ensure your PR description references the issue it resolves (e.g. Closes #123). This allows the bot to inherit any additional labels from that issue!

Happy coding! 🚀