{"id":13532941,"url":"https://github.com/itsalb3rt/cloudcsv","last_synced_at":"2025-10-25T20:50:49.120Z","repository":{"id":37925619,"uuid":"216598397","full_name":"itsalb3rt/cloudcsv","owner":"itsalb3rt","description":"Open source web application for the storage of dynamic CSV files, user management, email notifications and more ...","archived":false,"fork":false,"pushed_at":"2025-01-10T02:03:02.000Z","size":2566,"stargazers_count":51,"open_issues_count":10,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-10T03:17:48.449Z","etag":null,"topics":["csv","email-notifications","hacktoberfest","javascript","open-source","phpmailer","vue","vue-cli","vuetify"],"latest_commit_sha":null,"homepage":"https://cloudcsv.netlify.app/","language":"Vue","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/itsalb3rt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2019-10-21T15:11:03.000Z","updated_at":"2025-01-10T02:02:20.000Z","dependencies_parsed_at":"2023-11-18T21:28:33.854Z","dependency_job_id":"e425159d-671d-4199-b3ab-1b7866147450","html_url":"https://github.com/itsalb3rt/cloudcsv","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsalb3rt%2Fcloudcsv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsalb3rt%2Fcloudcsv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsalb3rt%2Fcloudcsv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsalb3rt%2Fcloudcsv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsalb3rt","download_url":"https://codeload.github.com/itsalb3rt/cloudcsv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246713099,"owners_count":20821838,"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":["csv","email-notifications","hacktoberfest","javascript","open-source","phpmailer","vue","vue-cli","vuetify"],"created_at":"2024-08-01T07:01:15.200Z","updated_at":"2025-10-25T20:50:49.022Z","avatar_url":"https://github.com/itsalb3rt.png","language":"Vue","funding_links":["https://github.com/sponsors/itsalb3rt"],"categories":["🙌 Projects using Vuetify \u003ca name=\"projects\"\u003e\u003c/a\u003e"],"sub_categories":["Vuetify 2"],"readme":"\u003cdiv align=\"center\"\u003e\n\t\u003cimg src=\"https://i.imgur.com/BwKm56Q.png\" /\u003e\n\u003c/div\u003e\n\n\nCloudCSV is a Open source web application for the storage all CSV file data into your data base from a friendly graphical interface for non-technical people, user management, email notifications and more ...\n\n## Give a Star! ⭐\n\nIf you like this project or plan to use it in the future, please give it a star. Thanks 🙏\n\n## Bugs and Feedback\n\nFor bugs, questions, and discussions, please use the [Github Issues](https://github.com/itsalb3rt/cloudcsv/issues) we have cool templates for you.\n\n\n## Contributing\n\nFor contributing, please see the following links:\n\n- [Contribution Documents](https://github.com/itsalb3rt/cloudcsv/blob/master/CONTRIBUTING.md)\n\nWe're glad to be supported by respected companies and individuals from several industries. [See our Github Sponsors learn more](https://github.com/sponsors/itsalb3rt).\n\n\u003e [Become a Github Sponsor](https://github.com/sponsors/itsalb3rt) :heart:\n\n## Index\n\n- [:computer: App Interface](#app-interface)\n- [🤔 What can be done in this application ?](#what-can-be-done-in-this-application)\n- [:wrench: Development tools](#development-tools)\n\t- [Front-end](#front-end)\n\t- [Back-end](#back-end)\n- [:blue_book: How to install on my own server](#how-to-install-on-my-own-server)\n\t- [Front-end implementation](#front-end-implementation)\n\t- [Back-end implementation](#back-end-implementation)\n\t- [Database](#database-postgres)\n- [:whale: Docker (Recommended)](#docker)\n\n\n## App interface\n\n\u003e **Create a table**\n\n![Create a table](https://i.imgur.com/Rj4AWlj.png)\n\n\u003e **Main app Settings**\n\n![Main Settings](https://i.imgur.com/kDqxmiC.png)\n\n\u003e **Upload data**\n\n![Upload data](https://i.imgur.com/yYrcJmU.png)\n\n\u003e **Data Query**\n\n![Data Query](https://i.imgur.com/ZWpGJ2K.png)\n\n\n**[⬆ Back to Index](#index)**\n\n### What can be done in this application\n\n**Auth**\n- User Registration\n- Login\n- Password recovery (Via Email)\n\n**Data treatment**\n\n- CSV file data upload\n\t- When you try upload new data file into a table, the app validate if the file have same columns of the table.\n\t- Define the file delimiter\n- Get a report of data upload\n\n**Settings**\n\n- Multi language app\n- SMTP email configuration in app\n- Notification via email when user upload data or delete any record, you choose\n- User management for admins\n- Create, edit or delete dynamics tables data base for keep organize your data\n\n**[⬆ Back to Index](#index)**\n\n## Development tools\n\n#### Front-end\n\n- [Vue-cli](https://vuejs.org/ \"Vue-cli\")\n\t- [Vuex](https://vuex.vuejs.org/ \"Vuex\")\n\t- [Vue route](https://router.vuejs.org/ \"Vue route\")\n\t- [Papaparse CSV parse Javascript](https://www.papaparse.com/ \"Papaparse CSV parse Javascript\")\n\n- [Vuetify (UI)](https://vuetifyjs.com \"Vuetify (UI)\")\n\n#### Back-end\n\n- [PHP (Framework Ligne Api Rest)](https://ligne-framework.gitbook.io/ligne-framework-php/ \"PHP (Framework Ligne Api Rest)\")\n- [Http Foundation](https://packagist.org/packages/symfony/http-foundation)\n- - The HttpFoundation component defines an object-oriented layer for the HTTP specification.\n- [ConfigFileManager (Edit ini files System)](https://github.com/ghalambaz/ConfigFileManager \"ConfigFileManager (Edit ini files System)\")\n\t- Email and password settings\n\t- Database credentials\n\t- Allow the registration of new users\n\n- [Phpmailer](https://packagist.org/packages/phpmailer/phpmailer \"Phpmailer\")\n- - Email send\n- [Ingenerator/tokenista](https://packagist.org/packages/ingenerator/tokenista \"Ingenerator/tokenista\")\n- - Generate a unique token with time mark, for example for account recovery\n- [Email Validator](https://packagist.org/packages/egulias/email-validator)\n\n#### Database\n - Postgres \u003e= 9.6\n\n\n**[⬆ Back to Index](#index)**\n\n## How to install on my own server\n\n#### :exclamation: Requirements\n\n- PHP \u003e= 7.2\n- Composer \u003e= 1.8\n- Postgres SQL \u003e= 9.6\n- Vue-Cli \u003e= 4.0\n- NodeJs \u003e= 10.14\n\n\u003cbr\u003e\n\n#### Front-end implementation\n\n\n```bash\n$ git clone https://github.com/itsalb3rt/cloudcsv.git\n# After cd cloudcsv\n$ npm install\n```\n\nAll setings in `.env` file in root dir\n\n\u003e This ref to you API implementation without the final slash ( / );\n\n```env\nVUE_APP_BASE_URL_DEV=http://localhost/cloudcsv_api\nVUE_APP_BASE_URL_PRO=http://localhost:8018/cloudcsv_api\n```\n\n#### Back-end implementation\n\n**PHP extensions required**;\n- pdo_pgsql \n\n\n```bash\n$ git clone https://github.com/itsalb3rt/cloudcsv_api.git\n#After cd cloudcsv_api\n$ composer install\n```\n\nAfter run `composer install` go to `system/config/config.php.ini` file and put your `postgres` auth information.\n\n\n### Database Postgres\n\nIn the `API` dir, go to file in `etc/init_db.sql` copy this script an run in your database;\n\n**:warning:IMPORTANT**: Make a sure the `dbname` and `prefix` is same on you `API config` file and you database instance;\n\nExample:\n\n```ini\ndbname=cloudcsv\nprefix=public.\n```\n\u003e Please include the dot ( . ) in the final of the `prefix`\n\n\n---\n\n### :tada: Now you system is ready!\n\n---\n\n# Docker\n\nBy default the App and the API is ready for used with docker;\n\n**App**\n\n```bash\ngit clone https://github.com/itsalb3rt/cloudcsv.git\n```\n\n```bash\ncd cloudcsv\n```\n\nNow you can run the compose file;\n```bash\ndocker-compose up -d\n```\n\nAfther this you only need run the API.\n\n**API**\n\n```bash\ngit clone https://github.com/itsalb3rt/cloudcsv_api.git\n```\n```bash\ncd cloudcsv_api\n```\n\n\n```bash\n# Install all the dependencies\nmake install-dependencies\n# Run the API\ndocker network create traefik_proxynet \u0026\u0026 docker-compose up\n```\n\nNow go to http://localhost:8017 and is done :tada:.\n\n---\n## Extra information\n\nAuthentication will be based on Tokens, the token will be stored in the database and validated if the token corresponds to the users, the token must be self-generated every time the user logs on.\n\nInto `API/etc` dir you have a `Adobe XD` project and `UML`  dir `StarUML` project. feel free to modicate this and send you suggestion.\n\n---\n\n## License\n\nCopyright (C) 2022 by Albert Hidalgo. MIT License (see [LICENSE](https://github.com/itsalb3rt/cloudcsv/blob/master/LICENSE) for details).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsalb3rt%2Fcloudcsv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsalb3rt%2Fcloudcsv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsalb3rt%2Fcloudcsv/lists"}