53 lines
2.7 KiB
Markdown
53 lines
2.7 KiB
Markdown
# Aether Platform - Strategic TODO (Agents & Operations)
|
|
|
|
This document tracks high-impact architectural improvements to the Aether Docker Environment and its connected services. These tasks focus on stability, security, and developer experience (DX).
|
|
|
|
---
|
|
|
|
## 🛠️ Infrastructure & Orchestration
|
|
|
|
### **1. Container Healthchecks (Self-Healing)**
|
|
- [x] **FastAPI Healthcheck:** Added a `/health` endpoint to `aether_api_fastapi` that verifies DB and Redis connectivity.
|
|
- [ ] **Docker Integration:** Update `docker-compose.yml` to use `healthcheck` for `ae_api` and `ae_app`. (Manual testing complete, next step is automation).
|
|
- [ ] **Dependency Ordering:** Use `condition: service_healthy` in `depends_on` blocks to ensure services start in the correct order.
|
|
|
|
### **2. Environment Abstraction & Safety**
|
|
- [ ] **IP Abstraction:** Move the hardcoded workstation IP (`192.168.32.7`) to an `.env` variable (e.g., `AE_HOST_IP`) and reference it in `extra_hosts`.
|
|
- [ ] **Env Validation:** Create a `scripts/validate_env.sh` to compare `.env` against `env.default` and catch missing keys or malformed values.
|
|
- [ ] **Secret Scanning:** Implement a pre-commit hook or script to ensure no sensitive credentials (from `.env` or backups) are accidentally staged.
|
|
|
|
### **3. Operational Tooling (The "Easy Button")**
|
|
- [ ] **Master Makefile:** Create a `Makefile` in the orchestration root for common commands:
|
|
- `make up` / `make down`
|
|
- `make build-ui` / `make build-api`
|
|
- `make db-backup` / `make db-restore`
|
|
- `make logs`
|
|
- [ ] **Unified Logs:** Enhance `ae_ops` to provide a consolidated view of critical system errors across all containers.
|
|
|
|
---
|
|
|
|
## 🐍 Backend (FastAPI) Modernization
|
|
|
|
### **4. Configuration via Pydantic Settings**
|
|
- [x] **Refactor `app/config.py`:** Switched from the mounted file pattern to `pydantic-settings`.
|
|
- [x] **Environment Injection:** API now inherits all settings directly from Docker environment variables.
|
|
- [ ] **V2 Migration:** (Long Term) Prepare for the upgrade to Pydantic V2 and SQLAlchemy 2.0.
|
|
|
|
### **5. Dependency Management**
|
|
- [x] **Lockfiles:** Created `requirements.lock` to ensure bit-identical builds across environments.
|
|
- [x] **Pruning:** Conducted a final audit of the FastAPI base image and removed 6 redundant Python dependencies.
|
|
|
|
---
|
|
|
|
## 🌐 Frontend (SvelteKit) Enhancements
|
|
|
|
### **6. Build & Runtime Optimization**
|
|
- [ ] **Image Size:** Optimize the multi-stage Dockerfile to further reduce the final runtime image size.
|
|
- [ ] **Cache Warming:** Implement a mechanism to warm the SvelteKit / Dexie cache on first load for better UX.
|
|
|
|
---
|
|
|
|
## 📝 Governance
|
|
- This list is managed by **Scott Idem** and **Aether Agents**.
|
|
- Tasks should be moved to the [Kanban Board] (via `ae_task_add`) when active work begins.
|