Skip to content

khovan123/alignify-backend

BranchesTags

Repository files navigation

🚀 Alignify Backend

EN:
Alignify is a management platform connecting social network influencers and brands, providing robust APIs for campaign, content, chat, and admin management.

VI:
Alignify là nền tảng quản lý kết nối Influencer và Brand trên mạng xã hội, cung cấp API mạnh mẽ cho quản lý chiến dịch, nội dung, chat và admin.

✨ Features

  • Brand: Launch & manage campaigns, send invitations, review influencer progress.
  • Influencer: Create content, apply to campaigns, update progress, interact.
  • Admin: Moderate content/users, handle reports, create upgrade packages.
  • Group chat: Brands & Influencers chat during collaborations.
  • Interactions: Like, comment on influencer posts.

🛠️ Tech Stack
☕ Java 21+ 🧑‍💻 Spring Boot 3.x
🍃 MongoDB 📨 Gmail SMTP
☁️ Cloudinary 💳 PAYOS, PayPal
📦 Docker 🔑 JWT Auth
📝 Swagger UI

🚦 Getting Started

1️⃣ Clone & Build

git clone https://github.com/khovan123/alignify-backend.git
cd alignify-backend
./mvnw clean install

2️⃣ Configure Environment Variables

Create a .env file or set the following environment variables:

API_SECRET_KEY=...
MONGODB_URI=...
MAIL_USERNAME=...
MAIL_PASSWORD=...
CLOUDINARY_CLOUD_NAME=...
CLOUDINARY_API_KEY=...
CLOUDINARY_API_SECRET=...
GOOGLE_CLIENT_ID=...
GOOGLE_SECRET_KEY=...
GEMINI_API_KEY=...
RAPIDAPI_KEY=...
PAYOS_CLIENT_ID=...
PAYOS_API_KEY=...
PAYOS_CHECKSUM_KEY=...
PAYPAL_CLIENT_ID=...
PAYPAL_CLIENT_SECRET=...

3️⃣ Run Locally

./mvnw spring-boot:run

Access Swagger UI for API documentation:
http://localhost:8080/swagger-ui
Or online Swagger UI:
https://alignify-backend.onrender.com/swagger-ui

4️⃣ Run with Docker

docker build -t alignify-backend .
docker run -d --env-file .env -p 8080:8080 alignify-backend

5️⃣ Live Frontend

Access the live web app:
https://alignify-rose.vercel.app

📚 Roles & Permissions

🛡️ Admin 🎯 Brand ⭐ Influencer
Manage/ban users Create/manage campaigns Create post, apply campaign
Delete content/campaign Invite influencer, review progress Accept/decline invites
Handle reports Track campaign progress Update progress
Create upgrade packages

📦 Release Information

Current Version: v1.3.1 (July 24, 2025)
Release Type: Initial Stable Release
Compatibility: Production Ready

📋 Quick Links

🏷️ Version Tags

This project follows Semantic Versioning:

  • Production: v1.0.0, v1.1.0, v2.0.0
  • Pre-release: v1.1.0-alpha.1, v1.1.0-beta.1, v1.1.0-rc.1
  • All tags are prefixed with v following best practices

🔗 API Overview

🌟 Contribution Guide

  1. Fork & create a new branch.
  2. Follow the DETAILED_DESIGN.md file (required!).
  3. Pull Request: Provide a clear description and link related tasks/discussions.
  4. Update API docs if API structure changes.
  5. Thorough code review before merging.

📜 License

MIT © khovan123

EN:
All changes must strictly follow the detailed design file and project conventions.

🎉 Welcome to Alignify — The modern platform for brand & influencer collaboration!

🚀 Alignify Backend (Tiếng Việt)

VI:
Alignify là nền tảng quản lý kết nối Influencer và Brand trên mạng xã hội, cung cấp API mạnh mẽ cho quản lý chiến dịch, nội dung, chat và admin.

