{"id":19290442,"url":"https://github.com/deve-sh/permit-system","last_synced_at":"2025-11-14T19:09:01.777Z","repository":{"id":118849026,"uuid":"190912258","full_name":"deve-sh/Permit-System","owner":"deve-sh","description":"A Lightweight Permit Application System written in PHP and SQL.","archived":false,"fork":false,"pushed_at":"2019-06-24T07:01:32.000Z","size":312,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-05T19:42:59.974Z","etag":null,"topics":["permit-system","permits","php","sql"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/deve-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2019-06-08T16:47:02.000Z","updated_at":"2024-02-09T15:14:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"fef9bfef-c62c-49af-8175-189b7a521766","html_url":"https://github.com/deve-sh/Permit-System","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/deve-sh%2FPermit-System","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FPermit-System/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FPermit-System/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deve-sh%2FPermit-System/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deve-sh","download_url":"https://codeload.github.com/deve-sh/Permit-System/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240395742,"owners_count":19794573,"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":["permit-system","permits","php","sql"],"created_at":"2024-11-09T22:19:18.588Z","updated_at":"2025-11-14T19:09:01.730Z","avatar_url":"https://github.com/deve-sh.png","language":"PHP","readme":"# \u003cdiv align='center'\u003ePermit System\u003c/div\u003e\n\nA Permit System Web Application written in PHP, SQL and JavaScript. Based primarily on the Permit Application System of Rohtang Pass, Manali. Where visitors apply for permits and visit the location if approved.\n\n### Working\n\nThe Web Application's basic working / process is as follows : \n\n- The Admin Creates an Opening (A Date for which permits to a specific place are available).\n- The User applies for a permit on an available opening (That was created by the admin in Step 1).\n- The Admin approves the application.\n- The User checks the status and if approved, visits the place. The Admin Requests for the ID of the user and if verified, marks the user having visited the place.\n\n\n### Pre - Requisites\n\n- A Web Server that can run PHP.\n- MySQL Improved Database.\n- PHP 7+.\n- Basic Knowledge of PHP, JS and CSS (For development or editing of the project).\n\n## Installation and Usage\n\nTo install the script, download the zip of the repo or clone the repo to your web server.\n\n```bash\ngit clone https://github.com/deve-sh/Permit-System.git\ncd Permit-System\n```\nThen navigate to the directory in your web browser using the web server. The Script shall automatically open the /install route. Enter all the necessary details and the script shall install itself.\n\nAfter the installtion, navigate to the main directory. Then use the app as normal.\n\nTo view the Admin Dashboard. Just navigate to  the **/admin** folder.\n\n## Project Structure\n\n```\nPermit-System\n├── .gitignore\n├── README.md\n├── about.php\n├── index.php\n├── ...\n├── admin\n│   ├── addadmin.php\n│   ├── adddate.php\n│   ├── index.php\n│   ├── ...\n├── files\n│   ├── contact_us.png\n│   ├── index.html\n│   └── ...\n├── install\n│   ├── index.php\n│   └── installer.php\n├── inc\n│   ├── index.php\n│   ├── adminstyles.html\n│   └── ...\n├── js\n│   ├── index.html\n│   ├── adminOpenings.js\n│   └── ...\n└── styles\n    └── styles.css\n```\n\nAs the above structure specifies. \n\n- The **/admin** folder contains the admin dashboard.\n\n- The **/files** folder contains all non-processing files required for the Application.\n\n- The **/inc** folder contains the most necessary files and libraries for the Application.\n\t- The file \u003cu\u003econfig.php\u003c/u\u003e is the backbone of the project past installtion, do not delete it in any case.\n\t- The file \u003cu\u003econnect.php\u003c/u\u003e is no less important, it contains the database driver necessary for the application to function.\n\t- The styles and necessary components for the aesthetic part of the application are included in the \u003cu\u003estyles.html\u003c/u\u003e and \u003cu\u003eadminstyles.html\u003c/u\u003e (For the admin dashboard).\n\n- The **/install** folder contains the installation files.\n\n- The **/js** folder contains the JavaScript files required for the Application.\n\n- The **/styles** folder contains the Stylesheet for the Application (styles.css).\n\t- \u003cu\u003e**Note**\u003c/u\u003e that the Stylesheet contains many components that are common between many elements but aren't noticeable on first look. However, slight documentation has been included to reduce the confusion in case you are looking to make changes in the styles.\n\n- In the main directory : \n\t- The **about.php** file houses info about the organisation. \n\t- The **contact.php** file houses the Contact Info. \n\t- These files are easy to edit and pose no problem to the application even if something goes wrong.\n\n## Contributing and Notes\n\nTo Contribute to the project, just change any aspect of the project you deem necessary and open a pull request to the Repo.\n\n**Note** : Before proceeding to changing the source code of the project, make sure you have enough knowledge of PHP and PHP's integration with HTML, or else you could mess a lot of things up.\n\nIts useful to take a look at the Notes below before proceeding to development : \n\n#### Turning Error Reporting Off\n\nError Reporting is turned off by default. To enable it go to `inc/config.php` and `admin/config.php` and remove the following line.\n\n```php\nerror_reporting(0);\n```\n\n#### Integrating a payments processor\n\nIf you want your applicants to make a payment. Include the PHP payment scripts (Example : PayU Money, UPI) to the `finalizeappl.php` file.\n\n```php\n// -----------------------------------\n// Add your Payment Integration here.\n// -----------------------------------\n\n// Variables\n\n$date = $db-\u003eescape($_POST['entereddate']);\n$vehiclenumber = $db-\u003eescape($_POST['vehiclenumber']);\n$applicant_name = $db-\u003eescape($_POST['applicantname']);\n$applicant_email = $db-\u003eescape($_POST['applicantemail']);\n$applicant_phone = $db-\u003eescape($_POST['applicantphone']);\n\n```\n\nYou could even create a seperate payments processing page, and redirect the application form to that page. Have a look at the `apply.php` page : \n\n```html\n\u003cform action=\"finalizeappl.php\" class=\"furtherdetails\" method=\"POST\"\u003e\n```\n\nChange the above to :\n\n```html\n\u003cform action=\"\u003cYour Payments Processing Page\u003e\" class='furtherdetails' methor=\"POST\"\u003e\n```\n\nAnd process the data from the form and the payments accordingly.\n\n* More notes will be added in the future.\n\n#### Update on the pagination.\n\nThe updated repo now has code for pagination of all applications page in the admin dashboard. The pagination frontend is in the file `js/adminRequestMaker.js` and the backend API is present in `admin/api.php`. In order to change the number of logs/applications that appear at once, just change this line from `admin/api.php` : \n\n```php\n$rowsperpage = 10;\t// Change the number 10 to the number of logs you want per page.\n```\n\n## Open Source Licenses Used\n\nOpen Source projects used in the Web Application include :\n\n- [Twitter Bootstrap](https://getbootstrap.com)\n- [Font Awesome](https://fontawesome.com)\n\n## License\n\nThe Project comes under the MIT License. Have a look at the LICENSE File of the project to view the implications and instructions on sharing and reproduction.\n\n## Contact and Issues\n\nFor any issue that might arise during the usage or development of the project, just raise an issue in the Repo or [Contact Me](mailto:devesh2027@gmail.com).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeve-sh%2Fpermit-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeve-sh%2Fpermit-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeve-sh%2Fpermit-system/lists"}