chore: track all project map and index files

Add generated .pi-map.md and .pi-map.index.md files across the repository
so the project navigation maps are shared and versioned. These artifacts
are maintained by project_map_init/patch/validate and must be kept in
sync with source edits.

Note: .cache/ remains ignored (added in previous commit).

apps/api/uploads/.pi-map.index.md

@@ -0,0 +1,20 @@
+# apps/api/uploads (index)
+dir: apps/api/uploads
+
+## role
+Handles file upload processing, storage, and management for the API application.
+## parent
+index: apps/api/.pi-map.index.md
+map: apps/api/.pi-map.md
+## children
+- apps/api/uploads/avatars
+  index: apps/api/uploads/avatars/.pi-map.index.md
+  map: apps/api/uploads/avatars/.pi-map.md
+## files
+## links
+index: apps/api/uploads/.pi-map.index.md
+map: apps/api/uploads/.pi-map.md
+## workflows
+-
+## dirty
+-

apps/api/uploads/.pi-map.md

@@ -0,0 +1,18 @@
+# apps/api/uploads
+dir: apps/api/uploads
+
+index: apps/api/uploads/.pi-map.index.md
+
+## role
+Handles file upload processing, storage, and management for the API application.
+## files
+## arch
+Modular service-oriented architecture with dedicated modules for different upload types (avatars, documents, images), using NestJS controllers/services with S3/cloud storage integration, file validation, and database persistence for upload metadata.
+## tags
+-
+## symbols
+-
+## workflows
+-
+## dirty
+-

apps/api/uploads/avatars/.pi-map.index.md

@@ -0,0 +1,22 @@
+# apps/api/uploads/avatars (index)
+dir: apps/api/uploads/avatars
+
+## role
+Storage directory for user avatar image files uploaded through the API.
+## parent
+index: apps/api/uploads/.pi-map.index.md
+map: apps/api/uploads/.pi-map.md
+## children
+-
+## files
+- 30d2810a-cb00-4065-8e5d-c7d32a0b55c9.png
+- b342b640-d3c1-488d-bdba-0e2890d6c363.png
+- da1c3121-20d7-400c-8c94-507a9d890810.png
+- ee9fdd89-0dcc-4f46-9ad8-01f4ff93720d.png
+## links
+index: apps/api/uploads/avatars/.pi-map.index.md
+map: apps/api/uploads/avatars/.pi-map.md
+## workflows
+-
+## dirty
+-

apps/api/uploads/avatars/.pi-map.md

@@ -0,0 +1,22 @@
+# apps/api/uploads/avatars
+dir: apps/api/uploads/avatars
+
+index: apps/api/uploads/avatars/.pi-map.index.md
+
+## role
+Storage directory for user avatar image files uploaded through the API.
+## files
+- 30d2810a-cb00-4065-8e5d-c7d32a0b55c9.png | Binary file
+- b342b640-d3c1-488d-bdba-0e2890d6c363.png | Binary file
+- da1c3121-20d7-400c-8c94-507a9d890810.png | Binary file
+- ee9fdd89-0dcc-4f46-9ad8-01f4ff93720d.png | Binary file
+## arch
+Simple flat file storage using UUID-named PNG files with no subdirectory organization or metadata indexing.
+## tags
+binary, 30d2810a, cb00, 4065, 8e5d, c7d32a0b55c9, b342b640, d3c1
+## symbols
+-
+## workflows
+-
+## dirty
+-