EpochtalkServer.Models.UserActivity.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="x-ua-compatible" content="ie=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="generator" content="ExDoc v0.37.2">
    <meta name="project" content="epochtalk_server v0.1.0">


    <title>EpochtalkServer.Models.UserActivity — epochtalk_server v0.1.0</title>

    <link rel="stylesheet" href="dist/html-elixir-6X3L5KMG.css" />

    <script defer src="dist/sidebar_items-C8922E45.js"></script>
    <script defer src="docs_config.js"></script>
    <script defer src="dist/html-6XHBGSGW.js"></script>

  </head>
  <body>
    <script>(()=>{var t="ex_doc:settings",e="dark";var o="dark",s="light";var E="sidebar_state",n="closed";var r="sidebar_width";var a="sidebar-open";var i=new URLSearchParams(window.location.search),S=i.get("theme")||JSON.parse(localStorage.getItem(t)||"{}").theme;(S===o||S!==s&&window.matchMedia("(prefers-color-scheme: dark)").matches)&&document.body.classList.add(e);var d=sessionStorage.getItem(E),A=d!==n&&!window.matchMedia(`screen and (max-width: ${768}px)`).matches;document.body.classList.toggle(a,A);var c=sessionStorage.getItem(r);c&&document.body.style.setProperty("--sidebarWidth",`${c}px`);var p=/(Macintosh|iPhone|iPad|iPod)/.test(window.navigator.userAgent);document.documentElement.classList.toggle("apple-os",p);})();
</script>

<div class="body-wrapper">

<button id="sidebar-menu" class="sidebar-button sidebar-toggle" aria-label="toggle sidebar" aria-controls="sidebar">
  <i class="ri-menu-line ri-lg" title="Collapse/expand sidebar"></i>
</button>

<nav id="sidebar" class="sidebar">

  <div class="sidebar-header">
    <div class="sidebar-projectInfo">

      <div>
        <a href="api-reference.html" class="sidebar-projectName" translate="no">
epochtalk_server
        </a>
        <div class="sidebar-projectVersion" translate="no">
          v0.1.0
        </div>
      </div>
    </div>
    <ul id="sidebar-list-nav" class="sidebar-list-nav" role="tablist" data-extras=""></ul>
  </div>
</nav>

<output role="status" id="toast"></output>

<main class="content page-module" id="main" data-type="modules">
  <div id="content" class="content-inner">
    <div class="top-search">
      <div class="search-settings">
        <form class="search-bar" action="search.html">
          <label class="search-label">
            <span class="sr-only">Search documentation of epochtalk_server</span>
            <input name="q" type="text" class="search-input" placeholder="Press / to search" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" />
          </label>
          <button type="submit" class="search-button" aria-label="Submit Search" tabindex="-1">
            <i class="ri-search-2-line ri-lg" aria-hidden="true"></i>
          </button>
          <button type="button" tabindex="-1" class="search-close-button" aria-hidden="true">
            <i class="ri-close-line ri-lg" title="Cancel search"></i>
          </button>
        </form>
        <div class="autocomplete">
        </div>
        <button class="icon-settings display-settings">
          <i class="ri-settings-3-line"></i>
          <span class="sr-only">Settings</span>
        </button>
      </div>
    </div>

<div id="top-content">
  <div class="heading-with-actions top-heading">
    <h1>
      <span translate="no">EpochtalkServer.Models.UserActivity</span> 
      <small class="app-vsn" translate="no">(epochtalk_server v0.1.0)</small>

    </h1>

  </div>


    <section id="moduledoc">
<p><code class="inline">UserActivity</code> model, for performing actions relating to <code class="inline">UserActivity</code></p>
    </section>

</div>

  <section id="summary" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#summary">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Summary</span>
    </h1>
<div class="summary-types summary">
  <h2>
    <a href="#types">Types</a>
  </h2>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#t:t/0" data-no-tooltip="" translate="no">t()</a>

      </div>

    </div>

</div>
<div class="summary-functions summary">
  <h2>
    <a href="#functions">Functions</a>
  </h2>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#append_user_activity_to_posts/1" data-no-tooltip="" translate="no">append_user_activity_to_posts(posts)</a>

      </div>

        <div class="summary-synopsis"><p>Appends <code class="inline">UserActivity</code> data to list of <code class="inline">Post</code></p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#get_by_user_id/1" data-no-tooltip="" translate="no">get_by_user_id(user_id)</a>

      </div>

        <div class="summary-synopsis"><p>Used to get the <code class="inline">UserActivity</code> for a specific <code class="inline">User</code></p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#update/1" data-no-tooltip="" translate="no">update(user_id)</a>

      </div>

        <div class="summary-synopsis"><p>Updates <code class="inline">UserActivity</code> using the following algorithm</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#update_user_activity/1" data-no-tooltip="" translate="no">update_user_activity(user)</a>

      </div>

        <div class="summary-synopsis"><p>Used to update <code class="inline">UserActivity</code> upon creating a <code class="inline">Post</code> or <code class="inline">Thread</code>. Removes newbie
