https://github.com/kamo333/ms-ai-hackathon
HTML5, CSS3, JavaScript, Node.js, Express, OpenAI integration, SQL database management – developed for the Microsoft AI Hackathon 2025. A full-stack application that helps social workers manage client information with AI-powered assistance, providing context-aware suggestions based on integrated client data.
https://github.com/kamo333/ms-ai-hackathon
css3 expressjs html5 javascript nodejs openai sql
Last synced: 4 days ago
JSON representation
HTML5, CSS3, JavaScript, Node.js, Express, OpenAI integration, SQL database management – developed for the Microsoft AI Hackathon 2025. A full-stack application that helps social workers manage client information with AI-powered assistance, providing context-aware suggestions based on integrated client data.
- Host: GitHub
- URL: https://github.com/kamo333/ms-ai-hackathon
- Owner: KAMO333
- Created: 2025-05-02T13:52:52.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-04T14:55:25.000Z (about 1 year ago)
- Last Synced: 2025-05-21T20:12:05.695Z (about 1 year ago)
- Topics: css3, expressjs, html5, javascript, nodejs, openai, sql
- Language: JavaScript
- Homepage:
- Size: 292 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CareMind 🤝💬
[](https://github.com/KAMO333/MS-AI-Hackathon/actions/workflows/tests.yml)
A professional full-stack application designed for social workers to manage client interactions with AI-powered clinical guidance. This project showcases a modern MVC (Model-View-Controller) architecture, cloud-native database integration, and automated testing.
---
## 📁 Project Structure
```text
backend/
├── src/
│ ├── controllers/ # Route logic & orchestration
│ ├── db/ # Database connection & pooling
│ ├── middleware/ # Request validation guards
│ ├── routes/ # API endpoint definitions
│ ├── services/ # External AI API integration
│ ├── tests/ # Jest unit & integration tests
│ └── server.js # Entry point
frontend/ # Client-side assets (HTML/CSS/JS)
.github/workflows/ # CI/CD (GitHub Actions)
```
---
## ✨ Key Features
- **MVC Architecture:** Decoupled concerns for high maintainability and scalability.
- **AI Consultation Engine:** Context-aware guidance powered by Groq (Llama-3-70b).
- **Cloud-Native Storage:** Robust data persistence using Neon PostgreSQL.
- **Automated Quality Assurance:** 100% mocked testing environment using Jest.
- **CI/CD Pipeline:** Automated test execution on every push via GitHub Actions.
- **Modern UI:** Professional "Digital Case File" aesthetic with real-time state feedback.
---
## 🛠️ Technologies Used
**Backend:**
- Node.js (ES Modules)
- Express.js
- Groq SDK (Llama-3-70b-versatile)
- PostgreSQL (pg) with Connection Pooling
**Frontend:**
- HTML5
- Vanilla JS (Fetch API & DOM Manipulation)
- CSS3 (Flexbox/Grid design system)
**DevOps & Testing:**
- Jest (Native ESM Testing)
- GitHub Actions
- Supertest (API Testing)
---
## 🚀 Installation Guide
### Prerequisites
- Node.js (v20+)
- Neon.tech (or local PostgreSQL) account
- Groq API Key
### Setup Instructions
#### 1. Clone & Install
```bash
git clone https://git@github.com:KAMO333/MS-AI-Hackathon.git
cd CareMind/backend
npm install
```
#### 2. Environment Configuration
Create a `.env` file in the `backend` folder:
```env
PORT=3000
DATABASE_URL=postgres://user:password@hostname/dbname?sslmode=require
GROQ_API_KEY=your_groq_key_here
```
#### 3. Database Migration
Run this in your PostgreSQL console:
```sql
CREATE TABLE Clients (
id SERIAL PRIMARY KEY,
name VARCHAR(255) NOT NULL,
surname VARCHAR(255),
age INTEGER,
location VARCHAR(255),
issue TEXT,
response TEXT,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```
---
## 🧪 Running Tests
This project uses Native ESM with Jest. Run the automated suite with:
```bash
npm test
```
---
## 🏃 Running the Application
#### 1. Start the Development Server
```bash
npm run dev
```
#### 2. Access the UI
Open `http://localhost:3000` in your browser.
---