✨ Tính Năng

  • Brand: Đăng & quản lý chiến dịch, gửi lời mời, duyệt tiến độ influencer.
  • Influencer: Đăng bài, ứng tuyển chiến dịch, cập nhật tiến độ, tương tác.
  • Admin: Quản lý bài đăng/người dùng, xử lý báo cáo, tạo gói nâng cấp.
  • Chat nhóm: Brand & Influencer chat trao đổi khi hợp tác.
  • Tương tác: Like, comment trên bài content/idea của influencer.

🛠️ Công Nghệ
☕ Java 21+ 🧑‍💻 Spring Boot 3.x
🍃 MongoDB 📨 Gmail SMTP
☁️ Cloudinary 💳 PAYOS, PayPal
📦 Docker 🔑 JWT Auth
📝 Swagger UI

🚦 Bắt Đầu Nhanh

1️⃣ Clone & Build

git clone https://github.com/khovan123/alignify-backend.git
cd alignify-backend
./mvnw clean install

2️⃣ Cấu Hình Biến Môi Trường

Tạo file .env hoặc đặt các biến môi trường như sau:

API_SECRET_KEY=...
MONGODB_URI=...
MAIL_USERNAME=...
MAIL_PASSWORD=...
CLOUDINARY_CLOUD_NAME=...
CLOUDINARY_API_KEY=...
CLOUDINARY_API_SECRET=...
GOOGLE_CLIENT_ID=...
GOOGLE_SECRET_KEY=...
GEMINI_API_KEY=...
RAPIDAPI_KEY=...
PAYOS_CLIENT_ID=...
PAYOS_API_KEY=...
PAYOS_CHECKSUM_KEY=...
PAYPAL_CLIENT_ID=...
PAYPAL_CLIENT_SECRET=...

3️⃣ Chạy Local

./mvnw spring-boot:run

Truy cập tài liệu API tại Swagger UI:
http://localhost:8080/swagger-ui
Hoặc xem Swagger UI online:
https://alignify-backend.onrender.com/swagger-ui

4️⃣ Chạy bằng Docker

docker build -t alignify-backend .
docker run -d --env-file .env -p 8080:8080 alignify-backend

5️⃣ Truy Cập Website

Truy cập web live tại:
https://alignify-rose.vercel.app

📚 Phân Quyền & Vai Trò

🛡️ Admin 🎯 Brand ⭐ Influencer
Quản lý/cấm user Đăng & quản lý chiến dịch Đăng bài, ứng tuyển
Xoá bài, chiến dịch Mời influencer, duyệt tiến độ Nhận/từ chối lời mời
Xử lý báo cáo Quản lý tiến độ Cập nhật tiến độ
Tạo gói nâng cấp

📦 Thông Tin Phiên Bản

Phiên Bản Hiện Tại: v1.3.1 (24 tháng 7, 2025)
Loại Phiên Bản: Phiên Bản Ổn Định Đầu Tiên
Tương Thích: Sẵn Sàng Production

📋 Liên Kết Nhanh

🏷️ Tag Phiên Bản

Dự án tuân thủ Semantic Versioning:

  • Production: v1.0.0, v1.1.0, v2.0.0
  • Pre-release: v1.1.0-alpha.1, v1.1.0-beta.1, v1.1.0-rc.1
  • Tất cả tag đều có tiền tố v theo best practices

🔗 Tổng Quan API

🌟 Đóng Góp

  1. Fork & tạo branch mới.
  2. Tuân thủ file DETAILED_DESIGN.md (bắt buộc!).
  3. Pull Request: Mô tả rõ ràng, dẫn nguồn task/thảo luận liên quan.
  4. Update tài liệu API nếu thay đổi cấu trúc API.
  5. Code review kỹ lưỡng trước khi merge.

📜 Giấy Phép

MIT © khovan123

VI:
Mọi thay đổi phải tuân thủ nghiêm ngặt file thiết kế chi tiết & quy tắc dự án!

🎉 Chào mừng đến với Alignify — Nền tảng kết nối thương hiệu & người ảnh hưởng hiện đại!

About

The management system connects influential people on social networks and advertising brands.

Resources

Readme
Activity

Stars

4 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 1

alignify_v1.3.1 Latest
Jul 24, 2025

Packages

 
 
 

Contributors

Languages