akf-forum/README.md

104 lines
2.8 KiB
Markdown
Raw Normal View History

2022-03-13 16:16:46 +03:00
# akf-forum
<img src="https://raw.githubusercontent.com/Akif9748/akf-forum/main/public/images/logo.jpg" align="right" width="300px" />
2022-05-01 17:10:44 +03:00
A forum software written in Node.js.
2022-03-13 16:16:46 +03:00
## Installation
2022-05-01 17:10:44 +03:00
- Clone or download this repo.
- Run `npm i` to install **dependencies**.
- Run `npm start` for run it.
2022-05-01 17:10:44 +03:00
### Extra
2022-08-10 15:25:05 +03:00
Run `node util/reset` to **reset the database**, and run `node util/admin` for give admin perms to first member.
2022-03-13 16:16:46 +03:00
## API
2022-08-11 03:49:54 +03:00
Akf-forum has got an API for other clients etc. You can test api with python files in `test` folder.
Python is only for testing 😭
2022-08-11 15:36:28 +03:00
And, you can learn about API in `util/APIDOCS.md`.
2022-03-13 16:16:46 +03:00
## Credits
2022-08-26 16:27:29 +03:00
* [Akif9748](https://github.com/Akif9748) - Project mainteiner, main developer, made **old** frontend
2022-08-26 16:37:26 +03:00
* [Tokmak](https://github.com/tokmak0) - Made **new** frontend
2022-08-26 16:27:29 +03:00
* [Camroku](https://github.com/Camroku) - Made **old** stylesheets
## Screenshot
2022-08-26 18:34:39 +03:00
### Old frontend
2022-08-26 16:27:29 +03:00
![akf-forum](https://user-images.githubusercontent.com/70021050/160255959-ef216cba-1348-4d4b-9347-fe67e21348e7.png)
2022-08-26 18:34:39 +03:00
### New frontend
![image](https://user-images.githubusercontent.com/70021050/186941146-f9a8fbf8-9b2b-4028-afc8-81cff559d9fb.png)
2022-08-26 16:27:29 +03:00
2022-03-13 16:16:46 +03:00
## Roadmap
2022-08-26 20:12:23 +03:00
### TO-DO:
- If thread deleted, not show its messages in API.
### Frontend
### User
| To do | Is done? | Priority |
| ----- | -------- | -------- |
2022-08-11 00:38:44 +03:00
| Login via redirect query | 🟢 | HIGH |
2022-05-01 17:07:01 +03:00
| Register | 🟢 | HIGH |
| Logout | 🟢 | HIGH |
| Admin | 🟢 | HIGH |
| Message count | 🟢 | MEDIUM |
| Delete user | 🟢 | HIGH |
2022-08-11 17:55:48 +03:00
| Undelete | 🔴 | MEDIUM |
2022-05-01 17:07:01 +03:00
| About me | 🔴 | LOW |
| Edit user | 🔴 | HIGH |
2022-08-10 02:12:36 +03:00
| IP ban | 🔴 | MEDIUM |
### Messages
| To do | Is done? | Priority |
| ----- | -------- | -------- |
| Ratelimit | 🟢 | HIGH |
2022-05-01 17:07:01 +03:00
| Send | 🟢 | HIGH |
| Delete | 🟢 | HIGH |
2022-08-24 22:39:38 +03:00
| Regex for scripts | 🔴 | HIGH |
2022-08-11 17:55:48 +03:00
| Undelete | 🔴 | MEDIUM |
2022-05-01 17:07:01 +03:00
| React | 🟢 | MEDIUM |
2022-08-11 01:11:07 +03:00
| Edit | 🔴 | MEDIUM |
### Threads
| To do | Is done? | Priority |
| ----- | -------- | -------- |
2022-08-10 02:12:36 +03:00
| Ratelimit | 🟢 | HIGH |
2022-05-01 17:07:01 +03:00
| Create | 🟢 | HIGH |
2022-08-10 00:46:54 +03:00
| Delete | 🟢 | HIGH |
2022-08-11 17:55:48 +03:00
| Undelete | 🔴 | MEDIUM |
2022-08-11 01:11:07 +03:00
| Edit | 🔴 | MEDIUM |
### API
2022-08-26 20:12:23 +03:00
| To do | Is done?
| ----- | --------
| RATELIMITS | 🟢
| Get message**s** | 🟢
| Create message & thread & user | 🟢
| Get message & thread & user | 🟢
| Delete message & thread & user | 🟢
| Undelete message & thread & user | 🟢
| Edit message & thread & user | 🔴
### Other
| To do | Is done? | Priority |
| ----- | -------- | -------- |
2022-08-12 22:32:22 +03:00
| Footer | 🟢 | LOW |
2022-08-11 18:34:56 +03:00
| auto-scroll | 🟢 | LOW |
2022-08-26 16:27:29 +03:00
| Multi-theme support | 🟡 | LOW |
| Search | 🟡 | MEDIUM |
2022-08-24 23:10:29 +03:00
| Better view, page support, support message limit correct | 🔴 | MEDIUM |
2022-08-11 03:48:35 +03:00
| Sending message etc. will use fetch API | 🟢 | HIGH |
2022-03-13 16:16:46 +03:00
2022-08-26 16:27:29 +03:00
### New Theme
- [x] Login
- [x] Register
- [x] Main page
- [x] Error
2022-08-26 20:15:04 +03:00
- [x] Users
- [x] Threads
- [x] Create Thread
2022-08-26 20:15:04 +03:00
- [ ] Thread
- [ ] User
- [ ] Admin