Overview

Findee is a full‑stack web application for a community request platform. It operates in a local, island‑based context. Users can browse public requests, post their own, and get in touch with requesters via phone, Viber or WhatsApp. The system supports moderates the platform via an admin panel. Users log in using a passwordless, phone‑number‑based OTP login.

Purpose & Problem Statement

People in local, often struggle to find what they need locally without a centralized place to ask. Posting on social media is disorganized and doesn't get visibility. Findee solves this by creating a dedicated platform where requests get moderated, categorized, searchable, and structured.

Who It's For

• Community members looking for items/services: Browse requests and post their own needs.

• Requesters: Post their requests and get contacted directly.

• Platform admins: Moderate content and users.

Core Features

• Browse Requests: Publicly viewable feed of requests with filtering, sorting, searching, and list/grid views.

• Post Requests: Registered users post with images, category, type, island, contact methods.

• Contact Requesters: Connect with requesters via their preferred channels.

• Report Requests: Users can report items and request moderation.

• OTP Authentication: Login via phone number + OTP sent via SMS.

• Admin Panel: Moderate posts, approve/reject posts, ban/unban users, reset reports.

• Request Management: Manage own posts, hide/show, edit, delete.

• User Profiles: Update user details, appearance settings, delete account.

How It Works

• Public Homepage: Visitors browse all approved, island‑based categorized and type‑based categorized. Filter by island, category, type, search keywords, sort by newest, search results.

• User Registration/Login: Enter phone number, get OTP code, verify code to log in or sign up.

• Posting a Request: Fill out a form with title, description, category, type, island, contact preferences, upload images, submit for moderation.

• My Requests Dashboard: Users manage their own requests, edit, hide/show, delete.

• Admin Dashboard: Moderate incoming posts, approve or reject, manage users, reset reports.

System Capabilities

User Management

• Phone‑based OTP login and user creation

• User ban/unban

• User profile management

• User account deletion

Request Management

• Request creation, editing, hiding, deletion

• Request moderation (approve/reject)

• Request reporting

• Request expiration

Content & Data

• Request images

• Categorized requests (categories, types, islands)

• Request contact methods (call, Viber, WhatsApp)

Admin Tools

• Post approval/rejection

• Report reset

• User ban/unban

• User deletion

Tech Stack

Language & Framework

• PHP 8.2+ with Laravel 12.x

• Laravel Fortify

• Livewire (Volts and Livewire Flux

Frontend

• Blade templates

• Tailwind CSS 4.x

• Vite for asset bundling

• Vanilla JavaScript

Database

• SQLite (default) with Laravel, configurable to other SQL DBs via Laravel's ORM, Eloquent.

Authentication

• Phone‑based OTP, no passwords

• SMS services for OTP delivery (MessageOwl)

Dev & Tooling

• Laravel Pint for code style

• Pest for testing

• Laravel Sail (optional Docker

• Laravel Boost

User Experience & Interface

Clean, modern interface built using Tailwind CSS with clean cards for each request. Browse public feed as homepage, search bar, filtering options, view as grid/list view toggle, infinite scroll or load more. Modal for viewing images in gallery, report, etc. User dashboard has sidebar navigation, clean cards for own requests, admin panel tables.

Access & Permissions

• Public visitors: Browse public approved posts, report, contact.

• Authenticated users: Post requests, manage own, edit/delete/hide, settings.

• Admin users: All user capabilities plus full admin dashboard, approve/reject posts, manage users, reset reports, delete posts/users.

Data & Content Management

Manages:

• **Users: phone numbers, OTPs, user profiles, admin status, ban status, passcode limits.

• Request Posts: title, description, category, type, island, images, contact preferences, approval status, hidden status, expiration, reports, user ownership, moderation.

• Categories/Types: Categorization of requests.

Integrations & External Connections

• **SMS Gateway (MessageOwl): Sending OTP codes for login.

Strengths & Highlights

• **Passwordless login OTP SMS‑based login

• Moderated content

• Island‑based categorization

• Clean, modern UI

• Responsive design

• Contact preferences (call, Viber, WhatsApp)

• Image support for posts

• Public browse without login

• Filter, search, sort, grid/list views

• Report system

• Admin tools

Current Limitations

• No email authentication

• Payment integration

• No notifications (push or email)

• No mobile app native

• No search is basic keyword‑matching

Potential Next Steps

• Add email notifications

• Improve search

• Add more integrations

• More robust moderation tools

• User ratings/reviews

• Saved/favorited requests

• Post expiration reminders

• User verification