v1.0.2 - Docker Setup and API Improvements

Tổng quan

Release v1.0.2 tập trung vào việc đơn giản hóa deployment với Docker và cải thiện API structure.

Tính năng mới

One-Command Docker Setup

• Script start.sh để khởi động Backend chỉ với 1 lệnh
• Tự động build Docker image và khởi động services
• Health check tự động cho PostgreSQL

Database Management

• DATABASE_IMPORT.md - Hướng dẫn import database chi tiết
• export_database.sh - Script export database
• import_database.sh - Script import database
• Hỗ trợ 487,000+ OSM entities

Cải tiến

Docker

• Container names sử dụng suffix -prod để tránh conflicts
• Loại bỏ version field (obsolete trong Docker Compose)
• Network riêng biệt: citylens-network-prod
• Mount volumes cho init scripts

Documentation

• Quick Start guide trong README
• Database import instructions
• Gitignore cho database dumps và OSM file

Contributors

@Vudangkhoa0910

CityLens v1.0.1

CityLens v1.0.1

Phiên bản patch cải thiện documentation và publish NPM packages.

NPM Packages Published

Đã publish 3 packages lên GitHub Packages:

• @pka-opendynamics/citylens-utils v1.0.0
• @pka-opendynamics/citylens-geo-utils v1.0.0
• @pka-opendynamics/citylens-ngsi-ld v1.0.0

Link: https://github.com/PKA-OpenDynamics/CityLens/packages

Documentation

Backend v1.0.1

• Thêm CHANGELOG.md với lịch sử thay đổi
• Thêm CONTRIBUTING.md với hướng dẫn đóng góp
• Thêm DEPENDENCIES.md với thông tin licenses

Web Dashboard v1.0.1

• Thêm CHANGELOG.md
• Thêm CONTRIBUTING.md
• Cập nhật DEPENDENCIES.md

Web App v1.0.1

• Cập nhật CHANGELOG.md với format tiếng Việt
• Thêm CONTRIBUTING.md đầy đủ
• Thêm DEPENDENCIES.md với thông tin licenses

Packages

• Thêm PUBLISHING.md hướng dẫn publish packages
• Script tự động publish packages

Improvements

• Chuẩn hóa format tài liệu tiếng Việt cho tất cả components
• Đồng bộ cấu trúc documentation
• Thêm Pull Request template
• Tối ưu .gitignore

Bug Fixes

• Sửa package names để phù hợp với GitHub organization (pka-opendynamics)
• Sửa repository URLs trong package.json

Installation

Xem hướng dẫn cài đặt trong README của từng component:

• backend/README.md
• web-dashboard/README.md
• web-app/README.md

Links

• Repository: https://github.com/PKA-OpenDynamics/CityLens
• Packages: https://github.com/PKA-OpenDynamics/CityLens/packages
• Issues: https://github.com/PKA-OpenDynamics/CityLens/issues

CityLens v1.0.0

Lịch sử thay đổi (Changelog)

Định dạng dựa trên Keep a Changelog,
và dự án tuân theo Semantic Versioning.

1.0.0 - 2025-12-07

Thêm mới

Backend (v1.0.0)

• API NGSI-LD tuân thủ chuẩn ETSI
• Hỗ trợ ontology SOSA/SSN
• API dữ liệu địa lý với PostGIS
• Tích hợp LOD (OpenWeatherMap, AQICN, TomTom, OSM)
• Xác thực người dùng với JWT
• Hệ thống quản lý báo cáo
• Quản lý ranh giới hành chính

Web Dashboard (v1.0.0)

• IntegratedDataPanel cho hiển thị LOD
• BoundarySelector cho truy vấn địa lý
• Hiển thị dữ liệu đa nguồn (thời tiết, AQI, giao thông, OSM)
• Dashboard với analytics
• Trang dữ liệu địa lý

Tài liệu

• README đầy đủ cho tất cả sub-projects
• DEPENDENCIES.md với thông tin license
• Hướng dẫn CONTRIBUTING.md
• CHANGELOG.md theo định dạng Keep a Changelog
• License headers GPL-3.0 trong tất cả source files

Hạ tầng

• Cấu hình Docker Compose
• Thiết lập PostgreSQL + PostGIS
• Alembic migrations
• Mẫu cấu hình environment
• Scripts cài đặt tự động (setup.sh)

Thay đổi

• Thống nhất license GPL-3.0 cho tất cả components
• Dọn sạch code và scripts không dùng
• Chuẩn hóa API client với hỗ trợ PATCH
• Cập nhật cấu trúc tài liệu

2025-11-25

Thêm mới

• SQLAlchemy models cho tất cả entities
• Alembic migration framework
• Script import OSM với osmium
• Seeding categories báo cáo
• Neo4j/GraphDB ontology schema

Thay đổi

• Cập nhật Python dependencies cho Python 3.11
• Đổi tên metadata thành report_metadata trong Report model

Sửa lỗi

• Import và export models
• Cấu hình Alembic
• Xử lý geometry PostGIS

Bảo mật

• Thêm .gitignore rules cho:
  • Dữ liệu OSM lớn (*.osm.pbf, *.geojson)
  • Cấu hình environment (.env)
  • Database files

2025-11-20

Thêm mới

• Cấu trúc dự án ban đầu
• Skeleton API backend với FastAPI
• Nền tảng web dashboard với React + TypeScript
• Thiết lập mobile app với Flutter
• Authentication models
• Report submission models
• Thiết kế database schema
• Cấu hình Docker cho development
• Thiết lập CI/CD pipeline
• Tài liệu dự án

Hạ tầng

• Thiết lập PostgreSQL database
• MongoDB cho dữ liệu thời gian thực
• Neo4j knowledge graph foundation
• Redis cho caching
• Cấu hình môi trường development

---

Phân loại thay đổi

• Thêm mới - Tính năng mới
• Thay đổi - Thay đổi trong chức năng hiện có
• Loại bỏ - Tính năng sắp bị gỡ bỏ
• Xóa bỏ - Tính năng đã bị gỡ bỏ
• Sửa lỗi - Sửa lỗi
• Bảo mật - Thay đổi liên quan đến bảo mật

---