<code class="inline">Role</code> from <code class="inline">User</code> if activity reaches 30 or greater. Sends websocket notification
to reauthenticate <code class="inline">User</code> after <code class="inline">Role</code> is removed.</p></div>

    </div>

</div>

  </section>


  <section id="types" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#types">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Types</span>
    </h1>
    <div class="types-list">
<section class="detail" id="t:t/0">

  <div class="detail-header">
    <a href="#t:t/0" class="detail-link" data-no-tooltip="" aria-label="Link to this type">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">t()</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@type</span> t() :: %EpochtalkServer.Models.UserActivity{
  __meta__: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  current_period_offset: <a href="https://hexdocs.pm/elixir/NaiveDateTime.html#t:t/0">NaiveDateTime.t</a>() | nil,
  current_period_start: <a href="https://hexdocs.pm/elixir/NaiveDateTime.html#t:t/0">NaiveDateTime.t</a>() | nil,
  remaining_period_activity: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>() | nil,
  total_activity: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>() | nil,
  user: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  user_id: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>() | nil
}</pre>

      </div>


  </section>
</section>

    </div>
  </section>

  <section id="functions" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#functions">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Functions</span>
    </h1>
    <div class="functions-list">
<section class="detail" id="append_user_activity_to_posts/1">

  <div class="detail-header">
    <a href="#append_user_activity_to_posts/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">append_user_activity_to_posts(posts)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> append_user_activity_to_posts(posts :: []) :: posts :: []</pre>

      </div>

<p>Appends <code class="inline">UserActivity</code> data to list of <code class="inline">Post</code></p>
  </section>
</section>
<section class="detail" id="get_by_user_id/1">

  <div class="detail-header">
    <a href="#get_by_user_id/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">get_by_user_id(user_id)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> get_by_user_id(user_id :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>()) ::
  user_activity :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>()</pre>

      </div>

<p>Used to get the <code class="inline">UserActivity</code> for a specific <code class="inline">User</code></p>
  </section>
</section>
<section class="detail" id="update/1">

  <div class="detail-header">
    <a href="#update/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">update(user_id)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> update(user_id :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>()) :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>() | :ok | :error</pre>

      </div>

<p>Updates <code class="inline">UserActivity</code> using the following algorithm</p><ol><li>Is current_period_start null, if so populate current_period_start and current_period_offset with user registration date</li><li>check if current date is past (current_period_start + 14) if so update current_period_start and remaining_period_activity set to 14 and set current_period_offset to match start</li><li>query remaining_period_activity if 0 then return else move to step 4</li></ol><h1>algorithm</h1><ol start="4"><li><p>current_period_offset - (current_period_start + 14 days) postsFound = (Query posts between this time for user)</p></li><li><p>if (postsFound &gt;= remaining_period_activity) {
  total_activity += remaining_period_activity;
  remaining_period_activity = 0;
}
else {
 total_activity += postsFound;
 remaining_period_activity = remaining_period_activity - postsFound;
}</p></li><li><p>update total_activity, remaining_period_activity current_period_offset</p></li></ol>
  </section>
</section>
<section class="detail" id="update_user_activity/1">

  <div class="detail-header">
    <a href="#update_user_activity/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">update_user_activity(user)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> update_user_activity(user :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>()) :: :ok</pre>

      </div>

<p>Used to update <code class="inline">UserActivity</code> upon creating a <code class="inline">Post</code> or <code class="inline">Thread</code>. Removes newbie
<code class="inline">Role</code> from <code class="inline">User</code> if activity reaches 30 or greater. Sends websocket notification
to reauthenticate <code class="inline">User</code> after <code class="inline">Role</code> is removed.</p>
  </section>
</section>

    </div>
  </section>

    <footer class="footer">
      <p>

        <span class="line">
          <button class="a-main footer-button display-quick-switch" title="Search HexDocs packages">
            Search HexDocs
          </button>

            <a href="epochtalk_server.epub" title="ePub version">
              Download ePub version
            </a>

        </span>
      </p>

      <p class="built-using">
        Built using
        <a href="https://github.com/elixir-lang/ex_doc" title="ExDoc" target="_blank" rel="help noopener" translate="no">ExDoc</a> (v0.37.2) for the

          <a href="https://elixir-lang.org" title="Elixir" target="_blank" translate="no">Elixir programming language</a>

      </p>

    </footer>
  </div>
</main>
</div>

  </body>
</html>