Flutter + FastAPI Full-Stack Developer for Pet Services App

# PET APP — Full-Stack Marketplace & Services Platform

We are looking for an experienced **Full-Stack Developer / Development Team** to build a production-ready PET Marketplace & Services Platform for **Android, iOS and Web**.

### Template & AI-Assisted Development

The mobile application UI may be based on a suitable **CodeCanyon Flutter template** selected/purchased by the client. The selected template is expected to be approximately **80% aligned with the planned PET APP user interface**, although certain additional screens, pages, components and modifications may be required to fully match the project requirements.

The developer is expected to **reuse and customize the existing template wherever technically appropriate**, rather than unnecessarily rebuilding standard UI components from scratch.

The project may also make use of modern AI-assisted development tools such as **Cursor and Claude** to accelerate coding, integration, debugging and documentation.

**Template + AI-assisted development (Cursor + Claude) can significantly reduce repetitive development effort and implementation time.** Therefore, the developer should take advantage of these available resources to deliver the agreed scope efficiently while maintaining proper code quality, architecture, testing, security and stability.

The use of templates or AI tools does **not** reduce the developer's responsibility for the final implementation. All customized code, integrations, Dynamic UI architecture, backend logic, security, testing, bug fixing and production readiness remain the developer's responsibility.

## 1. Mobile Application

* Flutter / Dart
* Android & iOS
* Modern responsive UI
* Schema-Driven / Dynamic UI Engine
* Reusable Widget Registry
* Offline fallback with Last Known Good Schema Cache
* Versioned JSON Schema with validation and rollback

## 2. Customer Web & Admin Panel

* Next.js
* Customer Web Application
* Super Admin Panel
* Role-Based Access Control (RBAC)
* Manager / Accounts / Marketing / Operations roles
* Category & Subcategory Management
* Dynamic Fields & Form Management
* User & Service Provider Management
* Listings / Products / Services Management
* Reports & Dashboard

## 3. Backend & Database

* Python + FastAPI
* REST APIs
* PostgreSQL
* JSONB
* PostGIS
* Redis
* Docker / Linux VPS / Nginx
* Secure and scalable architecture

## 4. Authentication & Security

* Phone OTP
* WhatsApp Cloud API as primary OTP provider
* SMS fallback
* Backend-controlled OTP generation, expiry, verification, rate limiting and retry
* Authentication & Authorization
* Session Management
* Login / Device History
* Last 3 login/device records per user
* IP / Platform / Browser / Device information
* Secure RBAC

## 5. Dynamic UI / Schema-Driven Architecture

* Super Admin controls categories, subcategories and fields
* Dynamic field types
* Validation rules
* Required / Optional fields
* Visibility rules
* Searchable / Filterable fields
* Ordering
* Localization-ready schema
* Schema versioning
* Local caching
* Schema validation and rollback
* No new APK required for normal category/field configuration changes

## 6. PET Marketplace & Services

The platform may support:

* Pet Buying & Selling
* Pet Adoption
* Pet Shop / Products
* Pet Food & Accessories
* Veterinary Doctors
* Pet Hostel / Boarding
* Pet Care Services
* Service Provider Listings
* Booking

## 7. Lead Management & Customer Interest

* Customer Activity Tracking
* Product / Service Views
* Frequently Viewed & Recently Viewed
* Favourite
* Add to Cart
* Enquiry
* Call / WhatsApp Click
* Product Sharing
* Booking Started / Abandoned
* Automated Lead Generation
* Lead Assignment & Follow-up
* Lead Lifecycle & Status
* Lead Source & Conversion Tracking
* Marketing Team Lead Management
* Lead Notifications
* Scalable Activity/Event Tracking

## 8. Lead Credits & Subscription

* Subscription Packages with Lead Credits
* Separate Lead Credit Packs
* Subscription Credits and Purchased Credits tracked separately
* Backend Lead Credit Ledger
* Lead Unlocking
* Credit Deduction / Refund / Expiry
* Backend-controlled Lead Eligibility and Credit Usage

## 9. WhatsApp & Email Marketing

* One-click WhatsApp from Lead Management
* WhatsApp Cloud API integration
* Product/Service information sharing
* WhatsApp message status/history
* One-click Email from Lead Management
* Email Templates
* Automated Customer Interest Emails
* Add-to-Cart / Favourite / Abandoned Booking emails
* Marketing consent / unsubscribe / suppression
* Email delivery/bounce handling

