Metadata-Version: 2.5
Name: university-marketplace
Version: 0.1.1
Summary: University Marketplace: listings, sellers, inventory, orders with escrow, disputes and reviews for the University platform.
Project-URL: Homepage, https://github.com/NzeStan/University
Project-URL: Documentation, https://github.com/NzeStan/University/blob/main/docs/modules/marketplace.md
Project-URL: Source, https://github.com/NzeStan/University
Project-URL: Changelog, https://github.com/NzeStan/University/blob/main/CHANGELOG.md
Author-email: Ifeanyi Stanley <nnamaniifeanyi10@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: africa,django,drf,escrow,listings,marketplace,orders,reviews,university
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.2
Classifier: Framework :: Django :: 6.0
Classifier: Framework :: Django :: 6.1
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: university-core<0.2,>=0.1.1
Provides-Extra: test
Requires-Dist: drf-spectacular>=0.27; extra == 'test'
Requires-Dist: pytest-cov>=5; extra == 'test'
Requires-Dist: pytest-django>=4.8; extra == 'test'
Requires-Dist: pytest>=8; extra == 'test'
Description-Content-Type: text/markdown

# university-marketplace

A campus marketplace for the [University platform](https://github.com/NzeStan/University):
listings, sellers, inventory, orders with escrow, disputes and reviews. This is an optional
*level two* module that depends only on `university-core`.

- **Listings** have categories (with subcategories), conditions, stock, images (content-checked)
  and pickup or delivery options. They can be limited to a campus or community audience.
- **Stock can't oversell or go negative.** It's reserved when an order is placed and returned
  when the order is cancelled or expires unpaid.
- **Buyer protection.**
  - Online orders are paid through any payments module (via Core's payable contract) and held in
    escrow.
  - The money is released when the buyer confirms delivery, or automatically after a dispute
    window.
  - Mediators resolve disputes: a full or partial refund, or release to the seller.
- **Cash on pickup** for everyday campus trades (clearly without protection).
- **Reviews** are tied to completed orders, with seller replies and moderated ratings.
- **Trust and safety:**
  - Listings and reviews are moderatable with an explicit policy; removed scam listings refund
    their buyers.
  - Blocks, spam screening and content-creation restrictions all apply.
  - Delivery addresses are visible only to the two parties and erased after the order closes.

```bash
pip install university-marketplace university-payments
```

```python
INSTALLED_APPS += ["university.marketplace", "university.payments"]
```

See [the module documentation](../../docs/modules/marketplace.md).
