marine-idea

Introduction

The "marine-idea" project aims to develop a healthcare chatbot that provides users with health-related information. This document outlines the system requirements for the MVP phase of the project, focusing on a Q&A chatbot that addresses user inquiries about health information.

System Overview

The "marine-idea" project is designed to offer users a seamless experience in obtaining health-related information through a chatbot interface. The MVP phase will focus on developing a Q&A chatbot that can understand user queries and provide accurate health information. The system will leverage AI models to ensure responses are relevant and user-friendly.

Functional Requirements

• As a User, I should be able to ask health-related questions to the chatbot.
• As a User, I should receive accurate and concise health information in response to my queries.
• As a User, I should be able to interact with the chatbot in a conversational manner.
• As a User, I should receive responses in a timely manner.

User Personas

• User: Individuals seeking health-related information through the chatbot interface.

Core User Flows

1. User opens the chatbot interface.
2. User types a health-related question.
3. Chatbot processes the query using AI models.
4. Chatbot provides a response with relevant health information.
5. User reads the response and may ask follow-up questions.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F97316 (Vibrant Orange)
• accent: #10B981 (Emerald Green)
• highlight: #F59E0B (Amber)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.2) (Light Gray)

Signature Design Concept

The homepage of the "marine-idea" chatbot will feature an interactive ocean-themed interface. Users will navigate through a virtual underwater world where each section of the chatbot is represented by different marine life. For instance, clicking on a dolphin will open the Q&A section, while a sea turtle might represent user settings. The interface will use @react-three/fiber for 3D effects and framer-motion for smooth transitions, creating an immersive experience that feels like diving into an ocean of knowledge.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, creating a layered depth effect as users scroll through the page. Marine life and oceanic elements will move at different speeds, enhancing the storytelling aspect of the interface. This approach will make the first impression visually rich and engaging, perfect for a healthcare chatbot that aims to provide a calming and informative experience.

Non-Functional Requirements

• The system should ensure data privacy and security for all user interactions.
• The chatbot should be available 24/7 to answer user queries.
• The system should be scalable to handle multiple user interactions simultaneously.

Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MongoDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The chatbot will initially support English language queries.
• The MVP phase will focus on providing general health information and not personalized medical advice.
• The system will rely on existing health databases and AI models for information accuracy.

Glossary

• MVP: Minimum Viable Product
• Q&A: Question and Answer
• AI: Artificial Intelligence
• LLM: Large Language Model

This document outlines the requirements for the MVP phase of the "marine-idea" project, focusing on developing a health-info Q&A chatbot.