CSR-Finder System Requirements Document

1. Introduction

CSR-Finder is a microSaaS platform designed to bridge the gap between businesses seeking genuine charitable opportunities and NGOs looking for corporate partners. The platform aims to facilitate Corporate Social Responsibility (CSR) opportunity matching, provide access to a comprehensive grant database, generate proposals, and offer impact reporting. The service is offered on a subscription basis, with pricing ranging from £99 to £500 per month.

2. System Overview

CSR-Finder will serve as a centralized platform for businesses and NGOs to connect and collaborate on CSR initiatives. The platform will provide tools for matching CSR opportunities, accessing grant information, generating proposals, and reporting on the impact of CSR activities. The subscription model will ensure sustainable access to these features for users.

3. Functional Requirements as Story Points

• As a Business User, I should be able to find and match with genuine charities for CSR opportunities.
• As an NGO User, I should be able to find corporate partners interested in CSR initiatives.
• As a User, I should be able to access a comprehensive grant database to identify funding opportunities.
• As a User, I should be able to generate proposals for CSR projects.
• As a User, I should be able to report on the impact of CSR activities.
• As a User, I should be able to subscribe to the platform with a pricing model ranging from £99 to £500 per month.

4. User Personas

• Business User: A representative from a corporation looking to engage in CSR activities and find genuine charitable opportunities.
• NGO User: A representative from a non-governmental organization seeking corporate partners for CSR initiatives.

5. Core User Flows

• Business User searches for CSR opportunities -> Matches with a suitable NGO -> Collaborates on a CSR project -> Reports on project impact.
• NGO User searches for corporate partners -> Matches with a suitable business -> Collaborates on a CSR project -> Reports on project impact.
• User accesses grant database -> Identifies potential funding -> Generates a proposal -> Submits proposal for funding.

6. Visuals Colors and Theme

• primary: #1E90FF (Dodger Blue)
• primary_light: #63B8FF (Light Dodger Blue)
• secondary: #FFD700 (Gold)
• accent: #FF4500 (Orange Red)
• highlight: #32CD32 (Lime Green)
• bg: #F5F5F5 (White Smoke)
• surface: #FFFFFF (White)
• text: #333333 (Dark Gray)
• text_muted: #777777 (Gray)
• border: #DDDDDD (Light Gray)

7. Signature Design Concept

Interactive CSR Network Map

The homepage will feature an interactive network map where businesses and NGOs are represented as nodes. Users can click on nodes to view detailed profiles and potential matches. The map will dynamically update to show connections and collaborations in real-time. Hovering over a node will highlight its connections, and clicking will expand a detailed view with options to connect or propose a project. This concept will be implemented using @react-three/fiber for 3D visualization and gsap for smooth animations.

Landing Hero Motion Brief

The landing page will feature a continuous loop animation depicting a business and an NGO coming together through CSR activities. The animation will show inputs (business goals and NGO missions) converging into a central hub (CSR-Finder platform), transforming into collaborative projects, and resulting in positive social impact. This will be achieved using motion/react for smooth transitions and interactions.

8. Interaction Model & Motion Direction

• Intended Interaction Model: Parallax
• The landing page will utilize a parallax effect to create a sense of depth and engagement. Layers of content will move at different speeds as the user scrolls, enhancing the storytelling of CSR collaborations.
• Internal pages will maintain a static interaction model to prioritize clarity and ease of use.

9. Non-Functional Requirements

• The platform must ensure data security and privacy for all users.
• The system should be scalable to accommodate a growing number of users and data.
• The platform must provide a responsive design for accessibility on various devices.

10. Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, with alembic for migrations
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

11. Assumptions and Constraints

• The platform will operate primarily in the UK, with currency and timezone settings defaulting to GBP and GMT.
• Subscription pricing is fixed between £99 and £500 per month.
• The platform will require internet connectivity to function.

12. Glossary

• CSR: Corporate Social Responsibility
• NGO: Non-Governmental Organization
• MicroSaaS: A small-scale Software as a Service platform focused on a niche market.