From 7e776ea6e3d7fb7b6a827898408f333bcae677d6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=90=D0=BB=D0=B5=D0=BA=D1=81=D0=B5=D0=B9=20=D0=A1=D0=B0?= =?UTF-8?q?=D0=B1=D0=B8=D0=BB=D0=B8=D0=BD?= Date: Fri, 17 Apr 2026 21:36:56 +0300 Subject: [PATCH] Stage 1 --- .gitignore | 23 ++++ LICENSE.md | 186 ++++++++++++++++++++++++++++++++ README.md | 9 ++ include/records.hrl | 160 +++++++++++++++++++++++++++ rebar.config | 28 +++++ src/config/sys.config | 21 ++++ src/eventhub.app.src | 23 ++++ src/eventhub_app.erl | 24 +++++ src/handlers/handler_health.erl | 6 ++ src/infra/infra_mnesia.erl | 135 +++++++++++++++++++++++ src/infra/infra_sup.erl | 28 +++++ 11 files changed, 643 insertions(+) create mode 100644 .gitignore create mode 100644 LICENSE.md create mode 100644 README.md create mode 100644 include/records.hrl create mode 100644 rebar.config create mode 100644 src/config/sys.config create mode 100644 src/eventhub.app.src create mode 100644 src/eventhub_app.erl create mode 100644 src/handlers/handler_health.erl create mode 100644 src/infra/infra_mnesia.erl create mode 100644 src/infra/infra_sup.erl diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..46f9f2b --- /dev/null +++ b/.gitignore @@ -0,0 +1,23 @@ +/EventHubBack.iml +/.idea/ +.rebar3 +_build +_checkouts +_vendor +.eunit +*.o +*.beam +*.plt +*.swp +*.swo +.erlang.cookie +ebin +log +erl_crash.dump +.rebar +logs +.idea +*.iml +rebar3.crashdump +*~ +/.tool-versions diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..01de4a5 --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,186 @@ +# Apache License +Version 2.0, January 2004 + +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + +## 1. Definitions. + +"License" shall mean the terms and conditions for use, reproduction, and +distribution as defined by Sections 1 through 9 of this document. + +"Licensor" shall mean the copyright owner or entity authorized by the copyright +owner that is granting the License. + +"Legal Entity" shall mean the union of the acting entity and all other entities +that control, are controlled by, or are under common control with that entity. +For the purposes of this definition, "control" means (i) the power, direct or +indirect, to cause the direction or management of such entity, whether by +contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the +outstanding shares, or (iii) beneficial ownership of such entity. + +"You" (or "Your") shall mean an individual or Legal Entity exercising +permissions granted by this License. + +"Source" form shall mean the preferred form for making modifications, including +but not limited to software source code, documentation source, and configuration +files. + +"Object" form shall mean any form resulting from mechanical transformation or +translation of a Source form, including but not limited to compiled object code, +generated documentation, and conversions to other media types. + +"Work" shall mean the work of authorship, whether in Source or Object form, made +available under the License, as indicated by a copyright notice that is included +in or attached to the work (an example is provided in the Appendix below). + +"Derivative Works" shall mean any work, whether in Source or Object form, that +is based on (or derived from) the Work and for which the editorial revisions, +annotations, elaborations, or other modifications represent, as a whole, an +original work of authorship. For the purposes of this License, Derivative Works +shall not include works that remain separable from, or merely link (or bind by +name) to the interfaces of, the Work and Derivative Works thereof. + +"Contribution" shall mean any work of authorship, including the original version +of the Work and any modifications or additions to that Work or Derivative Works +thereof, that is intentionally submitted to Licensor for inclusion in the Work +by the copyright owner or by an individual or Legal Entity authorized to submit +on behalf of the copyright owner. For the purposes of this definition, +"submitted" means any form of electronic, verbal, or written communication sent +to the Licensor or its representatives, including but not limited to +communication on electronic mailing lists, source code control systems, and +issue tracking systems that are managed by, or on behalf of, the Licensor for +the purpose of discussing and improving the Work, but excluding communication +that is conspicuously marked or otherwise designated in writing by the copyright +owner as "Not a Contribution." + +"Contributor" shall mean Licensor and any individual or Legal Entity on behalf +of whom a Contribution has been received by Licensor and subsequently +incorporated within the Work. + +## 2. Grant of Copyright License. + +Subject to the terms and conditions of this License, each Contributor hereby +grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, +irrevocable copyright license to reproduce, prepare Derivative Works of, +publicly display, publicly perform, sublicense, and distribute the Work and such +Derivative Works in Source or Object form. + +## 3. Grant of Patent License. + +Subject to the terms and conditions of this License, each Contributor hereby +grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, +irrevocable (except as stated in this section) patent license to make, have +made, use, offer to sell, sell, import, and otherwise transfer the Work, where +such license applies only to those patent claims licensable by such Contributor +that are necessarily infringed by their Contribution(s) alone or by combination +of their Contribution(s) with the Work to which such Contribution(s) was +submitted. If You institute patent litigation against any entity (including a +cross-claim or counterclaim in a lawsuit) alleging that the Work or a +Contribution incorporated within the Work constitutes direct or contributory +patent infringement, then any patent licenses granted to You under this License +for that Work shall terminate as of the date such litigation is filed. + +## 4. Redistribution. + +You may reproduce and distribute copies of the Work or Derivative Works thereof +in any medium, with or without modifications, and in Source or Object form, +provided that You meet the following conditions: + +1. You must give any other recipients of the Work or Derivative Works a copy of + this License; and + +2. You must cause any modified files to carry prominent notices stating that + You changed the files; and + +3. You must retain, in the Source form of any Derivative Works that You + distribute, all copyright, patent, trademark, and attribution notices from + the Source form of the Work, excluding those notices that do not pertain to + any part of the Derivative Works; and + +4. If the Work includes a "NOTICE" text file as part of its distribution, then + any Derivative Works that You distribute must include a readable copy of the + attribution notices contained within such NOTICE file, excluding those + notices that do not pertain to any part of the Derivative Works, in at least + one of the following places: within a NOTICE text file distributed as part + of the Derivative Works; within the Source form or documentation, if + provided along with the Derivative Works; or, within a display generated by + the Derivative Works, if and wherever such third-party notices normally + appear. The contents of the NOTICE file are for informational purposes only + and do not modify the License. You may add Your own attribution notices + within Derivative Works that You distribute, alongside or as an addendum to + the NOTICE text from the Work, provided that such additional attribution + notices cannot be construed as modifying the License. + +You may add Your own copyright statement to Your modifications and may provide +additional or different license terms and conditions for use, reproduction, or +distribution of Your modifications, or for any such Derivative Works as a whole, +provided Your use, reproduction, and distribution of the Work otherwise complies +with the conditions stated in this License. + +## 5. Submission of Contributions. + +Unless You explicitly state otherwise, any Contribution intentionally submitted +for inclusion in the Work by You to the Licensor shall be under the terms and +conditions of this License, without any additional terms or conditions. +Notwithstanding the above, nothing herein shall supersede or modify the terms of +any separate license agreement you may have executed with Licensor regarding +such Contributions. + +## 6. Trademarks. + +This License does not grant permission to use the trade names, trademarks, +service marks, or product names of the Licensor, except as required for +reasonable and customary use in describing the origin of the Work and +reproducing the content of the NOTICE file. + +## 7. Disclaimer of Warranty. + +Unless required by applicable law or agreed to in writing, Licensor provides the +Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, +including, without limitation, any warranties or conditions of TITLE, NON- +INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are +solely responsible for determining the appropriateness of using or +redistributing the Work and assume any risks associated with Your exercise of +permissions under this License. + +## 8. Limitation of Liability. + +In no event and under no legal theory, whether in tort (including negligence), +contract, or otherwise, unless required by applicable law (such as deliberate +and grossly negligent acts) or agreed to in writing, shall any Contributor be +liable to You for damages, including any direct, indirect, special, incidental, +or consequential damages of any character arising as a result of this License or +out of the use or inability to use the Work (including but not limited to +damages for loss of goodwill, work stoppage, computer failure or malfunction, or +any and all other commercial damages or losses), even if such Contributor has +been advised of the possibility of such damages. + +## 9. Accepting Warranty or Additional Liability. + +While redistributing the Work or Derivative Works thereof, You may choose to +offer, and charge a fee for, acceptance of support, warranty, indemnity, or +other liability obligations and/or rights consistent with this License. However, +in accepting such obligations, You may act only on Your own behalf and on Your +sole responsibility, not on behalf of any other Contributor, and only if You +agree to indemnify, defend, and hold each Contributor harmless for any liability +incurred by, or claims asserted against, such Contributor by reason of your +accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +Copyright 2026, Алексей Сабилин . + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..08ee7a1 --- /dev/null +++ b/README.md @@ -0,0 +1,9 @@ +eventhub +===== + +An OTP application + +Build +----- + + $ rebar3 compile diff --git a/include/records.hrl b/include/records.hrl new file mode 100644 index 0000000..2ec14e1 --- /dev/null +++ b/include/records.hrl @@ -0,0 +1,160 @@ +%% =================================================================== +%% EventHub Records Definition +%% =================================================================== + +%% ------------------- Пользователи и аутентификация ------------------- +-record(user, { + id :: binary(), + email :: binary(), + password_hash :: binary(), + role :: user | admin, + status :: active | frozen | deleted, + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +-record(session, { + token :: binary(), % JWT или refresh токен + user_id :: binary(), + expires_at :: calendar:datetime(), + type :: access | refresh +}). + +%% ------------------- Календари --------------------------------------- +-record(calendar, { + id :: binary(), + owner_id :: binary(), + title :: binary(), + description :: binary(), + tags :: [binary()], + type :: personal | commercial, + confirmation :: auto | manual | {timeout, integer()}, % секунд + rating_avg :: float(), + rating_count :: non_neg_integer(), + status :: active | frozen | deleted, + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +-record(calendar_share, { + calendar_id :: binary(), + user_id :: binary(), + rights :: read | write | admin +}). + +-record(location, { + address :: binary(), + lat :: float(), + lon :: float() +}). + +%% ------------------- События (включая повторяющиеся) ---------------- +-record(event, { + id :: binary(), + calendar_id :: binary(), + title :: binary(), + description :: binary(), + event_type :: single | recurring, + start_time :: calendar:datetime(), + duration :: integer(), % минуты + recurrence_rule :: binary() | undefined, + master_id :: binary() | undefined, + is_instance :: boolean(), + specialist_id :: binary() | undefined, + location :: #location{} | undefined, + tags :: [binary()], + capacity :: integer() | undefined, + online_link :: binary() | undefined, + status :: active | cancelled | completed, + rating_avg :: float(), + rating_count :: non_neg_integer(), + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +-record(recurrence_exception, { + master_id :: binary(), + original_start :: calendar:datetime(), + action :: cancel | reschedule, + new_start :: calendar:datetime() | undefined +}). + +%% ------------------- Бронирования ------------------------------------ +-record(booking, { + id :: binary(), + event_id :: binary(), % ссылка на конкретный экземпляр события + user_id :: binary(), + status :: pending | confirmed | cancelled, + confirmed_at :: calendar:datetime() | undefined, + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +%% ------------------- Отзывы ------------------------------------------ +-record(review, { + id :: binary(), + user_id :: binary(), + target_type :: calendar | event, + target_id :: binary(), + rating :: 1..5, + comment :: binary(), + status :: visible | hidden | deleted, + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +%% ------------------- Жалобы и модерация ------------------------------ +-record(report, { + id :: binary(), + reporter_id :: binary(), + target_type :: calendar | event | review, + target_id :: binary(), + reason :: binary(), + status :: pending | reviewed | dismissed, + created_at :: calendar:datetime(), + resolved_at :: calendar:datetime() | undefined, + resolved_by :: binary() | undefined +}). + +-record(banned_word, { + id :: binary(), + word :: binary() +}). + +%% ------------------- Баг-трекер -------------------------------------- +-record(ticket, { + id :: binary(), + error_hash :: binary(), + error_message :: binary(), + stacktrace :: binary(), + count :: non_neg_integer(), + first_seen :: calendar:datetime(), + last_seen :: calendar:datetime(), + status :: open | in_progress | resolved | closed, + assigned_to :: binary() | undefined, + resolution_note :: binary() | undefined +}). + +%% ------------------- Подписки ---------------------------------------- +-record(subscription, { + id :: binary(), + user_id :: binary(), + plan :: monthly | quarterly | biannual | annual, + status :: active | expired | cancelled, + trial_used :: boolean(), + started_at :: calendar:datetime(), + expires_at :: calendar:datetime(), + created_at :: calendar:datetime(), + updated_at :: calendar:datetime() +}). + +%% ------------------- Аудит ------------------------------------------- +-record(audit_log, { + id :: binary(), + admin_id :: binary(), + action :: binary(), + target_type :: binary() | undefined, + target_id :: binary() | undefined, + details :: binary() | undefined, + created_at :: calendar:datetime() +}). \ No newline at end of file diff --git a/rebar.config b/rebar.config new file mode 100644 index 0000000..9138231 --- /dev/null +++ b/rebar.config @@ -0,0 +1,28 @@ +{erl_opts, [debug_info]}. +{deps, [ + {cowboy, "2.10.0"}, + {jsx, "3.1.0"}, + {jose, "1.11.10"}, + {argon2, "1.2.0"}, + {meck, "0.9.2"}, + {gun, "2.0.0"} +]}. + +{shell, [ + {apps, [eventhub]} +]}. + +{relx, [ + {release, {eventhub, "0.0.1"}, [eventhub, sasl]}, + {dev_mode, true}, + {include_erts, false}, + {extended_start_script, true} +]}. + +{profiles, [ + {test, [ + {deps, [ + {meck, "0.9.2"} + ]} + ]} +]}. \ No newline at end of file diff --git a/src/config/sys.config b/src/config/sys.config new file mode 100644 index 0000000..072024a --- /dev/null +++ b/src/config/sys.config @@ -0,0 +1,21 @@ +[ + {eventhub, [ + {http_port, 8080}, + {ws_port, 8081}, + {admin_http_port, 8445}, + {admin_ws_port, 8446}, + {jwt_secret, <<"change_me_in_production">>}, + {argon2_params, #{t_cost => 2, m_cost => 19, parallelism => 1}} + ]}, + {mnesia, [ + {dir, "Mnesia.${NODE}"} + ]}, + {kernel, [ + {logger_level, info}, + {logger, [ + {handler, default, logger_std_h, + #{formatter => {logger_formatter, #{template => [time, " ", level, ": ", msg, "\n"]}}} + } + ]} + ]} +]. \ No newline at end of file diff --git a/src/eventhub.app.src b/src/eventhub.app.src new file mode 100644 index 0000000..50e1145 --- /dev/null +++ b/src/eventhub.app.src @@ -0,0 +1,23 @@ +{application, eventhub, [ + {description, "Event Management Platform"}, + {vsn, "0.0.1"}, + {registered, []}, + {mod, {eventhub_app, []}}, + {applications, [ + kernel, + stdlib, + mnesia, + crypto, + cowboy, + jsx + ]}, + {env, [ + {http_port, 8080}, + {ws_port, 8081}, + {admin_http_port, 8445}, + {admin_ws_port, 8446} + ]}, + {modules, []}, + {licenses, ["Apache-2.0"]}, + {links, []} +]}. \ No newline at end of file diff --git a/src/eventhub_app.erl b/src/eventhub_app.erl new file mode 100644 index 0000000..04d9940 --- /dev/null +++ b/src/eventhub_app.erl @@ -0,0 +1,24 @@ +%% Основной модуль приложения +-module(eventhub_app). +-behaviour(application). + +-export([start/2, stop/1]). + +start(_StartType, _StartArgs) -> + % Запускаем Mnesia + application:ensure_all_started(mnesia), + + case infra_sup:start_link() of + {ok, Pid} -> + % Инициализируем таблицы и ждем готовности + ok = infra_mnesia:init_tables(), + ok = infra_mnesia:wait_for_tables(), + + % Здесь позже запустим HTTP-сервер и другие сервисы + {ok, Pid}; + Error -> + Error + end. + +stop(_State) -> + ok. \ No newline at end of file diff --git a/src/handlers/handler_health.erl b/src/handlers/handler_health.erl new file mode 100644 index 0000000..946b013 --- /dev/null +++ b/src/handlers/handler_health.erl @@ -0,0 +1,6 @@ +-module(handler_health). +-export([init/2]). + +init(Req, _Opts) -> + {ok, Resp} = cowboy_req:reply(200, #{<<"content-type">> => <<"application/json">>}, <<"{\"status\":\"ok\"}">>, Req), + Resp. \ No newline at end of file diff --git a/src/infra/infra_mnesia.erl b/src/infra/infra_mnesia.erl new file mode 100644 index 0000000..e2d429a --- /dev/null +++ b/src/infra/infra_mnesia.erl @@ -0,0 +1,135 @@ +-module(infra_mnesia). +-behaviour(gen_server). + +-include("records.hrl"). + +%% API +-export([start_link/0, init_tables/0, wait_for_tables/0]). +-export([init/1, handle_call/3, handle_cast/2, handle_info/2, terminate/2, code_change/3]). + +-define(TABLES, [ + user, session, calendar, calendar_share, event, recurrence_exception, + booking, review, report, banned_word, ticket, subscription, audit_log +]). + +start_link() -> + gen_server:start_link({local, ?MODULE}, ?MODULE, [], []). + +init_tables() -> + gen_server:call(?MODULE, init_tables). + +wait_for_tables() -> + gen_server:call(?MODULE, wait_for_tables). + +init([]) -> + {ok, #{}}. + +handle_call(init_tables, _From, State) -> + ok = ensure_schema(), + lists:foreach(fun create_table/1, ?TABLES), + {reply, ok, State}; +handle_call(wait_for_tables, _From, State) -> + mnesia:wait_for_tables(?TABLES, 5000), + {reply, ok, State}. + +handle_cast(_Msg, State) -> + {noreply, State}. + +handle_info(_Info, State) -> + {noreply, State}. + +terminate(_Reason, _State) -> + ok. + +code_change(_OldVsn, State, _Extra) -> + {ok, State}. + +%% Internal functions +ensure_schema() -> + case mnesia:create_schema([node()]) of + ok -> + ok; + {error, {Node, {already_exists, Node}}} -> + ok; + {error, {already_exists, _Node}} -> + ok; + {error, Reason} -> + error({schema_creation_failed, Reason}) + end. + +create_table(Table) -> + case mnesia:create_table(Table, table_opts(Table)) of + {atomic, ok} -> + ok; + {aborted, {already_exists, _}} -> + ok; + {aborted, Reason} -> + error({table_creation_failed, Table, Reason}) + end. + +%% Опции таблиц без индексов (добавим позже) +table_opts(user) -> + [ + {attributes, record_info(fields, user)}, + {ram_copies, [node()]} + ]; +table_opts(session) -> + [ + {attributes, record_info(fields, session)}, + {ram_copies, [node()]} + ]; +table_opts(calendar) -> + [ + {attributes, record_info(fields, calendar)}, + {ram_copies, [node()]} + ]; +table_opts(calendar_share) -> + [ + {attributes, record_info(fields, calendar_share)}, + {ram_copies, [node()]} + ]; +table_opts(event) -> + [ + {attributes, record_info(fields, event)}, + {ram_copies, [node()]} + ]; +table_opts(recurrence_exception) -> + [ + {attributes, record_info(fields, recurrence_exception)}, + {ram_copies, [node()]} + ]; +table_opts(booking) -> + [ + {attributes, record_info(fields, booking)}, + {ram_copies, [node()]} + ]; +table_opts(review) -> + [ + {attributes, record_info(fields, review)}, + {ram_copies, [node()]} + ]; +table_opts(report) -> + [ + {attributes, record_info(fields, report)}, + {ram_copies, [node()]} + ]; +table_opts(banned_word) -> + [ + {attributes, record_info(fields, banned_word)}, + {ram_copies, [node()]} + ]; +table_opts(ticket) -> + [ + {attributes, record_info(fields, ticket)}, + {ram_copies, [node()]} + ]; +table_opts(subscription) -> + [ + {attributes, record_info(fields, subscription)}, + {ram_copies, [node()]} + ]; +table_opts(audit_log) -> + [ + {attributes, record_info(fields, audit_log)}, + {ram_copies, [node()]} + ]. \ No newline at end of file diff --git a/src/infra/infra_sup.erl b/src/infra/infra_sup.erl new file mode 100644 index 0000000..36571b4 --- /dev/null +++ b/src/infra/infra_sup.erl @@ -0,0 +1,28 @@ +%% Супервизор верхнего уровня +-module(infra_sup). +-behaviour(supervisor). + +-export([start_link/0]). +-export([init/1]). + +start_link() -> + supervisor:start_link({local, ?MODULE}, ?MODULE, []). + +init([]) -> + SupFlags = #{strategy => one_for_one, intensity => 5, period => 10}, + + Mnesia = #{ + id => infra_mnesia, + start => {infra_mnesia, start_link, []}, + restart => permanent, + shutdown => 5000, + type => worker, + modules => [infra_mnesia] + }, + + % Временная заглушка для HTTP-сервера (будет добавлен позже) + % Cowboy = #{...} + + ChildSpecs = [Mnesia], + + {ok, {SupFlags, ChildSpecs}}. \ No newline at end of file