TL-RTC-APP
Real-time IM application with chat channels, audio/video calls, file sharing, and admin management.
For Chinese documentation, see README_ZH.md.
Requirements
- Node.js 16+
- npm
- MySQL 5.7+
- Redis 4.0+
Quick Start
- Install dependencies:
npm install
- Start in HTTP mode:
npm run http
- Or start in HTTPS mode (recommended for media features):
npm run https
- Build frontend resources:
npx gulp default
- Open app URLs:
- App:
http://localhost:9096(orhttps://localhost:9096) - Admin:
http://localhost:9098/system.html(orhttps://localhost:9098/system.html)
Session Summary (2026-05-02)
This section summarizes the major changes completed in this working session.
Functional Changes
- Removed shared clipboard module from backend, frontend, routing, permissions, tables, services, and build assets.
- Updated SSO subject handling to pass through all
subject_typevalues directly. - Ensured subject users always create/join main channels during SSO flow.
Data Model and DB Fixes
- Updated
tl_channel.store_typefrom integer-based logic to string-based subject type support. - Fixed friend channel initialization failure caused by
storeTypetype mismatch in channel service. - Restored
tl_user.sso_idtoBIGINT(20) UNSIGNEDand aligned service defaults back to numeric behavior. - Cleaned incompatible
sso_idvalues before schema restore where necessary.
Frontend and Media Stability
- Fixed
getUserMedialegacy compatibility by normalizing old APIs to Promise-based behavior. - Added clearer media error messages (
NotAllowedError,NotFoundError,NotReadableError,SecurityError, unsupported browser). - Added pre-check for available
audioinputdevices to avoid direct runtimeNotFoundErrorsurprises.
Runtime and Deployment Notes
- Rebuilt both product and admin frontend bundles after changes:
npx gulp webnpx gulp system
- Resolved HTTPS startup failure (
ERR_SSL_EE_KEY_TOO_SMALL) by replacing weak cert/key with stronger local cert material. - Diagnosed Windows "flashing cmd" symptom as PM2 process restart loops; resolved by fixing startup-time data/type issues.
Git and Remote
- Updated remote to private Git server via SSH and successfully pushed
main.
License
MIT. See LICENSE.
Disclaimer
See DISCLAIMER.md.
Languages
JavaScript
75%
HTML
16.5%
CSS
8.5%