Aegis is a PC web instant messaging system built as the final project for Software Engineering, Tsinghua University, Spring 2026.
The project implements a full-stack chat application with account management, friend relationships, private chats, group chats, real-time notifications, group administration, an echo-yard feed, personal notes, message translation, a group bot, and tic-tac-toe invitations.
Frontend: frontend-dyno-whatthedogdoing.app.spring26b.secoder.net
This project won First Prize in the Excellent Course Project Evaluation.
Chat Overview
Echo Yard
Personal Notes
| Group Detail | Tic-Tac-Toe in Chat | Profile Settings |
|---|---|---|
![]() |
![]() |
![]() |
- User accounts: registration, login, JWT authentication, profile editing, password updates, and account deletion.
- Friend system: user search, friend requests, request handling, remarks, grouping, and deletion.
- Messaging: private chats, group chats, text and media messages, replies, recalls, unread counts, pinned chats, and mute settings.
- Group management: group creation, member invitations, join approvals, announcements, nicknames, administrators, ownership transfer, member removal, exit, and dissolution.
- Real-time delivery: WebSocket notifications with HTTP long-polling as a fallback.
- Extended experiences: echo-yard posts, personal notes, message translation, a group bot, and tic-tac-toe invitations.
| Layer | Tech |
|---|---|
| Frontend | React, Vite, Axios, Zustand, Ant Design Icons |
| Backend | FastAPI, Pydantic, SQLAlchemy |
| Database | SQLite / MySQL |
| Deployment | Docker, Nginx |
| Quality | pytest, pytest-cov, ESLint |
backend/ FastAPI backend service
frontend/ React + Vite frontend application
database/ Database container configuration
docs/screenshots/ README screenshots
PROJECT_REPORT.md Final course project report
Backend:
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reloadWindows PowerShell:
cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
uvicorn app.main:app --reloadFrontend:
cd frontend
npm install
npm run devThe frontend development server is usually available at http://localhost:5173, with API requests proxied to the backend configured by VITE_BACKEND_TARGET.
Common environment variables:
DATABASE_URL=sqlite:///./whatthedogdoing.db
SECRET_KEY=replace-with-a-random-secret
VITE_BACKEND_TARGET=http://localhost:8000
SILICONFLOW_API_KEY=optional-ai-service-key
Recommended checks before submission:
pytest backend/tests --cov=backend/app --cov-report=term-missing -q
cd frontend && npm run lint && npm run buildBackend tests cover authentication, friend relationships, group management, announcements, message notifications, database initialization and migration, and AI gateway failure handling. Frontend checks rely on linting and production builds.






