Skip to content
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
2 changes: 2 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
{
}
112 changes: 112 additions & 0 deletions PR_MESSAGE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
# Add REST API Endpoints and Modern Web Interface

## 📋 Summary

This PR adds comprehensive REST API endpoints and a modern, professional web interface for browsing aviation and travel data.

## ✨ New Features

### REST API Endpoints

1. **Airlines Endpoint** (`/api/airlines`)
- Get all airlines (5,929 airlines)
- Filter by country, IATA code, ICAO code
- Full-text search in airline names and aliases
- Example: `/api/airlines?country=Turkey`

2. **Countries Endpoint** (`/api/countries`)
- Get all countries (248 countries)
- Filter by region, subregion, currency, language
- Get country by ISO code (alpha-2 or alpha-3)
- Full-text search in country names
- Examples:
- `/api/countries?region=Europe`
- `/api/countries/TR`

3. **Enhanced Airports Endpoint**
- Existing endpoint maintained and improved

### Modern Web Interface

- **Professional Design**: Clean, minimal UI with gray color palette suitable for aviation industry
- **Responsive Layout**: Works seamlessly on desktop, tablet, and mobile
- **Real-time Search**: Instant filtering as you type
- **Advanced Filters**: Multiple filter options for each data type
- **Statistics Dashboard**: Live statistics for each dataset
- **Three Pages**:
- Airports browser (`/`)
- Airlines browser (`/airlines.html`)
- Countries browser (`/countries.html`)

## 📊 Data Coverage

- ✈️ **9,000+** Airports worldwide
- 🛫 **5,929** Airlines (including 38 Turkish airlines)
- 🌍 **248** Countries with detailed information

## 📚 Documentation

- **API_DOCUMENTATION.md**: Comprehensive API documentation with examples
- **CHANGELOG.md**: Detailed changelog of all changes
- **Updated README.md**: Installation and usage instructions

## 🛠️ Technical Details

- TypeScript + Express.js
- Modular route structure
- Query parameter filtering
- Error handling
- Maintains existing test infrastructure
- No breaking changes to existing endpoints

## 🧪 Testing

All endpoints tested and working:
```bash
# Airlines
GET /api/airlines
GET /api/airlines?country=Turkey
GET /api/airlines?iata=TK

# Countries
GET /api/countries
GET /api/countries?region=Europe
GET /api/countries/TR

# Airports (existing)
GET /api/airports
```

## 📸 Screenshots

Web interface features:
- Clean, professional design
- Real-time search and filtering
- Statistics dashboard
- Responsive grid layout
- Smooth hover effects

## 🔗 Links

- Live Demo: http://localhost:3000
- API Docs: [API_DOCUMENTATION.md](Rest%20Api/API_DOCUMENTATION.md)
- Changelog: [CHANGELOG.md](Rest%20Api/CHANGELOG.md)

## 👨‍💻 Author

**ADN Bilişim Teknolojileri**
🌐 [www.adnbilisim.com.tr](https://www.adnbilisim.com.tr)

## ✅ Checklist

- [x] Code follows project style guidelines
- [x] Self-review completed
- [x] Documentation added/updated
- [x] No breaking changes
- [x] All endpoints tested and working
- [x] Web interface tested on multiple browsers
- [x] Responsive design verified

## 📝 Notes

This contribution maintains backward compatibility with existing code while adding significant new functionality. The modern web interface provides an easy way to explore the data, and the new API endpoints enable developers to build applications using this comprehensive dataset.
Loading