​

Controller Documentation

​

Controller Organization

controller/
├── PublicController.java          # Public pages (no auth required)
├── DashboardController.java       # Main dashboard
├── ProfileController.java         # User profile management
├── RequestFormController.java     # Request creation/editing
├── MyRequestsController.java      # User's requests management
├── ProfessionalController.java    # Professional features
├── PostulacionesController.java   # Application management
├── RatingsController.java         # Rating submission
├── SharedController.java          # Shared authenticated pages
├── AdminController.java           # Admin dashboard
├── CategoryController.java        # Category CRUD
├── CustomErrorController.java     # Error pages
└── UserControllerAdvice.java      # Global controller advice

​

Public Access Controllers

​

PublicController

• Landing page
• Login/logout pages
• User registration
• Static pages (terms, privacy, help)

• Redirects authenticated users from login page
• Handles registration form validation
• Preserves form data on validation errors
• Displays flash messages for success/error states

• public/index - Landing page
• public/login - Login form
• public/signup - Registration form
• public/terms - Terms and conditions
• public/privacy - Privacy policy
• public/help - Help page

​

DashboardController

• Main dashboard page for authenticated users

• dashboard/home - Main dashboard

​

User Management Controllers

​

ProfileController

• User profile viewing and editing
• Professional profile management
• Account deletion (deactivation)

• Separate forms for user and professional profiles
• Validation groups for different profile types
• Secure account deletion with logout

• profile/profileUser - User profile edit
• profile/profileProfessional - Professional profile edit

​

Service Request Controllers

​

RequestFormController

• Display request creation/editing form
• Handle form submission
• Manage address selection (habitual vs new)

• Single form for both create and edit operations
• Edit mode detected via edit query parameter
• Address options: use habitual or specify new
• Deadline date handling
• Category selection
• Publish immediately or save as draft

• jobs/request - Request form

1. GET /requests/request - Show empty form (create)
2. GET /requests/request?edit={id} - Show form with data (edit)
3. POST /requests/request - Process submission

​

MyRequestsController

• Display user’s service requests
• Manage request states (publish, unpublish, cancel, reactivate, delete)
• View applications for requests
• Accept/reject applications
• Manage jobs as client (complete, pause, cancel)

• Lists all user’s requests with their status
• Shows active jobs as client
• Application management
• Job state transitions

• jobs/myrequest - List of user’s requests
• jobs/applications - Applications for a specific request

• DRAFT → PUBLISHED → (COMPLETED | CANCELLED)
• Cancelled requests can be reactivated to DRAFT

​

Professional Controllers

​

ProfessionalController

• Search for available service requests
• Submit applications to requests
• View own applications
• Manage application states

• Advanced search with filters (text, category, postal code)
• Application submission with price and message
• Edit pending applications
• Withdraw pending applications
• View active jobs as professional

• jobs/search - Search page with filters
• jobs/myaplication - Professional’s applications and jobs

• textoBusqueda - Search in title/description
• categoriaId - Filter by category
• codigoPostal - Filter by postal code

​

PostulacionesController

• View applications for a request (client view)
• Accept/reject applications
• Manage job lifecycle as professional

• Application acceptance creates a job
• Job state management (start, pause, resume, complete, cancel)
• Redirect parameter support for flexible navigation

• CREATED → IN_PROGRESS ↔ PAUSED → COMPLETED
• CANCELLED (can be set from any state)

• jobs/applications - View applications

​

Rating Controllers

​

RatingsController

• Submit ratings for completed jobs

• Score validation (1-5)
• Optional comment
• Automatic rating type detection (client rates professional or vice versa)

• Ratings are displayed in shared/ratings
• Submission redirects to ratings page

​

Shared Controllers

​

SharedController

• Display job history
• Display ratings page (pending and completed)

• History shows jobs as both client and professional
• Ratings page shows pending ratings and completed ratings
• Professional profile includes rating statistics

• shared/history - Job history
• shared/ratings - Ratings overview

​

Administration Controllers

​

AdminController

• User management page (view only, no CRUD)
• Statistics dashboard page

• admin/users - User list
• admin/stats - Statistics dashboard

​

CategoryController

• Complete CRUD operations for categories
• Toggle category active/inactive status

• List all categories
• Create new category
• Edit existing category
• Delete category
• Toggle active status

• admin/categories - Category management

• GET /admin/categories - List view
• POST /admin/categories - Create/update
• GET /admin/edit/{id} - Load for editing
• GET /admin/delete/{id} - Delete
• GET /admin/toggle/{id} - Toggle status

​

Error Handling

​

CustomErrorController

• Handle HTTP errors (403, 404, 500)
• Display custom error pages

• error/403 - Forbidden
• error/404 - Not Found
• error/500 - Server Error

​

Global Controller Advice

​

UserControllerAdvice

• Add authenticated user to all views automatically

• usuario - Current authenticated user (or null if not authenticated)

<span th:text="${usuario.firstName}">User Name</span>

​

Common Patterns

​

Flash Attributes

redirectAttributes.addFlashAttribute("success", "Operation successful");
redirectAttributes.addFlashAttribute("error", "Error message");

​

Model Attributes

@ModelAttribute("form")
public RequestDTO initializeForm() {
    return new RequestDTO();
}

​

Validation

public String submit(@Valid @ModelAttribute RequestDTO form,
                     BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        return "form-view";
    }
    // Process form
}

​

Authentication

public String action(Authentication auth) {
    AppUser user = authService.getAuthenticatedUser(auth);
    // Use user
}

​

Security Configuration

• /admin/** - Requires ADMIN role
• /professional/** - Requires PROFESSIONAL role
• /user/**, /shared/**, /profile/** - Requires authentication
• /, /login, /signup, /error/** - Public access

​

Response Types

• View names (String) - For page rendering
• Redirects (redirect:/path) - After form submissions
• Flash attributes - For temporary messages