77 lines
2.9 KiB
Markdown
77 lines
2.9 KiB
Markdown
# Tech4Biz Channel Partner Onboarding & Secure Asset Management
|
|
|
|
An enterprise-grade, secure, multi-tenant portal designed for onboarding channel partners, managing digital assets, and orchestrating NDA/MSA legal workflows.
|
|
|
|
---
|
|
|
|
## 🛠️ Technology Stack
|
|
* **Frontend**: React (Vite, TypeScript, Tailwind CSS, Axios)
|
|
* **Backend**: Node.js (Express, TypeScript, Prisma ORM, JWT, Helmet)
|
|
* **Databases**: PostgreSQL (Relational metadata storage)
|
|
* **Object Storage**: MinIO (Private, S3-compatible asset storage container)
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start (Development)
|
|
|
|
### Prerequisites
|
|
* Ensure **Docker** and **Node.js** are installed and running.
|
|
* The startup scripts automatically detect and terminate any processes occupying backend/frontend ports to prevent crash loops.
|
|
|
|
### Step 1: Start Backend, Database, & Storage
|
|
From the project root:
|
|
```bash
|
|
./run-backend.sh
|
|
```
|
|
This script will:
|
|
1. Spin up the Postgres and MinIO containers.
|
|
2. Generate environment variables.
|
|
3. Align the database schemas via Prisma.
|
|
4. Run database seeders (Admin/Partner mock accounts).
|
|
5. **Automatically seed the MinIO bucket with static documents.**
|
|
6. Free port `5000` (if in use) and launch the backend server.
|
|
|
|
### Step 2: Start Frontend App
|
|
From the project root:
|
|
```bash
|
|
./run-frontend.sh
|
|
```
|
|
This script will resolve dependencies, free port `5173` (if in use), and launch the Vite development server on [http://localhost:5173](http://localhost:5173).
|
|
|
|
---
|
|
|
|
## 📂 MinIO Seeding & Data Transfer
|
|
|
|
### How Asset Seeding Works
|
|
To ensure that digital assets (like product guides and NDA templates) are transferred when cloning the repository:
|
|
1. Standard assets are committed to the **`minio-seed/`** directory in the repository root (not ignored by Git).
|
|
2. During server start (via `./run-backend.sh`), the backend runs the S3 seeder command:
|
|
```bash
|
|
npx ts-node src/seed-minio.ts
|
|
```
|
|
3. The script initializes the `secure-assets` bucket in MinIO and uploads any files found in the local `/minio-seed/` folder to the bucket, preserving exact filenames, MIME types, and sizes.
|
|
|
|
### Manual Seeding / Restore Command
|
|
If you ever reset your MinIO volume and need to re-populate the S3 bucket with the committed repository assets, run the following commands:
|
|
```bash
|
|
cd Channel-Backend
|
|
npx ts-node src/seed-minio.ts
|
|
```
|
|
|
|
---
|
|
|
|
## 🔑 Default Credentials & Admin Ports
|
|
|
|
### Web Interfaces
|
|
* **Frontend Dashboard**: [http://localhost:5173](http://localhost:5173)
|
|
* **MinIO Console Dashboard**: [http://localhost:9090](http://localhost:9090)
|
|
|
|
### Login Credentials
|
|
| System | User/ID | Password/Secret |
|
|
| :--- | :--- | :--- |
|
|
| **Admin Account** | `admin@tech4biz.com` | `Password123` |
|
|
| **Partner (Approved)** | `active-partner@partner.com` | `Password123` |
|
|
| **Partner (Pending NDA)** | `pending-onboarding@partner.com` | `Password123` |
|
|
| **MinIO Console** | `minio_admin` | `minio_password_2026` |
|
|
| **JWT Secrets** | *Auto-generated in `.env`* | `super-secret-jwt-key-2026-world-class` |
|