Skip to content

v1.0.0 β€” Initial Public Release πŸŽ‰

Latest
Latest

Choose a tag to compare

View all tags
@jungang jungang released this 09 May 07:01
v1.0.0
8ebad07

AlumNet v1.0.0 β€” Initial Public Release

AI-Powered School History Exhibition & Alumni Management System

We're excited to announce the first public release of AlumNet β€” the first open-source AI-powered alumni exhibition system designed for school history museums.

✨ Highlights

πŸ–₯️ Touch-Screen Exhibition Kiosk

An immersive frontend built with Vue 3 + Three.js, featuring:

  • Alumni Galaxy β€” 3D interactive star map visualization of alumni
  • Time Corridor β€” Chronological photo gallery organized by graduation year
  • Vintage Museum β€” Digital archive of historical items
  • AI Smart Search β€” Natural language Q&A powered by RAG (Qdrant + pgvector)
  • Interactive Message Board β€” Alumni greetings and memories wall
  • Sci-fi standby screen with real-time clock and wake-on-touch

πŸ€– AI-Powered Smart Search

Natural language query powered by RAG architecture:

  • Ask questions like "ε“ͺδΊ›ζ ‘ε‹εœ¨εŒ»η–—ι’†εŸŸε·₯作？" and get intelligent answers
  • Multi-provider support: GLM-4, DeepSeek, or any OpenAI-compatible API
  • Powered by Qdrant vector database + pgvector embeddings

βš™οΈ Admin Dashboard

Complete management backend with Element Plus:

  • Alumni CRUD with batch import/export (Excel supported)
  • Graduation photo management with face tagging
  • Content moderation for messages & comments
  • System dashboard with usage analytics
  • One-click database backup & restore

πŸ—οΈ Production-Ready Infrastructure

  • Docker Compose β€” One command to production (docker compose up -d)
  • PM2 β€” Process management with auto-restart
  • Nginx β€” Reverse proxy with SPA routing
  • PostgreSQL + pgvector β€” Reliable data storage with vector support

πŸ› οΈ Tech Stack

Layer Technology
Kiosk Frontend Vue 3 Β· TypeScript Β· Three.js Β· Tailwind CSS
Admin Dashboard Vue 3 Β· TypeScript Β· Element Plus
Backend API Node.js Β· Express Β· TypeScript
Database PostgreSQL Β· pgvector
Vector Search Qdrant
AI Engine GLM-4 / DeepSeek API
Deployment Docker Β· PM2 Β· Nginx

πŸ“Š What's Included

  • 19 admin views for complete alumni management
  • RAG-powered hybrid search with keyword fallback
  • AI summary service for auto-generating alumni profiles
  • Comprehensive test suite with Vitest
  • CI/CD pipeline with GitHub Actions (lint β†’ test β†’ build)
  • ESLint 9 + Prettier 3 + Husky pre-commit hooks
  • Commitlint with conventional commits enforcement

πŸš€ Quick Start

git clone https://github.com/jungang/alumnet.git
cd alumnet
pnpm install
cp server/.env.example server/.env
# Configure your settings, then:
pnpm dev:server   # Backend API β†’ http://localhost:3000
pnpm dev:client   # Kiosk frontend β†’ http://localhost:5173
pnpm dev:admin    # Admin dashboard β†’ http://localhost:5174

Or with Docker:

cp server/.env.example server/.env
# Edit .env with production values
docker compose up -d

⚠️ Disclaimer

All alumni data included in this project is fictional and for demonstration purposes only. Do not use the sample data in production environments.

🀝 Get Involved

Made with ❀️ for school history museums everywhere

Assets 2
Loading