Skip to content

Commit 2e03656

Browse files
committed
Update README files to include environment variables and enhance project documentation
1 parent b30db59 commit 2e03656

3 files changed

Lines changed: 119 additions & 462 deletions

File tree

README.md

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,46 @@
1-
# Task_Management_System
1+
# Task_Management_System# Table of Contents
2+
3+
- [Task\_Management\_System# Table of Contents](#task_management_system-table-of-contents)
4+
- [Intro](#intro)
5+
- [Getting Started](#getting-started)
6+
- [Running the app locally](#running-the-app-locally)
7+
- [Known Issues in the Application](#known-issues-in-the-application)
8+
- [What to expect](#what-to-expect)
9+
- [Future Improvements](#future-improvements)
10+
11+
## Intro
12+
This project aim to build a task management system to help users create worksace, projects and orgnize related tasks in a kanban board. In addition users can add colaborators.
13+
Note the back-end was built within 3 weeks as well as the front-end.
14+
15+
## Getting Started
16+
17+
Clone the repository to your machine:
18+
19+
```sh
20+
$ git clone https://github.com/BasilOmsha/Task_Management_System.git
21+
```
22+
23+
## Running the app locally
24+
Please refer to the readme file first within the server directory and then check the one inside the client directory.
25+
26+
## Known Issues in the Application
27+
- Not all CRUD operation implemened.
28+
- Delay when when moving tasks betwen the kanban "columns". Example, from "ToDo" to "Done." Possible fix optimistic rendering.
29+
- Refreshing the page while logged in, will take you back to the dashboard.
30+
31+
## What to expect
32+
- Ability to sign up
33+
- Ability to login
34+
- Validation Errors
35+
- Ability to view own user's info when logged in
36+
- Ability to create workspace, projects, add users to workspaces and create kanban board with task.
37+
- Ability to rearrange tasks and columns in the kanban board
38+
- Ability to sign out
39+
40+
## Future Improvements
41+
- Improve Error handling in the backend and error messages
42+
- Implement all the CRUD operations
43+
- Fix the refreshing bug
44+
- Implement roles and permisions
45+
- Implement optimistic redering
46+
- Writing tests specially for the fornt-end

client/README.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
- [Data flow](#data-flow)
77
- [Lazy loading](#lazy-loading)
88
- [Running the application](#running-the-application)
9+
- [Environment variables](#environment-variables)
910
- [What to expect](#what-to-expect)
1011
- [Improvements and future features](#improvements-and-future-features)
1112

@@ -134,7 +135,18 @@ CD your-project-dir # moves to project directory
134135
yarn # downloads all the necessary packages
135136

136137
yarn dev # Runs the app on localhost
137-
```
138+
```
139+
140+
## Environment variables
141+
142+
Below are the environment variables required for the application:
143+
144+
| Environment Variable | Description |
145+
| -------------------- | --------------------------------- |
146+
| `VITE_API_URL_LOCAL` | http://localhost:5140/api/v1 |
147+
| `VITE_API_URL` | http://yourdeployedbackend/api/v1 |
148+
149+
138150
## What to expect
139151
- Ability to register and login
140152
- Create workspaces and view information about it

0 commit comments

Comments
 (0)