{"id":28263651,"url":"https://github.com/nurdaulet-no/cortex-chat-backend","last_synced_at":"2026-05-04T10:37:27.091Z","repository":{"id":287912894,"uuid":"965977174","full_name":"Nurdaulet-no/cortex-chat-backend","owner":"Nurdaulet-no","description":"Real-time chat application built with Spring Boot, WebSocket (STOMP), Spring Security (JWT), and PostgreSQL.","archived":false,"fork":false,"pushed_at":"2025-05-18T13:01:55.000Z","size":1443,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-26T12:59:06.052Z","etag":null,"topics":["chat-application","flyway","java","jpa-hibernate","maven","postgresql","spring-boot","spring-security-jwt","websocket-stomp-api"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Nurdaulet-no.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-04-14T07:59:05.000Z","updated_at":"2025-05-18T13:24:46.000Z","dependencies_parsed_at":"2025-05-06T20:45:02.101Z","dependency_job_id":null,"html_url":"https://github.com/Nurdaulet-no/cortex-chat-backend","commit_stats":null,"previous_names":["nurdaulet-no/websocket-chat-app","nurdaulet-no/cortexchat"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Nurdaulet-no/cortex-chat-backend","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nurdaulet-no%2Fcortex-chat-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nurdaulet-no%2Fcortex-chat-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nurdaulet-no%2Fcortex-chat-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nurdaulet-no%2Fcortex-chat-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Nurdaulet-no","download_url":"https://codeload.github.com/Nurdaulet-no/cortex-chat-backend/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Nurdaulet-no%2Fcortex-chat-backend/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260512069,"owners_count":23020323,"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":["chat-application","flyway","java","jpa-hibernate","maven","postgresql","spring-boot","spring-security-jwt","websocket-stomp-api"],"created_at":"2025-05-20T08:11:48.451Z","updated_at":"2026-05-04T10:37:27.084Z","avatar_url":"https://github.com/Nurdaulet-no.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Real-Time Chat Application (Spring Boot + WebSocket) 🚀\n\nA real-time chat application built with Spring Boot, WebSocket (STOMP), Spring Security (JWT), and PostgreSQL. Supports both group and private messaging.\n\n## Features\n\n- Secure authentication with JWT\n- Real-time messaging via WebSockets/STOMP\n- Group and private chats\n- Message history persistence\n- User management in chat rooms\n- System notifications\n\n## Tech Stack\n\n- **Backend**: Java 17+, Spring Boot 3.x (Web, Security, WebSocket, Data JPA)\n- **Database**: PostgreSQL (Flyway migrations)\n- **Authentication**: JWT\n\n## Setup\n\n1. **Prerequisites**: JDK 17+, Maven, PostgreSQL\n\n2. **Configure Database**:\n    - Create a PostgreSQL database\n    - Update `src/main/resources/application.properties` with your database details and JWT settings\n\n3. **Run Application**:\n   ```bash\n   mvn clean package\n   mvn spring-boot:run\n\n   ```\n\n4. Application runs at: `http://localhost:8080`\n\n## API Overview\n\n- **Auth**: `/api/auth/register`, `/api/auth/login`\n- **Chats**:\n    - List chats: `GET /api/chats`\n    - Create group: `POST /api/chats/group`\n    - Private chat: `POST /api/chats/private/{username}`\n    - Messages: `GET /api/chats/{roomId}/messages`\n    - Manage participants: `PUT|DELETE /api/chats/{roomId}/participants/{username}`\n\n## WebSocket Usage\n\n1. **Connect**: `ws://localhost:8080/ws` with JWT in Authorization header\n2. **Send**: `/app/chat/{roomId}/sendMessage` with message content\n3. **Subscribe**: `/topic/chats/{roomId}` to receive messages\n\n## Future Enhancements\n\n- Typing indicators\n- Read receipts\n- Message editing/deletion\n- User search\n- Docker support","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnurdaulet-no%2Fcortex-chat-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnurdaulet-no%2Fcortex-chat-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnurdaulet-no%2Fcortex-chat-backend/lists"}