{"id":28286325,"url":"https://github.com/kamo333/ms-ai-hackathon","last_synced_at":"2026-07-10T02:31:09.580Z","repository":{"id":291237051,"uuid":"976652250","full_name":"KAMO333/MS-AI-Hackathon","owner":"KAMO333","description":"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.","archived":false,"fork":false,"pushed_at":"2025-05-04T14:55:25.000Z","size":299,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-21T20:12:05.695Z","etag":null,"topics":["css3","expressjs","html5","javascript","nodejs","openai","sql"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KAMO333.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-02T13:52:52.000Z","updated_at":"2025-05-04T18:49:52.000Z","dependencies_parsed_at":"2025-05-03T10:19:19.955Z","dependency_job_id":null,"html_url":"https://github.com/KAMO333/MS-AI-Hackathon","commit_stats":null,"previous_names":["kamo333/ms-ai-hackathon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KAMO333/MS-AI-Hackathon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KAMO333%2FMS-AI-Hackathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KAMO333%2FMS-AI-Hackathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KAMO333%2FMS-AI-Hackathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KAMO333%2FMS-AI-Hackathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KAMO333","download_url":"https://codeload.github.com/KAMO333/MS-AI-Hackathon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KAMO333%2FMS-AI-Hackathon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260462042,"owners_count":23013014,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css3","expressjs","html5","javascript","nodejs","openai","sql"],"created_at":"2025-05-21T20:12:05.451Z","updated_at":"2026-07-10T02:31:09.571Z","avatar_url":"https://github.com/KAMO333.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CareMind 🤝💬\n\n![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=nodedotjs\u0026logoColor=white)\n![Express.js](https://img.shields.io/badge/Express.js-000000?style=for-the-badge\u0026logo=express\u0026logoColor=white)\n![PostgreSQL](https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge\u0026logo=postgresql\u0026logoColor=white)\n![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge\u0026logo=html5\u0026logoColor=white)\n![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge\u0026logo=javascript\u0026logoColor=black)\n![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=for-the-badge\u0026logo=css3\u0026logoColor=white)\n![Jest](https://img.shields.io/badge/Jest-C21325?style=for-the-badge\u0026logo=jest\u0026logoColor=white)\n![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-2088FF?style=for-the-badge\u0026logo=github-actions\u0026logoColor=white)\n![Groq](https://img.shields.io/badge/Groq-F55036?style=for-the-badge\u0026logo=groq\u0026logoColor=white)\n\n[![Node.js CI](https://github.com/KAMO333/MS-AI-Hackathon/actions/workflows/tests.yml/badge.svg)](https://github.com/KAMO333/MS-AI-Hackathon/actions/workflows/tests.yml)\n\nA 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.\n\n---\n\n## 📁 Project Structure\n\n```text\nbackend/\n├── src/\n│   ├── controllers/    # Route logic \u0026 orchestration\n│   ├── db/             # Database connection \u0026 pooling\n│   ├── middleware/     # Request validation guards\n│   ├── routes/         # API endpoint definitions\n│   ├── services/       # External AI API integration\n│   ├── tests/          # Jest unit \u0026 integration tests\n│   └── server.js       # Entry point\nfrontend/               # Client-side assets (HTML/CSS/JS)\n.github/workflows/      # CI/CD (GitHub Actions)\n```\n\n---\n\n## ✨ Key Features\n\n- **MVC Architecture:** Decoupled concerns for high maintainability and scalability.\n- **AI Consultation Engine:** Context-aware guidance powered by Groq (Llama-3-70b).\n- **Cloud-Native Storage:** Robust data persistence using Neon PostgreSQL.\n- **Automated Quality Assurance:** 100% mocked testing environment using Jest.\n- **CI/CD Pipeline:** Automated test execution on every push via GitHub Actions.\n- **Modern UI:** Professional \"Digital Case File\" aesthetic with real-time state feedback.\n\n---\n\n## 🛠️ Technologies Used\n\n**Backend:**\n\n- Node.js (ES Modules)\n- Express.js\n- Groq SDK (Llama-3-70b-versatile)\n- PostgreSQL (pg) with Connection Pooling\n\n**Frontend:**\n\n- HTML5\n- Vanilla JS (Fetch API \u0026 DOM Manipulation)\n- CSS3 (Flexbox/Grid design system)\n\n**DevOps \u0026 Testing:**\n\n- Jest (Native ESM Testing)\n- GitHub Actions\n- Supertest (API Testing)\n\n---\n\n## 🚀 Installation Guide\n\n### Prerequisites\n\n- Node.js (v20+)\n- Neon.tech (or local PostgreSQL) account\n- Groq API Key\n\n### Setup Instructions\n\n#### 1. Clone \u0026 Install\n\n```bash\ngit clone https://git@github.com:KAMO333/MS-AI-Hackathon.git\ncd CareMind/backend\nnpm install\n```\n\n#### 2. Environment Configuration\n\nCreate a `.env` file in the `backend` folder:\n\n```env\nPORT=3000\nDATABASE_URL=postgres://user:password@hostname/dbname?sslmode=require\nGROQ_API_KEY=your_groq_key_here\n```\n\n#### 3. Database Migration\n\nRun this in your PostgreSQL console:\n\n```sql\nCREATE TABLE Clients (\n    id SERIAL PRIMARY KEY,\n    name VARCHAR(255) NOT NULL,\n    surname VARCHAR(255),\n    age INTEGER,\n    location VARCHAR(255),\n    issue TEXT,\n    response TEXT,\n    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n```\n\n---\n\n## 🧪 Running Tests\n\nThis project uses Native ESM with Jest. Run the automated suite with:\n\n```bash\nnpm test\n```\n\n---\n\n## 🏃 Running the Application\n\n#### 1. Start the Development Server\n\n```bash\nnpm run dev\n```\n\n#### 2. Access the UI\n\nOpen `http://localhost:3000` in your browser.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamo333%2Fms-ai-hackathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkamo333%2Fms-ai-hackathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkamo333%2Fms-ai-hackathon/lists"}