docs(gsd): bootstrap planning and phase-1 discussion artifacts
This commit is contained in:
@@ -0,0 +1,14 @@
|
||||
# ActivityWatch-Russian
|
||||
|
||||
## Current Milestone: v1.0 Data Pipeline Stability
|
||||
|
||||
**Goal:** Ensure stable collection and rendering of endpoint activity data in AW Web UI.
|
||||
|
||||
**Target features:**
|
||||
- Reliable ingestion from Windows collectors (`endpoint-signals`, `browser-domains`).
|
||||
- Stable AW server query/render path for worktime/activity pages.
|
||||
- Deployment/runbook consistency (Ansible + install kit + rollback notes).
|
||||
|
||||
## Evolution
|
||||
|
||||
This document evolves at phase transitions and milestone boundaries.
|
||||
@@ -0,0 +1,14 @@
|
||||
# ROADMAP
|
||||
|
||||
## 🚧 v1.0 Data Pipeline Stability
|
||||
|
||||
- [ ] Phase 1: Collectors and API flow hardening
|
||||
- [ ] Phase 2: UI reports consistency and release proof
|
||||
|
||||
### Phase 1: Collectors and API flow hardening
|
||||
**Goal:** Stabilize collectors-to-server pipeline and remove known transport/runtime failure modes.
|
||||
**Depends on:** none
|
||||
|
||||
### Phase 2: UI reports consistency and release proof
|
||||
**Goal:** Validate report links/output, enforce rollout checks, and freeze reproducible release state.
|
||||
**Depends on:** Phase 1
|
||||
@@ -0,0 +1,26 @@
|
||||
---
|
||||
milestone: v1.0
|
||||
milestone_name: Data Pipeline Stability
|
||||
phase: "0"
|
||||
phase_name: Not started
|
||||
current_plan: 0
|
||||
total_plans_in_phase: 0
|
||||
status: planning
|
||||
progress_percent: 0
|
||||
last_activity: 2026-05-07
|
||||
---
|
||||
|
||||
## Current Position
|
||||
|
||||
Phase: Not started (defining requirements)
|
||||
Plan: —
|
||||
Status: Defining requirements
|
||||
Last activity: 2026-05-07 — Milestone v1.0 started
|
||||
|
||||
## Decisions
|
||||
|
||||
- Prioritize reliable data presence in activity/worktime views over UI extensions.
|
||||
|
||||
## Blockers
|
||||
|
||||
- None.
|
||||
@@ -0,0 +1,17 @@
|
||||
# Phase 1 Context
|
||||
|
||||
## Phase
|
||||
|
||||
Phase 1: Collectors and API flow hardening
|
||||
|
||||
## Focus
|
||||
|
||||
- Endpoint collectors must continuously send data without silent hangs.
|
||||
- AW server must accept/query data for UI pages consistently.
|
||||
- Failure points around transport/CORS/runtime must be explicitly checked.
|
||||
|
||||
## Initial Acceptance Targets
|
||||
|
||||
- Endpoint collector heartbeats arrive regularly.
|
||||
- Browser domains and endpoint signals appear in corresponding buckets.
|
||||
- Activity page for target host shows non-zero timeline/events for active period.
|
||||
@@ -0,0 +1,22 @@
|
||||
# PLAN — Phase 01: collectors-and-api-flow-hardening
|
||||
|
||||
## Goal
|
||||
|
||||
Deliver stable collector-to-server data flow so activity/worktime pages have consistent data.
|
||||
|
||||
## Work Items
|
||||
|
||||
1. Validate collector runtime and log rotation behavior.
|
||||
2. Validate server ingest endpoints and bucket write/read checks.
|
||||
3. Validate CORS/origin and report link consistency.
|
||||
4. Add/adjust scripts or runbook checks to detect zero-data regressions early.
|
||||
|
||||
## Verification
|
||||
|
||||
- Manual and scripted checks show fresh events in target buckets.
|
||||
- Host activity page reflects real activity (not `0s`) for active sessions.
|
||||
- No repeating transport errors in collector logs during test window.
|
||||
|
||||
## Status
|
||||
|
||||
Planned.
|
||||
Reference in New Issue
Block a user