Welcome to the official documentation for Yukinu—a modern multi-vendor e-commerce platform that enables buyers to shop from multiple sellers in a unified marketplace experience.
This documentation provides complete technical and product information for the Yukinu ecosystem. Whether you are a developer, a system administrator, or a product manager, these documents offer a comprehensive guide to understanding, operating, and extending the platform.
Live Previews
- Web App: https://yukinu.vercel.app
- Dashboard: https://yukinu-dashboard.vercel.app
- Mobile App: Download APK from GitHub Releases
- This Documentation: https://tiesen243.github.io/yukinu
Core Documentation Sections
- 1. Overview: Introduction to the Yukinu project, its purpose, and key features.
- 1.1. Development Setup: A step-by-step guide for setting up the project for local development.
- 1.2. System Architecture: A high-level overview of the system’s design, components, and the relationships between them.
- 2. User Guide: A practical, role-based guide to using the platform’s features.
- 3. Legal: Terms of Service, Privacy Policy, and other legal documentation.
- 4. Use Cases: A functional breakdown of all services, detailing the preconditions, post-conditions, actors, and flows for every feature.
- 5. Sequence Diagrams: Visual representations of the interaction flows for each use case, illustrating how actors and the system communicate to achieve specific goals.
- 6. Database: An overview of the database schema, tables, and relationships.
Key Features
The Yukinu platform is designed with a rich set of features to support a complete multi-vendor marketplace experience.
For Customers
- Unified Shopping Cart: Purchase items from multiple vendors in a single checkout transaction.
- Advanced Search & Filtering: Easily find products with powerful search and attribute-based filtering.
- Wishlist: Save products for later and track desired items.
- Order Management: View order history, track shipping status, and manage returns.
- Account Management: Update profiles, manage shipping addresses, and view personal data.
- Vendor Discovery: Browse products by specific vendors and explore different storefronts.
For Vendors
- Vendor Dashboard: A dedicated interface for managing products, orders, and staff.
- Product Management: Full CRUD (Create, Read, Update, Delete) for products, including variants like size and color.
- Order Processing: View and update the status of orders from processing to shipped.
- Staff Management: Invite and manage team members with access to the vendor dashboard.
- Storefront Profile: Manage public-facing store information and branding.
For Administrators
- Centralized Admin Dashboard: A powerful interface to oversee the entire marketplace.
- User & Vendor Management: Approve, suspend, or manage users and vendors.
- Content Moderation: Moderate products and other content across the platform.
- Category Management: Define and organize the product categories available in the marketplace.
- System-wide Analytics: (Planned) Access to key metrics and dashboards for monitoring platform health and growth.
Project To-Do List
Guest
- Register an account
- Login
- Browse product list
- View product details
- Search and filter products
- View products by vendor
- Reset password (forgot password)
User (Customer)
- Update personal profile
- Manage shipping addresses (CRUD)
- Add product to wishlist
- Remove product from wishlist
- Add product to cart
- Place an order (checkout)
- Make payment
- Track order status
- Cancel order (if not processed yet)
- Review products
- View order history
Vendor Owner / Manager
- Apply to become a vendor
- Manage store information
- Manage products (list/create/update)
- Manage product images
- Manage product variants (size, color, etc.)
- Manage vendor-specific orders
- Update order status (processing → shipped → delivered)
- Manage vendor members (add / remove)
Admin
- Manage users (activate / deactivate)
- Manage vendors (approve / suspend)
- Manage product categories (CRUD)
- Moderate products across the system
- System analytics & dashboards
- Manage roles & permissions (optional)
Payment System Integration
- Initialize payment transaction
- Confirm successful payment – [ ] Handle failed or refunded payments
Optional Enhancements
- Vendor payout system
- Coupon / voucher management
- Email notifications & marketing automation
Contributing
Guidelines for reporting issues and contributing improvements will be provided later.
License
This project is licensed under the terms of the LICENSE.