Hexis-formulation System Requirements Document

1. Introduction

The Hexis-formulation project aims to develop a SaaS tool that provides an AI-assisted formulation copilot for small labs. This tool focuses on stability prediction, ingredient substitution, and cost optimization, specifically catering to small R&D teams, freelance formulators, and contract manufacturers. The project seeks to offer affordable access to AI formulation tools, which are typically enterprise-focused.

2. System Overview

2a. Product Interpretation and Delivery Boundary

• Domain Descriptor: AI-driven formulation optimization

  • Source Evidence: The product aims to provide AI-assisted tools for formulation tasks, specifically targeting stability prediction, ingredient substitution, and cost optimization.
  • Confidence: 0.9

• What is being built: An AI-assisted formulation copilot for small labs focusing on stability prediction, ingredient substitution, and cost optimization.

• Excluded Assumptions: Generic enterprise PLM features and conventional e-commerce modules are not included.

• Custom Pages:

  • AI-assisted formulation copilot: Core functionality for small labs to predict stability, suggest ingredient substitutions, and optimize costs.
  • Landing: A public entry surface to orient and acquire users.
  • Authentication: A combined surface for sign-up, login, and session entry.

• Access: Application-owned identity is required for protected access to the AI-assisted formulation copilot.

• Behavior Contracts:

  • Stability Prediction: Initiated by small R&D teams to generate a stability report from formulation data. The outcome is a durable stability analysis record.
  • Ingredient Substitution Suggestion: Triggered by freelance formulators to receive substitution suggestions based on the current ingredient list.
  • Cost Optimization Analysis: Performed by contract manufacturers to produce a cost optimization report from formulation cost data, resulting in a durable cost analysis record.

2b. Source Content Inventory

No explicit content sources were provided.

2c. Page Content and Component Coverage

• AI-assisted formulation copilot:

  • Information: Stability prediction, ingredient substitution suggestions, cost optimization analysis.
  • Actions: Initiate stability prediction, request ingredient substitution, perform cost optimization.
  • Components: Formulation data input, ingredient list input, cost data input, report generation.
  • States: Loading, success, error notifications for predictions and optimizations.

• Landing Page:

  • Information: Overview of the tool's capabilities, benefits for small labs.
  • Actions: Navigate to sign-up/login, explore features.
  • Components: Hero section, feature highlights, call-to-action buttons.
  • States: Initial load, user interaction feedback.

• Authentication Page:

  • Information: User account creation, login access.
  • Actions: Sign-up, login, password recovery.
  • Components: Input fields for credentials, submit buttons, error messages.
  • States: Empty, loading, success, error.

3. Functional Requirements as Story Points

• As a small R&D team member, I should be able to initiate stability prediction using formulation data to receive a stability report. explicit
• As a freelance formulator, I should be able to request ingredient substitution suggestions based on my current ingredient list. explicit
• As a contract manufacturer, I should be able to perform cost optimization using formulation cost data to receive a cost optimization report. basic_default
• As a user, I should be able to sign up, log in, and access my session to use the AI-assisted formulation copilot. required_inference

4. User Personas

• Small R&D Teams: Primary users who will utilize the tool for formulation tasks.
• Freelance Formulators: Independent users who need affordable access to formulation tools.
• Contract Manufacturers: Users who manufacture formulations and require AI assistance for optimization.

5. Core User Flows

1. Small R&D Teams:

   • Access the Landing page.
   • Navigate to the Authentication page for login.
   • Access the AI-assisted formulation copilot.
   • Initiate stability prediction and receive a report.

2. Freelance Formulators:

   • Access the Landing page.
   • Navigate to the Authentication page for login.
   • Access the AI-assisted formulation copilot.
   • Request ingredient substitution suggestions.

3. Contract Manufacturers:

   • Access the Landing page.
   • Navigate to the Authentication page for login.
   • Access the AI-assisted formulation copilot.
   • Perform cost optimization analysis and receive a report.

6. Visuals Colors and Theme

• Primary: #4A90E2
• Primary Light: #8AB6E1
• Secondary: #50E3C2
• Accent: #F5A623
• Highlight: #D0021B
• Background: #F5F7FA
• Surface: #FFFFFF
• Text: #4A4A4A
• Text Muted: #9B9B9B
• Border: #E1E1E1

7. Signature Design Concept

The AI-assisted formulation copilot page will feature a clean, modern interface with a focus on usability and clarity. The design will incorporate a structured layout with a prominent hero section showcasing the tool's capabilities. The color palette will use the primary and secondary colors to highlight key actions and information. Typography will be clear and readable, with distinct headings and body text. Interactive elements will provide immediate feedback to enhance user engagement.

8. Interaction Model & Motion Direction

• Landing Page: Animated interaction model with moderate scroll-triggered reveals and hover transitions.
• AI-assisted Formulation Copilot: Static interaction model prioritizing clarity and task completion.
• Authentication Page: Static interaction model with minimal motion for clarity and ease of use.

9. Non-Functional Requirements

No additional non-functional requirements were inferred beyond those necessary for the functional requirements.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: GPT 5.4 for user-friendly response
• Local Orchestration: Docker, docker-compose

11. Assumptions and Constraints

• The system will not include generic enterprise PLM features or conventional e-commerce modules.
• Application-owned identity is required for protected access to the AI-assisted formulation copilot.

12. Glossary

• AI-assisted Formulation Copilot: A tool that aids in formulation tasks using AI for stability prediction, ingredient substitution, and cost optimization.
• Stability Prediction: The process of predicting the stability of a formulation over time.
• Ingredient Substitution: Suggesting alternative ingredients for a formulation.
• Cost Optimization: Analyzing and reducing the cost of formulations.