Proje aksiyonları, aktiviteleri ve toplantıları

Bu sayfa src/cluster_erp/modules/projects/ içindeki dört alt modülü anlatır. actions/ bir projenin toplantılardan veya doğrudan gelen aksiyonlarını tutar. activities/ bir proje çizelgesinin aktivitelerini, bağımlılık ilişkilerini ve malzeme bağlarını tutar. kickoffs/ bir projenin tek başlangıç toplantısını, meetings/ haftalık izleme toplantılarını tutar. Çizelgenin kendisi çizelgeler sayfasındadır.

Kapsam ve kaynak¶

Tanımlandığı yer: actions, activities, kickoffs ve meetings alt modüllerinin models.py, schemas.py, services.py, routes.py ve metadata.py dosyaları.
Sayım: 6 tablo; 8 aksiyon ucu, 12 aktivite ucu, 7 başlangıç toplantısı ucu ve 6 toplantı ucu (@router. dekoratörleri); 3 ActionMeta girdisi.

Alanlar¶

Varlık	Tablo	Anahtar alanlar	Kaynak
`ProjectAction`	`projects_actions`	`project_id`, `source` (`kickoff`, `weekly` veya `adhoc`), `source_meeting_id`, `title`, `description`, `owner_id`, `due_at`, `status`, `completed_at`, `completed_by`	`src/cluster_erp/modules/projects/actions/models.py:17-55`, `src/cluster_erp/modules/projects/actions/schemas.py:9-10`
`ProjectActivity`	`projects_activities`	`schedule_id`, `code`, `name`, `activity_type`, `planned_start`, `planned_end`, `work_qty_hours`, `work_center_group_ref`, `status`, `milestone_usage`, `release_successors`, `actual_at`, `ev_technique`, `budgeted_hours`	`src/cluster_erp/modules/projects/activities/models.py:28-80`
`ProjectActivityRelation`	`projects_activity_relations`	`predecessor_id`, `successor_id`, `relation_type` (`FS`, `SS`, `FF`, `SF`), `lag_days`	`src/cluster_erp/modules/projects/activities/models.py:83-108`, `src/cluster_erp/modules/projects/activities/schemas.py:18`
`ActivityMaterialLink`	`projects_activity_material_links`	`activity_id`, `project_item_id`, `bom_item_ref`, `qty`	`src/cluster_erp/modules/projects/activities/models.py:111-135`
`KickoffMeeting`	`projects_kickoffs`	`project_id`, `scheduled_at`, `held_at`, `attendees_jsonb`, `checklist_items_jsonb`, `minutes_doc_id`	`src/cluster_erp/modules/projects/kickoffs/models.py:17-56`
`WeeklyFollowupMeeting`	`projects_weekly_meetings`	`project_id`, `week_no`, `held_at`, `attendees_jsonb`, `summary`	`src/cluster_erp/modules/projects/meetings/models.py:17-52`

Aktivite tipleri engineering, procurement, production, assembly, milestone ve cost; durumları planned, in_progress, done ve cancelled; kazanılmış değer tekniği 0_100, 50_50 veya percent_complete'tir (src/cluster_erp/modules/projects/activities/schemas.py:10-33).

Durumlar ve aksiyonlar¶

Bir aksiyon open durumundan in_progress durumuna, ikisinden de done veya cancelled durumuna geçer; done ve cancelled son durumlardır (src/cluster_erp/modules/projects/actions/services.py:20-25).

stateDiagram-v2
 [*] --> open
 open --> in_progress
 open --> cancelled
 in_progress --> done
 in_progress --> cancelled

Düz anlatımla: bir aksiyon açık başlar, üzerinde çalışılır ve tamamlanmış veya iptal edilmiş olarak biter. Servis başka adımları reddeder (src/cluster_erp/modules/projects/actions/services.py:160-170).

Aksiyon	Etiket	Koşul	Uç	İzin	Kaynak
`transition` (aksiyon)	Durum Değiştir	yok; adımı servis denetler	`POST /actions/{id}/transition`	`action.assign`	`src/cluster_erp/modules/projects/actions/metadata.py:95-104`, `src/cluster_erp/modules/projects/actions/routes.py:88`
`mark_held` (başlangıç toplantısı)	Gerçekleşti Olarak İşaretle	yok	`POST /kickoffs/{id}/mark-held`	`meeting.record`	`src/cluster_erp/modules/projects/kickoffs/metadata.py:43-52`, `src/cluster_erp/modules/projects/kickoffs/routes.py:89`
`update_checklist` (başlangıç toplantısı)	Kontrol Listesini Güncelle	yok	`POST /kickoffs/{id}/checklist`	`meeting.record`	`src/cluster_erp/modules/projects/kickoffs/metadata.py:53-62`, `src/cluster_erp/modules/projects/kickoffs/routes.py:76`

