{"id":21506559,"url":"https://github.com/khomsiadam/censync","last_synced_at":"2025-04-23T22:08:27.443Z","repository":{"id":109418964,"uuid":"382658885","full_name":"KhomsiAdam/CenSync","owner":"KhomsiAdam","description":"This is an app designed for in-house use to manage IT incidents in any type of organization or establishment, using a simple ticketing system. Incidents are classified by type and priority. The purpose of such a system is to waste less time in dealing with issues therefore reducing costs and having better communication and traceability.","archived":false,"fork":false,"pushed_at":"2021-08-13T20:42:28.000Z","size":9786,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T22:07:02.709Z","etag":null,"topics":["adobe-xd","api","css","html","javascript","mvc","php","sass","scss","sql","uml"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/KhomsiAdam.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":"2021-07-03T16:15:20.000Z","updated_at":"2023-09-30T14:23:57.000Z","dependencies_parsed_at":"2023-03-22T21:48:47.848Z","dependency_job_id":null,"html_url":"https://github.com/KhomsiAdam/CenSync","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhomsiAdam%2FCenSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhomsiAdam%2FCenSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhomsiAdam%2FCenSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhomsiAdam%2FCenSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhomsiAdam","download_url":"https://codeload.github.com/KhomsiAdam/CenSync/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250522299,"owners_count":21444511,"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":["adobe-xd","api","css","html","javascript","mvc","php","sass","scss","sql","uml"],"created_at":"2024-11-23T19:41:59.753Z","updated_at":"2025-04-23T22:08:27.423Z","avatar_url":"https://github.com/KhomsiAdam.png","language":"JavaScript","readme":"# CenSync\n\"Standardize your incident management processes, centralized and synced in one place.\"\n\n# Table Of Contents\n\u003c!--ts--\u003e\n* [Project Description](#project-description)\n* [Flow of the Platform](#flow-of-the-platform)\n* [UML Diagrams](#uml-diagrams)\n* [Design](#design)\n* [Installation](#installation)\n* [Database Setup](#database-setup)\n* [Usage](#usage)\n* [Previews](#previews)\n  * [Desktop](#desktop)\n  * [Mobile](#mobile)\n\u003c!--te--\u003e\n\n# Project Description\n\nAn IT incident (be it of software or hardware origin) is defined as any event that is not part of the standard operation of an organization and that causes, or may cause, an interruption, reduction, loss or disruption in the quality of this organization's operations, services or functions.\n\nThis is a platform/app designed for in-house use by staff, administrators, employees, managers... to manage said incidents in any type of organization or establishment, using a simple ticketing system.\n\nIncidents are classified by type (software, hardware, *service) and priority (high, medium, low). The tickets must be resolved by order of importance.\n\n*services are always of low priorities since they are considered as demands instead of incidents.\n\nThe purpose of such a system is to waste less time in dealing with issues therefore reducing costs and having better communication and traceability.\n\n[Back to top](#table-of-contents)\n\n# Flow of the Platform\n\nIt begins by either signing in or signing up for an account (which will require validation from an administrator before being activated).\n\nThe targeted audience then can choose to create a ticket, with all the required informations and is in a pending status. The administrator then evaluates the ticket, opens it then assign the issue to the respective actor fit to deal with said issue (in this project as example: a developer for a software issue, a technician for a hardware issue).\n\nAfter the issue has been dealed with the ticket is marked as resolved.\n\n[Back to top](#table-of-contents)\n\n# UML Diagrams\n(Activity, Class, Sequence, Use Case)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/9354045/124355809-0580a500-dc0b-11eb-9c2a-b54ffe588572.png\" width=\"13.4%\"\u003e\u003c/img\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/9354045/124355811-06b1d200-dc0b-11eb-9acf-83e0dd3a4608.png\" width=\"39%\"\u003e\u003c/img\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/9354045/124355813-087b9580-dc0b-11eb-87f6-ec305133b730.png\" width=\"18%\"\u003e\u003c/img\u003e\n\u003cimg src=\"https://user-images.githubusercontent.com/9354045/124355814-0a455900-dc0b-11eb-9b6d-6c0ff50b6962.png\" width=\"21.5%\"\u003e\u003c/img\u003e\n\n[Back to top](#table-of-contents)\n\n# Design\nMade with adobe XD (file in design folder).\n\nQuick overview : Desktop\n\n![censync_xd_desktop](https://user-images.githubusercontent.com/9354045/124357105-a70af500-dc11-11eb-928c-85a707289946.gif)\n\nQuick overview : Mobile\n\n![censync_xd_mobile](https://user-images.githubusercontent.com/9354045/124357019-3a8ff600-dc11-11eb-898d-ad9dac8944b9.gif)\n\n[Back to top](#table-of-contents)\n\n# Installation\n\n[Composer](https://getcomposer.org/) and [Node](https://nodejs.org/en/) are required.\n\nInstall dependencies:\n\n```bash\ncomposer install\n```\n\n```bash\nnpm install\n```\n\n[Back to top](#table-of-contents)\n\n# Database Setup\n\nImport tables from the sql file in the SQL folder `SQL/censync_db.sql`.\n\nRename/copy .env.example file into .env (or create a new file), then copy the informations below and paste into your file:\n```\n# Database Credentials: *fill with your proper database information\nHOST=\nDB_NAME=\nUSERNAME=\nPASSWORD=\n\n# Developer mode for error handling: *change to OFF when deploying\nDEV_MODE=ON\n\n# Database Account Table:\nACCOUNTS_TABLE=user\n\n# Database Account Columns:\nACCOUNTS_ID=user_id\nACCOUNTS_ROLE=role\nACCOUNTS_EMAIL=email\nACCOUNTS_FIRSTNAME=firstname\nACCOUNTS_LASTNAME=lastname\nACCOUNTS_PASSWORD=password\nACCOUNTS_STATUS=status\n\n# Database Audience Table: *The recipient table for account for 'aud' in JWT token payload\nAUDIENCE_TABLE=ticket\n# Database Other Tables: *Other tables you may need, as argument for your CRUD operations in controller methods\nNOTES_TABLE=note\n\n# Data Source Name: *do not modify! $_ENV['DSN'] is used as first argument for your PDO connection\nDSN=mysql:host=${HOST};dbname=${DB_NAME}\n\n# API Token Authentication Secret Keys: *fill with your own key or add new keys as needed\nSECRET_KEY=\n```\n- HOST, DB_NAME, USERNAME, PASSWORD: fill with your database credentials.\n- DEV_MODE: for error handling when testing the API, delete it's value or replace to deactivate it when going into production or deploying.\n- SECRET_KEY: fill with your own secret key.\n\n[Back to top](#table-of-contents)\n\n# Usage\n\nRun PHP's Local Development Server with this custom command in your terminal (localhost:8080):\n```bash\ncomposer serve:local\n```\n\nIf you want to run the server on your local network for testing (your local IP address, ex: 192.168.1.2:8080):\n```bash\ncomposer serve:remote\n```\n\n* Backend made with: https://github.com/KhomsiAdam/PHP_MVC_API_Framework\n\n[Back to top](#table-of-contents)\n\n# Previews\n\n## Desktop:\n\nAccount creation:\n\n![censync_create_account_desktop](https://user-images.githubusercontent.com/9354045/126696279-c9ddc85d-d962-43f1-8794-6bf14c222dd5.gif)\n\nDashboard preview:\n\n![censync_login_dashboard_desktop](https://user-images.githubusercontent.com/9354045/126696487-482570eb-9316-444e-9404-07fdaec70c43.gif)\n\nAccount activation by Admin:\n\n![censync_activate_account_desktop](https://user-images.githubusercontent.com/9354045/126696562-ed9c334f-52a5-43f1-84de-939b21cd9062.gif)\n\nTicket creation by Employee:\n\n![censync_create_ticket_desktop](https://user-images.githubusercontent.com/9354045/126696633-5c9497a1-f6f5-48b4-84a5-d5021a8d389a.gif)\n\nTicket assignement and Note by Admin:\n\n![censync_assign_ticket_desktop](https://user-images.githubusercontent.com/9354045/126696688-94f54f21-33d3-4a60-b3d1-331b769380ac.gif)\n\nTicket resolution by Developer or Technician:\n\n![censync_resolve_ticket_desktop](https://user-images.githubusercontent.com/9354045/126696765-998066a7-9ade-4d42-aa24-39fb684952f5.gif)\n\nNote update and deletion, Ticket deletion (by Admin):\n\n![censync_delete_ticket_desktop](https://user-images.githubusercontent.com/9354045/126696819-218d04a3-cae3-44b8-b64f-0e6eb5a689ba.gif)\n\nAccount deletion by Admin:\n\n![censync_delete_account_desktop](https://user-images.githubusercontent.com/9354045/126696896-3d8471cf-c813-4032-a124-e53df5144069.gif)\n\nUser profile image upload and delete:\n\n![censync_upload_image_desktop](https://user-images.githubusercontent.com/9354045/127658303-a9bc9823-dc60-416f-b46c-02f648f88f0a.gif)\n\nAdmin deleting user profile image:\n\n![censync_delete_image_desktop](https://user-images.githubusercontent.com/9354045/127658344-6380ab80-20fd-4674-ac7e-a15f91f0dd0e.gif)\n\n[Back to top](#table-of-contents)\n\n## Mobile:\n\nAccount creation:\n\n![censync_create_account_mobile](https://user-images.githubusercontent.com/9354045/126840066-115ae5c7-1dfc-428b-ae05-1eb42f39fcba.gif)\n\nDashboard preview:\n\n![censync_login_dashboard_mobile](https://user-images.githubusercontent.com/9354045/126840076-89b10ab5-9570-4bfa-b77f-09fb2bad1033.gif)\n\nAccount activation by Admin:\n\n![censync_activate_account_mobile](https://user-images.githubusercontent.com/9354045/126840092-46fb29ec-b99d-4626-bda6-db4f79f75937.gif)\n\nTicket creation by Employee:\n\n![censync_create_ticket_mobile](https://user-images.githubusercontent.com/9354045/126840107-d48a797d-58ed-4623-9710-1deebf3d8a33.gif)\n\nTicket assignement and Note by Admin:\n\n![censync_assign_ticket_mobile](https://user-images.githubusercontent.com/9354045/126840120-1b3c49f0-ea7f-4451-869e-294b6f836a8f.gif)\n\nTicket resolution by Developer or Technician:\n\n![censync_resolve_ticket_mobile](https://user-images.githubusercontent.com/9354045/126840128-66c40f5c-903e-4b8d-936a-22bf2ca46277.gif)\n\nNote update and deletion, Ticket deletion (by Admin):\n\n![censync_delete_ticket_mobile](https://user-images.githubusercontent.com/9354045/126840133-27f09f63-5c80-428b-8f8a-81c33e359f8f.gif)\n\nAccount deletion by Admin:\n\n![censync_delete_account_mobile](https://user-images.githubusercontent.com/9354045/126840148-c79661b7-c4a7-4cad-a8b5-0e18eb61407b.gif)\n\nUser profile image upload and delete:\n\n![censync_upload_image_mobile](https://user-images.githubusercontent.com/9354045/127658325-15fc050d-c9ec-4fea-beea-57ed381c310c.gif)\n\nAdmin deleting user profile image:\n\n![censync_delete_image_mobile](https://user-images.githubusercontent.com/9354045/127658378-b1a8eee2-2113-4561-9d1a-b3c7dbf6c152.gif)\n\n[Back to top](#table-of-contents)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhomsiadam%2Fcensync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhomsiadam%2Fcensync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhomsiadam%2Fcensync/lists"}