Phase 1 - Internal reference cleanup:
- Delete dev_docs/meetings/ (internal meeting notes/transcripts)
- Replace hardcoded usernames (padak/matejkys/dasa) with deploy/generic
- Replace "Internal AI Data Analyst" with "AI Data Analyst"
- Replace keboola/internal_ai_data_analyst URLs with your-org/ai-data-analyst
- Replace /tmp/keboola_load/ with /tmp/data_analyst_staging/ in dev_docs
Phase 2 - Deployment hardening:
- Tighten sudoers wildcards to explicit paths (visudo, sudoers cp)
- setup.sh creates all groups (data-ops, dataread, data-private) and deploy user
- webapp-setup.sh copies sudoers-webapp from repo instead of inline definition
- deploy.sh conditional copy for data_description.md (not in git for OSS)
- deploy.sh ownership changed to deploy:data-ops for /data/{scripts,docs,examples}
Phase 3 - Config and misc:
- Add ${ENV_VAR} interpolation to config/loader.py
- Expand config/instance.yaml.example with all sections (admins, deployment, auth, etc.)
- Create config/.env.template for secret values
- Add MIT LICENSE
- Fix .gitignore: add .venv/, docs/data_description.md
- Fix README.md: CSV status Planned, remove metrics/, update license text
- Translate Czech comments in requirements.txt to English
- Fix test_account_service.py: mock username mapping instead of relying on instance config
All 118 tests pass.
|
||
|---|---|---|
| .. | ||
| draft | ||
| design-system.md | ||
| desktop-app.md | ||
| disaster-recovery.md | ||
| insights.md | ||
| jira.md | ||
| plan-corporate-memory.md | ||
| plan-rsync-fix.md | ||
| plan_parquet_types_fix.md | ||
| README.md | ||
| security.md | ||
| server.md | ||
| session_explore.md | ||
| telegram_bot.md | ||
Developer Documentation
This folder contains documentation for developers and server administrators only.
⚠️ This folder is NOT synced to analyst machines - it stays on the server and in the git repository only.
Contents
Server Administration
server.md- Data broker server configuration and managementdisaster-recovery.md- Recovery procedures for server failuressecurity.md- Security audit report and hardening guidelinesjira.md- Jira webhook integration and server-side processing
Application Development
desktop-app.md- macOS desktop app architecture and developmenttelegram_bot.md- Telegram notification bot technical docsdesign-system.md- UI/UX design system for web applicationsinsights.md- Activity Center dashboard feature documentation
Planning & Meetings
plan-corporate-memory.md- Corporate Memory module implementation planmeetings/- Meeting transcripts, summaries, and notes
For Analysts
If you're an analyst looking for documentation on how to use the platform, see the docs/ folder instead:
docs/GETTING_STARTED.md- Quick start guidedocs/data_description.md- Data schemas and table definitionsdocs/metrics/- Business metric definitionsdocs/jira_schema.md- Jira data schema referencedocs/notifications.md- How to use Telegram notifications in your scripts