154 lines
4.6 KiB
Markdown
154 lines
4.6 KiB
Markdown
# Vervis
|
|
|
|
**Vervis** is a project hosting and management application, with a focus on
|
|
softare projects and decentralization. It's still in very early development. At
|
|
the time of writing, it is a minimal web application in which you can create
|
|
Git repositories and watch their commit logs.
|
|
|
|
Vervis is free software, and is committed to software freedom and to freedom in
|
|
general. It is released to the public domain using the CC0 Public Domain
|
|
Dedication. For the boring "legal" details, see the file `COPYING`. Please use
|
|
and reuse Vervis for a Good purpose, and share your work too in the same
|
|
spirit.
|
|
|
|
## Features
|
|
|
|
This is a list of initial features I plan to support in Vervis. It helps me get
|
|
an overview of more-or-less what's left to do before the first release.
|
|
|
|
[ ] - To do
|
|
[~] - Work in progress
|
|
[/] - Initial coding done, needs tests and polishing
|
|
[x] - Complete
|
|
|
|
[ ] User management
|
|
[~] View your personal overview
|
|
[~] Other users' pages
|
|
[/] Register
|
|
[ ] Delete account
|
|
[/] Log in
|
|
[/] Log out
|
|
[ ] Reset password
|
|
[ ] TLS client cert
|
|
[ ] Upload it
|
|
[ ] View it
|
|
[ ] Log in using it
|
|
[ ] Change profile details
|
|
[/] Key management
|
|
[/] Add key
|
|
[/] Delete key
|
|
[/] View keys
|
|
[ ] Project management
|
|
[/] Tickets
|
|
[ ] Wiki
|
|
[ ] Kanban
|
|
[ ] Merge requests
|
|
[ ] Repo management
|
|
[ ] Delete repo
|
|
[/] Add repo
|
|
[ ] Rename repo
|
|
[ ] Edit repo settings
|
|
[ ] View repo content
|
|
[/] File tree
|
|
[ ] File content
|
|
[/] Plain text
|
|
[/] Syntax highlighting
|
|
[/] Document rendering
|
|
[ ] Images
|
|
[ ] Audio
|
|
[ ] Video
|
|
[ ] Raw file download
|
|
[ ] Darcs
|
|
[ ] Create new repo
|
|
[/] Web
|
|
[ ] SSH
|
|
[ ] Delete repo
|
|
[/] Web
|
|
[ ] SSH
|
|
[/] Clone
|
|
[/] HTTP
|
|
[/] SSH
|
|
[/] Pull
|
|
[/] HTTP
|
|
[/] SSH
|
|
[ ] Push
|
|
[ ] HTTP
|
|
[/] SSH
|
|
[/] View
|
|
[/] History
|
|
[/] Files
|
|
[ ] Git
|
|
[ ] Create new repo
|
|
[/] Web
|
|
[ ] SSH
|
|
[ ] Delete repo
|
|
[/] Web
|
|
[ ] SSH
|
|
[ ] Clone
|
|
[ ] HTTP
|
|
[/] SSH
|
|
[ ] Git
|
|
[ ] Pull
|
|
[ ] HTTP
|
|
[/] SSH
|
|
[ ] Git
|
|
[ ] Push
|
|
[ ] HTTP
|
|
[/] SSH
|
|
[/] View
|
|
[/] History
|
|
[/] Files
|
|
[ ] Federation
|
|
|
|
## Reliability requirements
|
|
|
|
These features are considered critical for a Vervis instance to be a reasonably
|
|
reliable place where people can host their projects and repos, and not worry
|
|
about some bug or missing feature causing loss of data or access.
|
|
|
|
[ ] Password reset, at least over plain email, either automatically or a
|
|
temporary manual hack which will work at least for personal instances
|
|
[x] Git pull and push over SSH fully working
|
|
[x] Darcs pull and push over SSH fully working
|
|
[x] SSH server implementation really secure as far as I know
|
|
[x] TLS support, especially critical when sending passwords. For now, done
|
|
externally through Lighttpd, not Vervis itself
|
|
[x] Darcs pull over HTTP and HTTPS
|
|
[ ] Git pull over HTTP and HTTPS
|
|
[ ] Clear policy and guidelines for DB schema changes
|
|
[ ] Running instance has data backups
|
|
|
|
## Installation
|
|
|
|
See `INSTALL.md`. To be honest, I haven't written it yet. Just use `stack
|
|
install`, pray, and ask me if anything fails. Ah, actually before that you need
|
|
to create a PostgreSQL database, generate an SSH key and update the settings in
|
|
`config/settings.yml` as needed. I promise to write detailed instructions soon.
|
|
|
|
## Using
|
|
|
|
See the .cabal file for more info and link to project website and version
|
|
control.
|
|
|
|
The official download location is the Darcs repository:
|
|
|
|
<http://hub.darcs.net/fr33domlover/vervis>
|
|
|
|
Releases are made to Hackage, the Haskell package repository.
|
|
See <http://hackage.haskell.org/package/vervis>.
|
|
|
|
See the file `INSTALL.md` for a detailed usage and deployment guide. The file
|
|
`ChangeLog` explains how to see the history log of the changes done in the
|
|
code. `NEWS.md` provides a friendly overview of the changes for each release.
|
|
|
|
## Reporting Bugs and Suggesting Features
|
|
|
|
If you found a bug, or you have an idea, a feature request or a wishlist item,
|
|
open a ticket for it! Even if you're goint to implement something or try to
|
|
solve it.
|
|
|
|
<http://rel4tion.org/projects/vervis/tickets/>
|
|
|
|
If you're going to implement some feature or fix some bug you found,
|
|
**start by opening a ticket** so that other people will know which features are
|
|
being developed and who does what.
|