This repository contains our team's B.R.A.D. (Bot to Report Abusive Domains) project, a cybersecurity web application that automates the analysis of potentially malicious URLs. Users can submit suspicious links through the website, where an AI-powered bot safely visits and analyzes the domain. The system extracts metadata, detects threats like malware, and compiles forensic reports. All findings are aggregated into a centralized platform that supports incident reporting, dashboard visualization, and historical threat analysis.
📂 BRAD
├── 📂 api/ # backend and data storage
├── 📂 backend/ # backend and data storage
├── 📂 bot/ # Used to analyze reports
├── 📂 frontend/ # UI
├── 📂 docs/ # Documentation
├── 📄 README.md # Project overview
├── 📄 docker-compose.yml # Docker setup
├── 📄 .gitignore # Ignore unnecessary files
├── 📄 .dockerignore # Ignore unnecessary files
git clone https://github.com/COS301-SE-2025/BRAD.git
cd BRADEnsure you have Docker installed, then run:
(first time only)
docker compose buildthen
docker compose upYou should see a message similar to this:
Local: http://localhost:5173/Simply type this link into a browser to view the project.
- Create a branch for your feature:
git checkout -b feature-name - Commit changes with clear messages.
- Open a Pull Request (PR) for review.
- Ensure tests pass before merging. -->
| Description | Links | |
|---|---|---|
 E (Ethan) Vletter u22497082 Project Manager, DevOps |
I am a final-year BSc Computer Science student with solid experience leading project teams. I never pretend to have all the answers, whether it’s feedback from other engineers or simply someone giving a tip on a better color palette. I want to listen and learn before I start to earn. |
  |
 TS (Tebatso) Mahlathini u22611704 API, DevOps |
I'm a 3rd-year student in information and knowledge systems, with a primary focus in computer science and secondary studies in multimedia and informatics. Because of this broad academic foundation, I can work in both frontend and backend development. I'm a hardworking and adaptable individual who learns quickly in group settings. I've worked on several group projects where I've improved my communication skills and often helped with achieving positive results. Im eager to learn new technologies and take on new challenges |
|
 C (Carinda) Smith u22652974 API |
I am a final-year BSc student in Information and Knowledge Systems, with a specialization in Data Science. My skills are Java and MySQL, but I also have experience with frontend development and API integration. I'm a quick learner with the tenacity to take on new challenges, whether it's learning a new language or troubleshooting complex issues under pressure. Working on many group projects has helped me develop excellent teamwork, adaptability, and communication skills. I enjoy building clean, user-friendly interfaces, developing secure and scalable APIs, and managing data-driven backends. Above all, I'm a dependable coworker who prioritizes quality and is dedicated to providing intelligent, user-centered solutions in any development context. | |
 M (Megan) Pretorius u23708833 UI |
I am a hardworking and motivated final-year BSc Computer Science student at the University of Pretoria with a strong technical foundation, keen attention to detail, and a passion for solving complex problems. I bring a unique combination of analytical thinking and creative problem-solving, which allows me to tackle technical challenges with innovative solutions. My ability to quickly understand and adapt to new technologies makes me a valuable asset in any software development team. I’m also bilingual, a confident communicator, and excel under pressure. I’ve worked on various collaborative projects where my organizational skills ensured timely delivery and high team morale. I thrive in fast-paced environments and always bring a proactive, can-do attitude to my work. |
|
 S (Salome) Kalaka u19364742 API |
A third-year BSc Computer Science student at the University of Pretoria, passionate about mathematics and coding. My interests include Data Science, Machine Learning and AI. I hold a Machine Learning certificate from MATLAB and enjoy applying theoretical knowledge to real-world challenges. I thrive in collaborative environments and bring a strong problem-solving mindset to every project. I also participate in hackathons not only to win but to expose myself to diverse real-life problems that build the practical experience I need to excel in my field. I believe that consistent practice is key to mastering any process. | |