# 🎓 AlumniVerse

A web-based platform designed to connect, engage, and empower alumni. This project aims to build a strong, lifelong alumni community through user profiles, messaging, events, job opportunities, and more.

## 🚧 Project Status

> **Status**: 🛠 In development
> The repository has been initialized. Core architecture, models, and features are currently being designed. Code will be pushed incrementally as development progresses.

## 📄 Software Requirements Specification (SRS)

Check out our detailed [Software Requirements Specification](docs/SRS.md) that includes:

- Complete tech stack (React/TypeScript, Django, PostgreSQL, Redis, etc.)
- Detailed core features (User & Access, Alumni Directory, Events, Jobs, Messaging, etc.)
- Technical architecture and implementation details
- Database schema and API endpoints
- Development requirements and setup instructions
- User roles and permissions
- Development phases and deployment guidelines

## 🌟 Planned Features

### Core Features

- Alumni registration and login (with verification)
- Profile management (education, job, contact info)
- Alumni directory with search and filters (batch, program, location)
- Event creation and RSVP functionality
- Admin panel for managing users and content

### Advanced Features

- Private messaging and group chats
- Job and internship board
- Community posts, forums, and announcements
- Email/newsletter notifications
- Privacy settings for public/private profiles
- Batch-wise or interest-based groups and feeds

## 🛠 Tech Stack

- **Frontend**: React + TypeScript
- **Backend**: Django + Django REST Framework
- **Database**: PostgreSQL
- **Authentication**: JWT or OAuth 2.0
- **Dev Tools**: Docker, GitHub Actions, Postman
- **Deployment**: Render, Railway, or VPS

## 📁 Folder Structure

```
alumnivarse/
├── apps/                    # Django applications
│   ├── accounts/           # User authentication & profiles
│   ├── achievements/       # Alumni achievements & recognition
│   ├── dashboard/          # User dashboard & analytics
│   ├── events/            # Event management
│   ├── forum/             # Discussion forums
│   ├── jobs/              # Job board & opportunities
│   ├── messaging/         # Private messaging system
│   ├── mentorship/        # Mentorship program
│   ├── news/              # News & announcements
│   └── notifications/     # User notifications
│
├── config/                 # Project configuration
│   ├── settings/          # Settings modules
│   │   ├── base.py       # Base settings
│   │   ├── development.py # Development settings
│   │   └── production.py  # Production settings
│   ├── urls.py           # Project URL configuration
│   ├── wsgi.py           # WSGI configuration
│   └── asgi.py           # ASGI configuration
│
├── docs/                   # Documentation
│   └── SRS.md            # Software Requirements Specification
│
├── requirements.txt        # Python dependencies
├── pyproject.toml         # Project metadata and dependencies
├── manage.py              # Django management script
├── .env.example           # Example environment variables
└── .gitignore            # Git ignore rules
```

## 📅 Roadmap

- [x] Repository initialized
- [ ] Requirements finalized
- [ ] Database models designed
- [ ] REST API developed
- [ ] Frontend UI implemented
- [ ] Integration and testing
- [ ] Initial release

## 🤝 Contributing

Contributions are welcome after the initial setup is complete.
Please follow standard practices and guidelines for AGPL-licensed software.

## ⚖ License

This project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**.
See the full license in the [LICENSE](./LICENSE) file.

> 🔐 Under the AGPL, if you deploy this project for public use, you must also make the complete source code publicly available.

---

> Stay tuned for project updates, SRS release, and development milestones. 🚀

---

<sub>
_"A man without aims is like a monkey."_ 🐒
— Sankalp, building one line of code at a time
</sub>