Booksia

## Overview
Booksia is a platform designed to facilitate book exchanges, sales, and purchases. It provides a user-friendly interface for users to list books, browse available books, and manage transactions. The platform also includes features for user authentication, messaging, and payment processing.

---

## Core Features

### 1. User Management
- **Registration and Login**: Users can register and log in using their email and password.
- **User Profiles**: Users can create and update their profiles, including personal details, location, and preferences.
- **Verification**: Users can verify their accounts to enhance trustworthiness.

### 2. Book Management
- **Listing Books**: Users can list books they want to sell, exchange, or give away.
- **Book Details**: Each book listing includes details such as title, author, condition, description, and cover image.
- **Pricing & Shipping**: Users can set both book price and shipping costs for books they want to sell.
- **Image Processing**: Book cover images are automatically resized to 240x320 pixels in the background.
- **Archiving Books**: Users can archive books that are no longer available.
- **Editing Books**: Users can edit all aspects of their book listings, including shipping costs.
- **Import/Export**: Users can export their book collections to CSV and import books from CSV files.
- **Bulk Management**: CSV template provided for easy bulk book uploads.

### 3. Transactions
- **Offers**: Users can make offers to exchange or purchase books.
- **Swap Offers**: Users can propose book swaps with other users.
- **Payments**: Integration with PayPal for secure payment processing.
- **Shipping**: Users can provide shipping details and track the status of their transactions.

### 4. Messaging
- **Direct Messaging**: Users can communicate with each other to discuss offers and transactions.
- **Notifications**: Users receive notifications for new messages, offers, and updates.

### 5. Feedback and Ratings
- **Exchange Feedback**: Users can leave feedback and ratings for completed transactions.
- **Response to Feedback**: Users can respond to feedback to clarify or address concerns.

### 6. Search and Discovery
- **Search Functionality**: Users can search for books by title, author, genre, or keywords.
- **Filters**: Users can filter search results by location, condition, and availability.
- **Most Wanted**: A feature highlighting the most sought-after books on the platform.

### 7. Administrative Features
- **Admin Panel**: Admins can manage users, books, and transactions.
- **Site Configuration**: Admins can update site settings and configurations.

---

## Technical Details

### Backend
- **Framework**: Django
- **Database**: PostgreSQL
- **Task Queue**: Celery for asynchronous tasks

### Frontend
- **Templates**: HTML templates for rendering pages
- **Static Files**: CSS and JavaScript for styling and interactivity

### APIs
- **REST API**: Provides endpoints for interacting with the platform programmatically.
- **Documentation**: API documentation is available in `api/API_DOCUMENTATION.md`.

### Other
- **Media Management**: Book cover images are stored in the `media/book_covers/` directory.
- **Static Files**: Static assets are located in the `static/` directory.

---

## Future Enhancements
- **Mobile App**: Development of a mobile application for iOS and Android.
- **Advanced Analytics**: Tools for users to analyze their transactions and activity.
- **Enhanced Search**: AI-powered search and recommendation system.

---

## Contact
For support or inquiries, please contact the Booksia team at support@booksia.com.