feat(api,web): tier-based session limits and daily turn usage display

Backend Changes: - Add tier-based max_sessions config (free: 1, basic: 2, premium: 3, elite: 5) - Add DELETE /api/v1/sessions/{id} endpoint for hard session deletion - Cascade delete chat messages when session is deleted - Add GET /api/v1/usage endpoint for daily turn limit info - Replace hardcoded TIER_LIMITS with config-based ai_calls_per_day - Handle unlimited (-1) tier in rate limiter service Frontend Changes: - Add inline session delete buttons with HTMX on character list - Add usage_display.html component showing remaining daily turns - Display usage indicator on character list and game play pages - Page refresh after session deletion to update UI state Documentation: - Update API_REFERENCE.md with new endpoints and tier limits - Update API_TESTING.md with session endpoint examples - Update SESSION_MANAGEMENT.md with tier-based limits 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-26 10:00:45 -06:00
parent 0a7156504f
commit 61a42d3a77
15 changed files with 768 additions and 59 deletions
--- a/public_web/app/views/character_views.py
+++ b/public_web/app/views/character_views.py
@@ -456,6 +456,14 @@ def list_characters():
            char_id = character.get('character_id')
            character['sessions'] = sessions_by_character.get(char_id, [])

+        # Fetch usage info for daily turn limits
+        usage_info = {}
+        try:
+            usage_response = api_client.get("/api/v1/usage")
+            usage_info = usage_response.get('result', {})
+        except (APIError, APINotFoundError) as e:
+            logger.debug("Could not fetch usage info", error=str(e))
+
        logger.info(
            "Characters listed",
            user_id=user.get('id'),
@@ -468,18 +476,46 @@ def list_characters():
            characters=characters,
            current_tier=current_tier,
            max_characters=max_characters,
-            can_create=can_create
+            can_create=can_create,
+            # Usage display variables
+            remaining=usage_info.get('remaining', 0),
+            daily_limit=usage_info.get('daily_limit', 0),
+            is_limited=usage_info.get('is_limited', False),
+            is_unlimited=usage_info.get('is_unlimited', False),
+            reset_time=usage_info.get('reset_time', '')
        )

    except APITimeoutError:
        logger.error("API timeout while listing characters", user_id=user.get('id'))
        flash('Request timed out. Please try again.', 'error')
-        return render_template('character/list.html', characters=[], can_create=False)
+        return render_template(
+            'character/list.html',
+            characters=[],
+            can_create=False,
+            current_tier='free',
+            max_characters=1,
+            remaining=0,
+            daily_limit=0,
+            is_limited=False,
+            is_unlimited=False,
+            reset_time=''
+        )

    except APIError as e:
        logger.error("Failed to list characters", user_id=user.get('id'), error=str(e))
        flash('An error occurred while loading your characters.', 'error')
-        return render_template('character/list.html', characters=[], can_create=False)
+        return render_template(
+            'character/list.html',
+            characters=[],
+            can_create=False,
+            current_tier='free',
+            max_characters=1,
+            remaining=0,
+            daily_limit=0,
+            is_limited=False,
+            is_unlimited=False,
+            reset_time=''
+        )


@character_bp.route('/<character_id>')
@@ -613,6 +649,58 @@ def create_session(character_id: str):
        return redirect(url_for('character_views.list_characters'))


+@character_bp.route('/sessions/<session_id>/delete', methods=['DELETE'])
+@require_auth_web
+def delete_session(session_id: str):
+    """
+    Delete a game session via HTMX.
+
+    This permanently removes the session from the database.
+    Returns a response that triggers page refresh to update UI properly
+    (handles "Continue Playing" button visibility).
+
+    Args:
+        session_id: ID of the session to delete
+    """
+    from flask import make_response
+
+    user = get_current_user()
+    api_client = get_api_client()
+
+    try:
+        api_client.delete(f"/api/v1/sessions/{session_id}")
+
+        logger.info(
+            "Session deleted via web UI",
+            user_id=user.get('id'),
+            session_id=session_id
+        )
+
+        # Return empty response with HX-Refresh to reload the page
+        # This ensures "Continue Playing" button visibility is correct
+        response = make_response('', 200)
+        response.headers['HX-Refresh'] = 'true'
+        return response
+
+    except APINotFoundError:
+        logger.warning(
+            "Session not found for deletion",
+            user_id=user.get('id'),
+            session_id=session_id
+        )
+        # Return error message that HTMX can display
+        return '<span class="error-message">Session not found</span>', 404
+
+    except APIError as e:
+        logger.error(
+            "Failed to delete session",
+            user_id=user.get('id'),
+            session_id=session_id,
+            error=str(e)
+        )
+        return '<span class="error-message">Failed to delete session</span>', 500
+
+
@character_bp.route('/<character_id>/skills')
@require_auth_web
 def view_skills(character_id: str):
