diff --git a/README.md b/README.md index 841bc0b..9c6d1a4 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ --- -
A simple yet somehow overdesigned guestbook system featuring a simple control panel (which is a WIP so you'll have to make do with a db manager)
+A simple yet somehow overdesigned guestbook system featuring a simple control panel
This is phase I of the personal backscratchers project.
@@ -29,6 +29,8 @@ - [π Documentation ](#-documentation-) - [π Getting Started ](#-getting-started-) - [πΈοΈ Prerequisites](#οΈ-prerequisites) + - [Backend:](#backend) + - [Admin panel:](#admin-panel) - [π Deployment ](#-deployment-) - [βοΈ Built Using ](#οΈ-built-using-) - [βοΈ Authors ](#οΈ-authors-) @@ -49,6 +51,8 @@ These instructions will get you a copy of the project up and running on your loc ## πΈοΈ Prerequisites +### Backend: + For running it locally: - .NET 8.0 - A running instance of MongoDB @@ -84,6 +88,12 @@ You will be able to see in `build/docker-compose.public.yml` that the applicatio > [!TIP] > For local usage of the backend, you can use `docker-compose.local.yml` and edit the fields you need. +### Admin panel: + +The admin panel is a simple React/Vite app. For development, it should be enough to run `vite` in Guestbooky-admin's `src` folder. + +In order to create a live version, adjust the **API_URL** path in `Guestbooky-admin/src/environment/constants.js`, and execute `vite build`. + ## π Deployment Use `docker-compose.public.yml` as a basis. it should create the image for you and start running. @@ -92,6 +102,7 @@ Use `docker-compose.public.yml` as a basis. it should create the image for you a - [MongoDB](https://www.mongodb.com/) - Database - [.NET](https://dot.net/) - Backend +- [React](https://react.dev/)/[Vite](https://vite.dev) - Admin Panel - [Cloudflare Turnstile](https://www.cloudflare.com/pt-br/products/turnstile/) - Captcha ## βοΈ Authors diff --git a/docs/comments.md b/docs/comments.md index 0f5e1b3..0c358bd 100644 --- a/docs/comments.md +++ b/docs/comments.md @@ -43,3 +43,4 @@ ___ - There isn't much exception handling, except in the API layer. This is on purpose. Another thing that this project could really use, but is left as an exercise, is using a `Maybe