Initial commit for resumeformatter project
This commit is contained in:
80
backend/README.md
Normal file
80
backend/README.md
Normal file
@@ -0,0 +1,80 @@
|
||||
# Profile Linker API
|
||||
|
||||
This is a FastAPI backend for the Profile Linker application. It provides API endpoints for managing a list of people's profiles.
|
||||
|
||||
## Project Structure
|
||||
|
||||
The project follows a modular structure:
|
||||
|
||||
```
|
||||
backend/
|
||||
├── app/
|
||||
│ ├── api/ # API endpoints
|
||||
│ │ ├── endpoints/ # API endpoint modules
|
||||
│ │ └── api.py # API router
|
||||
│ ├── core/ # Core application components
|
||||
│ │ └── config.py # Application settings
|
||||
│ ├── crud/ # CRUD operations
|
||||
│ │ └── person.py # Person CRUD operations
|
||||
│ ├── db/ # Database components
|
||||
│ │ ├── base.py # Database base
|
||||
│ │ ├── base_class.py # Base class for database models
|
||||
│ │ └── session.py # Database session
|
||||
│ ├── models/ # Database models
|
||||
│ │ └── person.py # Person model
|
||||
│ ├── schemas/ # Pydantic schemas
|
||||
│ │ └── person.py # Person schemas
|
||||
│ └── main.py # FastAPI application
|
||||
├── main.py # Entry point
|
||||
└── requirements.txt # Python dependencies
|
||||
```
|
||||
|
||||
## API Endpoints
|
||||
|
||||
The API provides the following endpoints:
|
||||
|
||||
- `GET /api/people`: Get all people
|
||||
- `POST /api/people`: Create a new person
|
||||
|
||||
## Development
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Python 3.11+
|
||||
- Docker and Docker Compose
|
||||
|
||||
### Running the Application
|
||||
|
||||
#### Using Docker Compose
|
||||
|
||||
1. Build and start the containers:
|
||||
|
||||
```bash
|
||||
docker-compose up --build
|
||||
```
|
||||
|
||||
2. Access the API at http://localhost:8080/api
|
||||
3. Access the API documentation at http://localhost:8080/docs
|
||||
|
||||
#### Running Locally
|
||||
|
||||
1. Install dependencies:
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
2. Run the application:
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
python main.py
|
||||
```
|
||||
|
||||
3. Access the API at http://localhost:8080/api
|
||||
4. Access the API documentation at http://localhost:8080/docs
|
||||
|
||||
## Frontend Integration
|
||||
|
||||
The backend serves the frontend as static assets. The frontend should be built and placed in the `dist` directory. The Docker setup handles this automatically.
|
||||
Reference in New Issue
Block a user