Skip to content
Kasun Akalanka edited this page Apr 26, 2026 · 3 revisions

⬑ OPOTIN - Student's Guide Chatbot

TAMK Student Guide Assistant - A student-facing AI chatbot powered by Microsoft Copilot Studio, with a secure Node.js proxy and a feedback analytics dashboard.


🌐 Live

Service URL
πŸ’¬ Chatbot opotin.ddnsking.com
πŸ“Š Admin Dashboard opotin-admin.duckdns.org

πŸ—ΊοΈ Wiki Navigation

Page What's inside
πŸ—οΈ Architecture System design, data flow, monorepo structure
✨ Features All key highlights across client, server, and admin
πŸ”Œ API Reference Endpoints, methods, authentication, request/response formats
πŸ€– Copilot Agent Configuration AI agent setup, knowledge base mapping, response rules
πŸš€ Setup & Configuration Install, configure, and run locally in simple steps
πŸ› οΈ Tech Stack Technologies used and their roles
🌍 Deployment Production infrastructure, CI/CD, and commands
πŸ‘₯ Team Team members and responsibilities
🩺 Troubleshooting Common issues and fixes

πŸ“ Project Structure

opotin/
β”œβ”€β”€ client/       # React + Vite chat UI          β†’ :5173
β”œβ”€β”€ server/       # Node.js Express proxy + API   β†’ :3000
β”œβ”€β”€ admin/        # React + Vite dashboard        β†’ :5174
└── package.json  # Root scripts (concurrently)

Each subproject is independently deployable with its own package.json, dev server, and scripts.


⚑ Quick Start

# 1. Install everything
npm install && npm run install-all

# 2. Configure the server
cp server/env.TEMPLATE server/.env
# β†’ edit server/.env with your DIRECT_LINE_SECRET and ADMIN_TOKEN

# 3. Run all three services
npm run dev
# Client  β†’ http://localhost:5173
# Server  β†’ http://localhost:3000
# Admin   β†’ http://localhost:5174

🏷️ Tech at a Glance

React TypeScript Vite TailwindCSS Node.js Express SQLite


Built for quick operational visibility into OPOTIN chatbot quality - TAMK, Finland.

⬑ OPOTIN Wiki


🌐 Live πŸ’¬ Chatbot πŸ“Š Admin Dashboard


πŸ“– Pages

🏠 Home πŸ—οΈ Architecture ✨ Features πŸ”Œ API Reference πŸš€ Setup & Config πŸ› οΈ Tech Stack 🌍 Deployment πŸ‘₯ Team 🩺 Troubleshooting


πŸ“ Subprojects

client/ Β· Chat UI Β· :5173 server/ Β· Proxy + API Β· :3000 admin/ Β· Dashboard Β· :5174


TAMK Student Guide

Clone this wiki locally