/**
 * @openapi
 * /api/academic_years:
 *   get:
 *     tags: [Academic Years]
 *     summary: List academic years (tenant-scoped)
 *     description: Requires READ_ACADEMIC_YEARS.
 *     responses:
 *       200:
 *         description: List payload.
 *         content:
 *           application/json:
 *             schema: { $ref: '#/components/schemas/ListResponse' }
 *       401: { $ref: '#/components/responses/UnauthorizedError' }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 *   post:
 *     tags: [Academic Years]
 *     summary: Create a academic years record
 *     description: Requires CREATE_ACADEMIC_YEARS.
 *     responses:
 *       200: { description: Created. }
 *       400: { $ref: '#/components/responses/ValidationError' }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 * /api/academic_years/count:
 *   get:
 *     tags: [Academic Years]
 *     summary: Count academic years
 *     description: Requires READ_ACADEMIC_YEARS.
 *     responses:
 *       200: { description: Count. }
 * /api/academic_years/autocomplete:
 *   get:
 *     tags: [Academic Years]
 *     summary: Autocomplete academic years
 *     description: Requires READ_ACADEMIC_YEARS.
 *     responses:
 *       200: { description: Autocomplete results. }
 * /api/academic_years/bulk-import:
 *   post:
 *     tags: [Academic Years]
 *     summary: Bulk-import academic years from CSV
 *     description: Requires CREATE_ACADEMIC_YEARS.
 *     responses:
 *       200: { description: Imported. }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 * /api/academic_years/deleteByIds:
 *   post:
 *     tags: [Academic Years]
 *     summary: Delete multiple academic years records
 *     description: Requires DELETE_ACADEMIC_YEARS.
 *     responses:
 *       200: { description: Deleted. }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 * /api/academic_years/{id}:
 *   get:
 *     tags: [Academic Years]
 *     summary: Get a academic years record by id
 *     description: Requires READ_ACADEMIC_YEARS.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema: { type: string, format: uuid }
 *     responses:
 *       200: { description: The record. }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 *       404: { description: Not found. }
 *   put:
 *     tags: [Academic Years]
 *     summary: Update a academic years record
 *     description: Requires UPDATE_ACADEMIC_YEARS.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema: { type: string, format: uuid }
 *     responses:
 *       200: { description: Updated. }
 *       400: { $ref: '#/components/responses/ValidationError' }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 *   delete:
 *     tags: [Academic Years]
 *     summary: Delete a academic years record
 *     description: Requires DELETE_ACADEMIC_YEARS.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         schema: { type: string, format: uuid }
 *     responses:
 *       200: { description: Deleted. }
 *       403: { $ref: '#/components/responses/ForbiddenError' }
 */
import controller from '@/api/controllers/academic_years.controller';
import { createCrudRouter } from '@/api/http/crud-router';

export default createCrudRouter(controller, { permission: 'academic_years' });
