Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Feature: Add authentic NATO (APP‑6 / MIL‑STD) & OPFOR/BLUFOR markers — include licensing/legal checklist

Đang mở
  • Có gì không ổn?
#22 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
android, kotlin
Lĩnh vực
documentation, mobile-dev

Hướng nghiên cứu

Bắt đầu bằng cách đọc MilitarySymbolPicker.kt, TacticalUnitsMapOverlay.kt, LocationEntity và TacticalUnitEntity để lập bản đồ các trường biểu tượng hiện có và hành vi fallback. Xem xét pipeline asset và thiết lập kiểm thử của dự án trước khi chọn một nguồn biểu tượng nội bộ hoặc được cấp phép theo giấy phép permissive. Được xem là hoàn tất khi picker và phần hiển thị bản đồ hỗ trợ biểu tượng, affiliation, modifier, persistence, fallback marker, có các bài kiểm thử hoặc kiểm tra QA, và giấy phép của asset được ghi lại.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement help wanted priority: low UI/UX

Summary

Add authentic NATO-style military symbols (APP‑6 / MIL‑STD family) and OPFOR/BLUFOR marker variants to the map symbol set and symbol picker. Ensure all assets are permissively licensed (or created in-house) and documented with a licensing checklist.

Why

  • Current markers are simplified (colored circle + letter + arrow). The UI already discovers drawables with prefix ic_mapicon_ (MilitarySymbolPicker.kt) and supports symbol fields in the DB (LocationEntity/TacticalUnitEntity).
  • Authentic symbols improve clarity and realism for tactical workflows and training.
  • We must ensure assets are free-to-use or have proper attribution to avoid legal issues.

Proposed work

  1. Add a canonical set of vector-based NATO / MIL‑STD symbols (SVG → Android VectorDrawable or runtime vector render). Prefer CC0/MIT/Apache or create in-house icons.
  2. Extend MilitarySymbolPicker to preview and select real symbols, affiliation colors, and modifiers.
  3. Update TacticalUnitsMapOverlay to render vector symbols with affiliation coloring and fall back to circle markers when none assigned.
  4. Add DB migration or mapping scripts if needed, tests, QA checks, and sample data.

Acceptance criteria

  • Picker saves a NATO symbol + affiliation into symbolSet, symbolEntity, symbolAffiliation, symbolColor.
  • Map displays vector-drawn NATO symbols (units + static locations) with correct color and modifiers; heading arrows still render for applicable units.
  • Legacy circle-letter markers remain as fallback.
  • All new symbol assets include license metadata or are created in-house and documented.
  • README/docs updated with asset origin and licensing guidance.
  • Tests and QA checklist completed (zoom/rotation/high-density scenarios).

Tasks

  • Research permissive MIL‑STD/APP‑6-compatible symbol sources (record licenses & links).
  • Convert chosen SVGs to Android VectorDrawable or add runtime SVG renderer.
  • Update MilitarySymbolPicker.kt to show symbol previews and affiliation colorings.
  • Implement symbol rendering in TacticalUnitsMapOverlay.kt (vector draw + color + modifiers).
  • Add migrations or mapping code for existing icons -> new symbol fields.
  • Add integration/UI tests and manual QA checklist.
  • Add /assets/licenses with attribution & license files.
  • Legal review / sign-off for third-party assets (if used).

Licensing & legal checklist

  • Prefer CC0 / MIT / Apache 2.0 assets or create icons in-house.
  • For third-party assets: include source link, license file, and required attribution in /assets/licenses or NOTICE.
  • Avoid trademarked logos (e.g., NATO crest) unless permission is granted.
  • If uncertain, create a stylized in-house APP‑6 compatible set to avoid legal risk.
Ngôn ngữ chính
Kotlin
Star
43
Fork
4
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của arn-c0de/InteractiveChecklists

Tất cả issue của arn-c0de/InteractiveChecklists

Issue tương tự

Thêm issue về Kotlin

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.