[FEAT]: Create frontend API to connect frontend and backend for form templates

[marcvergees]

🎯 Description

Create a frontend API layer that acts as an interface between the frontend and backend for managing form templates and filled documents. This API will handle two primary operations: creating new form templates and filling out documents based on existing templates.

🤝 Rationale

The frontend and backend need a well-defined API interface to manage the form lifecycle. Currently, there's no clear separation of concerns between the frontend UI components and backend data handling. By creating a dedicated frontend API, we establish:

• A single point of integration between frontend and backend services
• Clear contracts for form template creation and submission operations
• Easier testing and maintenance of frontend-backend interactions
• Better error handling and status reporting for form operations

💡 Proposed Solution

Develop a frontend API module that provides the following capabilities:

• Create and save new form templates through API calls to the backend
• Retrieve and list existing form templates for users to fill
• Submit filled form responses back to the backend, associating them with the correct template
• Handle errors and provide meaningful feedback to the frontend UI
• Document all API methods and usage examples

✅ Acceptance Criteria

• Frontend API supports creating new form templates with proper validation
• Frontend API supports submitting filled forms for existing templates
• All API methods include proper error handling and status reporting
• API documentation is updated with method signatures and examples
• Frontend components successfully integrate with the new API
• API works correctly in Docker container deployment

📎 Additional Context

This feature is essential for establishing a clean architecture pattern in the FireForm project, enabling scalability and maintainability as the form management system grows. The API will serve as the contract between frontend and backend services.

[pritishsharma2006]

Hi @marcvergees , I’d like to work on this feature.

My approach would be to introduce an API layer that defines clear endpoints for creating templates, listing/retrieving them, and submitting filled forms, along with basic validation and error handling.

Please let me know if this aligns with your expectations, I’d be happy to adjust the approach if needed and feel free to assign this issue to me.

[its-arunchauhan]

Hi @marcvergees,

I am interested in contributing to FireForm and would like to request to be assigned to Issue #1. I see that this is a critical feature for establishing a clean architecture between the frontend and backend services.

My Plan:
After reviewing the requirements, my initial approach would be:

Step 1: Establish the core API module structure to act as the single point of integration.

Step 2: Implement methods for creating/saving new form templates and retrieving existing ones.

Step 3: Develop the submission logic to link filled form responses back to their correct templates.

Step 4: Ensure all methods include proper error handling, status reporting, and documentation with usage examples as outlined in the acceptance criteria.

A bit about me: I have my local development environment set up and am ready to start. I'm looking forward to helping establish these clean contracts and improving the project's scalability. I will also ensure the final implementation works correctly within the Docker container deployment.

Could you please assign this issue to me?