He4rt Developers Platform

He4rt Developers Platform

This is the central monorepo application and Discord Bot for the He4rt Developers community, built on top of a modular Laravel architecture.

Modules Overview

This project is divided into several interconnected modules:

• Activity: Tracks user actions and engagement.
• Bot Discord: The core Discord bot functionality.
• Community: Forum, discussions, and community features.
• Economy: Virtual economy system for members.
• Events: Management of community events.
• Gamification: Badges, levels, and achievements.
• Identity: Centralized authentication and user profiles.
• Panel Admin: A Filament-powered administrative dashboard.
• Portal: The main web interface for users.
• Integrations: Integrations with external platforms like DevTo, Discord, and Twitch.

Requirements

Before starting, ensure you have the following installed:

• PHP 8.3 or higher
• Composer
• Node.js & NPM
• Docker (for PostgreSQL & Redis)

Getting Started

1. Start Infrastructure: Spin up the required database and cache containers.

   make env-up

2. Project Setup: Install PHP and Node dependencies, generate keys, and link storage.

   make setup

3. Run the Development Server: Start the Laravel server, Vite, and required queues.

   make dev

4. Run the Discord Bot: Boot up the Discord bot locally.

   make bot

Code Quality & Testing

We use multiple tools to ensure code quality:

• Tests: Run the Pest test suite.

  make test

• Code Styler: Format code using Laravel Pint.

  make pint

• Static Analysis: Run PHPStan.

  make phpstan

Contributing to He4rt Developers Platform

To contribute to this project, follow these steps:

1. Fork this repository.
2. Create a branch: git checkout -b <branch_name>.
3. Make your changes and commit them: git commit -m '<commit_message>'.
4. Push your branch: git push -u origin <branch_name>.
5. Create the pull request.

Alternatively, see the GitHub documentation on how to create a pull request.

Contributors

Thanks go to these wonderful people:

danielhe4rt 💻	PedroPMS 💻	Clintonrocha98 💻	gvieira18 💻	hehehenri 💻
rafael-neris 💻	Canhassi12 💻	RichardGL11 💻	DiogoKaster 💻	PilsAraujo 💻
Novout 💻	matheusdsilva01 💻	1pride 💻

Contributions of any kind are welcome!

Our Ecosystem & Socials

Projects & Initiatives:

• Website (heartdevs.com)
• He4rt Developers Platform (This Repo)
• 4noobs
• He4rtLabs Challenges
• 100DiasDeCodigo

Social Media:

• LinkedIn
• X / Twitter
• Instagram
• Dev.to

License

This project is under the MIT license. See the LICENSE file for more details.

---

Maintained by the He4rt Developers team.