Uçlar¶

Yöntem ve yol	İzin	Kaynak
`GET /actions/by-project/{project_id}`, `GET /actions/overdue`, `GET /actions/{action_id}`	`project.read`	`src/cluster_erp/modules/projects/actions/routes.py:25-61`
`POST /actions/`; `PUT`, `DELETE /actions/{action_id}`; toplu silme	`action.assign`, `project.update`	`src/cluster_erp/modules/projects/actions/routes.py:49-113`
`GET /activities/by-schedule/{schedule_id}`, `/for-project`, `/by-project/{project_id}`, `/{activity_id}`, `/{activity_id}/materials`	`project.read`	`src/cluster_erp/modules/projects/activities/routes.py:27-168`
aktiviteler, ilişkiler ve malzeme bağları için `POST`, `PUT`, `DELETE`	`project.update`	`src/cluster_erp/modules/projects/activities/routes.py:105-192`
`/kickoffs` altındaki başlangıç toplantısı uçları	`project.read`, `meeting.record`	`src/cluster_erp/modules/projects/kickoffs/routes.py:23-101`
`/meetings` altındaki toplantı uçları	`project.read`, `meeting.record`	`src/cluster_erp/modules/projects/meetings/routes.py:23-85`

Kısıtlar ve doğrulama¶

Bir aktivite mevcut bir çizelge ister ve planlanan bitişi planlanan başlangıçtan önce olamaz (src/cluster_erp/modules/projects/activities/services.py:97-121).
Bir ilişki bir aktiviteyi kendisine bağlayamaz, iki aktivite aynı çizelgede olmalıdır ve döngü oluşturacak bir ilişki reddedilir (src/cluster_erp/modules/projects/activities/services.py:154-211).
Bir malzeme bağı bir proje kalemi veya bir ürün ağacı kalemi başvurusu ister (src/cluster_erp/modules/projects/activities/services.py:221-243).
Aktivite değişiklikleri ProjectActivityChanged yayar (src/cluster_erp/modules/projects/activities/services.py:43-58).
Bir projenin bir canlı başlangıç toplantısı ve hafta numarası başına bir canlı toplantısı olur (src/cluster_erp/modules/projects/kickoffs/models.py:20-27, src/cluster_erp/modules/projects/meetings/models.py:19-27).
mark_held, held_at alanını bir kez damgalar ve ProjectKickoffCompleted yayar (src/cluster_erp/modules/projects/kickoffs/services.py:101-121).
GET /actions/overdue vadesi geçmiş aksiyonları listeler (src/cluster_erp/modules/projects/actions/services.py:51-70).
Aksiyon oluşturmak ProjectActionCreated yayar (src/cluster_erp/modules/projects/actions/services.py:94).
Saatler Numeric türündedir: iş miktarı Numeric(10, 2), bütçe saatleri Numeric(12, 2), bağ miktarı Numeric(14, 4) (src/cluster_erp/modules/projects/activities/models.py:43-45, src/cluster_erp/modules/projects/activities/models.py:71-73, src/cluster_erp/modules/projects/activities/models.py:132).

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
project action	`ProjectAction`	Bir toplantıdan veya doğrudan gelen, sahibi ve vadesi olan görev.	Proje aksiyonu	`src/cluster_erp/modules/projects/actions/models.py:17`
project activity	`ProjectActivity`	Bir proje çizelgesinin planlanmış bir adımı.	Proje aktivitesi	`src/cluster_erp/modules/projects/activities/models.py:28`
activity relation	`ProjectActivityRelation`	İki aktivite arasında FS, SS, FF veya SF tipinde, gecikmeli bağımlılık.	Aktivite ilişkisi	`src/cluster_erp/modules/projects/activities/models.py:83`
kick-off meeting	`KickoffMeeting`	Kontrol listesiyle bir projenin açılış toplantısı.	Başlangıç toplantısı	`src/cluster_erp/modules/projects/kickoffs/models.py:17`

İlgili sayfalar¶

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.