# Manage Projects

The Manage Projects section is the core of the platform where administrators can create and manage real estate investment projects. Each project contains detailed information about the property, investment terms, and available shares.

## Overview

The Manage Projects page displays all projects in a table format. You can access this section from the sidebar under Manage Projects → Projects.

### Page Controls

At the top of the page, you'll find:

- Status Tabs: Filter projects by status (All, Draft, Published, Inactive, Completed)
- Search: Search projects by name or code
- Date Range: Filter projects by date range
- Add Project: Button to create a new project
- Refresh: Reload the projects list

### Table Columns

Each project row displays the following information:

- Code-Title: Project code and title
- City-Address: Location details of the project
- Contract Type-ROI: Contract type and return on investment percentage
- Unit Price-Total Contract: Price per unit and total number of shares
- Gain-Total Value: Profit amount and total project value
- Effective-Mat/Ren Date: Effective date and maturity/renewal date
- Status: Current status (Draft, Published, Completed, etc.)
- Action: Options to manage each project

## Creating a New Project

Click the Add Project button to start creating a new project. The creation form uses a tabbed interface to organize different aspects of the project.

### Project Creation Tabs

The project form is organized into the following tabs:

- Project Info: Basic project information
- Contract Setup: Contract and investment configuration
- Location: Geographic location details
- Gallery: Images and video content
- Features: Project features and amenities
- Documents: Related documents and files

### Project Info Tab

The first tab contains essential project details:

- Project Title: Enter the title of the project
- Project Code: Unique code identifier for the project
- Select Type: Choose the project type (Residential, Commercial, etc.)
- Select City: Select the city where the project is located
- Project Address: Full address of the project
- Project Size in Sqft: Total size of the project in square feet
- Project Description: Detailed description of the project

Click Create Project to save the project and proceed to additional configuration.

## Configuring Project Details

After creating the project, you can configure additional details through the other tabs.

### Contract Setup Tab

Configure the investment and contract settings:

- Contract Type: Select the type of contract (Fixed, Renewable, etc.)
- Total Shares: Number of shares available
- Each Contract Value: Price per contract
- ROI (%): Return on investment percentage
- Effective Date: When the contract becomes effective
- Maturity Date: Contract maturity/end date
- Marketplace Resale: Enable or disable resale on the marketplace

Click Update Info to save the contract configuration.

### Gallery Tab

Upload visual content for the project:

- Project Thumbnail: Upload the main thumbnail image for the project
- Project Gallery Images: Add multiple gallery images using the + Add Image button
- Project Video Tour URL: Add a YouTube video URL for virtual tours

Click Update Info to save the gallery content.

## Project Draft Status

When a new project is created, it automatically starts with a Draft status. This allows administrators to complete all project information before making it visible to users.

Info

New projects are saved as drafts until all required information is complete and the project is ready to be published.

## Project Management Actions

### Action Menu Options

Each project row includes an action menu with the following options:

- Edit: Modify project details
- View: Preview the project
- Publish: Make the project visible to users (available for draft projects)
- Unpublish: Hide the project from users
- Delete: Remove the project from the system
- Change Status: Update the project status

### Viewing Project Details

When selecting View from the action menu, you'll see a comprehensive overview of the project with all its details displayed in organized sections.

#### Project Header and Overview

At the top of the details page, you'll find:

- Project Title: The name of the project with Edit and Back buttons
- Investment Summary: Quick stats showing Investors count, Shares Sold, Listed Shares, and Time Remaining
- Investment Progress: Financial metrics including Total Raised, This Month, Last Month, and Today earnings with a progress bar showing funding percentage
- Latest Shares: Table displaying recent contract purchases with Investor, Contract Number, Date, and Status

On the right sidebar, you'll see:

- Project Details - Basic Information: Status, Code, Size, City, Address, and Type
- Contract Information: Type, Total shares, ROI percentage, Contract Value, Marketplace Resale status, ROI Distribution frequency, Effective Date, and Renewal Date
- Features: List of project features and amenities

#### Section-Specific Editing

Below the overview, the details page displays content sections, each with its own Edit button that takes you directly to the corresponding tab:

- Project Media: Shows project thumbnail and gallery images. Edit button redirects to Gallery tab
- Location: Displays project address and map. Edit button redirects to Location tab
- Documents: Lists all uploaded documents. Edit button redirects to Documents tab

This allows for quick editing of specific sections without navigating through all tabs.

### Publishing a Project

To publish a project and make it available to users:

1. Complete all required project information
2. Review the project details for accuracy
3. Click on the Action menu (three dots)
4. Select Publish from the dropdown

Once published, the project will be visible and users can start investing.

Tip

Make sure all project details, images, and documents are complete before publishing. This ensures a professional presentation to potential investors.

## Marketplace Listing

Administrators can list unsold project shares on the marketplace for users to purchase.

### Accessing Marketplace Listing

From the projects list, click on the Action menu (three dots) for any project. The menu includes the following options:

- View: View project details
- Edit: Edit project information
- Unpublish: Hide the project from users
- Marketplace Listing: Access the contract listings page
- Distribute ROI: Distribute returns to investors
- Mark as Completed: Mark the project as completed

### Contract Listings Page

When you click Marketplace Listing, you'll be redirected to the Contract Listings page. This page shows:

#### Summary Stats

