Добавлен Swagger #20

src/handlers/admin/admin_handler_events.erl

@@ -2,14 +2,92 @@
 -behaviour(cowboy_handler).
 
 -export([init/2]).
+-export([trails/0]).
+
 -include("records.hrl").
 
+%%%===================================================================
+%%% cowboy_handler callbacks
+%%%===================================================================
+
 init(Req, _Opts) ->
   case cowboy_req:method(Req) of
     <<"GET">> -> list_all_events(Req);
     _ -> send_error(Req, 405, <<"Method not allowed">>)
   end.
 
+%%%===================================================================
+%%% Swagger / Trails metadata
+%%%===================================================================
+
+trails() ->
+  [
+    #{
+      path => <<"/v1/admin/events">>,
+      method => <<"GET">>,
+      handler => ?MODULE,
+      tags => [<<"Events">>],
+      description => <<"Search and list events (admin)">>,
+      parameters => [
+        #{name => <<"from">>, in => <<"query">>, description => <<"ISO8601 start datetime">>, required => false, schema => #{type => string}},
+        #{name => <<"to">>, in => <<"query">>, description => <<"ISO8601 end datetime">>, required => false, schema => #{type => string}},
+        #{name => <<"status">>, in => <<"query">>, description => <<"active, cancelled, completed, or all">>, required => false, schema => #{type => string}},
+        #{name => <<"calendar_id">>, in => <<"query">>, description => <<"Filter by calendar ID">>, required => false, schema => #{type => string}},
+        #{name => <<"title">>, in => <<"query">>, description => <<"Exact title match">>, required => false, schema => #{type => string}},
+        #{name => <<"q">>, in => <<"query">>, description => <<"Substring search in title/description">>, required => false, schema => #{type => string}},
+        #{name => <<"limit">>, in => <<"query">>, description => <<"Page size (max 200)">>, required => false, schema => #{type => integer}},
+        #{name => <<"offset">>, in => <<"query">>, description => <<"Offset">>, required => false, schema => #{type => integer}},
+        #{name => <<"sort">>, in => <<"query">>, description => <<"created_at, start_time, title, status">>, required => false, schema => #{type => string}},
+        #{name => <<"order">>, in => <<"query">>, description => <<"asc or desc">>, required => false, schema => #{type => string, enum => [<<"asc">>, <<"desc">>]}}
+      ],
+      responses => #{
+        200 => #{
+          description => <<"Array of events with Content-Range header">>,
+          content => #{
+            <<"application/json">> => #{
+              schema => #{
+                type => array,
+                items => event_schema()
+              }
+            }
+          }
+        },
+        405 => #{description => <<"Method not allowed">>}
+      }
+    }
+  ].
+
+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">>]},
+      rating_avg => #{type => number, format => float},
+      rating_count => #{type => integer},
+      created_at => #{type => string, format => <<"date-time">>},
+      updated_at => #{type => string, format => <<"date-time">>}
+    }
+  }.
+
+%%%===================================================================
+%%% Internal functions
+%%%===================================================================
+
 list_all_events(Req) ->
   case auth_admin(Req) of
     {ok, _AdminId, Req1} ->
@@ -26,9 +104,7 @@ list_all_events(Req) ->
         <<"x-total-count">> => integer_to_binary(Total),
         <<"access-control-expose-headers">> => <<"Content-Range, X-Total-Count">>
       },
-      Body = jsx:encode(Json),
-      cowboy_req:reply(200, Headers, Body, Req1),
-      {ok, Body, []};
+      send_json(Req1, 200, Json, Headers);
     {error, Code, Msg, Req1} ->
       send_error(Req1, Code, Msg)
   end.
@@ -48,9 +124,6 @@ parse_admin_event_search(Req) ->
     order  => proplists:get_value(<<"order">>, Qs, <<"desc">>)
   }.
 
-%%--------------------------------------------------------------------
-%% Вспомогательные функции
-%%--------------------------------------------------------------------
 auth_admin(Req) ->
   case handler_auth:authenticate(Req) of
     {ok, AdminId, Req1} ->
@@ -70,6 +143,22 @@ parse_datetime_qs(undefined) -> undefined;
 parse_datetime_qs(Bin) ->
   case parse_datetime(Bin) of {ok, Dt} -> Dt; _ -> undefined end.
 
+parse_datetime(Str) ->
+  try
+    [DateStr, TimeStr] = string:split(Str, "T"),
+    TimeStrNoZ = string:trim(TimeStr, trailing, "Z"),
+    [YearStr, MonthStr, DayStr] = string:split(DateStr, "-", all),
+    [HourStr, MinuteStr, SecondStr] = string:split(TimeStrNoZ, ":", all),
+    Year = binary_to_integer(list_to_binary(YearStr)),
+    Month = binary_to_integer(list_to_binary(MonthStr)),
+    Day = binary_to_integer(list_to_binary(DayStr)),
+    Hour = binary_to_integer(list_to_binary(HourStr)),
+    Minute = binary_to_integer(list_to_binary(MinuteStr)),
+    Second = binary_to_integer(list_to_binary(SecondStr)),
+    {ok, {{Year, Month, Day}, {Hour, Minute, Second}}}
+  catch _:_ -> {error, invalid_format}
+  end.
+
 event_to_json(Event) ->
   LocationJson = case Event#event.location of
                    undefined -> null;
@@ -118,21 +207,11 @@ datetime_to_iso8601({{Year, Month, Day}, {Hour, Minute, Second}}) ->
 datetime_to_iso8601(undefined) ->
   undefined.
 
-parse_datetime(Str) ->
-  try
-    [DateStr, TimeStr] = string:split(Str, "T"),
-    TimeStrNoZ = string:trim(TimeStr, trailing, "Z"),
-    [YearStr, MonthStr, DayStr] = string:split(DateStr, "-", all),
-    [HourStr, MinuteStr, SecondStr] = string:split(TimeStrNoZ, ":", all),
-    Year = binary_to_integer(list_to_binary(YearStr)),
-    Month = binary_to_integer(list_to_binary(MonthStr)),
-    Day = binary_to_integer(list_to_binary(DayStr)),
-    Hour = binary_to_integer(list_to_binary(HourStr)),
-    Minute = binary_to_integer(list_to_binary(MinuteStr)),
-    Second = binary_to_integer(list_to_binary(SecondStr)),
-    {ok, {{Year, Month, Day}, {Hour, Minute, Second}}}
-  catch _:_ -> {error, invalid_format}
-  end.
+send_json(Req, Status, Data, ExtraHeaders) ->
+  Body = jsx:encode(Data),
+  Headers = maps:merge(#{<<"content-type">> => <<"application/json">>}, ExtraHeaders),
+  cowboy_req:reply(Status, Headers, Body, Req),
+  {ok, Body, []}.
 
 send_error(Req, Status, Message) ->
   Body = jsx:encode(#{error => Message}),