In Japan, the approval of application forms and other documents is generally achieved by printing those out and stamping them with one's personal seal, called ハンコ (Hanko). This practice has been a a significant obstacle to the adoption of remote work, as many employees still need to commute to work in order to get paper documents stamped by their superiors. This repository contains the source-code of 申請マネージャ (Shinsei-manager), a web-based approval system that aims at solving this problem.
申請マネージャ is a Node.js application that allows the approval of virtually any kind of application forms or documents. It manages those, alongside their approval or rejections, as nodes and relationships in a Neo4J database.
The current repository contains the source-code of the back-end application of 申請マネージャ. For its GUI, please see the dedicated repository.
| Endpoint | Method | body/query | Description |
|---|---|---|---|
| /applications | POST | type, title, private, form_data, recipients_ids, group_ids | Create an application form |
| /applications | GET | filters, query parameters, etc. | Query application forms |
| /applications/{application_id} | GET | - | Query a single application forms using its ID |
| /applications/{application_id} | DELETE | - | Delete an application forms |
| /applications/{application_id}/approve | POST | - | Approve an application form |
| /applications/{application_id}/reject | POST | - | Reject an application form |
| /applications/{application_id}/files/{file_id} | GET | - | Query an attachment of an application |
| Endpoint | Method | body/query | Description |
|---|---|---|---|
| /templates/ | POST | template_properties | Create a form template |
| /templates/ | GET | - | Get templates visible to the current user |
| /templates/{template_id} | GET | - | gets an application form template using its ID |
| /templates/{template_id} | POST | fields, label, description, group_ids | Creates an application form template |
| /templates/{template_id} | PUT | fields, label, description, group_ids | Updates an application form template |
| /templates/{template_id} | DELETE | - | Deletes an application form template |
| Endpoint | Method | body/query | Description |
|---|---|---|---|
| /files | POST | multipart/form-data with file as 'file_to_upload' | Creates an attachment |
| variable | Description |
|---|---|
| APP_PORT | App on which the application listens for HTTP requests |
| NEO4J_URL | URL of the Neo4J instance |
| NEO4J_USERNAME | Username for the Neo4J instance |
| NEO4J_PASSWORD | Password for the Neo4J instance |
| IDENTIFICATION_URL | URL of the authentication endpoint |
| S3_BUCKET | S3 Bucket to upload images. If set, images are uploaded to S3, otherwise they are stored locally |
| S3_ACCESS_KEY_ID | S3 access key ID |
| S3_SECRET_ACCESS_KEY | S3 secret access key |
| S3_REGION | S3 region |
| S3_ENDPOINT | S3 Endpoint |