Skip to content

Commit a9dd7cd

Browse files
Merge pull request #109 from bluewave-labs/copy-settings-page
Settings Page
2 parents 1ffac6b + a19c72b commit a9dd7cd

File tree

81 files changed

+23264
-9011
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

81 files changed

+23264
-9011
lines changed

.coderabbit.yaml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
language: "en-CA"
2+
early_access: false
3+
reviews:
4+
profile: "assertive"
5+
request_changes_workflow: false
6+
high_level_summary: false
7+
poem: false
8+
review_status: true
9+
auto_review:
10+
enabled: true
11+
drafts: false
12+
chat:
13+
auto_reply: false

.gitignore

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@
44
/node_modules
55
/.pnp
66
.pnp.js
7-
/client
87

98
# testing
109
/coverage
@@ -19,6 +18,9 @@
1918
.env.development.local
2019
.env.test.local
2120
.env.production.local
21+
.env
22+
/dev
23+
/constants/data/images
2224

2325
.storybook
2426
.vscode
@@ -27,3 +29,9 @@
2729
npm-debug.log*
2830
yarn-debug.log*
2931
yarn-error.log*
32+
33+
*storybook.log
34+
.storybook/
35+
/src/stories
36+
37+
.env

CONTRIBUTING.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
2+
# Contributing to the BlueWave HRM application
3+
4+
First off, thanks for taking the time to contribute! ❤️
5+
6+
All types of contributions are encouraged and valued. See the [Table of Contents](#table-of-contents) for different ways to help and details about how the HRM project handles them. Please make sure to read the relevant section before making your contribution. It will make it much easier for us maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉
7+
8+
> And if you like the project, but don't have time to contribute, that's fine. There are other easy ways to support the project and show your appreciation, which we would also be very happy about:
9+
> - Star the project
10+
> - Tweet about it
11+
> - Refer this project in your project's readme
12+
> - Mention the project at local meetups and tell your friends/colleagues
13+
14+
## Table of Contents
15+
16+
- [I Have a Question](#i-have-a-question)
17+
- [I Want To Contribute](#i-want-to-contribute)
18+
- [Suggesting Enhancements](#suggesting-enhancements)
19+
20+
## I Have a Question
21+
22+
If you'd like to ask a question, we assume that you have read the available readme.md files. In the near future we'll come up with a proper installation and usage document.
23+
24+
Before you ask a question, search for existing [Issues](/issues) that might help you. In case you have found a suitable issue and still need clarification, you can write your question in this issue. It is also advisable to search the internet for answers first.
25+
26+
If you then still feel the need to ask a question and need clarification, we recommend the following:
27+
28+
- Open an [Issue](/issues/new).
29+
- Provide as much context as you can about what you're running into.
30+
- Provide project and platform versions (NodeJs, PostgreSQL, etc), depending on what seems relevant.
31+
32+
We will then take care of the issue as soon as possible.
33+
34+
35+
## I Want To Contribute
36+
37+
> ### Legal Notice
38+
> When contributing to this project, you must agree that you have authored 100% of the content, that you have the necessary rights to the content and that the content you contribute may be provided under the project license.
39+
40+
### Reporting Bugs
41+
42+
#### Before Submitting a Bug Report
43+
44+
A good bug report shouldn't leave others needing to chase you up for more information. Therefore, we ask you to investigate carefully, collect information and describe the issue in detail in your report. Please complete the following steps in advance to help us fix any potential bug as fast as possible.
45+
46+
- Make sure that you are using the latest version.
47+
- Determine if your bug is really a bug and not an error on your side e.g. using incompatible environment components/versions. If you are looking for support, you might want to check [this section](#i-have-a-question)).
48+
- To see if other users have experienced (and potentially already solved) the same issue you are having, check if there is not already a bug report existing for your bug or error in the [bug tracker](issues?q=label%3Abug).
49+
- Also make sure to search the internet (including Stack Overflow) to see if users outside of the GitHub community have discussed the issue.
50+
- Collect information about the bug:
51+
- Stack trace (Traceback)
52+
- OS, Platform and Version (Windows, Linux, macOS, x86, ARM)
53+
- Version of the interpreter, compiler, SDK, runtime environment and package manager, depending on what seems relevant.
54+
- Possibly your input and the output
55+
- Can you reliably reproduce the issue? And can you also reproduce it with older versions?
56+
57+
58+
#### How Do I Submit a Good Bug Report?
59+
60+
> You must never report security related issues, vulnerabilities or bugs including sensitive information to the issue tracker, or elsewhere in public. Instead sensitive bugs must be sent by email to [email protected]
61+
62+
We use GitHub issues to track bugs and errors. If you run into an issue with the project:
63+
64+
- Open an [Issue](/issues/new). (Since we can't be sure at this point whether it is a bug or not, we ask you not to talk about a bug yet and not to label the issue.)
65+
- Explain the behaviour you would expect and the actual behaviour.
66+
- Please provide as much context as possible and describe the *reproduction steps* that someone else can follow to recreate the issue on their own. This usually includes your code. For good bug reports, you should isolate the problem and create a reduced test case.
67+
- Provide the information you collected in the previous section.
68+
69+
Once it's filed:
70+
71+
- The project team will label the issue accordingly.
72+
- A team member will try to reproduce the issue with your provided steps. If there are no reproduction steps or no obvious way to reproduce the issue, the team will ask you for those steps and mark the issue as `needs-repro`. Bugs with the `needs-repro` tag will not be addressed until they are reproduced.
73+
- If the team is able to reproduce the issue, it will be marked `needs-fix`, as well as possibly other tags (such as `critical`), and the issue will be left to be [implemented by someone](#your-first-code-contribution).
74+
75+
## Suggesting Enhancements
76+
77+
This section guides you through submitting an enhancement suggestion for the app, **including completely new features and minor improvements to existing functionality**. Following these guidelines will help maintainers and the community understand your enhancements and find related suggestions.
78+
79+
- Make sure that you are using the latest version.
80+
- Find out if the functionality is already covered, maybe by an individual configuration.
81+
- Perform a [search](/issues) to see if the enhancement has already been suggested. If it has, add a comment to the existing issue instead of opening a new one.
82+
- Find out whether your idea fits with the scope and aims of the project. It's up to you to make a strong case to convince the project's developers of the merits of this feature. Keep in mind that we want features that will be useful to the majority of our users and not just a small subset. If you're just targeting a minority of users, consider writing an add-on/plugin library.
83+
84+
#### How Do I Submit a Good Enhancement Suggestion?
85+
86+
Enhancement suggestions are tracked as [GitHub issues](/issues).
87+
88+
- Use a **clear and descriptive title** for the issue to identify the suggestion.
89+
- Provide a **step-by-step description of the suggested enhancement** in as many details as possible.
90+
- **Describe the current behavior** and **explain which behavior you expected to see instead** and why. At this point you can also tell which alternatives do not work for you.
91+
- You may want to **include screenshots and animated GIFs** which help you demonstrate the steps or point out the part which the suggestion is related to.
92+
- **Explain why this enhancement would be useful** to most CONTRIBUTING.md users. You may also want to point out the other projects that solved it better and which could serve as inspiration.
93+
94+
We have a Figma file that includes:
95+
96+
- All the dashboard elements and components
97+
- The design guideline for the app
98+
99+
You can see the dashboard designs [here](https://www.figma.com/design/GC5nLN8GAXV9NJkzEnDRj3/HRM-app?node-id=1-1207&t=wzDWuABPkPl5Tdeb-1), and the style guides [here](https://www.figma.com/design/USQRG7Oacv7uXw8XkTPINq/Style-guide?node-id=170-4048&t=QwZ5JRnYywYsScLj-1). Since they are read-only, we encourage you to copy to your own Figma page, then work on it.
100+
101+
[This document](https://docs.google.com/document/d/1Gy3LiimGUNoSiWAMbwyK3SeMADcCMjCLu6cQYoawtSE/edit#heading=h.1lj2lgut6m7h) outlines the process every developer should follow for managing the issues lifecycle. Also make sure you read the [document about how to make a good pull request](/PULLREQUESTS.md).
102+
103+
## Attribution
104+
This guide is based on the **contributing.md**. [Make your own](https://contributing.md/)!

Entity Relationship Diagram.png

217 KB
Loading

PULLREQUESTS.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
## The Importance of Small Pull Requests
2+
3+
4+
Pull requests are an integral part of our workflow, but does the scope of your pull request matter? In my opinion yes it does, and here’s why I think so
5+
6+
### Smaller PRs make you spend more time thinking about your code before you write it
7+
8+
Spend some time thinking about the PR you are going to open. If you think about the scope of the PR you will be forced to limit the scope of your feature, and that will force you to plan your code out.
9+
10+
### Smaller PRs are easier to review
11+
12+
If a PR is massive and complicated it is very difficult to review. Reviewers are busy working on their own features and can quickly run into cognitive limits when a large PR comes in. A PR should be simple enough that a busy dev can jump on the review without fatiguing themself.
13+
14+
### Smaller PRs get better reviews
15+
16+
The smaller your PR, the greater the amount of quality feedback a reviewer can give you. If you have 600 lines of codes you are not going to get decent feedback at line 500. Try to limit your PRs to 200 lines of code at the most in order to get quality feedback from your reviewers.
17+
18+
### Smaller PRs get reviewed faster and merged faster
19+
20+
If your PR is short and sweet your reviewers can get you feedback ASAP, this reduces the turnaround time for the whole pull request. If it takes your reviewer a whole day to review your pull request you are looking at 2 days for the
21+
22+
Pull Request -> Review -> Revise -> Review -> Merge
23+
24+
Process. If more revisions are required after the second review we’re looking at almost a week to get the feature reviewed, revised, and merged in.
25+
26+
### Smaller PRs lead to better quality code
27+
28+
If PRs are small and manageable it is far more likely that a dev will catch bugs during the review process. If our eyes glaze over at line 400 of a 700 line PR since we’ve reached our cognitive limit we’re not going to likely miss bugs in the last 300 lines of code.
29+
30+
### Bonus Topic: Keep PRs focused
31+
32+
It may be tempting to address a bug you suddenly remembered or make some tiny adjustments in some component that bothers you, but don’t! Keep all commits in your pull request fully focused on the specific feature you are working on. Open up another PR if you want to fix a big or work on another feature.

README.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,19 @@
1-
# BlueWave HR
1+
![](https://img.shields.io/github/license/bluewave-labs/bluewave-hrm)
2+
![](https://img.shields.io/github/repo-size/bluewave-labs/bluewave-hrm)
3+
![](https://img.shields.io/github/commit-activity/w/bluewave-labs/bluewave-hrm)
4+
![](https://img.shields.io/github/last-commit/bluewave-labs/bluewave-hrm)
5+
![](https://img.shields.io/github/languages/top/bluewave-labs/bluewave-hrm)
6+
![](https://img.shields.io/github/issues-pr/bluewave-labs/bluewave-hrm)
7+
![](https://img.shields.io/github/issues/bluewave-labs/bluewave-hrm)
28

3-
The BlueWave HR is a people and resource management application for your organization. It has the following features:
9+
10+
# BlueWave HRM
11+
12+
The BlueWave HRM is a people and resource management application for your organization. It has the following features:
413

514
- Team management
615
- Employee management
7-
- Time off / vacation management
16+
- Time off & vacation management
817
- Reporting
918

1019
![Time off settings](https://github.com/bluewave-labs/hrm/blob/main/Time%20off.png?raw=true)

SECURITY.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Security Policy
2+
3+
If you find a vulnerability, send it to [email protected]
4+
5+
Please do not create an issue for security vulnerabilities.

0 commit comments

Comments
 (0)