feral-project

As a user, I want to use a Landing page that showcases the Feral-Project self-help platform so that I can explore features and navigate to Login or Register. Implement based on the existing Landing (v2) JSX design. Page includes: hero section with mood gradient, feature highlights (habit tracker, journal, goals, fitness, mental health), CTA buttons linking to /Login. Flows from: entry point. Flows to: /Login.

As a user, I want to use a Login page so that I can sign in or register for the platform. Implement based on existing Login (v2) JSX design. Includes: sign in form, register link, OAuth placeholder, error validation with accent color (#FF6B7A). Flows from: /Landing. Flows to: /Dashboard (user) or /Admin Dashboard (admin).

As a user, I want to use a Dashboard page so that I can view my overview, track mood, and navigate to Habits, Journal, Goals, and Community. Implement based on existing Dashboard (v1) JSX design. Includes: mood tracker with interactive gradient, stats summary cards, quick-nav tiles to all tools (habit tracker, journal, goals, fitness, mental health, to-do, picture journal). Flows from: /Login. Flows to: /Habits, /Journal, /Goals, /Community.

As a user, I want to use a Habits page so that I can log habits and view my progress. Implement based on existing Habits (v2) JSX design. Includes: active habits list, habit log form, progress charts, streak badges, habit library with pre-built templates, community insights. Flows from: /Dashboard. Flows to: /Dashboard (View Progress).

As a user, I want to use a Journal page so that I can write personal reflection entries and maintain a picture journal. Implement based on existing Journal (v1) JSX design. Includes: text journal editor, picture journal (photo upload grid), entry history list, mood tagging. Flows from: /Dashboard. Flows to: /Dashboard.

As a user, I want to use a Goals page so that I can set and track personal goals. Implement based on existing Goals (v1) JSX design. Includes: goal creation form, active goals list with progress bars, milestone tracker, completed goals archive. Flows from: /Dashboard. Flows to: /Dashboard.

As a user, I want to use a Community page so that I can browse forums and share experiences. Implement based on existing Community (v1) JSX design. Includes: forum categories, thread list, post creation, likes/comments, trending topics. Flows from: /Dashboard. Flows to: /Dashboard. Admin can moderate from this page.

As a user, I want to use an Articles page so that I can read self-help articles categorized by topics. Implement based on existing Articles (v1) JSX design. Includes: article grid with category filters (Mental Health, Fitness, Productivity, Mindfulness), featured articles carousel, search bar, newsletter signup. As an admin, I can manage and publish articles. Flows from: /Landing, /Admin Dashboard. Flows to: individual article view.

As an admin, I want to use an Admin Dashboard page so that I can view analytics, monitor users, and manage content. Implement based on existing Admin Dashboard (v1) JSX design. Includes: engagement analytics charts, user activity monitoring, article management panel, forum moderation tools. Flows from: /Login (admin). Flows to: /Users, /Articles, /Community.

As an admin, I want to use a Users management page so that I can manage user accounts. Implement based on existing Users (v1) JSX design. Includes: user list with search/filter, account status toggles (active/suspended), role assignment, user detail view. Flows from: /Admin Dashboard. Flows to: /Admin Dashboard.

As a user, I want to use a backend API for habits so that I can create, log, update, and retrieve habits and streak data. Endpoints: POST /api/habits, GET /api/habits, POST /api/habits/{id}/log, GET /api/habits/{id}/progress, GET /api/habits/library. Built with FastAPI + MySQL via Alembic migrations.

As a user, I want to use a backend API for journals so that I can create, retrieve, update, and delete journal and picture journal entries. Endpoints: POST /api/journal, GET /api/journal, PUT /api/journal/{id}, DELETE /api/journal/{id}, POST /api/journal/picture. Built with FastAPI + MySQL.

As a user, I want to use a backend API for goals so that I can set, update, track progress, and complete personal goals. Endpoints: POST /api/goals, GET /api/goals, PUT /api/goals/{id}, DELETE /api/goals/{id}, POST /api/goals/{id}/milestone. Built with FastAPI + MySQL.

As a user, I want to use a backend API for community forums so that I can create posts, comment, like, and browse forum threads. Endpoints: GET /api/community/threads, POST /api/community/threads, POST /api/community/threads/{id}/comment, POST /api/community/threads/{id}/like. Admin moderation endpoints included. Built with FastAPI + MySQL.

As a user, I want to use a backend API for articles so that I can retrieve, filter, and search self-help articles by category. Admin endpoints for creating, updating, publishing, and deleting articles. Endpoints: GET /api/articles, GET /api/articles/{id}, POST /api/articles (admin), PUT /api/articles/{id} (admin), DELETE /api/articles/{id} (admin). Built with FastAPI + MySQL.

As an admin, I want to use a backend API for analytics so that I can view user engagement metrics and website performance data. Endpoints: GET /api/admin/analytics/users, GET /api/admin/analytics/engagement, GET /api/admin/analytics/performance. Built with FastAPI + MySQL, aggregates user activity logs.

As a user, I want to use a backend API for newsletter subscription so that I can subscribe and receive updates and self-help tips. Endpoints: POST /api/newsletter/subscribe, DELETE /api/newsletter/unsubscribe. Stores email preferences in MySQL. Integrates with email service provider.

As a user, I want to use an AI-powered mood assistant so that I can receive personalized self-help responses based on my mood input. Integrates LiteLLM router with GPT for friendly responses and Claude for deeper wellness guidance. Endpoints: POST /api/ai/mood-response. Uses Langchain for prompt orchestration.