zinc-baby System Requirements Document

Introduction

The "zinc-baby" project is an AI-powered parenting assistant designed to support both new parents and caregivers in managing and enhancing the care of infants and young children. The application focuses on personalized child profiles to provide tailored recommendations and reminders, thereby streamlining the parenting experience.

System Overview

The zinc-baby application aims to offer a comprehensive suite of tools for parents and caregivers, including a baby meal planner, sleep tracker, vaccine reminders, AI chatbot, growth charts, and offline sync capabilities. By leveraging AI, the app provides personalized insights and recommendations based on each child's unique profile, which includes details such as birthdate, name, allergies, and sleeping routines.

Functional Requirements

• As a User, I should be able to create and manage personalized profiles for each child, including details like birthdate, name, allergies, and sleeping routines.
• As a User, I should be able to access a baby meal planner that provides recommendations based on the child's age and dietary needs.
• As a User, I should be able to track my child's sleep patterns and receive insights on improving sleep routines.
• As a User, I should receive reminders for upcoming vaccines based on my child's age and health guidelines.
• As a User, I should be able to interact with an AI chatbot for parenting advice and support.
• As a User, I should be able to view and track my child's growth charts over time.
• As a User, I should be able to sync data offline and have it update once connected to the internet.

User Personas

• New Parent: Individuals who have recently become parents and are seeking guidance and tools to manage their child's needs effectively.
• Caregiver: Professionals or family members who assist in the care of children and require tools to ensure consistent and informed care.

Visuals Colors and Theme

• primary: #4A90E2 (a calming blue to represent trust and reliability)
• primary_light: #A6C8F0 (a lighter tint of the primary color for hover states)
• secondary: #F5A623 (a warm orange for emphasis and highlights)
• accent: #E94E77 (a vibrant pink for call-to-action buttons and active states)
• highlight: #F8E71C (a bright yellow for notifications and alerts)
• bg: #FFFFFF (a clean white background for clarity)
• surface: rgba(255, 255, 255, 0.9) (a slightly opaque white for cards and panels)
• text: #333333 (a dark gray for primary text)
• text_muted: #777777 (a softer gray for secondary text and labels)
• border: rgba(200, 200, 200, 0.5) (a subtle gray for borders)

Signature Design Concept

The zinc-baby app will feature an interactive "Nursery Room" homepage. This virtual room will allow users to navigate through different features by interacting with objects within the room. For example, clicking on a crib will open the sleep tracker, while a high chair will lead to the meal planner. The room will have a day-night cycle, with lighting and colors changing based on the time of day, creating an immersive experience. The design will utilize @react-three/fiber for 3D interactions and gsap for smooth transitions and animations.

Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, providing a layered depth effect as users scroll through the page. Decorative elements like clouds and toys will move at different speeds to create a dynamic and engaging experience. Internal pages, such as profiles and settings, will use a "static" model to ensure clarity and ease of use.

Non-Functional Requirements

• The application must support both online and offline modes, with data syncing automatically when an internet connection is available.
• The app should be responsive and accessible on both mobile and desktop devices.
• Data security and privacy must be ensured, especially concerning children's personal information.

Tech Stack

• Frontend: React for Web
• Backend: Python with FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing
• Local Orchestration: Docker and docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The application will primarily target users in India, considering local time zones and cultural preferences.
• The app will require periodic updates to incorporate new parenting guidelines and health recommendations.
• The system must handle multiple user profiles efficiently without performance degradation.

Glossary

• AI: Artificial Intelligence
• LLM: Large Language Model
• API: Application Programming Interface
• RDBMS: Relational Database Management System
• UI: User Interface
• UX: User Experience