--- a/public_web/app/views/game_views.py
+++ b/public_web/app/views/game_views.py
@@ -201,6 +201,14 @@ def play_session(session_id: str):
        # Get user tier
        user_tier = _get_user_tier(client)

+        # Fetch usage info for daily turn limits
+        usage_info = {}
+        try:
+            usage_response = client.get("/api/v1/usage")
+            usage_info = usage_response.get('result', {})
+        except (APINotFoundError, APIError) as e:
+            logger.debug("could_not_fetch_usage_info", error=str(e))
+
        # Build session object for template
        session = {
            'session_id': session_id,
@@ -220,7 +228,13 @@ def play_session(session_id: str):
            npcs=npcs,
            discovered_locations=discovered_locations,
            actions=DEFAULT_ACTIONS,
-            user_tier=user_tier
+            user_tier=user_tier,
+            # Usage display variables
+            remaining=usage_info.get('remaining', 0),
+            daily_limit=usage_info.get('daily_limit', 0),
+            is_limited=usage_info.get('is_limited', False),
+            is_unlimited=usage_info.get('is_unlimited', False),
+            reset_time=usage_info.get('reset_time', '')
        )

    except APINotFoundError:
@@ -259,13 +273,27 @@ def character_panel(session_id: str):
        character = _build_character_from_api(char_data)
        user_tier = _get_user_tier(client)

+        # Fetch usage info for daily turn limits
+        usage_info = {}
+        try:
+            usage_response = client.get("/api/v1/usage")
+            usage_info = usage_response.get('result', {})
+        except (APINotFoundError, APIError) as e:
+            logger.debug("could_not_fetch_usage_info", error=str(e))
+
        return render_template(
            'game/partials/character_panel.html',
            session_id=session_id,
            character=character,
            location=location,
            actions=DEFAULT_ACTIONS,
-            user_tier=user_tier
+            user_tier=user_tier,
+            # Usage display variables
+            remaining=usage_info.get('remaining', 0),
+            daily_limit=usage_info.get('daily_limit', 0),
+            is_limited=usage_info.get('is_limited', False),
+            is_unlimited=usage_info.get('is_unlimited', False),
+            reset_time=usage_info.get('reset_time', '')
        )
    except APIError as e:
        logger.error("failed_to_refresh_character_panel", session_id=session_id, error=str(e))
--- a/public_web/templates/character/list.html
+++ b/public_web/templates/character/list.html
@@ -10,6 +10,7 @@
            <p class="page-subtitle">
                {{ characters|length }} of {{ max_characters }} characters
                <span class="tier-badge">{{ current_tier|upper }}</span>
+                {% include 'components/usage_display.html' %}
            </p>
        </div>
        <div class="header-right">
@@ -63,10 +64,21 @@
                        </div>
                        <div class="sessions-list">
                            {% for sess in character.sessions[:3] %}
-                            <a href="{{ url_for('game.play_session', session_id=sess.session_id) }}" class="session-link">
-                                <span class="session-turn">Turn {{ sess.turn_number or 0 }}</span>
-                                <span class="session-status {{ sess.status or 'active' }}">{{ sess.status or 'active' }}</span>
-                            </a>
+                            <div class="session-item" id="session-{{ sess.session_id }}">
+                                <a href="{{ url_for('game.play_session', session_id=sess.session_id) }}" class="session-link">
+                                    <span class="session-turn">Turn {{ sess.turn_number or 0 }}</span>
+                                    <span class="session-status {{ sess.status or 'active' }}">{{ sess.status or 'active' }}</span>
+                                </a>
+                                <button
+                                    hx-delete="{{ url_for('character_views.delete_session', session_id=sess.session_id) }}"
+                                    hx-confirm="Delete this session? This action cannot be undone."
+                                    hx-target="#session-{{ sess.session_id }}"
+                                    hx-swap="outerHTML"
+                                    class="btn-delete-session"
+                                    title="Delete Session">
+                                    &times;
+                                </button>
+                            </div>
                            {% endfor %}
                            {% if character.sessions|length > 3 %}
                            <span class="sessions-more">+{{ character.sessions|length - 3 }} more</span>
