System Requirements Document (SRD) for Zinc-System

1. Introduction

The Zinc-System is a specialized platform designed to manage and run advertisements for haircut services in Phoenix, Arizona. This system aims to streamline ad creation, targeting, and campaign tracking, ensuring that local haircut businesses can effectively reach their audience. The system will cater to the unique needs of the Phoenix market, taking into account locale-specific preferences, timezone (MST), and US currency standards (USD).

This document outlines the system requirements for the Zinc-System, including functional and non-functional requirements, user personas, design concepts, and technical specifications.

2. System Overview

The Zinc-System will serve as a comprehensive advertising management platform tailored for haircut services in Phoenix. It will enable businesses to create, manage, and track ad campaigns with ease. The system will focus on user-friendly interfaces, robust targeting capabilities, and detailed analytics to help businesses optimize their advertising efforts.

Key features include:

• Ad creation tools with customizable templates.
• Targeting options based on demographics, location, and preferences.
• Campaign performance tracking with detailed analytics.
• User roles for business owners, admins, and guests.

3. Functional Requirements

• As a Business Owner, I should be able to create and customize ads for haircut services.
• As a Business Owner, I should be able to target ads based on location, age, and preferences.
• As a Business Owner, I should be able to track the performance of my ad campaigns.
• As an Admin, I should be able to manage user accounts and permissions.
• As a Guest, I should be able to view sample ads and learn about the platform's features.

4. User Personas

1. Business Owner

• Description: Local haircut business owners in Phoenix who want to advertise their services.
• Goals: Create and manage ad campaigns, attract new customers, and track campaign performance.
• Technical Proficiency: Moderate.

2. Admin

• Description: System administrators responsible for managing user accounts and maintaining the platform.
• Goals: Ensure smooth operation of the system and manage user permissions.
• Technical Proficiency: High.

3. Guest

• Description: Potential users exploring the platform.
• Goals: Learn about the platform's features and view sample ads.
• Technical Proficiency: Low to moderate.

5. Visuals Colors and Theme

The Zinc-System will adopt a modern and professional aesthetic with a focus on simplicity and usability. The proposed color scheme is as follows:

• Primary Color: Deep Blue (#003366) – Represents trust and professionalism.
• Secondary Color: Vibrant Orange (#FF6600) – Adds energy and draws attention to key elements.
• Accent Color: Light Gray (#F5F5F5) – Ensures a clean and minimalistic background.
• Font: Sans-serif fonts like Open Sans or Roboto for readability.

6. Signature Design Concept

The Zinc-System's homepage will feature an interactive cityscape of Phoenix as its centerpiece. This cityscape will be a dynamic, animated 3D map that highlights local haircut businesses as glowing pins. Users can hover over these pins to see a brief preview of the business, including its name, logo, and a snippet of its ad.

Key Features:

• Dynamic Animations: The cityscape will subtly shift between day and night modes based on the user's local time.
• Interactive Pins: Clicking on a pin will open a sleek modal with more details about the business and its ad campaign.
• Smooth Transitions: Micro-interactions like hover effects and smooth scrolling will enhance the user experience.
• Call-to-Action: A prominent "Get Started" button will guide users to sign up or log in.

This design concept will make the Zinc-System's homepage unforgettable, creating an immediate connection with its Phoenix-based audience.

7. Non-Functional Requirements

• The system must support at least 10,000 concurrent users.
• The system should load the homepage within 2 seconds under normal traffic conditions.
• The system must comply with US data privacy regulations (e.g., CCPA).
• The system should be accessible on both desktop and mobile devices.

8. Tech Stack

Frontend

• React for Web

Backend

• Python
• FastAPI

Database

• MySQL (with Alembic for migrations)

AI Models

• GPT 5.2 for user-friendly responses.

AI Tools

• Langchain
• Litellm for LLM Routing

Local Orchestration

• Docker
• docker-compose

Server-Side Orchestration

• Kubernetes

9. Assumptions and Constraints

• The system will primarily target businesses in Phoenix, Arizona.
• The system will use USD as the default currency.
• The system will operate in the Mountain Standard Time (MST) timezone.
• Internet connectivity is required for all functionalities.

10. Glossary

• Ad Campaign: A series of advertisements with a unified theme or goal.
• CCPA: California Consumer Privacy Act, a data privacy law in the United States.
• MST: Mountain Standard Time, the timezone for Phoenix, Arizona.
• Micro-Interactions: Small, subtle animations that enhance user experience.
• Modal: A pop-up window that appears on top of the main content.

This document provides a comprehensive overview of the Zinc-System's requirements and design. If you have any additional input or changes, Nelly, feel free to share!