Skip to content

Commit

Permalink
added api endpoint-component specifications, #1
Browse files Browse the repository at this point in the history
  • Loading branch information
genericSpecimen committed Nov 13, 2021
1 parent 5d545b5 commit be7b111
Showing 1 changed file with 65 additions and 0 deletions.
65 changes: 65 additions & 0 deletions docs/specifications.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Specifications
This document describes resources, their endpoints, and corresponding components.

## Art

### Views
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `ArtCardView` | - | - | [MUI Card](https://mui.com/components/cards/) |
| `ArtDetailView` | `GET` | `/art/id` | |
| `ArtGridView` | `GET` | `/art` | [MUI Grid](https://mui.com/components/grid/) of `ArtCardView`s |

### Forms
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `ArtCreateForm` | `POST` | `/art` | |
| `ArtUpdateForm` | `PUT` | `/art/id` | |
| `ArtDeleteForm` | `DELETE` | `/art/id` | |

## User

### Views
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `UserCardView` | - | - | [MUI Card](https://mui.com/components/cards/) |
| `UserDetailView` | `GET` | `/user/id` | |
| `UserGridView` | `GET` | `/users` | [MUI Grid](https://mui.com/components/grid/) of `UserCardView`s |

### Forms
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `UserCreateForm` | `POST` | `/users` | |
| `UserUpdateForm` | `PUT` | `/user/id` | |
| `UserDeleteForm` | `DELETE` | `/user/id` | |

## Order

### Views

| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `OrderListItemView` | - | - | [MUI List Item](https://mui.com/api/list-item/) |
| `OrderDetailView` | `GET` | `/order/id` | |
| `OrderListView` | `GET` | `/orders` | [MUI List](https://mui.com/components/lists/) of `OrderListItemView`s |

### Forms
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `OrderCreateForm` | `POST` | `/orders` | |
| `OrderUpdateForm` | `PUT` | `/order/id` | |
| `OrderDeleteForm` | `DELETE` | `/order/id` | |

## Cart

### Views
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `CartView` | `GET` | `/cart` | |

## Authentication
### Forms
| Component | Method | Endpoint | Remarks |
| --------- | ------ | -------- | ------ |
| `SignUpForm` | | | related to `UserCreateForm` |
| `SignInForm` | | | |

0 comments on commit be7b111

Please sign in to comment.