{"id":13618157,"url":"https://github.com/fairnesscoop/permacoop","last_synced_at":"2025-05-16T14:05:02.529Z","repository":{"id":37013191,"uuid":"223739562","full_name":"fairnesscoop/permacoop","owner":"fairnesscoop","description":"Open source and eco-designed ERP solution for worker-owned businesses.","archived":false,"fork":false,"pushed_at":"2025-03-21T10:39:38.000Z","size":6248,"stargazers_count":254,"open_issues_count":8,"forks_count":36,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-04-19T15:56:29.658Z","etag":null,"topics":["clean-code","coop","cqrs","crm","ddd","ecodesign","erp","hexagonal-architecture","nestjs","nodejs","open-source","sapper","sveltejs","sveltekit","typescript","unit-testing"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fairnesscoop.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-11-24T12:20:42.000Z","updated_at":"2025-04-06T04:38:40.000Z","dependencies_parsed_at":"2023-10-27T14:39:28.722Z","dependency_job_id":"7fad932b-d3cf-4bb5-9291-2357e4891836","html_url":"https://github.com/fairnesscoop/permacoop","commit_stats":{"total_commits":440,"total_committers":17,"mean_commits":25.88235294117647,"dds":0.4954545454545455,"last_synced_commit":"111e8295e4dc592b4a1441308ac378cbb9a63f0f"},"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairnesscoop%2Fpermacoop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairnesscoop%2Fpermacoop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairnesscoop%2Fpermacoop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fairnesscoop%2Fpermacoop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fairnesscoop","download_url":"https://codeload.github.com/fairnesscoop/permacoop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254544146,"owners_count":22088807,"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":["clean-code","coop","cqrs","crm","ddd","ecodesign","erp","hexagonal-architecture","nestjs","nodejs","open-source","sapper","sveltejs","sveltekit","typescript","unit-testing"],"created_at":"2024-08-01T20:01:55.414Z","updated_at":"2025-05-16T14:05:02.495Z","avatar_url":"https://github.com/fairnesscoop.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003ca href=\"https://fairness.coop\"\u003e\u003cimg src=\"https://fairness.coop/image/fairness_logo.svg\" alt=\"Fairness\"\u003e\u003c/a\u003e\u003c/h1\u003e\n\nPermacoop is an open source and eco design ERP solution reserved for worker-owned business.\n\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/fairnesscoop/permacoop/ci.yml?branch=master)\n[![codecov](https://codecov.io/gh/fairnesscoop/permacoop/branch/master/graph/badge.svg)](https://codecov.io/gh/fairnesscoop/permacoop)\n[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/fairnesscoop/permacoop/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/fairnesscoop/permacoop/?branch=master)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/3bf4f001d4904cdb89e71f2793d1c6b7)](https://www.codacy.com/gh/fairnesscoop/permacoop?utm_source=github.com\u0026utm_medium=referral\u0026utm_content=fairnesscoop/permacoop\u0026utm_campaign=Badge_Grade)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/fairnesscoop/permacoop)\n[![GitHub license](https://img.shields.io/github/license/fairnesscoop/permacoop.svg)](https://github.com/fairnesscoop/permacoop)\n\n## Technical stack\n\n- [Node.js](https://nodejs.org) / [Nestjs](https://nestjs.com/) / [Nunjucks](https://mozilla.github.io/nunjucks/templating.html)\n- HTML, CSS, [WebComponents](https://developer.mozilla.org/en-US/docs/Web/API/Web_Components)\n- [TypeORM](https://typeorm.io)\n- [PostgreSQL](https://www.postgresql.org/)\n- [Typescript](https://www.typescriptlang.org/)\n- [Jest](https://jestjs.io/) / [ts-mockito](https://github.com/NagRock/ts-mockito)\n- [Docker](https://www.docker.com/)\n\n## Prerequisites\n\nYou must have **[PostgreSQL](https://www.postgresql.org/)** installed, or **[Docker](https://www.docker.com/)** and **[Docker Compose](https://docs.docker.com/compose/)** to run PostgreSQL using the provided `docker-compose.yml`.\n\nEnsure you have [Node.js](https://nodejs.org) **16.x** and `node-gyp` installed globally (`npm install -g node-gyp`).\n\n## Quickstart\n\nFirst, install dependencies:\n\n```bash\nmake install\n```\n\nThen start the servers, database and other services:\n\n```\nmake start\n```\n\nIn a separate terminal, run database migrations:\n\n```\nmake database-migrate\n```\n\nThen, you can seed the database with fake data\n\n```\nmake database-seed\n```\n\nThis command will create the default user \"John Doe\" :\n\n```json\n{\n  \"email\": \"john@doe.com\",\n  \"password\": \"john\"\n}\n```\n\nThe server will be available at \u003chttp://localhost:3000\u003e.\n\n## Helpers\n\nTo view all available commands, run:\n\n```bash\nmake help\n```\n\n### Building and serving\n\nTo serve the built server and client locally, run:\n\n```bash\nmake build\nmake start-dist\n```\n\n### Tests\n\nTo run tests, use:\n\n```bash\nmake test\n```\n\nRun E2E tests using:\n\n```bash\nmake test-e2e\n```\n\n### Code quality\n\nTo run automatic code formatting, run:\n\n```bash\nmake format\n```\n\nTo run linters and code checks, use:\n\n```bash\nmake linter\n```\n\n### Database migrations\n\nTo generate a migration from the current state of the code, run:\n\n```bash\nmake database-migration NAME=add_some_column\n```\n\n## Features\n\n- Tasks management\n- Projects management\n- Customers management\n- Calendar (timesheets etc.)\n- Human Resources\n  - Meal tickets\n  - Leaves\n  - Cooperators / employee\n\n## Credits\n\nCreated by [Fairness](https://fairness.coop)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffairnesscoop%2Fpermacoop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffairnesscoop%2Fpermacoop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffairnesscoop%2Fpermacoop/lists"}