{"id":13557613,"url":"https://github.com/AtelierSoude/OpenRepairPlatform","last_synced_at":"2025-04-03T12:30:52.201Z","repository":{"id":31604956,"uuid":"127430187","full_name":"AtelierSoude/OpenRepairPlatform","owner":"AtelierSoude","description":"OpenRepairPlatform is a web application based on Django designed to organizing collaborative and non-profits repair structures - Still in development ","archived":false,"fork":false,"pushed_at":"2025-03-26T14:40:23.000Z","size":17007,"stargazers_count":36,"open_issues_count":33,"forks_count":18,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-26T15:43:48.135Z","etag":null,"topics":["collaborative","community","django-project","event-management","membership-management","non-profit-organizations","repair-management"],"latest_commit_sha":null,"homepage":"","language":"Python","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/AtelierSoude.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}},"created_at":"2018-03-30T13:16:01.000Z","updated_at":"2025-03-26T14:40:30.000Z","dependencies_parsed_at":"2023-02-14T16:31:50.632Z","dependency_job_id":"6987961c-3fa6-4dad-a685-3ec620e53d79","html_url":"https://github.com/AtelierSoude/OpenRepairPlatform","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierSoude%2FOpenRepairPlatform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierSoude%2FOpenRepairPlatform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierSoude%2FOpenRepairPlatform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AtelierSoude%2FOpenRepairPlatform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AtelierSoude","download_url":"https://codeload.github.com/AtelierSoude/OpenRepairPlatform/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247002127,"owners_count":20867403,"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":["collaborative","community","django-project","event-management","membership-management","non-profit-organizations","repair-management"],"created_at":"2024-08-01T12:04:27.003Z","updated_at":"2025-04-03T12:30:47.174Z","avatar_url":"https://github.com/AtelierSoude.png","language":"Python","funding_links":[],"categories":["Python","others"],"sub_categories":[],"readme":"\n# OpenRepairPlatform\n\nCe projet cherche à faciliter l’accessibilité de la réparation par le plus grand nombre. Par une interface simple et claire, l'application web invite participants et organisations à collaborer autours de l’auto-réparation et de la réparation participative.\n\nOpenRepairPlateform est une application basée sur Django, pensée pour organiser les structures de réparations participatives.\nElle intègre principalement des fonctionnalités de gestion d'organisation, de membres, de comptabilité, la publication d'événements, d'inventaire et de suivi/partage de réparations.\n\nCette application est développée et notamment utilisée par [l'Atelier Soudé](https://atelier-soude.fr) pour la plateforme [Réparons](https://dev.atelier-soude.fr).\n\nToute la documentation d'installation et d'utilisation est disposible [ici](https://openrepairplatform.readthedocs.io/en/latest/).\n\n----- ENG -----\n\nThis application is still in developpment.\nAny contributes are welcome. Please contact us if you want to contribute and we tell you how to.\n\n# Atelier Soudé\n\nOpenRepairPlatform is a Django based application designed to organize collaborative repair structures, features provides organization managment, event publishing, community members managment, repair tracking and sharing.\n\nThe plateform is created by Atelier Soudé, an organization which repair everyday's people electric and electronic objects in Lyon, France.\n\nFull installation and user documentation are avalaible [here](https://openrepairplatform.readthedocs.io/en/latest/). (sorry, only in French at this point !)\n\nFor basic develop installation, follow those steps:\n\n## Run the application (in Develop mode only)\n\n1.Set django, postgres and nginx/domain variables in `openrepairplatform/.env` \n\n2.Run the following command:\n\n```\ndocker-compose up\n```\nYou can then access `http://127.0.0.1:8000/` and log with the admin user `admin@example.com` // `adminpass`\n\n3.Create an organization within the `http://127.0.0.1:8000/organizations` path and you can start everythings else (further documentation will come)\n\n### Debug with Visual Studio Code\n\nIf you open the main folder with vs code, you will be able to use the configuration present in `.vscode`.\n\nThis will allow you to connect to the container in debug mode and to stop at breakpoints in the code, which is quite confortable to inspect the variables and test new code in the required state of the program (typically before a failure).\nBefore starting, you may have to install the Python extension.\n\nFor this, just click on `Debug`, and `Start Debugging`: you will run the `Debug Django app` configuration. \nA small additional bar will appear with useful commands for the debug: go to next breakpoint, stop debugging, etc\nMore information on debugging with vs code: `https://code.visualstudio.com/Docs/editor/debugging`\n\nCreate a breakpoint in the code, for example in a view, and go to the corresponding page from your browser.\nThe browser will freeze and vs code will stop at the breakpoint.\n\nIn the lower part of vs code, in the `DEBUG CONSOLE`, you can test code.\n\nIn the debug section, in the left vertical bar, you can see all the breakpoints, all the variables and their content, and the call stack.\nYou can click on any step of the call stack, and browser the variables, test some code, etc, at this step.\n\n### Coding \"live\"\n\nThe local code is mounted in a Docker volume, so if you change the code locally and refresh your browser, you will immediatly see the changes.\n\n### Run unit tests\n\nFirst, start the containers with `docker-compose up`\nThen, run the tests with `docker exec openrepairplatform_django_1 pytest --disable-pytest-warnings --cov=openrepairplatform --cov-report term-missing`\n\n\n### Run integration tests\n\nIntegration tests are run using a Docker image containing a chrome Selenium installation and a VNC server.\nIt is possible to debug the tests using a local VNC client that connects to the VNC server in the Docker container, that allows to graphically see what the selenium test is doing on the site.\n\nTo install the VNC client on your local computer:\n\n`sudo apt-get install krdc`\n\nTo launch it:\n\n`krdc`\n\nStart KRDC, and connect to `localhost:5900`\n\nTo see the running chrome sessions:\n`http://localhost:4444/wd/hub/static/resource/hub.html`\n\nTo launch the tests :\n\nFirst, start the Docker containers with `docker-compose up`, and then:\n\n`docker exec openrepairplatform_selenium_1 python3 -m pytest /tests/integration_tests.py -v`\n\nIf you uncomment the following lines, it will wait for a debugger to connect before running the tests\n\n```\nptvsd.enable_attach()\nptvsd.wait_for_attach()\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAtelierSoude%2FOpenRepairPlatform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAtelierSoude%2FOpenRepairPlatform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAtelierSoude%2FOpenRepairPlatform/lists"}