purple-professional System Requirements Document

Introduction

The "purple-professional" project aims to develop a mobile application specifically designed for local newspaper distribution management in India. This app is tailored for local newspaper center owners, providing them with a user-friendly interface to manage subscribers, delivery lists, and payments efficiently.

System Overview

The "purple-professional" app is intended to simplify the daily operations of local newspaper center owners by offering a digital solution for managing subscribers, delivery routes, and payment tracking. The app will be designed with a warm, approachable aesthetic, reflecting the neighborhood shopkeeper feel, and will prioritize ease of use for users with minimal technical experience.

Functional Requirements as Story Points

• As a newspaper center owner, I should be able to enter my name, shop/business name, area/locality, and number of delivery boys during onboarding.
• As a newspaper center owner, I should be able to bulk-add subscribers via a simple form with fields for name, address, newspaper type, and monthly rate.
• As a newspaper center owner, I should see an empty state message prompting me to add my first subscriber with a big "+" button.
• As a newspaper center owner, I should have a home dashboard displaying today's date, total active subscribers count, and total delivery boys count.
• As a newspaper center owner, I should receive a notification badge for new customer requests pulled from WhatsApp form submissions.
• As a newspaper center owner, I should have a primary action button to send today's delivery list.
• As a newspaper center owner, I should see a secondary stat row showing pending payments count and this month's collected amount.
• As a newspaper center owner, I should be able to view and manage customer requests with options to approve or reject them.
• As a newspaper center owner, I should be able to search and filter the subscriber list by active, paused, and area/route.
• As a newspaper center owner, I should be able to view subscriber details, including history of pauses/resumes and payment history.
• As a newspaper center owner, I should be able to generate and send a delivery list via WhatsApp, with options to preview and edit route grouping.
• As a newspaper center owner, I should be able to manually track payments with a monthly grid view and toggle payment status.
• As a newspaper center owner, I should be able to manage delivery boys with a simple list showing name, phone number, assigned area/route, and number of subscribers assigned.
• As a newspaper center owner, I should be able to edit business info, WhatsApp number, and language preferences in settings.

User Personas

• Raja Lal: A local newspaper center owner with 12 years of experience, managing 400-500 subscribers and 4 delivery boys. He is comfortable with smartphones and WhatsApp but prefers simple, intuitive apps.

Core User Flows

• Onboarding: Owner enters personal and business details -> Bulk-add subscribers -> View empty state message.
• Home Dashboard: View today's date and stats -> Receive notification badge -> Send delivery list.
• Customer Requests: View list of requests -> Approve/Reject requests -> Update subscriber list.
• Subscriber Management: Search/filter subscribers -> View/edit subscriber details -> Track payment status.
• Delivery List Generation: Group subscribers by route -> Generate WhatsApp message -> Send message.
• Payment Tracking: View monthly grid -> Toggle payment status -> View monthly summary.
• Delivery Boy Management: View list of delivery boys -> Edit details as needed.

Visuals Colors and Theme

• primary: #D2691E (Terracotta)
• primary_light: #F4A460 (Light Terracotta)
• secondary: #8B4513 (Saddle Brown)
• accent: #FFD700 (Gold)
• highlight: #FF4500 (Orange Red)
• bg: #FFF8DC (Cornsilk)
• surface: #FAEBD7 (Antique White)
• text: #000000 (Black)
• text_muted: #696969 (Dim Gray)
• border: #D3D3D3 (Light Gray)

Signature Design Concept

The landing page of the "purple-professional" app will feature an interactive "Neighborhood Map" concept. Users will see a stylized map of their locality with animated newspaper icons representing subscribers. As the user interacts with the map, they can tap on icons to view subscriber details or drag to rearrange delivery routes. The map will have a warm terracotta background with animated transitions using motion/react for a smooth, engaging experience.

Landing Hero Motion Brief

The hero section will depict a morning scene with newspapers being delivered to homes. Animated newspaper icons will travel from the center (representing the newspaper center) to various homes on the map. The animation will loop every 10 seconds, showing the transformation from a stack of newspapers to individual deliveries. Users can interact by tapping on homes to see subscriber details, with responsive behavior for different screen sizes.

Interaction Model & Motion Direction

• Intended Interaction Model: Animated
• The landing page will feature moderate scroll-triggered reveals and hover transitions, with spring physics on interactive elements to enhance user engagement.

Non-Functional Requirements

• The app must be responsive and accessible on various mobile devices.
• The app should have a low cognitive load, with large text and minimal jargon.
• The app must be reliable and handle up to 500 subscribers efficiently.

Tech Stack

• Frontend: React Native for mobile app
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• Local Orchestration: Docker, docker-compose

Assumptions and Constraints

• The app is designed for a single user type: the newspaper center owner.
• No GPS or live tracking features will be included in this version.
• Payment tracking will be manual, with no integration for automatic deductions.

Glossary

• Subscriber: A customer who receives newspapers delivered to their address.
• Delivery Boy: An individual responsible for delivering newspapers to subscribers.
• WhatsApp Integration: The use of WhatsApp for communication and delivery list distribution.