System Requirements Document (SRD)

Project Name: honest-photo

1. Introduction

The honest-photo project is designed to provide users with a comprehensive tool for creating professional passport-size photos and document-ready images. This tool is tailored for individuals in India, addressing common needs such as creating photos for government documents like Aadhaar cards, PAN cards, and driving licenses. By offering features like customizable backgrounds, cropping tools, professional outfit overlays, and paper size presets, honest-photo simplifies the process of creating high-quality, professional photos from the comfort of one's home.

This SRD outlines the system requirements for the honest-photo project, ensuring it meets the needs of users like Abhishek Kanabar and aligns with Indian standards and preferences.

2. System Overview

The honest-photo system is a web and mobile application that allows users to create professional photos for various purposes, including passport photos, government document photos, and general professional use. The system will feature:

• Tools for selecting professional outfits for men, women, and children.
• Background removal and replacement functionality.
• Customizable borders and cropping tools.
• Presets for Indian government documents such as Aadhaar cards, PAN cards, and driving licenses.
• Support for standard paper sizes like A4, 4x6, etc.

The application will cater to individuals who need professional-quality photos for personal or official purposes, ensuring ease of use and adherence to Indian standards.

3. Functional Requirements

• As a User, I should be able to select professional outfits for men, women, and children.
• As a User, I should be able to add or customize borders for photos.
• As a User, I should be able to remove and replace photo backgrounds to make them professional.
• As a User, I should be able to crop photos for precise adjustments.
• As a User, I should be able to resize photos to fit standard paper sizes like A4, 4x6, etc.
• As a User, I should be able to use presets for Indian government documents such as Aadhaar cards, PAN cards, and driving licenses for photocopy purposes.
• As a User, I should be able to preview the final photo before saving or printing.
• As an Admin, I should be able to manage outfit templates, background options, and document presets.

4. User Personas

1. User

• Individuals who need professional photos for personal or official purposes.
• Likely to be Indian citizens requiring photos for government documents or general professional use.

2. Admin

• Responsible for managing templates, presets, and system configurations.
• Ensures the application aligns with Indian standards and user needs.

5. Visuals Colors and Theme

The honest-photo application will use a clean and professional color palette to ensure a user-friendly and visually appealing experience. Suggested colors include:

• Primary Color: Deep Blue (#003366) – Represents professionalism and trust.
• Secondary Color: White (#FFFFFF) – Ensures clarity and simplicity.
• Accent Color: Bright Orange (#FFA500) – Adds vibrancy and highlights key features.
• Background Color: Light Gray (#F5F5F5) – Provides a neutral backdrop for photos and tools.

The theme will focus on simplicity and functionality, with intuitive navigation and clear visual cues for each feature.

6. Signature Design Concept

Interactive Photo Studio Experience

The homepage of honest-photo will resemble a virtual photo studio, immersing users in an engaging and professional environment. Key features include:

• Dynamic Outfit Selection: Users can drag and drop outfits onto a mannequin that adjusts to their photo dimensions.
• Background Customization: A live preview area where users can experiment with different backgrounds, including solid colors, gradients, and professional settings like office spaces.
• Document Preset Carousel: A rotating carousel showcasing Indian government document presets (Aadhaar card, PAN card, driving license, etc.), allowing users to select and preview their photo within the preset dimensions.
• Interactive Cropping Tool: A cropping area with draggable corners and zoom functionality for precise adjustments.
• Paper Size Preview: A visual representation of the selected paper size (e.g., A4, 4x6) with the photo positioned accordingly.

Animations and transitions will enhance the experience, such as smooth outfit changes, background fades, and carousel rotations. Micro-interactions like hover effects and tooltips will guide users through the process seamlessly.

7. Non-Functional Requirements

• The system must support high-resolution photo processing (minimum 300 DPI).
• The application must load within 3 seconds on standard internet connections.
• The system must comply with Indian government standards for photo dimensions and layouts.
• The application must be accessible on both web and mobile platforms.
• The system must ensure data security and privacy for uploaded photos.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL or MariaDB (using Alembic for migrations)

AI Models

• Google Nano Banana for image generation
• GPT 5.2 for user-friendly responses

AI Tools

• Litellm for LLM Routing
• Langchain

Local Orchestration

• Docker
• docker-compose

Server-Side Orchestration

• Kubernetes

9. Assumptions and Constraints

• The application will primarily cater to Indian users, adhering to local standards for government document photos.
• Users will have access to devices with internet connectivity to use the application.
• The system will support common photo formats like JPEG and PNG.
• The application will be optimized for both desktop and mobile devices.

10. Glossary

• Aadhaar Card: A unique identification document issued by the Indian government.
• PAN Card: A Permanent Account Number card used for tax purposes in India.
• DPI: Dots Per Inch, a measure of image resolution.
• Preset: Predefined dimensions and layouts for specific purposes.
• Mannequin: A virtual representation used for outfit selection.

This document outlines the requirements for the honest-photo project, ensuring it meets the needs of users like Abhishek Kanabar and provides a seamless, professional photo creation experience.