docs: on-prem data platform proposal for autonomous drone swarms
Problem statement, on-board architecture, Parquet/DuckDB storage design, swarm sync strategy, zero-trust networking, environments, observability, CI/CD delivery with fleet release manifests, roadmap and open questions.
This commit is contained in:
@@ -0,0 +1,26 @@
|
||||
# AGENTS.md
|
||||
|
||||
Rules for anyone (human or tooling) contributing to this repository.
|
||||
|
||||
## Hard rules
|
||||
|
||||
1. **English only.** All documentation, code, comments, commit messages, and file names are written in English.
|
||||
2. **No identifying references.** Never mention names of people, companies, organizations, or locations anywhere in this repository — not in docs, code, comments, or git history. This is a generic, self-contained design proposal for an on-prem data platform for autonomous drone swarms.
|
||||
3. **Clean git history.** Commit messages must never reference AI assistants, code generation tools, or editors. No `Co-authored-by` trailers pointing to tools, no "Generated with ..." lines. Conventional commit format (`feat:`, `fix:`, `docs:`, `refactor:`).
|
||||
4. **Push target.** The only remote is `origin` → `git.produktor.io`. Never mirror this repository anywhere else.
|
||||
|
||||
## Project layout
|
||||
|
||||
```
|
||||
docs/ Design documentation (Markdown + Mermaid)
|
||||
simulator/ Virtual drone fleet — Python data generator (Parquet/DuckDB pipeline)
|
||||
prototype/ 2D swarm visualization — React + TypeScript (Vite)
|
||||
```
|
||||
|
||||
## Conventions
|
||||
|
||||
- Markdown: ATX headings, fenced code blocks with language tags, pipe tables.
|
||||
- Python: PEP 8, type hints, pure functions where possible, no unnecessary classes.
|
||||
- TypeScript: strict mode, functional components and hooks, no extra UI libraries.
|
||||
- YAML: 2-space indent.
|
||||
- Diagrams: Mermaid inside Markdown.
|
||||
Reference in New Issue
Block a user