Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added Readme and Contributing file #2

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions Contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# How to Contribute

## Issues
- Browse the [issues](https://github.com/lugnitdgp/TDoC-Docify/issues) currently raised and select one that you would like to work on.
- Each issue is labeled according to its difficulty level.
- If you encounter a new issue that isn't listed, feel free to raise a new issue on the [issues page](https://github.com/lugnitdgp/TDoC-Docify/issues) of the repository.

## Steps to Contribute
1. Review the [README.md](./README.md) file to understand the setup process and project guidelines.
2. Make the necessary changes to the codebase.
3. Fork the repo, clone it, and implement your changes.
4. Push your updates to your forked repository.
5. Submit a pull request to the main branch.
6. In your pull request description, include details about the issue you resolved and any other relevant information.

Thank you for contributing to our project!
73 changes: 73 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,76 @@ Docify, a Python-based app, akin to Google Docs, employs sockets for real-time d

PyQt5, Sockets, Supabase

## Table of Contents
- [Supabase Tables](#supabase-tables)
- [Configuration](#configuration)
- [Setup Instructions](#setup-instructions)
- [Usage](#usage)

## Supabase Tables

### `user` Table
- **Columns:**
- `uid` (UUID): Unique identifier for the user.
- `full_name` (Text): Full name of the user.
- `email` (Text): Email address of the user.
- `password` (Text): Password of the user.
- `docs` (Text Array): Array of document IDs associated with the user.

### `docs` Table
- **Columns:**
- `doc_id` (UUID): Unique identifier for the document.
- `name` (Text): Name of the document.
- `links` (Text): Links related to the document.
- `access` (Text): Access level for the document (e.g., "Restricted", "Readable", "Writable").
- `user_access` (Text Array): Array of access types for specific users.
- `content` (Text): Content of the document.
- `users` (Text Array): Array of user IDs who have access to the document.

## Configuration

1. **Cloudinary Credentials:**
- Create a file named `cloudinary_credentials.py` in your home directory and configure it with your Cloudinary credentials.
```python
# cloudinary_credentials.py
import cloudinary
import cloudinary.uploader

# Configure your Cloudinary credentials
cloudinary.config(
cloud_name='your_cloud_name', # Replace with your Cloudinary cloud name
api_key='your_api_key', # Replace with your Cloudinary API key
api_secret='your_api_secret' # Replace with your Cloudinary API secret
)

2. **Supabase and SMTP Credentials:**
- Create a file named `credentials.py` in the utils directory and configure it with your Supabase URL and key, and SMTP username and password.
```python
# utils/credentials.py

# Supabase credentials
SUPABASE_URL = 'your_supabase_url' # Replace with your Supabase URL
SUPABASE_KEY = 'your_supabase_key' # Replace with your Supabase API key

# Google SMTP credentials
google_username = 'your_smtp_username' # Replace with your SMTP username
google_password = 'your_smtp_password' # Replace with your SMTP password

## Setup Instructions

### Clone the Repository:


git clone https://github.com/Pudi-Sravan/Docify-TDoC.git
cd your-repo-name

### Install Dependencies:

pip install -r requirements.txt


## To start the main application:

python3 main.py
python3 server.py

Binary file added __pycache__/cloudinary_credentials.cpython-310.pyc
Binary file not shown.
Empty file added utils/__init__.py
Empty file.
Binary file added utils/__pycache__/__init__.cpython-310.pyc
Binary file not shown.
Binary file added utils/__pycache__/client.cpython-310.pyc
Binary file not shown.
Binary file added utils/__pycache__/credentials.cpython-310.pyc
Binary file not shown.