System Requirements Document (SRD) for project-07e870e4

1. Introduction

Welcome to the System Requirements Document (SRD) for project-07e870e4, officially named 网络项目辅助系统. This document outlines the functional and non-functional requirements, user personas, design concepts, and technical specifications for the development of this innovative web application. The system is designed to provide users with a seamless and dynamic experience in analyzing, matching, evaluating, and visualizing project lists, leveraging cutting-edge AI technologies and interactive design principles.

The system is tailored for users in Armenia (AM) and ensures compatibility with locale-specific defaults, such as time zones, currency, and language preferences. The goal is to create a user-friendly, free-to-use platform that requires no registration and offers dynamic, interactive outputs.

2. System Overview

The 网络项目辅助系统 is a web-based application that allows users to upload project lists in various formats (DOCX, PDF, XLSX). The system then utilizes integrated AI models to analyze, match, evaluate, and visualize the data, presenting results in dynamic, interactive pages. The system supports four main functionalities:

1. 清单分析: Analyzes the uploaded project list and generates a dynamic interactive analysis page.
2. 清单配单: Matches products based on the uploaded list and generates a dynamic interactive product matching page.
3. 配单自检评析: Evaluates the matched products and generates a dynamic interactive self-check evaluation page.
4. 配单绘制拓扑图: Visualizes the matched products in a dynamic interactive topology diagram.

The system ensures that all functionalities are accessible independently, while maintaining logical dependencies where necessary. For example, functionalities 3 and 4 depend on the results of functionality 2 if used sequentially.

3. Functional Requirements

Story Points:

• As a User, I should be able to upload project lists in DOCX, PDF, or XLSX formats.
• As a User, I should be able to analyze the uploaded project list using the 清单分析 functionality.
• As a User, I should be able to match products based on the uploaded project list using the 清单配单 functionality.
• As a User, I should be able to evaluate matched products using the 配单自检评析 functionality.
• As a User, I should be able to visualize matched products in a topology diagram using the 配单绘制拓扑图 functionality.
• As a User, I should be able to view real-time AI progress and reasoning in the display window.
• As a User, I should be able to see a timer showing the duration of AI-generated results for each functionality.
• As a User, I should be able to export generated pages as offline HTML files with dynamic interactive effects.
• As a User, I should be able to share generated pages via unique URLs valid for 30 days.
• As a User, I should be able to view detailed "适配度说明" in the 清单配单 functionality, including parameter comparisons and compatibility explanations.
• As a User, I should be able to interact with topology diagrams, including dragging, zooming, and viewing detailed device information.

4. User Personas

Persona 1: General User

• Description: Individuals who need to analyze, match, evaluate, and visualize project lists without requiring technical expertise.
• Goals: Upload project lists, view AI-generated results, and export/share outputs.
• Pain Points: Complexity in understanding technical data; need for intuitive and interactive outputs.

Persona 2: Technical Analyst

• Description: Professionals who require detailed compatibility analysis and topology diagrams for project planning.
• Goals: Ensure precise matching of technical parameters and visualize network layouts.
• Pain Points: Lack of clarity in compatibility explanations; difficulty in visualizing complex layouts.

5. Visuals Colors and Theme

Unique Color Palette:

• Background: #F9F9F9 (Light Gray)
• Surface: #FFFFFF (Pure White)
• Text: #333333 (Dark Gray)
• Accent: #0078D7 (Azure Blue)
• Muted Tones: #E5E5E5 (Soft Gray)

Mood Direction:

The theme emphasizes clarity, professionalism, and modernity, ensuring users can focus on the content without distractions.

6. Signature Design Concept

Concept: Interactive Data Universe

The homepage will feature a dynamic galaxy visualization, where each star represents one of the four functionalities: 清单分析, 清单配单, 配单自检评析, and 配单绘制拓扑图. Users can navigate the galaxy by clicking on stars, which zoom into detailed interactive pages.

Key Features:

• Animations: Stars pulsate gently, and connections between functionalities are represented as glowing lines.
• Transitions: Clicking a star triggers a smooth zoom-in effect, transitioning to the respective functionality page.
• Micro-interactions: Hovering over stars reveals tooltips with brief descriptions of each functionality.
• Color Shifts: The galaxy background subtly changes hues based on the time of day (e.g., warm tones in the morning, cool tones at night).

This design will create an unforgettable first impression, making the system feel futuristic and engaging.

7. Non-Functional Requirements

• Performance: The system must process uploaded files and generate results within 30 seconds for each functionality.
• Scalability: Support concurrent usage by up to 1,000 users.
• Accessibility: Ensure compatibility with screen readers and keyboard navigation.
• Security: Protect uploaded files and generated results with encryption; ensure URLs for shared pages are secure and expire after 30 days.
• Localization: Support Armenian language and locale-specific formats.

8. Tech Stack

Frontend:

• React for Web

Backend:

• Python
• FastAPI

Database:

• MySQL (preferred) or MariaDB for structured data
• MongoDB for unstructured data
• WeaviateDB for vector-based queries

AI Models:

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for technical analysis
• Gemini 3.1 Pro for interactive outputs
• Google Nano Banana for image generation

AI Tools:

• Litellm for LLM routing
• Langchain for AI workflow orchestration

Orchestration:

• Docker and docker-compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

Assumptions:

• Users will upload project lists in supported formats (DOCX, PDF, XLSX).
• The system will handle file format conversions automatically.
• Users will primarily access the system via desktop browsers.

Constraints:

• The system must not rely on external AI APIs; all AI logic must be embedded.
• Generated pages must retain dynamic interactivity when exported as HTML files.

10. Glossary

• 清单分析: List analysis functionality.
• 清单配单: Product matching functionality.
• 配单自检评析: Self-check evaluation functionality.
• 配单绘制拓扑图: Topology diagram visualization functionality.
• 动态交互页: Dynamic interactive page.
• 适配度说明: Compatibility explanation section.

End of Document