%%%------------------------------------------------------------------- %%% @doc Обработчик конкретного события (клиентский API). %%% %%% GET – получить информацию о событии. %%% PUT – обновить событие. %%% DELETE – удалить событие. %%% @end %%%------------------------------------------------------------------- -module(handler_event_by_id). -behaviour(cowboy_handler). -export([init/2]). -export([trails/0]). -include("records.hrl"). %%% cowboy_handler callback -spec init(cowboy_req:req(), any()) -> {ok, cowboy_req:req(), any()}. init(Req, Opts) -> handle(Req, Opts). %%% Swagger metadata -spec trails() -> [map()]. trails() -> BaseParams = [ #{ name => <<"id">>, in => <<"path">>, description => <<"Event ID">>, required => true, schema => #{type => string} } ], [ #{ % GET by id path => <<"/v1/events/:id">>, method => <<"GET">>, description => <<"Get event by ID">>, tags => [<<"Events">>], parameters => BaseParams, responses => #{ 200 => #{ description => <<"Event details">>, content => #{<<"application/json">> => #{schema => event_schema()}} }, 403 => #{description => <<"Access denied">>}, 404 => #{description => <<"Event not found">>} } }, #{ % PUT update path => <<"/v1/events/:id">>, method => <<"PUT">>, description => <<"Update event">>, tags => [<<"Events">>], parameters => BaseParams, requestBody => #{ required => true, content => #{<<"application/json">> => #{schema => event_update_schema()}} }, responses => #{ 200 => #{description => <<"Event updated">>}, 400 => #{description => <<"Invalid request">>}, 403 => #{description => <<"Access denied">>}, 404 => #{description => <<"Event not found">>} } }, #{ % DELETE path => <<"/v1/events/:id">>, method => <<"DELETE">>, description => <<"Delete event">>, tags => [<<"Events">>], parameters => BaseParams, responses => #{ 200 => #{description => <<"Event deleted">>}, 403 => #{description => <<"Access denied">>}, 404 => #{description => <<"Event not found">>} } } ]. event_schema() -> #{ type => object, properties => #{ id => #{type => string}, calendar_id => #{type => string}, title => #{type => string}, description => #{type => string}, event_type => #{type => string, enum => [<<"single">>, <<"recurring">>]}, start_time => #{type => string, format => <<"date-time">>}, duration => #{type => integer}, recurrence => #{type => object, nullable => true}, master_id => #{type => string, nullable => true}, is_instance => #{type => boolean}, specialist_id => #{type => string, nullable => true}, location => #{type => object, nullable => true}, tags => #{type => array, items => #{type => string}}, capacity => #{type => integer, nullable => true}, online_link => #{type => string, nullable => true}, status => #{type => string, enum => [<<"active">>, <<"cancelled">>, <<"completed">>]}, reason => #{type => string, nullable => true}, rating_avg => #{type => number, format => float}, rating_count => #{type => integer}, attachments => #{type => array, items => #{type => string}, nullable => true}, edit_history => #{type => array, items => #{type => object}, nullable => true}, created_at => #{type => string, format => <<"date-time">>}, updated_at => #{type => string, format => <<"date-time">>} } }. event_update_schema() -> #{ type => object, properties => #{ title => #{type => string}, description => #{type => string}, start_time => #{type => string, format => <<"date-time">>}, duration => #{type => integer}, status => #{type => string, enum => [<<"active">>, <<"cancelled">>, <<"completed">>]}, specialist_id => #{type => string}, location => #{ type => object, properties => #{ address => #{type => string}, lat => #{type => number, format => float}, lon => #{type => number, format => float} } }, tags => #{type => array, items => #{type => string}}, capacity => #{type => integer}, online_link => #{type => string} } }. %%%=================================================================== %%% HTTP-методы %%%=================================================================== %% @private -spec handle(cowboy_req:req(), any()) -> {ok, cowboy_req:req(), any()}. handle(Req, _Opts) -> case cowboy_req:method(Req) of <<"GET">> -> get_event(Req); <<"PUT">> -> update_event(Req); <<"DELETE">> -> delete_event(Req); _ -> handler_utils:send_error(Req, 405, <<"Method not allowed">>) end. %% @doc GET /v1/events/:id — получение события. -spec get_event(cowboy_req:req()) -> {ok, binary(), cowboy_req:req()}. get_event(Req) -> case handler_utils:auth_user(Req) of {ok, UserId, Req1} -> EventId = cowboy_req:binding(id, Req1), case logic_event:get_event(UserId, EventId) of {ok, Event} -> handler_utils:send_json(Req1, 200, handler_utils:event_to_json(Event)); {error, access_denied} -> handler_utils:send_error(Req1, 403, <<"Access denied">>); {error, not_found} -> handler_utils:send_error(Req1, 404, <<"Event not found">>); {error, _} -> handler_utils:send_error(Req1, 500, <<"Internal server error">>) end; {error, Code, Message, Req1} -> handler_utils:send_error(Req1, Code, Message) end. %% @doc PUT /v1/events/:id — обновление события. -spec update_event(cowboy_req:req()) -> {ok, binary(), cowboy_req:req()}. update_event(Req) -> case handler_utils:auth_user(Req) of {ok, UserId, Req1} -> EventId = cowboy_req:binding(id, Req1), {ok, Body, Req2} = cowboy_req:read_body(Req1), try jsx:decode(Body, [return_maps]) of UpdatesMap when is_map(UpdatesMap) -> Updates = maps:to_list(UpdatesMap), UpdatesWithTypes = convert_fields(Updates), case logic_event:update_event(UserId, EventId, UpdatesWithTypes) of {ok, Event} -> handler_utils:send_json(Req2, 200, handler_utils:event_to_json(Event)); {error, access_denied} -> handler_utils:send_error(Req2, 403, <<"Access denied">>); {error, not_found} -> handler_utils:send_error(Req2, 404, <<"Event not found">>); {error, event_in_past} -> handler_utils:send_error(Req2, 400, <<"Event cannot be in the past">>); {error, {content_banned, _}} -> handler_utils:send_error(Req2, 400, <<"Content contains banned words">>); {error, invalid_specialist} -> handler_utils:send_error(Req2, 400, <<"Invalid specialist_id for this calendar">>); {error, _} -> handler_utils:send_error(Req2, 500, <<"Internal server error">>) end; _ -> handler_utils:send_error(Req2, 400, <<"Invalid JSON">>) catch _:_ -> handler_utils:send_error(Req2, 400, <<"Invalid JSON format">>) end; {error, Code, Message, Req1} -> handler_utils:send_error(Req1, Code, Message) end. %% @doc DELETE /v1/events/:id — удаление события. -spec delete_event(cowboy_req:req()) -> {ok, binary(), cowboy_req:req()}. delete_event(Req) -> case handler_utils:auth_user(Req) of {ok, UserId, Req1} -> EventId = cowboy_req:binding(id, Req1), case logic_event:delete_event(UserId, EventId) of {ok, _} -> handler_utils:send_json(Req1, 200, #{status => <<"deleted">>}); {error, access_denied} -> handler_utils:send_error(Req1, 403, <<"Access denied">>); {error, not_found} -> handler_utils:send_error(Req1, 404, <<"Event not found">>); {error, _} -> handler_utils:send_error(Req1, 500, <<"Internal server error">>) end; {error, Code, Message, Req1} -> handler_utils:send_error(Req1, Code, Message) end. %%%=================================================================== %%% Вспомогательные функции %%%=================================================================== %% @private Преобразует поля из бинарных ключей в атомы и значения в правильные типы. -spec convert_fields([{binary(), term()}]) -> [{atom(), term()}]. convert_fields(Updates) -> lists:map(fun convert_field/1, Updates). -spec convert_field({binary(), term()}) -> {atom(), term()}. convert_field({<<"title">>, Val}) -> {title, Val}; convert_field({<<"description">>, Val}) -> {description, Val}; convert_field({<<"event_type">>, Val}) -> {event_type, Val}; convert_field({<<"start_time">>, Val}) -> case handler_utils:parse_datetime(Val) of {ok, Dt} -> {start_time, Dt}; _ -> {start_time, Val} end; convert_field({<<"duration">>, Val}) -> {duration, Val}; convert_field({<<"recurrence">>, Val}) -> RuleJson = jsx:encode(Val), {recurrence_rule, RuleJson}; convert_field({<<"specialist_id">>, Val}) -> {specialist_id, Val}; convert_field({<<"location">>, Val}) when is_map(Val) -> Loc = #location{ address = maps:get(<<"address">>, Val, undefined), lat = maps:get(<<"lat">>, Val, undefined), lon = maps:get(<<"lon">>, Val, undefined) }, {location, Loc}; convert_field({<<"location">>, Val}) -> {location, Val}; convert_field({<<"tags">>, Val}) -> {tags, Val}; convert_field({<<"capacity">>, Val}) -> {capacity, Val}; convert_field({<<"online_link">>, Val}) -> {online_link, Val}; convert_field({<<"status">>, Val}) -> try binary_to_existing_atom(Val, utf8) of Atom -> {status, Atom} catch error:badarg -> {status, Val} end; convert_field(Other) -> Other.