@@ -328,6 +340,35 @@
    background: var(--bg-secondary);
 }

+.session-item {
+    display: flex;
+    align-items: center;
+    gap: 0.25rem;
+}
+
+.btn-delete-session {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 20px;
+    height: 20px;
+    padding: 0;
+    background: transparent;
+    border: 1px solid var(--accent-red);
+    border-radius: 3px;
+    color: var(--accent-red);
+    font-size: 14px;
+    font-weight: bold;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    line-height: 1;
+}
+
+.btn-delete-session:hover {
+    background: var(--accent-red);
+    color: var(--text-primary);
+}
+
 .session-turn {
    font-size: var(--text-xs);
    color: var(--text-primary);
--- a/public_web/templates/components/usage_display.html
+++ b/public_web/templates/components/usage_display.html
@@ -0,0 +1,83 @@
+{# Daily Usage Indicator Component
+
+   Required template variables:
+   - remaining: Number of turns remaining (-1 if unlimited)
+   - daily_limit: Daily turn limit (-1 if unlimited)
+   - is_limited: Boolean, true if limit reached
+   - is_unlimited: Boolean, true if user has unlimited turns
+   - reset_time: ISO timestamp of when limit resets (optional)
+#}
+
+<div class="daily-usage-indicator">
+    {% if is_unlimited %}
+        <span class="usage-badge unlimited">
+            <span class="usage-icon">&#9889;</span>
+            <span class="usage-text">Unlimited Turns</span>
+        </span>
+    {% elif is_limited %}
+        <span class="usage-badge limited">
+            <span class="usage-icon">&#9888;</span>
+            <span class="usage-text">Limit Reached</span>
+        </span>
+    {% else %}
+        <span class="usage-badge normal">
+            <span class="usage-icon">&#9201;</span>
+            <span class="usage-count">{{ remaining }}/{{ daily_limit }}</span>
+            <span class="usage-label">turns today</span>
+        </span>
+    {% endif %}
+</div>
+
+<style>
+.daily-usage-indicator {
+    display: inline-flex;
+    align-items: center;
+}
+
+.usage-badge {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.4rem;
+    padding: 0.35rem 0.75rem;
+    border-radius: 12px;
+    font-size: var(--text-xs);
+    font-weight: 600;
+    white-space: nowrap;
+}
+
+.usage-badge.normal {
+    background: var(--bg-input);
+    border: 1px solid var(--border-primary);
+    color: var(--text-secondary);
+}
+
+.usage-badge.limited {
+    background: rgba(239, 68, 68, 0.15);
+    border: 1px solid var(--accent-red);
+    color: var(--accent-red);
+}
+
+.usage-badge.unlimited {
+    background: rgba(212, 175, 55, 0.15);
+    border: 1px solid var(--accent-gold);
+    color: var(--accent-gold);
+}
+
+.usage-icon {
+    font-size: 0.9rem;
+}
+
+.usage-count {
+    font-family: var(--font-mono);
+    color: var(--text-primary);
+}
+
+.usage-label {
+    color: var(--text-muted);
+}
+
+.usage-text {
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+}
+</style>
--- a/public_web/templates/game/partials/character_panel.html
+++ b/public_web/templates/game/partials/character_panel.html
@@ -10,6 +10,9 @@ Displays character stats, resource bars, and action buttons
            <span class="character-class">{{ character.class_name }}</span>
            <span class="character-level">Level {{ character.level }}</span>
        </div>
+        <div class="character-usage">
+            {% include 'components/usage_display.html' %}
+        </div>
    </div>

    {# Resource Bars #}