The open-source trust infrastructure for African commerce - QR
# AuthentiChain
**Anti-Counterfeit Product Verification Platform**
> Scan a QR code. Verify authenticity instantly. Protect your supply chain.
---
## Table of Contents
1. Overview
2. Quick Start
3. Architecture
4. API Documentation
5. Security & Compliance
6. Installation
7. Configuration
8. Usage
9. Testing
10. Deployment
11. Troubleshooting
12. Contributing
13. License
---
## Overview
### What is AuthentiChain?
AuthentiChain is a **B2B2C (Business-to-Business-to-Consumer) product verification platform** that enables manufacturers to combat counterfeit goods by embedding secure QR codes into products. Consumers and sellers can instantly verify authenticity by scanning the code.
### Key Features
- **Instant Verification**: Scan QR → Get authenticity result in
```
### Core Endpoints
#### 1. User Registration
```http
POST /api/auth/signup
Content-Type: application/json
{
"email": "user@example.com",
"password": "SecurePass123!",
"user_type": "manufacturer",
"company_name": "My Brand" (optional, for manufacturers)
}
Response (201 Created):
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com",
"user_type": "manufacturer"
}
```
#### 2. User Login
```http
POST /api/auth/login
Content-Type: application/json
{
"email": "user@example.com",
"password": "SecurePass123!"
}
Response (200 OK):
{
"access": "eyJhbGc...",
"refresh": "eyJhbGc...",
"user": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"email": "user@example.com"
}
}
```
#### 3. Verify Product (Core Feature)
```http
POST /api/verify/scan
Content-Type: application/json
{
"code_value": "product-id:timestamp:signature",
"latitude": 0.3149,
"longitude": 51.5290,
"device_type": "mobile"
}
Response (200 OK):
{
"is_authentic": true,
"status": "verified",
"product": {
"name": "Luxury Watch Pro",
"sku": "LW-PRO-001",
"category": "Luxury Goods"
},
"batch": "BATCH-2024-001",
"manufacturer": "Acme Luxury Brands",
"scan_count": 1250
}
OR
{
"is_authentic": false,
"status": "co …