## 10. Booking, Chat & Notifications

* Service Booking
* Booking Management
* Real-time WebSocket Chat
* Text Chat for MVP
* Push Notifications
* In-App Notifications
* Marketing Notifications
* Booking Notifications

## 11. Payments, Wallet & Subscriptions

* Razorpay
* Subscription Packages
* Wallet
* Lead Credits
* Payment History
* Refund handling
* Backend-controlled payment/business logic

## 12. User & Service Provider Verification

* User Verification
* Service Provider Verification
* KYC / Identity Verification
* SignCare API integration
* Manual Admin Review
* Verification Status
* Verification Audit Log
* Verified User / Service Provider Badge
* Re-verification / Suspension / Revocation support

## 13. Advertisement & Campaign System

* Advertisement Management
* Admin-managed Advertisements
* Campaign Management
* Banner / Product / Service Promotion
* Targeted Campaigns
* Campaign Start/End Date
* Customer Interest-based marketing

## 14. Product & Customer Features

* Product Search
* Filters
* Wishlist / Favourite
* Recently Viewed
* Frequently Viewed
* Personalized Recommendations architecture
* Cart
* Product / Service Sharing
* WhatsApp Sharing
* Deep Links
* Web fallback links

## 15. Media & File Management

* Product Images
* Service Images
* User/Provider Documents
* Image/File Upload
* Cloud Storage integration
* Secure upload/download
* Media validation

## 16. Production Quality

The final delivery must include:

* Full API integration
* Security testing
* Functional testing
* QA
* Bug fixing
* Performance optimization
* Error handling
* Offline/failure fallback
* Production deployment
* Android AAB/APK
* iOS build
* Customer Web
* Super Admin Panel

## 17. Development Architecture

The final architecture should follow:

**Flutter → FastAPI → PostgreSQL / JSONB / PostGIS → Redis**

with:

**Next.js → FastAPI**

and backend integrations for:

**Razorpay + WhatsApp Cloud API + KYC Provider + Email Provider + Cloud Storage**

The architecture must be modular, scalable, secure and maintainable.

## 18. Development Process

Before full development:

1. Pre-Development Setup & Scope Confirmation
2. Technical Architecture Approval
3. JSON Schema & Dynamic UI Architecture Approval
4. POC Demo & Acceptance
5. UI/UX Direction & Screen Flow Approval
6. Development & Module Implementation
7. Integration, Testing, QA & Bug Fixing
8. Production Deployment & Environment Setup
9. Final Builds, Source Code & Documentation Handover
10. Final Acceptance & Project Closure

## Important Requirement

The developer/team must provide a **POC before full implementation** demonstrating:

**Super Admin → Create Category/Fields → Backend JSON Schema → Flutter Dynamic UI → Form Submission → Backend Storage**

No major change to the agreed core architecture should be made without prior approval.

## Source Code & Development Tracking

* GitHub repository must be owned/controlled by the client.
* Developer must work through the client's repository.
* Regular commits/pushes are required.
* Development progress should be traceable through Git history.
* Final source code, environment configuration, API documentation and deployment documentation must be handed over.

## Post-Delivery Bug Fixing

All bugs originating from the agreed project scope and delivered implementation must be fixed by the developer/team without additional development charges, subject to the agreed warranty/support period.

## Developer Requirements

Please provide:

* Previous Flutter projects
* Next.js projects
* FastAPI projects
* Marketplace / Service Platform experience
* Dynamic UI / Schema-Driven architecture experience
* GitHub / Portfolio
* Estimated timeline
* Fixed project cost
* POC timeline/cost
* Post-delivery bug-fixing/warranty terms

**We are looking for a production-ready implementation, not just a UI prototype. Quality, stability, security, scalability and clean architecture are important.**

The full description of the project and the PDF file are placed here with password security which will facilitate communication, and allow us to see the full details of the awardees.

**Note :-
** The above 18 points provide a short overview of the complete project scope and major requirements. Detailed technical specifications, business rules, workflows, API requirements, validation rules, architecture details, and all remaining implementation details will be provided in the **complete project documentation** after the project is awarded and during the initial technical discussion with the selected developer/team.