impact-api

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 15 Open GitHub ↗

Initiative for Minoritized Pioneers and Achievements in Computer Technology

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# impact

![IMPACT LOGO](https://raw.githubusercontent.com/Lauwed/impact-api/main/pwa/public/logo.png)

## Roadmap

- [ ] Fix `media_object` upload - `api` -> https://github.com/Lauwed/impact-api/issues/5
- [ ] Fix `person_picture` upload - `api`
- [ ] Sorting data - `api` -> https://github.com/Lauwed/impact-api/issues/6
- [ ] Add edit modal for the main picture on person page - `pwa`
- [ ] Add gallery section with images upload on person page - `pwa`
- [x] Add `Achievement` entity - `api`
- [x] Create achievements section on person page - `pwa`

## How to contribute?

As the project is still small and the setup isn't finish yet, please create your branch from `main` and submit your Pull Request when you are finished with your developments.

### ⚠️ Warning regarding --delete
The deployment workflow uses --delete option of `rsync` ensures that files removed from the Git repository are also deleted from the server. However, be cautious if the application generates files in production (e.g., logs, cache, or uploaded files), as they could be unintentionally deleted. If necessary, add specific --exclude rules to protect such directories.

## Install

### Docker

#### Build the containers
```
docker compose build --no-cache
```

#### Start the containers
```
docker compose up --wait
```

#### Access the DB

You have a default user named `app` with a PostgreSQL database by default named `app`

From the container
```
psql -U app
```
From outside the container
```
docker exec -it impact-api-database-1 psql -U app
```
Enter the database `app`
```
\c app
```

#### Generate JWT keys

```
docker compose exec php sh -c '
    set -e
    apt-get install openssl
    php bin/console lexik:jwt:generate-keypair
    setfacl -R -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt
    setfacl -dR -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt
'
```

#### Generate admin user
Generated by default when you start the containers.

**username:** admin

**email:** admin@localhost

**password:** admin

Don't hesitate to change the logins.

#### Debug logs
```
docker logs impact-api-php-1
```

### Manual

#### Generate JWT keys

```
php sh -c '
    set -e
    apt-get install openssl
    php bin/console lexik:jwt:generate-keypair
    setfacl -R -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt
    setfacl -dR -m u:www-data:rX -m u:"$(whoami)":rwX config/jwt
'
```

#### Generate admin user

```
php bin/console doctrine:fixtures:load --append
```

username: admin
password: admin

Don't hesitate to change the logins.

impact-api

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README