- Unsold Shares: Total number of unsold shares
- Sold/Listed Shares: Number of sold vs listed shares
- Active Listings: Currently active marketplace listings
- Available for Listing: Shares available to be listed

#### Listings Table

The table displays contract listings with the following columns:

- Number of Shares: How many shares in the listing
- Sold Shares: Number of shares sold from this listing
- Price: Price per contract
- Listed At: Date and time of listing
- Action: Options to manage the listing

Click + List Shares to create a new listing.

### List Unsold Shares

When clicking + List Shares, a modal opens to create a new marketplace listing:

- Number of Shares: Enter the number of shares to list (shows available quantity)
- Each Contract Price: Set the price per contract
- Cancel: Close the modal without saving
- Confirm: Create the marketplace listing

## ROI Distribution

Administrators can distribute returns on investment (ROI) to contract holders directly from the projects list.

### Distributing ROI

To distribute ROI to investors:

1. From the projects list, click on the Action menu (three dots) for the project
2. Select Distribute ROI from the dropdown menu
3. The system will process and distribute the ROI to all contract holders based on their investment

The action menu also shows other options like View, Edit, Unpublish, and Mark as Completed.

# Cities

The Cities section allows administrators to manage geographic locations where real estate projects are available. Cities help users filter and discover projects based on their preferred locations.

## Cities Overview

The Cities page displays all available city locations in a table format. You can access this section from the sidebar under Manage Projects → Cities.

Each city displays:

- Name: The name of the city (e.g., New York, Los Angeles, Chicago)
- Status: Shows whether the city is Active or Inactive
- Action: Options to manage each city

## Page Controls

At the top of the page, you'll find the following controls:

- Search: Filter cities by name
- Add New City: Button to create a new city
- Refresh: Reload the cities list

## Add New City

Click the Add New City button to open the creation modal.

#### Add New City Modal

The modal includes:

- Name Field: Enter the new city name
- Save Button: Create the new city

## City Management Actions

### Action Menu Options

Each city row includes an action menu (three dots) with the following options:

- Edit: Modify city details
- Delete: Remove the city from the system
- Change Status: Toggle between Active and Inactive status

### Edit City

When selecting "Edit" from the action menu, a modal dialog opens allowing administrators to modify:

#### Edit City Modal

- Name Field: Update the city name
- Save Button: Apply changes to the city

# Project Types

The Project Types section allows administrators to organize and categorize different types of real estate projects. Each type helps users filter and identify projects based on their property classification.

## Types Overview

The Project Types page displays all available project categories in a table format. You can access this section from the sidebar under Manage Projects → Types.

Each type displays:

- Name: The name of the project type (e.g., Residential Apartments, Commercial Apartments and Hotels)
- Status: Shows whether the type is Active or Inactive
- Action: Options to manage each project type

## Type Management Actions

### Action Menu Options

Each project type row includes an action menu (three dots) with the following options:

- Edit: Modify project type details including name and icon
- Delete: Remove the project type from the system
- Change Status: Toggle between Active and Inactive status

### Edit Project Type

When selecting "Edit" from the action menu, a modal dialog opens allowing administrators to modify:

#### Edit Type Modal

- Name Field: Update the project type name
- Icon Field: Set an icon for the type using icon class names (e.g., `ph:ph-house`)
- Save Button: Apply changes to the project type

### Add New Project Type

Administrators can create new project types using the Add New Project Type button located in the top-right corner of the interface. The creation modal includes the same fields as the edit modal:

- Name: Enter the new project type name
- Icon: Specify an icon class for visual identification
- Save: Create the new project type

# Contract Transfers

The Contract Transfers section allows administrators to manage and monitor contract ownership transfers between users. This feature enables users to transfer their investment shares to other registered users on the platform.

## Contract Transfers Overview

The Contract Transfers page displays all transfer requests in a table format. You can access this section from the sidebar under Manage Projects → Contract Transfers.

Each transfer displays:

- Contract ID: Unique identifier for the contract
- From User: The current owner transferring the contract
- To User: The recipient of the contract transfer
- Project: The project associated with the contract
- Amount: The value of the contract being transferred
- Status: Current status of the transfer (Pending, Approved, Rejected)
- Date: When the transfer was initiated
- Action: Options to manage each transfer

## Page Controls

At the top of the page, you'll find the following controls:

- Search: Filter transfers by contract ID, user name, or project
- Status Filter: Filter by transfer status (All, Pending, Approved, Rejected)
- Refresh: Reload the transfers list

## Transfer Management Actions

### Action Menu Options

Each transfer row includes an action menu with the following options:

- View Details: View complete transfer information
- Approve: Approve the pending transfer request
- Reject: Reject the transfer request
- Change Status: Modify the transfer status

### Approve Transfer Confirmation

When selecting "Approve" from the action menu, a confirmation modal appears to verify the action:

#### Confirmation Dialog

- Warning Message: Confirmation prompt to approve the transfer
- Cancel Option: Button to abort the approval
- Confirm Option: Button to proceed with approving the transfer

This confirmation step ensures transfers are not accidentally approved, providing an extra layer of verification before ownership changes.

## Transfer Workflow

1. User Initiates Transfer: A contract owner requests to transfer their contract to another user
2. Pending Review: The transfer appears in the admin panel with "Pending" status
3. Admin Review: Administrator reviews the transfer details
4. Approval/Rejection: Admin approves or rejects the transfer
5. Completion: Upon approval, the contract ownership is updated