Bridge US V2

A fuller international-student community platform with posts, translation, moderation, AI Q&A, and admin tools.

Chinese · Bridge-US v1 · Quickstart · Features · Tech Stack

Overview

Bridge US V2 turns the early community idea into a broader full-stack product: multilingual content, search, notifications, moderation workflows, AI translation, AI Q&A, and admin operations.

It is an independent React/FastAPI rebuild rather than a patch on V1, so the codebase can evolve with clearer frontend/backend boundaries.

Features

• Posts, replies, saved posts, tags, categories, search, and profiles.
• AI translation and multilingual content workflow.
• AI moderation, reports, appeals, audit logs, and admin dashboard.
• AI Q&A assistant with guardrails for student-life questions.
• Implementation plans, API notes, and staged backend checks in repo docs.

How It Works

1. Run the FastAPI backend and apply Alembic migrations.
2. Run the React/Vite frontend against the backend API.
3. Configure email, OpenAI-compatible API, and database settings through backend .env.
4. Use admin and moderation workflows to operate community content.

Quickstart

Run the project locally with the commands below.

git clone https://github.com/Ha22yX/Bridge-US-V2.git
cd Bridge-US-V2/WebSite/BackEnd
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload

cd ../FrontEnd
npm install
npm run dev

Create backend .env values before using email, OpenAI, or production database features.

Configuration

Item	Purpose
Backend .env	Database URL, JWT/session secrets, OpenAI-compatible API keys, email settings.
Frontend API URL	Point the Vite app to the backend during local development or deployment.
Migrations	Run Alembic before using a fresh database.
Moderation	Review AI-assisted flows before trusting them in public communities.

Tech Stack

Layer	Technology	Role
Frontend	React, TypeScript, Vite, Tailwind	Responsive community interface.
Backend	FastAPI, SQLAlchemy, Alembic	API, auth, moderation, data model.
AI	OpenAI-compatible API	Translation, moderation, and Q&A flows.
Ops	SQLite/PostgreSQL, SMTP	Development and deployable services.

Project Layout

WebSite/FrontEnd/          React/Vite application
WebSite/BackEnd/           FastAPI backend and Alembic migrations
Docs/                      API and implementation plans
Accesses/Img/              logo and README preview assets
Test/Script/Backend        staged backend check scripts

Status

Fuller V2 rebuild. It shares the mission of Bridge-US v1 but should be treated as a separate, more complete codebase.

Related Projects

• Bridge-US v1 - companion/version reference.

License

No project-wide open-source license has been declared yet.