This project was developed during our attachment period as our final project. It is a comprehensive system designed to track and manage the assets of SwahiliPot Hub Foundation. The project was built using Django for the backend and React/Next.js for the frontend. The application is deployed on PythonAnywhere for the backend and Vercel for the frontend.
The SwahiliPot Hub Foundation Asset Management System provides an easy-to-use interface for managing the foundation's assets. It includes features such as:
- Asset tracking
- Category management
- User authentication and roles
- Backend: Django
- Frontend: React.js, Next.js
PythonAnywhere (Backend)
Vercel (Frontend)
Check out the live version of the project:
Frontend (Vercel): SwahiliPot Hub Asset Management System Frontend
Backend (PythonAnywhere): SwahiliPot Hub Asset Management System Backend
To log into the system, use the following credentials:
Admin Account:
(Frontend)
Username: swahilipot
Password: 12345678sf
(Backend)
Username: admin
Password: admin123
User Account:
For frontend user account, you can simply register and login to your account.
If you'd like to run the project locally, follow these steps:
Backend (Django)
Clone the repository:
git clone https://github.com/ismaelaboud/ams.git
cd ams/backend
Create a virtual environment and activate it:
python -m venv myenv
source myenv/bin/activate
On Windows use
myenv/Scripts/activate
Install the dependencies:
pip install -r requirements.txt
Run the Django server:
python manage.py runserver
Frontend (React/Next.js)
Navigate to the frontend directory:
cd ../frontend
Install the dependencies:
npm install
Run the Next.js development server:
npm run dev
Read full documentation here